DokuWiki: возможности

Содержание:
1. Знакомство и первые шаги после установки;
2. ~~Возможности~~ (Вы читаете данный раздел);
3. Расширение функций.

Вопреки бытующему мнению, что DokuWiki медлительнее, чем MediaWiki, из-за отсутствия взаимодействия с СУБД, DokuWiki всё же быстрее подготавливает страницы для отображения в браузере - это ощущается просто во время работы с вики. Быстро работает поиск по названиям статей. Не так быстро, как при обращении к СУБД, работает поиск по подстроке, неполному слову. (Впрочем, очевидно, что скорость работы будет во многом зависеть от размеров базы знаний.)

Для правки статей DokuWiki оснащена приятным редактором с панелью инструментов. Текст в процессе правки время от времени сохраняется автоматически в виде черновика, что весьма удобно. Синтаксис подобен MediaWiki, но с рядом косметических отличий. Например, жирный текст, в DokuWiki **отмечается так**, а в MediaWiki - '''вот так'''.

Пустые строки служат отметками новых абзацев. Простой «перевод строки» пропускается. Чтобы сделать жесткий перевод строки в нужном месте, надо написать: «» (без кавычек, конечно), после чего сделать новую строку или поставить пробел. Очень просто создавать сноски - заключаем текст в двойные скобки, и он автоматически нумеруется и становится сноской. Например:

DokuWiki поддерживает создание сносок (сноска - пояснение внизу страницы), что позволяет облегчить основной текст.

DokuWiki - отличное решение для организации информационного портала любого формата. К примеру, если Вы хотите осветить функционал передовой программы http://itools-ru.com/ (http://itools-ru.com/) и ее аналогов, то данная платформа идеально Вам подойдет!

В этом случае при отображении страницы после слова «сноска» будет поставлено приподнятое по вертикали число, обозначающее номер сноски. Нажав на него мышью, пользователь перенесется в конец страницы, где и увидит текстовое пояснение сноски, а именно, например, «1) Сноска - пояснение внизу страницы».

Ряд функций, присущих MediaWiki внутренне, в DokuWiki реализован через плагины - например, выравнивание текста или «редиректы». Впрочем, то же справедливо и в обратную сторону: движок MediaWiki лишен некоторых функций, встроенных в DokuWiki. Подробное сравнение можно увидеть на сайте www.wikimatrix.org.

Мне очень нравится встроенная в DokuWiki подсветка синтаксиса языков программирования. В самом названии этого wiki-движка очевидна его направленность - разработка документации, в том числе технической. При помощи плагинов можно добавлять в статьи диаграммы, а также формулы, записанные в LaTeX. Картинки вставляются встроенными средствами, для HTMLS-видео (ogv) и звука нужны плагины.
Для отображения на странице исходного кода на каком-либо языке программирования, используются теги code и file. Внутри этих тегов сохраняется всё исходное форматирование (пробелы, переносы строк...). Чтобы включить дополнительно подсветку синтаксиса, надо указать язык. Например:

<code php>
<?php echo "hello world!"; ?> 
</code>

Если вы хотите, чтобы над примером исходника была иконка и ссылка для скачивания кода в виде файла, исходник следует оформить примерно так:

<file php example01.php> 
<?php echo "hello world!"; ?>
</file>

При этом, example01.php и будет именем файла, с которым будет сформирована ссылка для скачивания.
Подсветка каких языков программирования поддерживается в DokuWiki? Для этого используется движок GeSHi (http://qbnz.com/highlighter), так что зависит от его способностей, а они впечатляют. Раз уж речь зашла о программировании, замечу, что DokuWiki позволяет вставлять в свои вики-страницы рабочий код на PHP и HTML, тем самым предоставляя возможность неограниченного расширения возможностей вашей Wiki. В целях безопасности такая возможность, однако, отключена.

Для включения встроенного PHP в файл надо /conf/local.php поместить:

$conf['phpok'] = 1;

А для встраивания HTML:

$conf['htmlok'] = 1;

В DokuWiki есть поддержка таблиц с весьма простым синтаксисом. Вот красноречивый пример таблицы с двумя рядами по три колонки/ячейки в каждом.