Это старая версия документа.
Здесь описаны правила организации ссылок при создании страниц с помощью системы DokuWiki.
После слова результат следует снимок экрана с тем, как это будет выглядеть в системе.
Внешние ссылки распознаются автоматически: http://www.google.com.
Или просто www.google.com.
Также можно указывать текст ссылки:
[[http://www.google.com|Это ссылка на Google]].
Результат:
Адреса электронной почты тоже распознаются: andi@splitbrain.org.
Внутренние ссылки создаются посредством квадратных скобок.
Можно либо просто указать [[wiki/syntax]]
Результат:
Либо дополнительно прописать [[wiki/syntax|Справка по синтаксису]].
Результат:
Имена Wiki-страниц автоматически переводятся в нижний регистр, спецсимволы использовать нельзя.
Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку имя раздела, также как это делается в HTML.
Ссылка на [[http://byte_srv:8080/doku.php/wiki/syntax?&#внутренние_ссылки|Внутренние ссылки]].
Результат:
Примечания:
Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:
[[http://www.php.net|{{dokuwiki-128.png}}]]
Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.
Здесь приводятся способы вставки картинок при создании страниц в системе DokuWiki.
С помощью фигурных скобок можно вставлять в текст внешние и внутренние картинки.
{{wiki/syntax/dokuwiki-128.png?nolink}}
Поставив слева или справа пробел можно задать выравнивание картинки:
{{wiki/syntax/dokuwiki-128.png?nolink }} {{ wiki/syntax/dokuwiki-128.png?nolink }} {{ wiki/syntax/dokuwiki-128.png?nolink}}
Картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).
{{wiki/syntax/dokuwiki-128.png?nolink|DokuWiki}}
Если задать имя файла (внутреннее или внешнее), который не является картинкой (gif, jpeg, png
), оно будет отображаться в виде ссылки.
Также можно указывать ссылку на изображение с учётом пространства имён в странице:
{{ ru:head1:img1.png }}
При этом необходимо, чтобы картинка находилась в каталоге Media в соответствущем месте:
/media/ru/head1/img1.png.
Все иконки должны браться из единой папки: common/icons.
Иконки пронумерованы с 0 до 257. Если в системе меняется какая-либо иконка, то менять её именно в этой папке, чтобы потом изменения отобразились везде, где она есть.
Если есть иконки со словами, то вставлять их в подобный каталог в соответствующий региональный раздел. (н-р ru/common/icons).
Все большие изображение, шириной более 800 пикселей, нужно сжимать.
Для сжатия использовать FastStown Wiever. Использовать фильтр Lanczos3.
Прочие особенности синтаксиса не нужны.
Для конвертации страниц используется Html2DokuWiki.ЕХЕ (лежит в этой же папке). Принимает этот HTML код небольшими порциями.
Но ссылки и изображение приходится редактировать вручную.
Для названия статьи всегда используем заголовок первого уровня ( ====== Заголовок1 ====== ). Остальные по понижающейся ( ===== Заголовок2 ===== ).
Вставка рисунка внутри рамки с помощью плагина imagebox осуществляется с помощью тага
[{{ путь?nolink |Рисунок 1. Описание}}]
Здесь:
1. Путь – путь к файлу.
2. ? – разделитель.
3. nolink – команда с помощью которой изображение перестаёт быть ссылкой на само себя (по умолчанию в ДокуВики при нажатии на любое изображение осуществляется переход на него)
4. | - разделитель.
5. Рисунок 1. Описание – подпись к рисунку. Структура подписи следующая:
a. Сначала пишется «Рисунок 1.» обычным шрифтом (без подчёркивания и курсива) с точкой на конце.
b. Описание, если такое присутствует. Шрифт обычный (без подчёркивания и курсива).
Вставка таблиц внутри рамки осуществляется с помощью следующих тагов:
^ Заголовок 1 ^ Заголовок 2 ^
| Ячейка 1 | Ячейка 2 |
| Ячейка 3 | Ячейка 4 |
Здесь:
1.
- начало контейнера.
2. ^ Заголовок 1 ^ Заголовок 2 ^
| Ячейка 1 | Ячейка 2 |
| Ячейка 3 | Ячейка 4 | - содержимое таблицы (стандартный синтаксис ДокуВики)
3.
a. endTableBox – команда контейнера.
b. | - разделитель.
c. Таблица 1. Описание – подпись к таблице:
i. Сначала пишется «Таблица 1.» обычным шрифтом (без подчёркивания и курсива) с точкой на конце.
ii. Описание, если такое присутствует. Шрифт обычный (без подчёркивания и курсива).