Это старая версия документа!
Содержание
Синтаксис форматирования
DokuWiki поддерживает простой язык разметки, который старается сделать файлы данных максимально читаемыми. Эта страница содержит все возможные синтаксические конструкции, которые вы можете использовать при редактировании страниц. Просто посмотрите на исходный код этой страницы, нажав «Редактировать страницу». Если вы хотите что-то попробовать, используйте страницу песочница. Простые элементы форматирования также доступны через быстрые кнопки.
Базовое форматирование текста
DokuWiki поддерживает полужирный, курсив, подчёркнутый и моноширинный текст. Конечно, вы можете комбинировать все эти стили.
DokuWiki поддерживает полужирный, курсив, подчёркнутый и моноширинный текст.
Конечно, вы можете комбинировать все эти стили.
Вы также можете использовать нижний индекс и верхний индекс.
Вы также можете использовать нижний индекс и верхний индекс.
Вы можете пометить текст как удалённый.
Вы можете пометить текст как удалённый.
Абзацы создаются с помощью пустых строк. Если вы хотите принудительно перенести строку без создания абзаца, используйте две обратные косые черты, за которыми следует пробел или конец строки.
Это текст с несколькими переносами\ Обратите внимание, что две обратные косые черты распознаются только в конце строки\ или если за ними следует\ пробел \это происходит и без него.
Это текст с несколькими переносами\ Обратите внимание, что две обратные косые черты распознаются только в конце строки\ или если за ними следует\ пробел \это происходит и без него.
Используйте принудительные переносы только в случае крайней необходимости.
Ссылки
DokuWiki поддерживает несколько способов создания ссылок.
Внешние
Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com – Вы также можете задать текст ссылки: Эта ссылка ведёт на Google. Адреса электронной почты, например, andi@splitbrain.org, также распознаются.
DokuWiki поддерживает несколько способов создания ссылок. Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com – Вы также можете задать текст ссылки: Эта ссылка ведёт на Google. Адреса электронной почты, например, andi@splitbrain.org, также распознаются.
Внутренние
Внутренние ссылки создаются с помощью квадратных скобок. Вы можете просто указать имя_страницы или использовать дополнительный текст ссылки.
Внутренние ссылки создаются с помощью квадратных скобок. Вы можете просто указать имя_страницы или использовать дополнительный текст ссылки.
Имена страниц вики автоматически приводятся к нижнему регистру, специальные символы не допускаются.
Вы можете использовать имён с помощью двоеточия в имени страницы.
Вы можете использовать имён с помощью двоеточия в имени страницы.
Подробнее о пространствах имён см. namespaces.
Также возможна ссылка на конкретный раздел. Просто добавьте имя раздела после символа решётки, как в HTML. Эта ссылка ведёт на этот раздел.
Эта ссылка ведёт на этот раздел.
Примечания:
Ссылки на существующие страницы отображаются иначе, чем на несуществующие.
По умолчанию DokuWiki не использует CamelCase для автоматического создания ссылок, но это поведение можно включить в файле конфигурации. Подсказка: если DokuWiki является ссылкой, значит, эта функция включена.
При изменении заголовка раздела меняется и его якорь, поэтому не стоит слишком полагаться на ссылки на разделы.
Интервики
DokuWiki поддерживает ссылки Interwiki. Это быстрые ссылки на другие вики. Например, это ссылка на страницу Википедии о вики: Wiki.
DokuWiki поддерживает ссылки Interwiki. Это быстрые ссылки на другие вики. Например, это ссылка на страницу Википедии о вики: Wiki.
Сетевые папки Windows
Сетевые папки Windows, например эта, также распознаются. Обратите внимание, что они имеют смысл только в однородной группе пользователей, например, в корпоративном интранете.
Сетевые папки Windows, например эта, также распознаются.
Примечания:
По соображениям безопасности прямой просмотр сетевых папок Windows по умолчанию работает только в Microsoft Internet Explorer (и только в «локальной зоне»).
Для Mozilla и Firefox это можно включить с помощью различных обходных путей, описанных в базе знаний Mozilla. Однако всё равно будет появляться предупреждение JavaScript о попытке открыть сетевую папку. Чтобы убрать это предупреждение (для всех пользователей), добавьте следующую строку в файл conf/lang/en/lang.php (подробнее в локализации):
- conf/lang/en/lang.php
<?php /** * Настройка английского языкового файла * Копируйте только те строки, которые нужно изменить */ $lang['js']['nosmblinks'] = '';
==== Ссылки-картинки ==== Вы также можете использовать изображение для ссылки на другую внутреннюю или внешнюю страницу, комбинируя синтаксис ссылок и изображений (см. ниже) следующим образом:
Обратите внимание: форматирование изображения — это единственный синтаксис форматирования, допустимый в тексте ссылки. Поддерживается полный синтаксис изображений и ссылок (включая изменение размера, внутренние и внешние изображения, URL и интервики-ссылки). ===== Сноски ===== Вы можете добавлять сноски 1) с помощью двойных круглых скобок. Вы можете добавлять сноски 2) с помощью двойных круглых скобок. ===== Разделы ===== Вы можете использовать до пяти уровней заголовков для структурирования содержимого. Если заголовков больше трёх, автоматически генерируется оглавление — его можно отключить, добавив строку ~~NOTOC~~ в документ. ==== Заголовок уровня 3 ==== === Заголовок уровня 4 === == Заголовок уровня 5 == ==== Заголовок уровня 3 ==== === Заголовок уровня 4 === == Заголовок уровня 5 == С помощью четырёх или более дефисов можно создать горизонтальную линию: —- ===== Медиафайлы ===== Вы можете вставлять внешние и внутренние изображения, видео и аудиофайлы с помощью фигурных скобок. При необходимости вы можете указать их размер. Реальный размер:
Изменить до заданной ширины:
Изменить до заданной ширины и высоты3):
Изменённое внешнее изображение:
Реальный размер:
Изменить до заданной ширины:
Изменить до заданной ширины и высоты:
Изменённое внешнее изображение:
Используя пробелы слева или справа, вы можете выбрать выравнивание.
Конечно, вы также можете добавить подпись (она отображается как всплывающая подсказка в большинстве браузеров).
Для создания ссылки из изображения на другую страницу см. Ссылки-картинки выше. ==== Поддерживаемые форматы мультимедиа ==== DokuWiki может встраивать следующие форматы напрямую. | Изображения | gif, jpg, png | | Видео | webm, ogv, mp4 | | Аудио | ogg, mp3, wav | | Flash | swf | Если вы укажете имя файла, не являющееся поддерживаемым мультимедийным форматом, он будет отображаться как ссылка. Добавив ?linkonly, вы получите ссылку на медиафайл без его встраивания. dokuwiki-128.png dokuwiki-128.png Это просто ссылка на изображение. ==== Запасные форматы ==== К сожалению, не все браузеры поддерживают все видео- и аудиоформаты. Чтобы смягчить эту проблему, вы можете загружать файлы в разных форматах для максимальной совместимости с браузерами. Например, рассмотрим встроенное видео mp4:
Если вы загрузите video.webm и video.ogv рядом с указанным video.mp4, DokuWiki автоматически добавит их как альтернативы, чтобы один из трёх файлов был понятен вашему браузеру. Кроме того, DokuWiki поддерживает изображение-«постер», которое будет показываться до начала воспроизведения видео. Это изображение должно иметь то же имя, что и видео, и быть в формате jpg или png. В приведённом выше примере подошёл бы файл video.jpg. ===== Списки ===== DokuWiki поддерживает маркированные и нумерованные списки. Чтобы создать элемент списка, сделайте отступ в два пробела и используйте * для маркированного списка или - для нумерованного. * Это список * Второй элемент * Вы можете использовать разные уровни * Ещё один элемент - Такой же список, но нумерованный - Другой элемент - Просто используйте отступ для более глубоких уровней - Вот и всё
* Это список * Второй элемент * Вы можете использовать разные уровни * Ещё один элемент - Такой же список, но нумерованный - Другой элемент - Просто используйте отступ для более глубоких уровней - Вот и всё
Также обратите внимание на FAQ по элементам списков. ===== Преобразования текста ===== DokuWiki может преобразовывать определённые заранее заданные символы или строки в изображения, другой текст или HTML. Преобразование текста в изображения в основном используется для смайликов. А преобразование текста в HTML используется для типографских замен, но может быть настроено и для использования другого HTML. ==== Преобразование текста в изображения ==== DokuWiki преобразует часто используемые эмотиконы в их графические эквиваленты. Эти смайлики и другие изображения можно настраивать и расширять. Вот обзор смайликов, включённых в DokuWiki: * 8-) *
8-O *
:-( *
:-) *
=) *
:-/ *
:-\ *
:-? *
:-D *
:-P *
:-O *
:-X *
:-| *
;-) *
^_^ *
m( *
:?: *
:!: *
LOL *
FIXME *
DELETEME ==== Преобразование текста в HTML ==== Типографика: DokuWiki может преобразовывать простые текстовые символы в их типографски правильные сущности. Вот пример распознаваемых символов. → ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® «He thought 'It's a man's world'…»
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..."
То же самое можно сделать для создания любого HTML-кода, нужно лишь добавить его в файл шаблонов. Есть три исключения, которые не берутся из этого файла: сущность умножения (640×480), «одинарные» и «двойные» кавычки. Их можно отключить через параметр конфигурации. ===== Цитирование ===== Иногда вы хотите выделить текст, чтобы показать, что это ответ или комментарий. Вы можете использовать следующий синтаксис:
Я думаю, нам стоит это сделать > Нет, не стоит >> Ну, я говорю, что стоит > Правда? >> Да! >>> Тогда давайте сделаем!
Я думаю, нам стоит это сделать > Нет, не стоит » Ну, я говорю, что стоит > Правда? » Да! »> Тогда давайте сделаем! ===== Таблицы ===== DokuWiki поддерживает простой синтаксис для создания таблиц. ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | Строка 1 Столбец 1 | Строка 1 Столбец 2 | Строка 1 Столбец 3 | | Строка 2 Столбец 1 | объединение столбцов (обратите внимание на двойную черту) || | Строка 3 Столбец 1 | Строка 3 Столбец 2 | Строка 3 Столбец 3 | Строки таблицы должны начинаться и заканчиваться символом | для обычных строк или ^ для заголовков. ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | Строка 1 Столбец 1 | Строка 1 Столбец 2 | Строка 1 Столбец 3 | | Строка 2 Столбец 1 | объединение столбцов (обратите внимание на двойную черту) || | Строка 3 Столбец 1 | Строка 3 Столбец 2 | Строка 3 Столбец 3 | Чтобы объединить ячейки по горизонтали, просто сделайте следующую ячейку полностью пустой, как показано выше. Убедитесь, что количество разделителей ячеек всегда одинаково! Вертикальные заголовки таблиц тоже возможны. | ^ Заголовок 1 ^ Заголовок 2 ^ ^ Заголовок 3 | Строка 1 Столбец 2 | Строка 1 Столбец 3 | ^ Заголовок 4 | на этот раз без объединения | | ^ Заголовок 5 | Строка 2 Столбец 2 | Строка 2 Столбец 3 | Как вы видите, именно разделитель ячеек перед ячейкой определяет форматирование: | ^ Заголовок 1 ^ Заголовок 2 ^ ^ Заголовок 3 | Строка 1 Столбец 2 | Строка 1 Столбец 3 | ^ Заголовок 4 | на этот раз без объединения | | ^ Заголовок 5 | Строка 2 Столбец 2 | Строка 2 Столбец 3 | Вы можете объединять ячейки по вертикали, добавляя ::: в ячейки ниже той, с которой они должны быть соединены. ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | Строка 1 Столбец 1 | эта ячейка объединена вертикально | Строка 1 Столбец 3 | | Строка 2 Столбец 1 | ::: | Строка 2 Столбец 3 | | Строка 3 Столбец 1 | ::: | Строка 2 Столбец 3 | Помимо синтаксиса объединения по вертикали, эти ячейки не должны содержать ничего другого. ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | Строка 1 Столбец 1 | эта ячейка объединена вертикально | Строка 1 Столбец 3 | | Строка 2 Столбец 1 | ::: | Строка 2 Столбец 3 | | Строка 3 Столбец 1 | ::: | Строка 2 Столбец 3 | Вы также можете выравнивать содержимое таблицы. Просто добавьте как минимум два пробела с противоположного конца текста: добавьте два пробела слева для выравнивания вправо, два пробела справа для выравнивания влево и по два пробела с обоих концов для выравнивания по центру. ^ Таблица с выравниванием ^^^ | вправо| по центру |влево | |влево | вправо| по центру | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Вот как это выглядит в исходном коде: ^ Таблица с выравниванием ^^^ | вправо| по центру |влево | |влево | вправо| по центру | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Примечание: вертикальное выравнивание не поддерживается. ===== Отключение форматирования ===== Если вам нужно отобразить текст точно так, как он набран (без какого-либо форматирования), заключите область в теги <nowiki> или, что ещё проще, в двойные знаки процента %%. Это текст, который содержит адреса, например: http://www.splitbrain.org и **форматирование**, но с ним ничего не делается. То же самое верно для //__этого__ текста// со смайликом ;-). Это текст, который содержит адреса, например: http://www.splitbrain.org и **форматирование**, но с ним ничего не делается. То же самое верно для //__этого__ текста// со смайликом ;-). ===== Блоки кода ===== Вы можете включать блоки кода в свои документы, либо сделав отступ не менее двух пробелов (как в предыдущих примерах), либо используя теги <code> или <file>. Это текст с отступом в два пробела.
Это предварительно отформатированный код, все пробелы сохраняются: например, <-вот так
Это почти то же самое, но вы можете использовать это, чтобы показать, что вы цитируете файл.
Эти блоки были созданы с помощью такого исходного кода: Это текст с отступом в два пробела.
Это предварительно отформатированный код, все пробелы сохраняются: например, <-вот так
Это почти то же самое, но вы можете использовать это, чтобы показать, что вы цитируете файл.
==== Подсветка синтаксиса ==== DokuWiki может подсвечивать исходный код, что облегчает его чтение. Для этого используется GeSHi — универсальный подсветчик синтаксиса, поэтому поддерживается любой язык, который поддерживает GeSHi. Синтаксис использует те же блоки code и file, описанные в предыдущем разделе, но на этот раз имя языка подсветки указывается внутри тега, например <code java> или <file java>.
/** * Класс HelloWorldApp реализует приложение, * которое просто выводит "Hello World!" в стандартный вывод. */ class HelloWorldApp { public static void main(String[] args) { System.out.println("Hello World!"); // Вывод строки. } }
В настоящее время распознаются следующие строки языков: 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 Для подсветки синтаксиса доступны дополнительные расширенные возможности, такие как подсветка строк или добавление номеров строк. ==== Блоки кода для скачивания ==== Когда вы используете синтаксис <code> или <file>, как описано выше, возможно, вы захотите предоставить показанный код для скачивания. Это можно сделать, указав имя файла после кода языка, например:
<file php myexample.php> <?php echo "hello world!"; ?></file>
- myexample.php
<?php echo "hello world!"; ?>
Если вы не хотите подсветки, но хотите сделать файл доступным для скачивания, укажите дефис (-) в качестве кода языка: <code - myfile.foo>.
Агрегация RSS/ATOM лент
DokuWiki может интегрировать данные из внешних XML-лент. Для разбора XML-лент используется SimplePie. Все форматы, понимаемые SimplePie, могут использоваться и в DokuWiki. Вы можете влиять на отображение с помощью нескольких дополнительных параметров, разделённых пробелами:
| Параметр | Описание |
|---|---|
| любое число | будет использоваться как максимальное количество элементов для отображения, по умолчанию 8 |
| reverse | отображать последние элементы ленты первыми |
| author | показывать имена авторов элементов |
| date | показывать даты элементов |
| description | показывать описание элемента. Все HTML-теги будут удалены |
| nosort | не сортировать элементы в ленте |
| n[dhm] | период обновления, где d=дни, h=часы, m=минуты (например, 12h = 12 часов). |
Период обновления по умолчанию — 4 часа. Любое значение менее 10 минут будет рассматриваться как 10 минут. DokuWiki обычно пытается выдавать кэшированную версию страницы, но это неуместно, когда страница содержит динамический внешний контент. Параметр указывает DokuWiki перерендеривать страницу, если с момента последнего рендеринга прошло больше периода обновления.
По умолчанию лента сортируется по дате, сначала новые. Вы можете отсортировать сначала старые с помощью параметра reverse или отобразить ленту как есть с помощью nosort.
Пример:
- Microsoft Promises To Fix Search With Major Windows 11 Overhaul — BeauHD (2026/07/13 23:00)
- US Government Warns That Russia State Hackers Are Coming After Your Router — BeauHD (2026/07/13 22:00)
- German Firm Files For Insolvency After Cybercriminals Shut Down Production For 6 Weeks — BeauHD (2026/07/13 21:12)
- States Sue to Block Paramount-Warner Bros Merger, Defying DOJ — BeauHD (2026/07/13 20:00)
- Apple Reportedly Agreed to Intel Chips To Avoid White House Tariffs — BeauHD (2026/07/13 19:00)
- Microsoft Promises To Fix Search With Major Windows 11 Overhaul — BeauHD (2026/07/13 23:00)
- US Government Warns That Russia State Hackers Are Coming After Your Router — BeauHD (2026/07/13 22:00)
- German Firm Files For Insolvency After Cybercriminals Shut Down Production For 6 Weeks — BeauHD (2026/07/13 21:12)
- States Sue to Block Paramount-Warner Bros Merger, Defying DOJ — BeauHD (2026/07/13 20:00)
- Apple Reportedly Agreed to Intel Chips To Avoid White House Tariffs — BeauHD (2026/07/13 19:00)
Управляющие макросы
Некоторые синтаксические конструкции влияют на то, как DokuWiki отображает страницу, без создания какого-либо вывода. Доступны следующие управляющие макросы:
| Макрос | Описание |
|---|---|
| ~~NOTOC~~ | Если этот макрос найден на странице, оглавление не будет создано |
| ~~NOCACHE~~ | DokuWiki кэширует весь вывод по умолчанию. Иногда это может быть нежелательно (например, при использовании синтаксиса <php> выше). Добавление этого макроса заставит DokuWiki перерендеривать страницу при каждом вызове |
Плагины синтаксиса
Синтаксис DokuWiki может быть расширен с помощью плагинов. Как использовать установленные плагины, описано на их соответствующих страницах. В данной установке DokuWiki доступны следующие плагины синтаксиса:
- Wrap Plugin 2026-06-02 — 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.
