Здесь описаны правила организации ссылок при создании страниц с помощью системы DokuWiki.

После слова результат следует снимок экрана с тем, как это будет выглядеть в системе.

Внешние ссылки распознаются автоматически: http://www.google.com.

Или просто www.google.com.

Также можно указывать текст ссылки:

[[http://www.google.com|Это ссылка на Google]].

Результат:

Это ссылка на Google 

Адреса электронной почты тоже распознаются: andi@splitbrain.org.

Внутренние ссылки создаются посредством квадратных скобок.

Можно либо просто указать  [[wiki/syntax]]

Результат:

Форматирование синтаксиса

Либо дополнительно прописать [[wiki/syntax|Справка по синтаксису]].

Результат:

Справка по синтаксису 

Имена Wiki-страниц автоматически переводятся в нижний регистр, спецсимволы использовать нельзя.

Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку имя раздела, также как это делается в HTML.

Ссылка на Внутренние ссылки.

Результат:

Внутренние ссылки

Примечания:

• Ссылки на существующие страницы отображаются иным цветом, чем ссылки на несуществующие.
• Внутренние ссылки без указанного текста могут отображаться по разному в зависимости от настроек - в качестве текста может использоваться название страницы или заголовок первого уровня. Так что лучше каждый раз указывать текст ссылки.
• Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.

Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:

[[http://www.php.net|{{dokuwiki-128.png}}]]

Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.

Картинки и текст можно делать в виде сноски.

(({{wiki:dokuwiki-128.png}}))

При этом при наведении указателя мыши на надпись буть всплывать окно (popup) с содержимым сноски, но при этом содержание сноски будет также присутствовать внизу под статьёй.

Здесь приводятся способы вставки картинок при создании страниц в системе DokuWiki.

С помощью фигурных скобок можно вставлять в текст внешние и внутренние картинки. По желанию можно указать их размер.

Нормальный размер:

Отмасштабированная до заданной ширины:

Отмасштабированная до заданных размеров:

Отмасштабированная внешняя картинка:

Нормальный размер:                        {{dokuwiki-128.png}}

Отмасштабированная до заданной ширины:    {{dokuwiki-128.png?50}}

Отмасштабированная до заданных размеров:  {{dokuwiki-128.png?200x50}}

Отмасштабированная внешняя картинка:      {{http://de3.php.net/images/php.gif?200x50}}

Поставив слева или справа пробел можно задать выравнивание картинки:

{{dokuwiki-128.png }}

{{ dokuwiki-128.png }}

{{ dokuwiki-128.png}}

Картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).

{{ dokuwiki-128.png |Название картинки}}

Если задать имя файла (внутреннее или внешнее), который не является картинкой (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.      

a.       endTableBox – команда контейнера.

b.      | - разделитель.

c.        Таблица 1. Описание – подпись к таблице:

                                                                     i.      Сначала пишется «Таблица 1.» обычным шрифтом (без подчёркивания и курсива) с точкой на конце.

                                                                   ii.      Описание, если такое присутствует. Шрифт обычный (без подчёркивания и курсива).