RTzRa's hive - wiki

404 - страница не найдена

anonymous@undisclosed.example.com (Anonymous) — Tue, 09 May 2017 15:34:00 +0000

404 - страница не найдена

Ошибка 404 или Not Found (не найдено) стандартный код ответа HTTP о том, что клиент был в состоянии общаться с сервером, но сервер не может найти данные согласно запросу. Ошибку 404 не следует путать с «Сервер не найден» или иными ошибками, в которых есть ограничение доступа к серверу. Ошибка 404 означает, что запрашиваемый ресурс может быть доступен в будущем. Википедия

Синтаксис дополнительных плагинов Dokuwiki

anonymous@undisclosed.example.com (Anonymous) — Tue, 21 Jul 2020 13:38:49 +0000

Синтаксис дополнительных плагинов Dokuwiki

Bootstrap 3

Страница плагина: https://www.dokuwiki.org/plugin:bootswrapper

Примеры использования возможностей: http://www.lotar.altervista.org/dokuwiki/wiki/plugin/bootswrapper

Bootstrap3 нынче повсюду:

Родина это не то место где ты родился, родина это то место где ты готов построить дом и воспитать детей, и где окружающий тебя мир будет помогать тебе, ну или как минимум не мешать.

Скоро останутся лишь две группы работников: те, кто контролирует компьютеры, и те, кого контролируют компьютеры. Постарайтесь попасть в первую. Льюис Д. Эйген

Тыкни меня

Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Default Callout

This is a default callout.

Success Callout

This is a success callout.

Danger Callout

This is a danger callout.

Info Callout

This is a info callout.

Warning Callout

This is a warning callout.

Tip Callout

This is a tip callout.

Question Callout

This is a question callout.

Открывашка-группа #1

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.

Открывашка-группа #2

Открывашка-группа #3

Note Plugin

This is my note ! Remember it!!

Warning ! You're about to lose your mind

The clues are in the images.

Beware of the dog when you open the door !!

FlowPlayer plugin

http://www.rtzra.ru/cigun/video/FBI-2005-FengJi.flv 640,480 noautoPlay,autoBuffering

Wrap plugin

xbr Plugin

Строка 1
Строка 2
Строка 3

синтаксис, плагинов, plugins, syntax

⁉️ Dokuwiki: ответы на основные вопросы

anonymous@undisclosed.example.com (Anonymous) — Tue, 27 May 2025 10:34:41 +0000

⁉️ Dokuwiki: ответы на основные вопросы

Как создать новую страницу?

Классический способ: в строке адреса написать путь к создаваемой странице, перейти по ссылке, например: https://yousite.ru/new-page. После получения сообщения «Эта страница ещё не существует» нажать клавишу [e] или на кнопку «Создать страницу»

Расширенный способ, требует установленного плагина «Add New Page» и включении настройки «showAddNewPage Включить плагин «Add New Page» в панель навигации (требуется плагин Add New Page)»:

Как удалить страницу?

Откройте страницу на редактирование, удалите все, сохраните изменения

Как сделать название страницы на русском языке?

Название страницы - это заголовок верхнего уровня. Напишите текст заголовка в окне редактирования, выделите, нажмите «H#» и выберите «H1»

Как сделать название раздела (папки) на русском языке?

Для этого необходимо создать новую страницу с именем start, например: «../my-folder/start»

Где my-folder - как будет показываться имя раздела в ссылке, а start - обязательное имя. Далее на этой странице нужно написать имя вашего раздела по-русски и выделить заголовком «H1»

Как комфортно редактировать страницу, я привык работать в Word (иной офисной программе)?

Нужно установить плагин ckgedit https://www.dokuwiki.org/plugin:ckgedit

НО. Стоит обратить внимание на тот факт, что данный плагин не всегда корректно работает с другими и имеет ряд своих косяков. Используйте на свой страх и риск.

Лично я пользуюсь плагином CodeMirror: https://www.dokuwiki.org/plugin:codemirror

Как создавать разделы при установленном indexmenu?

Продумайте структуру
Создайте страницу с нужным наименованием раздела
Создайте дочернюю страницу/страницы

Дерево с индексом страниц - это результат работы плагина IndexMenu. Когда плагин подключен и настроен, достаточно просто создавать страницы с содержимым и результат будет похожим.

Я делаю таким способом (для меня так удобнее): Например мне нужно создать раздел tipa-test и в нем страницу test-page1 - я в браузере в строке адреса пишу: https://wiki.rtzra.ru/software/tipa-test/test-page1

Получаю ответ: «Эта страница ещё не существует. Вы перешли по ссылке на страницу, которая ещё не существует. Если позволяют ваши права доступа, создайте её, нажав на кнопку Создать страницу», далее нажимаю «Создать страницу» и после сохранения получаю итоговый результат.

Если же мне нужно создать раздел с каким-то содержимым и в нем иные страницы - делаем так:

создаю страницу https://wiki.rtzra.ru/wiki/test/page01
создаю страницу https://wiki.rtzra.ru/wiki/test
и внутри обоих пишу нужную информацию.

В итоге работает и https://wiki.rtzra.ru/wiki/test и https://wiki.rtzra.ru/wiki/test/page01

Как убрать горизонтальный скроллинг в боковом меню (sidebar)

Нужно делать короткие заголовки. Так же это поведение можно отключать настройкой noscroll как описано на https://www.dokuwiki.org/plugin:indexmenu например:

{{indexmenu>..#1|js#thread navbar nsort tsort noscroll}}

dokuwiki, faq, часто задаваемые вопросы, ЧАВО

🙂 Делаем Dokuwiki красивой и удобной

anonymous@undisclosed.example.com (Anonymous) — Fri, 17 Jan 2025 19:31:24 +0000

🙂 Делаем Dokuwiki красивой и удобной

Ответы на часто задаваемые вопросы

Ниже описывается как своими силами доделать Dokuwiki от вида «из коробки» до примерно того что вы видите на этом сайте. Это не сложно, но при первой установке могут понадобиться некоторые знания.

Бесплатно

Если у вас есть вопросы по настройке или возможностях dokuwiki - можно задать их мне (на главной страничке есть мои координаты). Постараюсь ответить по мере возможности, будьте терпеливы.

Платно

Если вам некогда разбираться, я могу проделать эту работу за небольшое вознаграждение, размер которого зависит от ваших хотелок и потраченного времени. Уточнение: дизайном я НЕ занимаюсь!

Время на установку и приведение в божеский вид: от 1 часа в зависимости от объема работы, скорости работы вашего хостинга и т.д.

Что для этого нужно:

ВЫ: Связыватесь со мной: Контакты
ВЫ: Отправляете понятное описание что должно быть на выходе
Я: Уточняю возможность/сроки/деньги
ВЫ: Предоставляете логин/пароль от вашего хостинга с доступом по SSH (в крайнем случае FTP)
Я: Выполняю работу
ВЫ: Ожидаете выполнения работ
ВЫ: Проверяете результат

По окончании работ вы ОБЯЗАТЕЛЬНО должны:

Самостоятельно сменить пароли на вашем хостинге
Проверить и удалить все аккаунты в Dokuwiki, за исключением вашего административного аккаунта
Сменить пароль вашего аккаунта Dokuwiki

Установка Dokuwiki

Скачать можно тут: https://download.dokuwiki.org/
Используйте только Stable версию
Инструкция по установке: https://www.dokuwiki.org/install
Настройка безопасности: https://www.dokuwiki.org/security
Настройка красивых URL: https://www.dokuwiki.org/rewrite

Красивый и моднявый Bootstrap3

После выполнения этих действий dokuwiki станет похожей на мою

Обновляем (или устанавливаем) Dokuwiki последней версии
Переходим Управление → Управление дополнениями
- В «Установленные плагины» устанавливаем плагин Indexmenu Plugin
- В «Установленные шаблоны» устанавливаем шаблон Bootstrap3 Template Giuseppe Di Terlizzi
Создаем в корне dokuwiki страничку с именем sidebar.txt (в файловой системе он лежит в папке data/pages) и следующим содержимым:
```
{{indexmenu>..#1|js#thread navbar nsort tsort noscroll}}

~~NOCACHE~~
```

Расшифровка магии:
{{indexmenu>..:#1}} - Отображать пространство имен родителя и текущий уровень, не разворачивать ноды
js#thread - использовать JS, тема "thread"
navbar - Разворачивать дерево текущего неймспейса
nsort tsort - сортировка страниц в алфавитном порядке
nomenu - используйте если нужно скрывать всплывающее меню
noscroll - если нужно отключить скроллер (если надпись не входит в ширину indexmenu, будет возможность ее двигать и не всем это нравится)
Все параметры тут: https://www.dokuwiki.org/plugin:indexmenu#full_syntax

Переходим Управление → Настройки вики
- В разделе «Параметры «ДокуВики»» устанавливаем:
  - template / Шаблон: bootstrap3
  - sidebar / Боковая панель, пустое поле отключает боковую панель: sidebar
- В разделе «Параметры плагинов» → Indexmenu устанавливаем скрываемые страницы:
  - plugin»indexmenu»skip_file / Список страниц для пропуска: /^sidebar$/
- В разделе «Параметры шаблонов» → Bootstrap3 ставим галочки по желанию для изменения внешнего вида, подключения тем, включения/отключения функций на панели навигации и т.д. Из функционального:
  - tpl»bootstrap3»showCookieLawBanner / Display the Cookie Law banner on footer: выкл
  - tpl»bootstrap3»fixedTopNavbar / Зафиксировать панель навигации сверху: вкл
  - tpl»bootstrap3»fluidContainer / Разрешить плавающий контейнер(страница во весь экран): вкл (отсутствует в новых версиях шаблона)
  - tpl»bootstrap3»fluidContainerBtn / Display a button in navbar to expand container: вкл
  - tpl»bootstrap3»pageOnPanel / Включить рамку вокруг страницы: вкл
  - tpl»bootstrap3»tableFullWidth / Разрешить таблицы в 100% ширину: вкл

Настройки

Параметры «Докувики» / Параметры отображения / Первый заголовок вместо имени страницы (useheading) - Только в навигации
Indexmenu / Скрывать заглавные страницы (hide_headpage) - Отключено

Изменяем тему sidebar

Если стандартная тема сайдбара не нравится, изменяем ее легко и просто: в строке

{{indexmenu>..#1|js#thread navbar nsort tsort}}

кусочек #thread как раз и указывает какую тему использовать. В стандартной поставке есть следующие темы (лежат в папке lib/plugins/indexmenu/images): bj-tango.png, dryoo.png, kde.png, prdsuser-de.png, thread2, bj_ubuntu.png, kgs, bw.png, gnome.png, repository, vista.png, human.png, leopard.png, shiki_brave.png, default, simple, doku, indextheme, pcc_dotted, tango.png, drktheme, kde, phoenity.png, thread

Изменяем цвет sidebar

По умолчанию sidebar зеленого цвета. Чтобы изменить цвет на ваш любимый открываем Управление → Настройка стилей шаблона и меняем existing на #337ab7 (синий цвет), и нажимаем «Сохранить изменения»

Как сделать sidebar видимым только для пользователей с правом "Правка" или выше

Нужно вносить изменения в шаблоне, при обновлении шаблона придется повторить. Для шаблона bootstrap3 нужно отредактировать файл lib/tpl/bootstrap3/Template.php

Было:

        switch ($type) {
            case 'left':
 
                if ($this->getConf('sidebarPosition') == 'left') {
                    $this->sidebarWrapper($left_sidebar, 'dokuwiki__aside', $left_sidebar_grid, 'sidebarheader', 'sidebarfooter');
                }
 
                return true;

Стало:

        switch ($type) {
            case 'left':
                if (auth_quickaclcheck($ID) >= AUTH_EDIT) {
 
                    if ($this->getConf('sidebarPosition') == 'left') {
                        $this->sidebarWrapper($left_sidebar, 'dokuwiki__aside', $left_sidebar_grid, 'sidebarheader', 'sidebarfooter');
                    }
                  }
 
                return true;

Меняем лого и favicon

Заходим в «Управление медиафайлами»
Выбираем каталог «wiki»
Загружаем по очереди файлы logo.png и favicon.ico - это и будет замена стандартным изображениям

Как добавить сайдбар справа (по аналогии с левым)

Устанавливаем тему Bootstrap3 как описано выше, проверяем настройки в разделе Боковая панель (они уже должны быть по умолчанию):
- tpl»bootstrap3»rightSidebar: rightsidebar
- tpl»bootstrap3»rightSidebarGrid: col-sm-3 col-md-2
Создаем страницу rightsidebar.txt в корне вики со следующим содержимым:
```
~~NOCACHE~~
```
В разделе «Параметры плагинов» → Indexmenu устанавливаем скрываемые страницы:
- plugin»indexmenu»skip_file / Список страниц для пропуска: /^sidebar$|^rightsidebar$/

Дополнительные интересные страницы по настройке Dokuwiki

https://starmaugli.ru/dokuwiki/start - Автором нарыто много полезных вещей, оказывается я ему немного помогал в освоении Dokuwiki

Устаревшая информация

Классический способ настройки indexmenu [УСТАРЕЛО]

Обновляем (или устанавливаем) Dokuwiki последней версии
Переходим Управление → Управление дополнениями
- В «Установленные плагины» устанавливаем плагин Indexmenu Plugin
Создаем в корне dokuwiki страничку с именем sidebar (полное имя sidebar.txt если создаете страничку при помощи любого редактора, в файловой системе он лежит в папке data/pages) и следующим содержимым:
```
{{indexmenu>..#1|js#thread navbar nsort tsort noscroll}}

~~NOCACHE~~
```

Расшифровка магии:
{{indexmenu>..:#1}} - Отображать пространство имен родителя и текущий уровень, не разворачивать ноды
js#thread - использовать JS, тема "thread"
navbar - Разворачивать дерево текущего неймспейса
nsort tsort - сортировка страниц в алфавитном порядке
noscroll - если нужно отключить скроллер (если надпись не входит в ширину indexmenu, будет возможность ее двигать и не всем это нравится)
Если нужно скрывать всплывающее меню - используйте nomenu
Все параметры тут: https://www.dokuwiki.org/plugin:indexmenu#full_syntax

Переходим Управление → Настройки вики
- В разделе «Параметры «ДокуВики»» устанавливаем:
  - template / Шаблон: dokuwiki
  - sidebar / Боковая панель, пустое поле отключает боковую панель: sidebar
- В разделе «Параметры плагинов» → Indexmenu устанавливаем скрываемые страницы:
  - plugin»indexmenu»skip_file / Список страниц для пропуска: /^sidebar$/

dokuwiki, theme, themes, bootstrap, sidebar, classic, modern, logo.png, favicon.ico, красивый и удобный вид, украшательства

Sidebar - боковое меню для Dokuwiki

anonymous@undisclosed.example.com (Anonymous) — Tue, 09 May 2017 15:34:00 +0000

Sidebar - боковое меню для Dokuwiki

Информация устарела

Для новых версий Dokuwiki используйте вот этот способ: Делаем Dokuwiki красивой и удобной

Как сделать боковое меню с перечнем всех страничек?

Для этого необходимо установить тему sidebar.

Файлы

Оригинальная тема: sidebar-2010-01-26.tar.gz

Заточенная под последние версии dokuwiki: sidebar-2012-01-28.tar.bz2

sidebar, боковое меню, тема, dokuwiki

Sidebar - боковое меню для Dokuwiki версии 2012-10-13 "Adora Belle"

anonymous@undisclosed.example.com (Anonymous) — Tue, 09 May 2017 15:34:00 +0000

Sidebar - боковое меню для Dokuwiki версии 2012-10-13 "Adora Belle"

Информация устарела

Для новых версий Dokuwiki используйте вот этот способ: Делаем Dokuwiki красивой и удобной

Вышла новая версия Dokuwiki (2012-10-13 «Adora Belle») и стандартный sidebar более не работает.

Можно взять новую версию здесь: http://www.jandecaluwe.com/testwiki/doku.php/navigation:sidebar_install

А можно немного подпилить стандартную тему, но сайдбар будет работать немного кривовато: при переходах дерево содержания будет сворачиваться.

Так как же сделать привычное боковое меню с перечнем всех страничек?

Для этого необходимо сделать несколько движений.

Изменяем настройки

Заходим «Управление» → «Настройки вики», делаем следующее:

Шаблон: dokuwiki
Боковая панель, пустое поле отключает боковую панель: sidebar
Сохраняем настройки

Теперь у нас появилось пустое пространство в левой части странички, нужно поместить туда наш индекс страничек.

Устанавливаем плагин SimpleIndex

Ставим плагин отсюда: https://www.dokuwiki.org/plugin:simpleindex

Создаем страницу sidebar

А внутрь странички пишем следующее:

~~NOCACHE~~
===== Индекс =====
<simpleindex>

Ну и вообще можно навести красоту любым способом.

Правим ширину шаблона dokuwiki

Для этого правим lib/tpl/dokuwiki/style.ini

Например, пусть шаблон занимает 95% по ширине, меняем

__site_width__      = "75em"

на

__site_width__      = "95%"

sidebar, боковое меню, тема, dokuwiki, Adora Belle, simpleindex, ширина шаблона

Toolbar

anonymous@undisclosed.example.com (Anonymous) — Tue, 09 May 2017 15:34:00 +0000

Within the edit window, the toolbar helps users formatting their texts without remembering the syntax.

The toolbar buttons work pretty much like the formatting buttons in your favorite word processor. Select a word or phrase and press a button to format the selection. If you click without a selection, a sample text is inserted at the cursor.

The toolbar also gives access to the media manager popup.

If the toolbar does not show up for you, follow the steps outlined in the toolbar FAQ to troubleshoot the problem!

Toolbar Buttons

Most buttons have shortcuts assigned to them based on the access keys of your browser, usually the accesskeys are: ALT + <Key> or ALT + Shift + <Key> on Windows and CTRL + ⌥ Opt + <Key> on Mac, please refer to the access keys for more details.

Button	Key	Function
	b	Bold formatting
	i	Italic formatting
	u	Underlined formatting
	c	Code formatting
	d	Strike-through formatting
	8	Same level headline
	9	Lower headline
	0	Higher headline
		Select headline
	1	Level 1 headline (via 'Select headline' button)
	2	Level 2 headline (via 'Select headline' button)
	3	Level 3 headline (via 'Select headline' button)
	4	Level 4 headline (via 'Select headline' button)
	5	Level 5 headline (via 'Select headline' button)
	l	Internal link formatting (launches the Link Wizard)
		External link formatting
	-	Ordered list item
	.	Unordered list item
		Horizontal rule
		Media Selection, includes file/attachment uploader
		Smiley picker
		Character picker
	y	Signature (only when logged in)

Полезные плагины для Dokuwiki

anonymous@undisclosed.example.com (Anonymous) — Fri, 29 Dec 2023 18:39:38 +0000

Полезные плагины для Dokuwiki

Вся сила функционала Dokuwiki в плагинах, они существенно расширяют возможности вики и делают ее красивее и удобнее. И самое приятное - они опциональные, надо - ставь, не надо - можно прекрасно обойтись и без них.

Домашняя страница плагинов: https://www.dokuwiki.org/plugins

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

Не ставьте плагины впрок, только если нужны и действительно используются. Это позволяет увеличить безопасность вашей вики. Если плагин не используется - удалите его, не оставляйте отключенным.
Плагин должен быть поддерживаемым, если плагин давно не обновляется - не устанавливайте, это источник проблем.
Плагин должен быть совместимым с вашей версией dokuwiki, это избавит от большого количества проблем.
Читайте список совместимости, не все плагины «дружат» друг с другом.

Внешний вид

• Indexmenu

Боковое меню навигации, рекомендую

• Bootstrap Wrapper

Bootstrap нынче везде, с ним ваша вика выглядит стильно и современно. Большое количество украшений для вики, подробнее можно посмотреть тут: http://www.lotar.altervista.org/dokuwiki/wiki/plugin/bootswrapper

• Icons

Позволяет вставлять красивые иконки из различных паков, требует установленных плагинов Font Awesome, Glyphicons from Twitter Bootstrap

Редактирование и форматирование текста

• CodeMirror Plugin

Мой выбор. Значительно улучшает стандартный редактор: добавляет изменение размера редактора, встроенный поиск (в т.ч. по regexp), темы и подсветку синтаксиса, размер шрифта, номера строк и т.д. Однозначно MustHave.

• CKGEdit

Визуальный редактор, более привычный широкому кругу пользователей нежели стандартный. Обладает рядом багофич, которые нужно иметь в виду при эксплуатации.

Конфликтует с плагинами: Fastwiki и Edittable

Reverse Proxy Problem: When dokuwiki is behind a reverse proxy, the save button does not work out of the box. Solution: inside the dokuwiki configuration set the baseurl setting to the outside url . This fixes all “false” and other problems using this plugin. See: https://github.com/turnermm/ckgedit/issues/335 –Thanks to FrankIJskes (github.com)

Или можно руками внести изменения в файл <dokuwiki_dir>/conf/local.php добавив $conf['baseurl'] = 'https://our.domain.xx';

• EditTable

Исключительно удобный инструмент для работы с таблицами

• DataTables

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

• xbr Plugin

Позволяет делать привычные переносы строк

• Code Replacement

Для вставки кусочков кода на различных языках программирования

• Imgpaste

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

• dropfiles

Позволяет перетаскивать файлы прямо в окно редактирования

• keyboard

Вставляет красивые сочетания клавиш, очень удобно для всяких мануалов

• Note

Симпатичные заметки

• Wrap

Включает большой функционал, позволяет произвольно создавать контейнеры div и span, размещать в них информацию

Управление страницами

• editx

Расширенные функции редактирования, такие как переименование и удаление страниц

• Move

Переименование и перемещение страниц и файлов

Переименовать страницу: открываем на редактирование, в меню справа выбираем «Переименовать страницу», вводим новое название.

Перемещение: открываем на редактирование, в меню последовательно открываем Инструменты / Управление / Перемещение страниц и пространств имён (или Управление / Перемещение страниц и пространств имён - в зависимости как у вас настроено меню шаблона), убедимся что включено «Переместить страницу» и в поле «Новое название» пишем куда должна быть перемещена страница (пространство имен), нажимаем «Начать», при необходимости убедиться что все верно нажимаем «Просмотреть ожидаемые изменения» и если все ок - нажимаем «Начать».

Функционал

• Tag

Позволяет назначать теги, с ними поиск становится удобнее

• Video Share

Для вставки видео с различных хостингов

• Gallery

Для вставки фото

Разное

• DW2PDF

Экспорт страниц в PDF

Администрирование

• upgrade

Упрощает процесс обновления dokuwiki

• CAPTCHA

Защита от ботов

dokuwiki, plugins, плагины, must have

DokuWiki

anonymous@undisclosed.example.com (Anonymous) — Sat, 17 Feb 2024 12:50:04 +0000

DokuWiki

DokuWiki is a simple to use and highly versatile Open Source wiki software that doesn't require a database. It is loved by users for its clean and readable syntax. The ease of maintenance, backup and integration makes it an administrator's favorite. Built in access controls and authentication connectors make DokuWiki especially useful in the enterprise context and the large number of plugins contributed by its vibrant community allow for a broad range of use cases beyond a traditional wiki.

Read the DokuWiki Manual to unleash the full power of DokuWiki.

Download

DokuWiki is available at https://download.dokuwiki.org/

All documentation and additional information besides the syntax description is maintained in the DokuWiki at www.dokuwiki.org.

About DokuWiki

Installing DokuWiki

Using DokuWiki

Customizing DokuWiki

DokuWiki Feedback and Community

Copyright

2004-2020 © Andreas Gohr andi@splitbrain.org¹⁾ and the DokuWiki Community

The DokuWiki engine is licensed under GNU General Public License Version 2. If you use DokuWiki in your company, consider donating a few bucks .

Not sure what this means? See the FAQ on the Licenses.

¹⁾

Please do not contact me for help and support – use the mailinglist or forum instead

Инсталляция DokuWiki [Устарело]

anonymous@undisclosed.example.com (Anonymous) — Tue, 02 Jan 2024 10:54:08 +0000

Инсталляция DokuWiki [Устарело]

Информация устарела

Все нижеописанное весьма устарело и рекомендуется для очень старых версий, имейте это ввиду.
Для новых версий Dokuwiki используйте вот этот способ: Делаем Dokuwiki красивой и удобной

Для того, чтобы развернуть на своей площадке такой же сайт необходимо установить и настроить ядро DokuWiki, установить и настроить тему, установить и настроить необходимые плагины.

Ниже представлен примерный перечень шагов с описаниями, которые может быть необходимо выполнить:

Работать в соответствии с инструкцией по установке Install:
- Скачать с сайта DokuWiki последний стабильный релиз
- Распаковать архив, загрузить через FTP или SSH содержимое архива на сервер в целевую директорию (например, в корень WWW)
- Либо web dokuwiki installer → тут
- Создать пустой файл changes.log в папке data (либо командой touch data/changes.log, либо копированием пустого файла через FTP)
- Установить папкам data и conf и подпапкам атрибуты 755 или 777
- Установить всем файлам в data и conf атрибуты 644 или 666
- Копировать conf/users.auth.php.dist в conf/users.auth.php и установить атрибуты 644 или 666
- Копировать conf/acl.auth.php.dist в conf/acl.auth.php и установить атрибуты 644 или 666
- Копировать conf/dokuwiki.php в conf/local.php и установить атрибуты 644 или 666
- Создать первую страницу - средствами DokuWiki (кнопка Create Page)
В соответствии с руководством по улучшению безопасности security
- Переименовать папку data в другое имя, например data2²⁾ и внести соответствующее изменение в conf/local.php
```
$conf['savedir'] = '/data2';
```
Включить поддержку авторизации в соответствии с acl
- Исправить conf/local.php
```
$conf['useacl']       = 1;        // this enables the ACL feature
$conf['superuser']    = '@admin'; // admin group is superuser
```
- Зарегистрировать в системе пользователя - средствами DokuWiki
- В файле conf/users.auth.php исправить группу у пользователя на группу суперюзера (указать после последнего двоеточия admin) - пользователь приобретёт администраторские права
- На первой странице (start) зайти в Admin/Access Control List Management и исправить права доступа для пространства имён, группа ALL оставить только чтение, нажать «Обновить»
Настроить DokuWiki в соответствии с config
- Зайти в DokuWiki под админским логином в раздел Admin/Configuration Manager (кнопка снизу) и поставить language=ru, применить настройки
- В «Управление/Настройки Вики» (бывшее Admin/Configuration Manager):
  - Права для создаваемых директорий - 0777 (чтобы не было проблем с бэкапом и управлением через FTP)
  - Права для создаваемых файлов - 0666 (чтобы не было проблем с бэкапом и управлением через FTP)
  - Включить отладку (отключите!) - убрать флажок
  - Транслитерация в именах страниц - полная транслитерация (чтобы не было ссылок с %D0%A4…)
  - Разрешить подписку на изменения - да
  - Удобочитаемые адреса (URL) - Средствами DokuWiki
установить плагин plugin:txtconf и добавить ссылки на yandex.ru и google.ru:
- Вставить в conf/interwiki.conf строки:
```
ya        http://www.yandex.ru/yandsearch?text=
google.ru http://www.google.ru/search?q=
```
- Загрузить в lib/images/interwiki файлы и
Настроить дату сервера в соответствии с tips:timezone, ниже приведён пример для Московского времени:
- Исправить файл conf/local.protected.php, добавив после <?php строку
```
putenv("TZ=Europe/Moscow");// - для PHP4
date_default_timezone_set("Europe/Moscow"); // - для PHP5
```
Добавить определения новых типов файлов (example.mpp, example.vsd, , example.rar, example.djvu)
- В conf/mime.conf дописать следующие строки³⁾:
```
mpp     application/vnd.ms-project
vsd     application/vnd.visio
mp3     audio/mpeg
rar     application/x-rar-compressed
djvu    application/x.djvu
djv     application/x.djvu
```
  если установить плагин plugin:txtconf, то добавить эти строки в mime.conf можно с помощью этого плагина.

Скопировать файлы , , , , в директорию lib/images/fileicons

Темы

Better Navigation Template - тема, в которой название сайта помещено в левый угол, сделана подсветка активной страницы в списке посещённых, добавлено боковое меню для разделов сайта. Либо тут → http://www.jandecaluwe.com/testwiki/doku.php/navigation:sidebar_install

После установки темы необходимо скопировать в папку темы из папки стандартной темы lib\tpl\default\ файлы _admin.css и _linkwiz.css, а также добавить пару строк в файл style.ini в раздел [stylesheets]:

_admin.css     = screen
_linkwiz.css   = screen

Дополнительные плагины

Никогда, никогда не используйте программу MS Notepad⁴⁾ для редактирования файлов в UTF-8 кодировке!
Эта программа вставляет тройку символов в самое начало файла (EF BB BF), по которым определяет, что это UTF-8 кодировка, что иногда приводит к сбоям в PHP скриптах и порче разметки сайтов.

Конечно, эти символы не есть личная придумка Microsoft - это один из способов отмечать UTF-8 документы. Но MS Notepad не умеет сохранять документы без этого префикса.

Используйте редакторы, умеющие правильно работать с UTF-8⁵⁾.

Google Analitycs

Плагин для подключения статистики от Google Analytics.

plugin:google_analytics

Надо модифицировать шаблон, вставив в файл lib/tpl/…./main.php следующие строки:

было:
</body>
</html>
 
стало:
</body>
  <?php
    if (file_exists(DOKU_PLUGIN.'googleanalytics/code.php')) include_once(DOKU_PLUGIN.'googleanalytics/code.php');
    if (function_exists('ga_google_analytics_code')) ga_google_analytics_code();
  ?>
</html>

BookmarkMe

Вставляет блок кнопок для создания закладок на публичных серверах типа http://del.icio.us

ActionLink

Вставляет ссылки на служебные функции/специальные страницы DokuWiki. Например, index.

plugin:actionlink - страница о плагине

{{actionlink>[action]|[title]}}

Элемент action может принимать следующие значения:

edit - редактировать/создать/показать страницу
history - история страницы
recent - недавние изменения
login - войти/выйти
index - все страницы
admin - управление DokuWiki
top - ссылка «перейти к началу»
back - ссылка «вернуться назад»
backlink - список обратных ссылок

Элемент title является необязательным. Он позволяет вставить другой текст вместо стандартного 'Редактировать страницу', 'Старые версии', 'Недавние изменения', и т.д.

Search Index Manager

Перестраивает индекс для полнотекстового поиска

Страница о плагине - plugin:searchindex_manager
Загрузить исправленную версию плагина searchindex.zip (добавлен русскоязычный интерфейс)
Разархивировать плагин в папку /lib/plugins/searchindex
Использование плагина - в панели управления выбрать строку «Менеджер индекса полнотекстового поиска»

Иногда плагин не работает и выдаёт ошибку

Warning: array_keys(): The first argument should be an array in ...\inc\indexer.php on line 56
Warning: join(): Bad arguments in ...\inc\indexer.php on line 56

В таком случае может помочь исправление в файле inc\indexer.php:

// добавить следующую строку
if (!is_array($links)) { $links = Array($links); }
// перед строчкой 
$tmp = join(' ',array_keys($links));

Note

Оформляет текст как заметку ( Выглядит по-разному в Explorer'е и Firefox'е)

В таком виде можно оформлять всевозможные комментарии в справочных руководствах

Страница о плагине - plugin:note
Загрузить исправленную версию плагина :note.rar (изменён стиль обычной заметки)
Разархивировать плагин в папку /lib/plugins/note

Использование плагина -

<note>обычная заметка</note>
<note tip>заметка-подсказка</note>
<note important>важная заметка</note>
<note warning>заметка-предупреждение</note>

заметка-подсказка

важная заметка

заметка-предупреждение

PageMove

Переименовывает и переносит страницы между разными пространствами имён

Страница о плагине - plugin:rename
Загрузить версию плагина с официальной страницы
Разархивировать плагин в папку /lib/plugins/pagemove
Использование - администраторский плагин - «Управление»/«Перемещение/Переименование страницы…»

Discussion

Добавляет форму отправки комментариев к странице, фактически позволяет разместить на странице ветку форума. Пример смотри в конце этой страницы.

Страница о плагине - plugin:discussion
Установка - разархивировать плагин в папку /lib/plugins/discussion
Использование плагина - вставить в конец текста страницы
```
~~DISCUSSION~~
```
До конца переведённый файл поддержки русского языка discussion_ru.rar

Плагин не совместим с предыдущей версией плагина Blog, составной частью которого он является. Старую версию надо удалить перед инсталляцией Discussion.

ICQ

Выводит номер ICQ с отображением текущего статуса пользователя (запрашивает картинку с сервера ICQ): 123456789

Страница о плагине - plugin:icq
Загрузить исправленую версию плагина:icq.zip (добавлена строка с номером ICQ)
Разархивировать плагин в папку /lib/plugins/icq
Использование плагина -
```
[[icq>123456789]]
```

Highlight

Выделяет текст цветом: <hi>выделение по умолчанию</hi> <hi red>выделение нужным цветом (red)</hi>

Страница о плагине - plugin:highlight
Загрузить исправленную версию плагина (исправлена уязвимость XSS) - highlight.zip
Разархивировать плагин в папку /lib/plugins/highlight

Использование плагина:

<hi>текст</hi>
<hi red>текст</hi>
<hi #A8F1F2>текст</hi>
<hi rgb(255,34,123)>текст</hi>

<hi>текст</hi>
<hi red>текст</hi>
<hi #A8F1F2>текст</hi>
<hi rgb(255,34,123)>текст</hi>

FreeMind

Выводит файлы сделанные в FreeMind в виде интерактивного Flash или Java.

Страница о плагине - plugin:freemind
Требует установки плагина plugin:command
Разархивировать плагин в папку lib/plugins/command/ext
Добавить в conf/mime.conf строчку:
```
mm   text/xml
```

Пример использования:

#freemind?type=flash(dokuwiki.mm)#

#freemind?type=flash(dokuwiki.mm)#

BackupTool

Позволяет делать архивную копию страниц, предыдущих версий, meta-данных, media-файлов, файлов конфигурации, тем и плагинов.

Страница о плагине - BackupTool (на английском)
Скачать дистрибутив - backuptool-current.tar.gz
Разархивировать плагин в папку lib/plugins/backup

Замечание: Данный плагин использует библиотеку PEAR. Если эта библиотека не установлена, то вы получите сообщение о невозможности создания архивной копии.

Инфа на будущее

tips:pdfexport - о том, как настроить экспорт в PDF
tips:htmltowiki - конвертор из HTML в WIKI

Миграция со старых версий

Когда обновляется DokuWiki со старой версии, которая ещё не поддерживала функцию «транслитерация» сталкиваешься с проблемой, что получается практически нечитабельная структура файлов и директорий.

Например : «%D0%BA%D1%8B%D1%80%D0%B3%D1%8B%D0%B7%D1%81%D1%82%D0%B0%D0%BD.txt» это тоже самое, что «кыргызстан.txt»

Это происходит потому что имена файлов в UTF-8 подвергаются url-кодированию.

В последних версиях DokuWiki есть опция «транслитерация» для того, чтобы изменить такое поведение. Однако простая смена настроек DokuWiki недостаточна - все старые файлы переименованы не будут.

Для того, чтобы конвертировать нечитабельную файловую структуру в «транслитерированный формат» был написан следующий скрипт:

<?php
 
if(!defined('DOKU_INC')) define('DOKU_INC',realpath(dirname(__FILE__).'/../').'/');
require_once(DOKU_INC.'inc/utf8.php');
 
 
/**
 * Copy a file, or recursively copy a folder and its contents, and clean up the filenames according to the dokuwiki UTF-8 
 *
 * @original_author      Aidan Lister <aidan@php.net>
 * @link        http://aidanlister.com/repos/v/function.copyr.php
 * @param       string   $source    Source path
 * @param       string   $dest      Destination path
 * @return      bool     Returns TRUE on success, FALSE on failure
 */
function copyr($source, $dest)
{
	$dest2=cleanID($dest);
	echo $source."->".$dest." ->$dest2<br/>";
    // Simple copy for a file
    if (is_file($source)) {
        return copy($source, $dest2);
    }
 
    // Make destination directory
    if (!is_dir($dest)) {
        mkdir($dest2);
 
	}
 
    // Loop through the folder
    $dir = dir($source);
    while (false !== $entry = $dir->read()) {
        // Skip pointers
        if ($entry == '.' || $entry == '..') {
            continue;
        }
 
        // Deep copy directories
        if ($dest !== "$source/$entry") {
            copyr("$source/$entry", "$dest/$entry");
        }
    }
 
    // Clean up
    $dir->close();
    return true;
}
 
copyr("/srv/www/htdocs/data/","/srv/www/htdocs/datanew/"); // пути к папкам на сервере (исходный и конечный)
 
function cleanID($id,$ascii=false){
  $id = trim(urldecode($id));
  $id = utf8_strtolower($id);
  $id = utf8_romanize($id);
  utf8_deaccent($id,-1);
  $id = preg_replace('#\'+#','_',$id);
  return($id);
}
 
?>

В скрипте надо исправить путь к директории с данными, поместить его в папку bin и запустить из браузера www.yoursite.ru/bin/convert.php

После этого будет создана папка с копией данных но в транслитерированном формате. Теперь осталось только зайти в настройки DokuWiki, исправить путь к папке с данными на datanew и выбрать вариант «Полная транслитерация в именах страниц», а также «Использовать первый заголовок вместо имени».

Также может потребоваться чистка кэша DokuWiki (для этого можно использовать соответствующий плагин).

После использования скрипт надо удалить!
Также не помешает проверить структуру созданных папок и файлов на корректность — в именах файлов могут появиться символы типа «'» (если в названии страницы был твёрдый знак).

~~DISCUSSION~~

²⁾

В некоторых случаях нужно указывать абсолютный путь (точка перед слэшем), './data2'. Например, плагин СacheRevisionsEraser не работал, пока не был указан именно второй вариант.

³⁾

для DJVU файлов правильный mime тип image/x.djvu, однако в таком случае они будут переданы на обработку в графическую библиотеку, которая попытается (безуспешно) сделать иконку. С типом application/x.djvu DokuWiki поступает проще - делает для таких файлов ссылку на скачивание и даёт стандартную иконку.

⁴⁾

он же Блокнот

⁵⁾

Текстовые редакторы, в которых можно без проблем работать с файлами Dokuwiki: Notepad++ (Опция «Кодировать в UTF-8 без BOM»), или встроенные в FAR, либо в Total Commander, а также множество других более современных программ

PlantUML - прикручиваем к Dokuwiki

anonymous@undisclosed.example.com (Anonymous) — Tue, 09 May 2017 15:34:00 +0000

PlantUML - прикручиваем к Dokuwiki

PlantUML - это плагин для отрисовывания UML-диаграмм.

Требования

Java
PlantUML в виде plantuml.jar отсюда: http://plantuml.sourceforge.net/download.html
Плагин PlantUML для Dokuwiki отсюда: https://www.dokuwiki.org/plugin:plantuml
GraphViz http://www.graphviz.org/

Установка описана для Ubuntu Server 10.04.4 & 12.04.2

Установка

Ставим Java. Я пробовал OpenJDK и IcedTea - и там и там работает нормально.

$ sudo apt-get install openjdk-6-jre

Ставим GraphViz (наче далеко не все диаграммы будут отрисовываться):

$ sudo apt-get install graphviz

Устанавливаем плагин в Dokuwiki
Настраиваем плагин через Управление→Настройки вики→Plantuml Параметры плагина
- Render localy: включаем
- The path to your Java runtime interpreter (eg. /usr/bin/java): /usr/bin/java
Качаем plantuml.jar и подкладываем его в папку плагина dokuwiki/lib/plugins/plantuml/

Работаем

Создаем страничку, пишем

<uml>
Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response
Alice ->> Bob: Another authentication Request
Alice <<-- Bob: another authentication Response
</uml>

<uml>
[*] --> outbox
outbox -> отправка : С частотой 2 раза в сек.
отправка --> bounced : Известная ошибка,\nтребующая повторной\nотправки
отправка --> sent : Отправка без ошибок
отправка --> error : Неизвестная ошибка\nпри отправке
отправка --> overlimit : Превышен лимит\nотправок
overlimit --> [*]  
sent --> [*]
error --> [*]
bounced --> outbox : После выдержки 1 мин
</uml>

Проверяем, должно работать. Если что - проверяем логи веб-сервера, смотрим не заблокирована ли функция PHP под названием 'exec'

<uml>
Alice → Bob: Authentication Request
Bob –> Alice: Authentication Response
Alice →> Bob: Another authentication Request
Alice «– Bob: another authentication Response
</uml>

<uml>
[*] –> outbox
outbox → отправка : С частотой 2 раза в сек.
отправка –> bounced : Известная ошибка,\nтребующая повторной\nотправки
отправка –> sent : Отправка без ошибок
отправка –> error : Неизвестная ошибка\nпри отправке
отправка –> overlimit : Превышен лимит\nотправок
overlimit –> [*]
sent –> [*]
error –> [*]
bounced –> outbox : После выдержки 1 мин
</uml>

uml, plantuml, dokuwiki, установка, java, graphviz

Formatting Syntax

anonymous@undisclosed.example.com (Anonymous) — Sat, 17 Feb 2024 12:50:04 +0000

Formatting Syntax

DokuWiki supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing «Edit this page». If you want to try something, just use the playground page. The simpler markup is easily accessible via quickbuttons, too.

Basic Text Formatting

DokuWiki supports bold, italic, underlined and monospaced texts. Of course you can combine all these.

DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts.
Of course you can **__//''combine''//__** all these.

You can use _subscript and ^superscript, too.

You can use <sub>subscript</sub> and <sup>superscript</sup>, too.

You can mark something as ~~deleted~~ as well.

You can mark something as <del>deleted</del> as well.

Paragraphs are created from blank lines. If you want to force a newline without a paragraph, you can use two backslashes followed by a whitespace or the end of line.

This is some text with some linebreaks
Note that the
two backslashes are only recognized at the end of a line

or followed by
a whitespace \\this happens without it.

This is some text with some linebreaks\\ Note that the
two backslashes are only recognized at the end of a line\\
or followed by\\ a whitespace \\this happens without it.

You should use forced newlines only if really needed.

Links

DokuWiki supports multiple ways of creating links.

External

External links are recognized automagically: http://www.google.com or simply www.google.com - You can set the link text as well: This Link points to google. Email addresses like this one: andi@splitbrain.org are recognized, too.

DokuWiki supports multiple ways of creating links. External links are recognized
automagically: http://www.google.com or simply www.google.com - You can set
link text as well: [[http://www.google.com|This Link points to google]]. Email
addresses like this one: <andi@splitbrain.org> are recognized, too.

Internal

Internal links are created by using square brackets. You can either just give a pagename or use an additional link text.

Internal links are created by using square brackets. You can either just give
a [[pagename]] or use an additional [[pagename|link text]].

Wiki pagenames are converted to lowercase automatically, special characters are not allowed.

You can use namespaces by using a colon in the pagename.

You can use [[some:namespaces]] by using a colon in the pagename.

For details about namespaces see namespaces.

Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to this Section.

This links to [[syntax#internal|this Section]].

Notes:

Links to existing pages are shown in a different style from nonexisting ones.
DokuWiki does not use CamelCase to automatically create links by default, but this behavior can be enabled in the config file. Hint: If DokuWiki is a link, then it's enabled.
When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much.

Interwiki

DokuWiki supports Interwiki links. These are quick links to other Wikis. For example this is a link to Wikipedia's page about Wikis: Wiki.

DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis.
For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].

Windows Shares

Windows shares like this are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate Intranet.

Windows Shares like [[\\server\share|this]] are recognized, too.

Notes:

For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the «local zone»).
For Mozilla and Firefox it can be enabled through different workaround mentioned in the Mozilla Knowledge Base. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in conf/lang/en/lang.php (more details at localization):
conf/lang/en/lang.php
```
<?php
/**
 * Customization of the english language file
 * Copy only the strings that needs to be modified
 */
$lang['js']['nosmblinks'] = '';
```

Image Links

You can also use an image to link to another internal or external page by combining the syntax for links and images (see below) like this:

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

Please note: The image formatting is the only formatting syntax accepted in link names.

The whole image and link syntax is supported (including image resizing, internal and external images and URLs and interwiki links).

Footnotes

You can add footnotes ⁶⁾ by using double parentheses.

You can add footnotes ((This is a footnote)) by using double parentheses.

Sectioning

You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically – this can be disabled by including the string ~~NOTOC~~ in the document.

Headline Level 3

Headline Level 4

Headline Level 5

==== Headline Level 3 ====
=== Headline Level 4 ===
== Headline Level 5 ==

By using four or more dashes, you can make a horizontal line:

Media Files

You can include external and internal images, videos and audio files with curly brackets. Optionally you can specify the size of them.

Real size:

Resize to given width:

Resize to given width and height⁷⁾:

Resized external image:

Real size:                        {{wiki:dokuwiki-128.png}}
Resize to given width:            {{wiki:dokuwiki-128.png?50}}
Resize to given width and height: {{wiki:dokuwiki-128.png?200x50}}
Resized external image:           {{https://www.php.net/images/php.gif?200x50}}

By using left or right whitespaces you can choose the alignment.

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

Of course, you can add a title (displayed as a tooltip by most browsers), too.

{{ wiki:dokuwiki-128.png |This is the caption}}

For linking an image to another page see Image Links above.

Supported Media Formats

DokuWiki can embed the following media formats directly.

Image	`gif`, `jpg`, `png`
Video	`webm`, `ogv`, `mp4`
Audio	`ogg`, `mp3`, `wav`
Flash	`swf`

If you specify a filename that is not a supported media format, then it will be displayed as a link instead.

By adding ?linkonly you provide a link to the media without displaying it inline

{{wiki:dokuwiki-128.png?linkonly}}

dokuwiki-128.png This is just a link to the image.

Fallback Formats

Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility.

For example consider this embedded mp4 video:

{{video.mp4|A funny video}}

When you upload a video.webm and video.ogv next to the referenced video.mp4, DokuWiki will automatically add them as alternatives so that one of the three files is understood by your browser.

Additionally DokuWiki supports a «poster» image which will be shown before the video has started. That image needs to have the same filename as the video and be either a jpg or png file. In the example above a video.jpg file would work.

Lists

Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a * for unordered lists or a - for ordered ones.

This is a list
The second item
- You may have different levels
Another item

The same list but ordered
Another item
1. Just use indention for deeper levels
That's it

  * This is a list
  * The second item
    * You may have different levels
  * Another item

  - The same list but ordered
  - Another item
    - Just use indention for deeper levels
  - That's it

Also take a look at the FAQ on list items.

Text Conversions

DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML.

The text to image conversion is mainly done for smileys. And the text to HTML conversion is used for typography replacements, but can be configured to use other HTML as well.

Text to Image Conversions

DokuWiki converts commonly used emoticons to their graphical equivalents. Those Smileys and other images can be configured and extended. Here is an overview of Smileys included in DokuWiki:

8-)
8-O
:-(
:-)
=)
:-/
:-\
:-?
:-D
:-P
:-O
:-X
:-|
;-)
^_^
m(
:?:
:!:
LOL
FIXME
DELETEME

Text to HTML Conversions

Typography: DokuWiki can convert simple text characters to their typographically correct entities. Here is an example of recognized characters.

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

The same can be done to produce any kind of HTML, it just needs to be added to the pattern file.

There are three exceptions which do not come from that pattern file: multiplication entity (640×480), 'single' and «double quotes». They can be turned off through a config option.

Quoting

Some times you want to mark some text to show it's a reply or comment. You can use the following syntax:

I think we should do it

> No we shouldn't

>> Well, I say we should

> Really?

>> Yes!

>>> Then lets do it!

I think we should do it

No we shouldn't

Well, I say we should

Really?

Yes!

Then lets do it!

Tables

DokuWiki supports a simple syntax to create tables.

Heading 1	Heading 2	Heading 3
Row 1 Col 1	Row 1 Col 2	Row 1 Col 3
Row 2 Col 1	some colspan (note the double pipe)
Row 3 Col 1	Row 3 Col 2	Row 3 Col 3

Table rows have to start and end with a | for normal rows or a ^ for headers.

^ Heading 1      ^ Heading 2       ^ Heading 3          ^
| Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        |
| Row 2 Col 1    | some colspan (note the double pipe) ||
| Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        |

To connect cells horizontally, just make the next cell completely empty as shown above. Be sure to have always the same amount of cell separators!

Vertical tableheaders are possible, too.

	Heading 1	Heading 2
Heading 3	Row 1 Col 2	Row 1 Col 3
Heading 4	no colspan this time
Heading 5	Row 2 Col 2	Row 2 Col 3

As you can see, it's the cell separator before a cell which decides about the formatting:

|              ^ Heading 1            ^ Heading 2          ^
^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        |
^ Heading 4    | no colspan this time |                    |
^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        |

You can have rowspans (vertically connected cells) by adding ::: into the cells below the one to which they should connect.

Heading 1	Heading 2	Heading 3
Row 1 Col 1	this cell spans vertically	Row 1 Col 3
Row 2 Col 1		Row 2 Col 3
Row 3 Col 1		Row 2 Col 3

Apart from the rowspan syntax those cells should not contain anything else.

^ Heading 1      ^ Heading 2                  ^ Heading 3          ^
| Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        |
| Row 2 Col 1    | :::                        | Row 2 Col 3        |
| Row 3 Col 1    | :::                        | Row 2 Col 3        |

You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text.

Table with alignment
right	center	left
left	right	center
xxxxxxxxxxxx	xxxxxxxxxxxx	xxxxxxxxxxxx

This is how it looks in the source:

^           Table with alignment           ^^^
|         right|    center    |left          |
|left          |         right|    center    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Note: Vertical alignment is not supported.

No Formatting

If you need to display text exactly like it is typed (without any formatting), enclose the area either with <nowiki> tags or even simpler, with double percent signs %%.

This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
The same is true for //__this__ text// with a smiley ;-).

<nowiki>
This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
</nowiki>
The same is true for %%//__this__ text// with a smiley ;-)%%.

Code Blocks

You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags <code> or <file>.

This is text is indented by two spaces.

This is preformatted code all spaces are preserved: like              <-this

This is pretty much the same, but you could use it to show that you quoted a file.

Those blocks were created by this source:

  This is text is indented by two spaces.

<code>
This is preformatted code all spaces are preserved: like              <-this
</code>

<file>
This is pretty much the same, but you could use it to show that you quoted a file.
</file>

Syntax Highlighting

DokuWiki can highlight sourcecode, which makes it easier to read. It uses the GeSHi Generic Syntax Highlighter – so any language supported by GeSHi is supported. The syntax uses the same code and file blocks described in the previous section, but this time the name of the language syntax to be highlighted is included inside the tag, e.g. <code java> or <file java>.

/**
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

The following language strings are currently recognized: 4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic

There are additional advanced options available for syntax highlighting, such as highlighting lines or adding line numbers.

Downloadable Code Blocks

When you use the <code> or <file> syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this:

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

myexample.php

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

If you don't want any highlighting but want a downloadable file, specify a dash (-) as the language code: <code - myfile.foo>.

RSS/ATOM Feed Aggregation

DokuWiki can integrate data from external XML feeds. For parsing the XML feeds, SimplePie is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:

Parameter	Description
any number	will be used as maximum number items to show, defaults to 8
reverse	display the last items in the feed first
author	show item authors names
date	show item dates
description	show the item description. All HTML tags will be stripped
nosort	do not sort the items in the feed
n[dhm]	refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours).

The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. DokuWiki will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells DokuWiki to re-render the page if it is more than refresh period since the page was last rendered.

By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the reverse parameter, or display the feed as is with nosort.

Example:

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

James Webb Space Telescope Discovers How Black Holes Feed Themselves — EditorDavid (2026/07/19 22:05)
Robot 'Decapitated' in World's First-Ever Humanoid UFC Fight — EditorDavid (2026/07/19 20:49)
Windows 10 Still Being Used, Often Unpatched and Insecure — EditorDavid (2026/07/19 19:34)
Aptera Announces US-Wide Repair Network for Its Upcoming Solar Electric Car — EditorDavid (2026/07/19 18:34)
Former Richard Stallman Colleague Now Argues for Open AI Models Too — EditorDavid (2026/07/19 17:34)

Control Macros

Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:

Macro	Description
~~NOTOC~~	If this macro is found on the page, no table of contents will be created
~~NOCACHE~~	DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the <php> syntax above is used), adding this macro will force DokuWiki to rerender a page on every call

Syntax Plugins

DokuWiki's syntax can be extended by Plugins. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:

Add New Page plugin 2026-04-24 — Damien Regad, Benjamin Santalucia, Sam Wilson and other contributors
Adds a "new page form" to any wiki page.
Bootstrap Wrapper Plugin 2022-09-22 — Giuseppe Di Terlizzi
Bootstrap Wrapper for DokuWiki
Changes Plugin 2023-12-14 — Andreas Gohr
List the most recent changes of the wiki
Cloud Plugin 2023-02-11 — Michael Hamann, Michael Klier, Gina Haeussge
Displays the most used words in a word cloud.
Dw2Pdf plugin 2026-01-08 — Andreas Gohr and Luigi Micco
DokuWiki to PDF converter
Icons Plugin 2024-10-30 — Giuseppe Di Terlizzi
Embed icons in Dokuwiki
ifauthex plugin 2023-02-08 — Pietro Saccardi
Toggle DokuWiki page content based on users and groups with arbitrary boolean expressions.
Indexmenu Plugin 2024-01-05 — Samuele Tognini, Gerrit Uitslag
Show a customizable and sortable index for a namespace
Info Plugin 2020-06-04 — Andreas Gohr
Displays information about various DokuWiki internals
keyboard 2023-02-23 — Gina Häußge
The keyboard plugin provides a combined syntax and action plugin in order to markup text as keyboard keys, similar to (and making use of) the existing (X)HTML tag <kbd>…</kbd>. A quick button for the markup is automatically inserted into the toolbar of the edit form.
Note Plugin 2024-04-15 — Anael Mobilia
Add Note/Important/Tip/Warning Capability (DIV+CSS box)
Pagelist Plugin 2023-08-27 — Matthias Schulte, Michael Hamann, Michael Klier, Gina Haeussge
Lists pages in a nice formatted way
Semantic Plugin 2024-10-05 — Giuseppe Di Terlizzi
Add Semantic Data in DokuWiki
svgEmbed plugin 2025-07-07 — Emma Bowers
Allows the use of the standard media syntax, but SVG files are placed with the <object> or <embed> tag, not the <img> tag.
Tag Plugin 2023-10-17 — Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
tag wiki pages
top plugin 2020-11-24 — Andreas Gohr
show the top ten most visited pages
Wrap Plugin 2023-08-13 — Anika Henke
Universal plugin which combines functionalities of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction.

⁶⁾

This is a footnote

⁷⁾

when the aspect ratio of the given width and height doesn't match that of the image, it will be cropped to the new ratio before resizing

Тестовая страничка Dokuwiki

anonymous@undisclosed.example.com (Anonymous) — Mon, 07 Aug 2023 13:37:42 +0000

Тестовая страничка Dokuwiki

Для тестовых целей

Тестовый раздел

anonymous@undisclosed.example.com (Anonymous) — Tue, 18 Feb 2025 18:29:57 +0000

Тестовый раздел

Внутри тестовая страница

TOP-10: Самые просматриваемые страницы

anonymous@undisclosed.example.com (Anonymous) — Fri, 26 Apr 2024 07:58:32 +0000

TOP-10: Самые просматриваемые страницы

Самые просматриваемые страницы (за весь период)

Самые просматриваемые страницы (за последний месяц)

Welcome to your new DokuWiki

anonymous@undisclosed.example.com (Anonymous) — Sun, 19 Jan 2025 12:18:17 +0000

Welcome to your new DokuWiki

Congratulations, your wiki is now up and running. Here are a few more tips to get you started.

Enjoy your work with DokuWiki,

– the developers

Create your first pages

Your wiki needs to have a start page. As long as it doesn't exist, this link will be red: start.

Go on, follow that link and create the page. If you need help with using the syntax you can always refer to the syntax page.

You might also want to use a sidebar. To create it, just edit the sidebar page. Everything in that page will be shown in a margin column on the side. Read our FAQ on sidebars to learn more.

Please be aware that not all templates support sidebars.

Customize your Wiki

Once you're comfortable with creating and editing pages you might want to have a look at the configuration settings (be sure to login as superuser first).

You may also want to see what plugins and templates are available at DokuWiki.org to extend the functionality and looks of your DokuWiki installation.

Join the Community

DokuWiki is an Open Source project that thrives through user contributions. A good way to stay informed on what's going on and to get useful tips in using DokuWiki is subscribing to the newsletter.

The DokuWiki User Forum is an excellent way to get in contact with other DokuWiki users and is just one of the many ways to get support.

Of course we'd be more than happy to have you getting involved with DokuWiki.