Различия

Показаны различия между двумя версиями страницы.

--- wiki:syntax [2026/07/13 22:01] – root
+++ wiki:syntax [2026/07/13 22:03] (текущий) – старая версия восстановлена (2026/07/13 21:57) root
@@ Строка 1: / Строка 1: @@
 ====== Синтаксис форматирования ======
-[[doku>DokuWiki]] поддерживает простой язык разметки, который делает файлы с данными максимально удобочитаемыми. На этой странице приведены все возможные синтаксические конструкции, которые можно использовать при редактировании страниц. Чтобы увидеть исходный код этой страницы, нажмите «Редактировать страницу». Если хотите поэкспериментировать, используйте страницу [[playground:playground|песочницы]]. Простейшая разметка легко доступна через [[doku>toolbar|панель инструментов]].
+«Докувики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «[[playground:playground|песочницу]]». Простую разметку также можно легко сделать с помощью [[ru:toolbar|панели инструментов]].
-===== Основное форматирование текста =====
+===== Основные конструкции форматирования =====
-DokuWiki поддерживает жирный, //курсив//, подчёркнутый и ''моноширинный'' текст. Разумеется, можно //''комбинировать''// всё это.
+«Докувики» поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**.
-DokuWiki поддерживает жирный, //курсив//, подчёркнутый и ''моноширинный'' текст.
+<code>
-Разумеется, можно //''комбинировать''// всё это.
+«Докувики» поддерживает выделение текста **жирным шрифтом**, //курсивом//,
+__подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''.
+Все эти конструкции можно **__//''объединить''//__**.
+</code>
-Можно использовать <sub>нижний индекс</sub> и <sup>верхний индекс</sup>.
+Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.
-Можно использовать <sub>нижний индекс</sub> и <sup>верхний индекс</sup>.
+<code>
+Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.
+</code>
-Также можно помечать что-либо как <del>удалённое</del>.
+Ещё можно <del>зачеркнуть текст</del>.
-Также можно помечать что-либо как <del>удалённое</del>.
+<code>
+Ещё можно <del>зачеркнуть текст</del>.
+</code>
-Абзацы создаются с помощью пустых строк. Если нужно принудительно перенести строку без создания абзаца, используйте две обратные косые черты с последующим пробелом или концом строки.
+**Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке.
-Вот пример текста с переносами строк\ Обратите внимание, что
+Просто текст с разрывом строк\\ Обратите внимание,
-две обратные косые черты распознаются только в конце строки\
+что два обратных слэша действуют только в конце строки\\
-или после них идёт пробел\ а без пробела это не сработает.
+или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.
-Вот пример текста с переносами строк\ Обратите внимание, что
+<code>Просто текст с разрывом строк\\ Обратите внимание,
-две обратные косые черты распознаются только в конце строки\
+что два обратных слэша действуют только в конце строки\\
-или после них идёт пробел\ а без пробела это не сработает.
+или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.
+</code>
-Принудительные переносы строк стоит использовать только при реальной необходимости.
+Принудительные переносы следует использовать только в случае крайней необходимости.
 ===== Ссылки =====
-DokuWiki поддерживает несколько способов создания ссылок.
+Ссылки в «Докувики» бывают разные и создавать их можно тоже по-разному.
 ==== Внешние ====
-Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com — Можно также задать текст ссылки: [[http://www.google.com|Эта ссылка указывает на Google]]. Адреса электронной почты, например andi@splitbrain.org, тоже распознаются.
+Внешние ссылки распознаются автоматически: http://www.google.com или
+просто www.google.com --- также можно указывать текст ссылки:
+[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
+тоже распознаются: <andi@splitbrain.org>.
-DokuWiki поддерживает несколько способов создания ссылок. Внешние ссылки распознаются
+<code>Внешние ссылки распознаются автоматически: http://www.google.com или
-автоматически: http://www.google.com или просто www.google.com — Можно также задать
+просто www.google.com --- также можно указывать текст ссылки:
-текст ссылки: [[http://www.google.com|Эта ссылка указывает на Google]]. Адреса
+[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
-электронной почты, например andi@splitbrain.org, тоже распознаются.
+тоже распознаются: <andi@splitbrain.org>.</code>
 ==== Внутренние ====
-Внутренние ссылки создаются с помощью квадратных скобок. Можно указать просто [[pagename|имя страницы]] или использовать дополнительный [[pagename|текст ссылки]].
+Внутренние ссылки создаются посредством квадратных скобок.
+Можно либо просто указать [[ru:pagename|имя страницы]], либо
+дополнительно прописать [[ru:pagename|текст ссылки]]. Имена
+вики-статей автоматически  переводятся в нижний регистр,
+спецсимволы использовать нельзя.
-Внутренние ссылки создаются с помощью квадратных скобок. Можно указать просто
+<code>Внутренние ссылки создаются посредством квадратных скобок.
-[[pagename|имя страницы]] или использовать дополнительный [[pagename|текст ссылки]].
+Можно либо просто указать [[ru:pagename]], либо
+дополнительно прописать [[ru:pagename|текст ссылки]]. Имена
+вики-статей автоматически  переводятся в нижний регистр,
+спецсимволы использовать нельзя.</code>
-[[doku>pagename|Имена вики-страниц]] автоматически приводятся к нижнему регистру, специальные символы не допускаются.
+Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.
-Можно использовать [[some:namespaces|пространства имён]], указав двоеточие в имени страницы.
+<code>Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.</code>
-Можно использовать [[some:namespaces|пространства имён]], указав двоеточие в имени страницы.
+Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на [[#внутренние|этот раздел]].
-Подробнее о пространствах имён смотрите [[doku>namespaces]].
+<code>Ссылка на [[#внутренние|этот раздел]].</code>
-Также можно создать ссылку на конкретный раздел. Просто добавьте название раздела после символа решётки, как в HTML. Вот ссылка на [[syntax#internal|этот раздел]].
+Примечания:
-Вот ссылка на [[syntax#internal|этот раздел]].
+  * Ссылки на [[ru:wiki:syntax|существующие статьи]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]].
+  * «Докувики» по умолчанию не использует [[wp>ru:CamelCase|CamelCase]] (ВерблюжийРегистр) для автоматического создания ссылок, но эту возможность можно включить в файле [[doku>config]]. Проверка: если DokuWiki --- ссылка, значит эта возможность включена.
+  * Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.
+  * Ссылки на разделы делаются именно на [[#Разбивка на разделы|разделы]].
+==== Интервики ====
+«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки
+на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
+<code>«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки
+на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
+</code>
+==== Сетевые ресурсы Windows ====
+Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, что такие ссылки имеют смысл только в гомогенных группах пользователей, например в корпоративном интранете.
+<code>Ссылки на сетевые ресурсы вида \\server\share тоже распознаются.</code>
 Примечания:
-Ссылки на [[syntax|существующие страницы]] отображаются иначе, чем на [[nonexisting|несуществующие]].
+  * Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»).
+  * В браузерах Mozilla эту возможность можно включить с помощью опции [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], но делать это не рекомендуется.
+  * Подробней читайте здесь: [[bug>151]].
-DokuWiki по умолчанию не использует [[wp>CamelCase]] для автоматического создания ссылок, но это поведение можно включить в файле [[doku>config]]. Подсказка: если DokuWiki является ссылкой — значит, функция включена.
+==== Картинки-ссылки ====
-При изменении заголовка раздела меняется и его закладка. Поэтому не стоит слишком полагаться на ссылки на разделы.
+Совместив синтаксис ссылки и [[#картинки и другие файлы|картинки]], можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:
-==== Интервики ====
+<code>[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]</code>
-DokuWiki поддерживает [[doku>Interwiki]]-ссылки. Это быстрые ссылки на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
+[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]
-DokuWiki поддерживает [[doku>Interwiki]]-ссылки. Это быстрые ссылки на другие вики.
+Учтите: форматирование картинок --- это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.
-Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
-==== Сетевые папки Windows ====
+==== Сноски ====
-Сетевые адреса Windows, например [[\server\share|вот такой]], тоже распознаются. Обратите внимание, что они имеют смысл только в однородной пользовательской среде, например в корпоративной [[wp>Интранет]].
+С помощью двойных скобок можно добавить сноску((Сноска — помещаемые внизу страницы примечание, ссылка, перевод.)).
-Сетевые адреса Windows, например [[\server\share|вот такой]], тоже распознаются.
+<code>С помощью двойных скобок можно добавить сноску((Сноска —
+помещаемые внизу страницы примечание, ссылка, перевод.)).</code>
-Примечания:
+===== Разбивка на разделы =====
-Из соображений безопасности прямой просмотр сетевых папок Windows по умолчанию работает только в Microsoft Internet Explorer (и только в «локальной зоне»).
+Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку %%~~NOTOC~~%%.
-В Mozilla и Firefox это можно включить с помощью обходных путей, описанных в [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|базе знаний Mozilla]]. Однако всё равно будет появляться предупреждение JavaScript о попытке открыть сетевую папку Windows. Чтобы убрать это предупреждение (для всех пользователей), добавьте следующую строку в файл ''conf/lang/en/lang.php'' (подробнее о [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|локализации]]): <code - conf/lang/en/lang.php>
-<?php /** * Customization of the english language file * Copy only the strings that needs to be modified */ $lang['js']['nosmblinks'] = ''; </code> ==== Ссылки-изображения ==== Можно также использовать изображение для ссылки на другую внутреннюю или внешнюю страницу, комбинируя синтаксис ссылок и [[#images_and_other_files|изображений]] (см. ниже) следующим образом: [[http://php.net|{{wiki:dokuwiki-128.png}}]] [[http://php.net|{{wiki:dokuwiki-128.png}}]] Обратите внимание: в именах ссылок допускается только синтаксис форматирования изображений. Поддерживается весь синтаксис [[#images_and_other_files|изображений]] и [[#links|ссылок]] (включая изменение размера, внутренние и внешние изображения, URL и интервики-ссылки). ===== Сноски ===== Можно добавлять сноски ((Это сноска)) с помощью двойных круглых скобок. Можно добавлять сноски ((Это сноска)) с помощью двойных круглых скобок. ===== Заголовки разделов ===== Можно использовать до пяти различных уровней заголовков для структурирования содержимого. Если заголовков больше трёх, автоматически создаётся оглавление — это можно отключить, добавив в документ строку ''<nowiki>~~NOTOC~~</nowiki>''. ==== Заголовок уровня 3 ==== === Заголовок уровня 4 === == Заголовок уровня 5 == ==== Заголовок уровня 3 ==== === Заголовок уровня 4 === == Заголовок уровня 5 == С помощью четырёх или более дефисов можно создать горизонтальную линию: ---- ===== Медиафайлы ===== Можно вставлять внешние и внутренние [[doku>images|изображения, видео и аудиофайлы]] с помощью фигурных скобок. При желании можно указать их размер. Исходный размер: {{wiki:dokuwiki-128.png}} Уменьшить до заданной ширины: {{wiki:dokuwiki-128.png?50}} Уменьшить до заданных ширины и высоты((Если соотношение сторон заданных ширины и высоты не совпадает с соотношением сторон изображения, оно будет обрезано до нового соотношения перед масштабированием)): {{wiki:dokuwiki-128.png?200x50}} Внешнее изображение с изменённым размером: {{https://www.php.net/images/php.gif?200x50}} Исходный размер: {{wiki:dokuwiki-128.png}} Уменьшить до заданной ширины: {{wiki:dokuwiki-128.png?50}} Уменьшить до заданных ширины и высоты: {{wiki:dokuwiki-128.png?200x50}} Внешнее изображение с изменённым размером: {{https://www.php.net/images/php.gif?200x50}} С помощью пробелов слева или справа можно выбрать выравнивание. {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} Разумеется, можно добавить и заголовок (большинство браузеров отображают его в виде всплывающей подсказки). {{ wiki:dokuwiki-128.png |Это подпись}} {{ wiki:dokuwiki-128.png |Это подпись}} О том, как сделать изображение ссылкой, смотрите выше в разделе [[#Image Links|Ссылки-изображения]]. ==== Поддерживаемые медиаформаты ==== DokuWiki может непосредственно встраивать следующие медиаформаты. | Изображение | ''gif'', ''jpg'', ''png'' | | Видео | ''webm'', ''ogv'', ''mp4'' | | Аудио | ''ogg'', ''mp3'', ''wav'' | | Flash | ''swf'' | Если указано имя файла, формат которого не поддерживается, оно будет отображено как ссылка. Добавив ''?linkonly'', можно создать ссылку на медиафайл без его встраивания. {{wiki:dokuwiki-128.png?linkonly}} {{wiki:dokuwiki-128.png?linkonly}} Это просто ссылка на изображение. ==== Резервные форматы ==== К сожалению, не все браузеры понимают все видео- и аудиоформаты. Чтобы смягчить проблему, можно загрузить файл в разных форматах для максимальной совместимости с браузерами. Например, рассмотрим встроенное видео mp4: {{video.mp4|Забавное видео}} Если рядом с указанным файлом ''video.mp4'' вы загрузите ''video.webm'' и ''video.ogv'', DokuWiki автоматически добавит их как альтернативные, так что браузер сможет воспроизвести один из трёх файлов. Кроме того, DokuWiki поддерживает изображение-«постер», которое будет показано до начала воспроизведения видео. Это изображение должно иметь то же имя файла, что и видео, и быть в формате jpg или png. В приведённом выше примере подойдёт файл ''video.jpg''. ===== Списки ===== DokuWiki поддерживает неупорядоченные и упорядоченные списки. Чтобы создать элемент списка, сделайте отступ в два пробела и используйте ''*'' для неупорядоченных или ''-'' для упорядоченных. * Это список * Второй элемент * Можно создавать разные уровни * Ещё один элемент - Тот же список, но упорядоченный - Другой элемент - Просто используйте отступы для глубоких уровней - Вот и всё <code> * Это список * Второй элемент * Можно создавать разные уровни * Ещё один элемент - Тот же список, но упорядоченный - Другой элемент - Просто используйте отступы для глубоких уровней - Вот и всё </code> Также ознакомьтесь с [[doku>faq:lists|FAQ по элементам списков]]. ===== Текстовые преобразования ===== DokuWiki может преобразовывать определённые предопределённые символы или строки в изображения, другой текст или HTML. Преобразование текста в изображения в основном используется для смайликов. Преобразование текста в HTML применяется для типографских замен, но может быть настроено и для другого HTML. ==== Преобразование текста в изображения ==== DokuWiki преобразует часто используемые [[wp>emoticon|эмотиконы]] в их графические аналоги. Эти [[doku>Smileys]] и другие изображения можно настраивать и расширять. Вот обзор смайликов, включённых в DokuWiki: * 8-) %% 8-) %% * 8-O %% 8-O %% * :-( %% :-( %% * :-) %% :-) %% * =) %% =) %% * :-/ %% :-/ %% * :-\ %% :-\ %% * :-? %% :-? %% * :-D %% :-D %% * :-P %% :-P %% * :-O %% :-O %% * :-X %% :-X %% * :-| %% :-| %% * ;-) %% ;-) %% * ^_^ %% ^_^ %% * m( %% m( %% * :?: %% :?: %% * :!: %% :!: %% * LOL %% LOL %% * FIXME %% FIXME %% * DELETEME %% DELETEME %% ==== Преобразование текста в HTML ==== Типографика: [[DokuWiki]] может преобразовывать простые текстовые символы в их типографски правильные эквиваленты. Вот пример распознаваемых символов. -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Он подумал: 'Это мужской мир'..." <code> -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Он подумал: 'Это мужской мир'..." </code> То же самое можно делать для генерации любого HTML, достаточно добавить его в [[doku>entities|файл шаблонов]]. Есть три исключения, которые не берутся из файла шаблонов: знак умножения (640x480), 'одинарные' и "двойные кавычки". Их можно отключить через [[doku>config:typography|параметр конфигурации]]. ===== Цитирование ===== Иногда нужно выделить текст, чтобы показать, что это ответ или комментарий. Можно использовать следующий синтаксис: <code> Я думаю, нам стоит это сделать > Нет, не стоит >> Ну, я считаю, стоит > Правда? >> Да! >>> Тогда давайте сделаем! </code> Я думаю, нам стоит это сделать > Нет, не стоит >> Ну, я считаю, стоит > Правда? >> Да! >>> Тогда давайте сделаем! ===== Таблицы ===== 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 | Можно создавать объединение ячеек по вертикали (rowspan), добавив ''%%:::%%'' в ячейки ниже той, с которой они должны быть объединены. ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | Строка 1 Кол 1 | эта ячейка объединяется по вертикали | Строка 1 Кол 3 | | Строка 2 Кол 1 | ::: | Строка 2 Кол 3 | | Строка 3 Кол 1 | ::: | Строка 3 Кол 3 | Кроме синтаксиса rowspan, такие ячейки не должны содержать ничего другого. ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | Строка 1 Кол 1 | эта ячейка объединяется по вертикали | Строка 1 Кол 3 | | Строка 2 Кол 1 | ::: | Строка 2 Кол 3 | | Строка 3 Кол 1 | ::: | Строка 3 Кол 3 | Также можно выравнивать содержимое таблицы. Просто добавьте не менее двух пробелов на противоположном конце текста: два пробела слева — выравнивание вправо, два пробела справа — влево, и не менее двух пробелов с обеих сторон — по центру. ^ Таблица с выравниванием ^^^ | вправо| по центру |влево | |влево | вправо| по центру | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Вот как это выглядит в исходном коде: ^ Таблица с выравниванием ^^^ | вправо| по центру |влево | |влево | вправо| по центру | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Примечание: вертикальное выравнивание не поддерживается. ===== Без форматирования ===== Если нужно отобразить текст в точности так, как он набран (без какого-либо форматирования), заключите его в теги ''%%<nowiki>%%'' или, ещё проще, в двойные знаки процента ''<nowiki>%%</nowiki>''. <nowiki> Вот текст, содержащий адреса типа http://www.splitbrain.org и **форматирование**, но ничего из этого не обрабатывается. </nowiki> То же самое справедливо для %%//__этого текста__// со смайликом ;-)%%. <nowiki> Вот текст, содержащий адреса типа http://www.splitbrain.org и **форматирование**, но ничего из этого не обрабатывается. </nowiki> То же самое справедливо для %%//__этого текста__// со смайликом ;-)%%. ===== Блоки кода ===== Вы можете включать блоки кода в документы, либо делая отступ не менее двух пробелов (как в предыдущих примерах), либо используя теги ''%%<code>%%'' или ''%%<file>%%''. Этот текст имеет отступ в два пробела. <code> Это предварительно отформатированный код, все пробелы сохраняются: как <-здесь </code> <file> Это почти то же самое, но можно использовать, чтобы показать, что вы цитируете файл. </file> Эти блоки были созданы из следующего исходного кода: Этот текст имеет отступ в два пробела. <code> Это предварительно отформатированный код, все пробелы сохраняются: как <-здесь </code> <file> Это почти то же самое, но можно использовать, чтобы показать, что вы цитируете файл. </file> ==== Подсветка синтаксиса ==== [[wiki:DokuWiki]] может подсвечивать исходный код, что облегчает его чтение. Используется универсальный подсветчик синтаксиса [[http://qbnz.com/highlighter/|GeSHi]] — поддерживается любой язык, доступный в GeSHi. Синтаксис использует те же блоки code и file, описанные в предыдущем разделе, но на этот раз внутри тега указывается название языка для подсветки, например ''<nowiki><code java></nowiki>'' или ''<nowiki><file java></nowiki>''. <code 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. } } </code> В настоящее время распознаются следующие строки языков: //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// Существуют дополнительные [[doku>syntax_highlighting|расширенные возможности]] подсветки синтаксиса, такие как выделение строк или добавление номеров строк. ==== Загружаемые блоки кода ==== При использовании синтаксиса ''%%<code>%%'' или ''%%<file>%%'', как показано выше, вы можете также сделать код доступным для скачивания. Для этого укажите имя файла после кода языка: <code> <file php myexample.php> <?php echo "hello world!"; ?></file> </code><file php myexample.php> <?php echo "hello world!"; ?> </file>
+==== Заголовок 3 уровня ====
-Если вы не хотите подсветки, но нужен скачиваемый файл, укажите дефис (''-'') в качестве кода языка: ''%%<code - myfile.foo>%%''.
+=== Заголовок 4 уровня ===
+== Заголовок 5 уровня ==
-===== Агрегация RSS/ATOM-лент =====
+<code>==== Заголовок 3 уровня ====
-[[DokuWiki]] может интегрировать данные из внешних XML-лент. Для разбора XML-лент используется [[http://simplepie.org/|SimplePie]]. В DokuWiki можно использовать все форматы, понимаемые SimplePie. Вы можете управлять отображением с помощью дополнительных параметров, разделённых пробелами:
+=== Заголовок 4 уровня ===
+== Заголовок 5 уровня ==</code>
-^ Параметр ^ Описание ^
+Четыре и более тире преобразуются в горизонтальную черту:
-| любое число | используется как максимальное количество отображаемых элементов, по умолчанию 8 |
-| reverse | отображать последние элементы ленты первыми |
-| author | показывать имена авторов элементов |
-| date | показывать даты элементов |
-| description | показывать описание элемента. Все HTML-теги будут удалены |
-| nosort | не сортировать элементы в ленте |
-| //n//[dhm] | период обновления, где d=дни, h=часы, m=минуты (например, 12h = 12 часов) |
-Период обновления по умолчанию — 4 часа. Любое значение меньше 10 минут будет рассматриваться как 10 минут. [[wiki:DokuWiki]] обычно старается отдавать кэшированную версию страницы, что, очевидно, неуместно, когда страница содержит динамическое внешнее содержимое. Этот параметр указывает [[wiki:DokuWiki]] перерендерить страницу, если с момента последнего рендеринга прошло больше, чем //период обновления//.
+----
-По умолчанию лента сортируется по дате, сначала новые элементы. Вы можете отсортировать сначала старые с помощью параметра ''reverse'' или отображать ленту как есть с помощью ''nosort''.
+===== Картинки и другие файлы =====
-Пример:
+См. также: «[[ru:images|Работа с изображениями и медиафайлами]]».
-{{rss>http://slashdot.org/index.rss 5 author date 1h }}
+С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[ru:images|картинки]]. По желанию можно указать их размер.
-{{rss>http://slashdot.org/index.rss 5 author date 1h }}
+Нормальный размер:                        {{wiki:dokuwiki-128.png}}
+Отмасштабированная до заданной ширины:    {{wiki:dokuwiki-128.png?50}}
+Отмасштабированная до заданных размеров:  {{wiki:dokuwiki-128.png?200x50}}
+Отмасштабированная внешняя картинка:      {{https://www.php.net/images/php.gif?200x50}}
+<code>
+Нормальный размер:                        {{wiki:dokuwiki-128.png}}
+Отмасштабированная до заданной ширины:    {{wiki:dokuwiki-128.png?50}}
+Отмасштабированная до заданных размеров:  {{wiki:dokuwiki-128.png?200x50}}
+Отмасштабированная внешняя картинка:      {{https://www.php.net/images/php.gif?200x50}}
+</code>
+Поставив слева или справа пробел, можно задать выравнивание картинки:
+{{wiki:dokuwiki-128.png }}
+{{ wiki:dokuwiki-128.png}}
+{{ wiki:dokuwiki-128.png }}
+<code>{{wiki:dokuwiki-128.png }} — картинка слева
+{{ wiki:dokuwiki-128.png }} — посередине
+{{ wiki:dokuwiki-128.png}} — справа
+</code>
+И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).
+{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}
+<code>{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}</code>
+Узнать, как вставить картинку со ссылкой можно в [[#картинки-ссылки|разделе выше]].
+==== Поддерживаемые форматы медиа ====
+«Докувики» поддерживает следующие форматы данных:
+| Изображение | ''gif'', ''jpg'', ''png''  |
+| Видео | ''webm'', ''ogv'', ''mp4'' |
+| Аудио | ''ogg'', ''mp3'', ''wav''  |
+| Flash | ''swf''                    |
+Если вы укажете имя файла, которое не является поддерживаемым медиаформатом, то оно будет отображаться в виде ссылки.
+Добавляя ''?linkonly'', вы предоставляете ссылку на МЕДИА, не отображая ее в качестве встроенной
+  {{wiki:dokuwiki-128.png?linkonly}}
+{{wiki:dokuwiki-128.png?linkonly}} Это всего лишь ссылка на изображение.
+==== Резервные форматы ====
+К сожалению, не все браузеры поддерживают все видео- и аудиоформаты. Чтобы устранить проблему, вы можете загрузить свой файл в разных форматах для обеспечения максимальной совместимости с браузером.
+Рассмотрим, например, это встроенное видео в формате mp4:
+  {{video.mp4|Забавное видео}}
+Когда вы загружаете ''video.webm'' и ''video.ogv'' рядом с указанным ''video.mp4'', «Докувики» автоматически добавит их в качестве альтернативных файлов, чтобы один из трех файлов был понятен вашему браузеру.
+Кроме того, «Докувики» поддерживает изображение "poster", которое будет показано перед запуском видео. Это изображение должно иметь то же имя, что и видео, и быть в формате jpg или png. В приведенном выше примере подойдет файл ''video.jpg''.
+===== Списки =====
+«Докувики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом звёздочку (*) в случае маркированного списка, или дефис (-) --- в случае нумерованного.
+  * Первый элемент маркированного списка
+    * Второй элемент списка
+      * Можно сделать вложенный список
+    * Ещё один элемент
+  - Тот же список, только нумерованный
+    - Ещё элемент
+      - Чем больше пробелов в начале, тем глубже вложенность
+    - Всё просто
+<code>
+  * Первый элемент маркированного списка
+    * Второй элемент списка
+      * Можно сделать вложенный список
+    * Ещё один элемент
+  - Тот же список, только нумерованный
+    - Ещё элемент
+      - Чем больше пробелов в начале, тем глубже вложенность
+    - Всё просто
+</code>
+См. также [[ru:faq:lists|FAQ по элементам списка]].
+===== Смайлики =====
+«Докувики» переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию ''smiley'' и добавить их в файл ''conf/smileys.local.conf''. Вот смайлики, которые есть в «Докувики»:
+  * 8-) %%8-)%%
+  * 8-O %%8-O%%
+  * :-( %%:-(%%
+  * :-) %%:-)%%
+  * =) %%=)%%
+  * :-/ %%:-/%%
+  * :-\ %%:-\%%
+  * :-? %%:-?%%
+  * :-D %%:-D%%
+  * :-P %%:-P%%
+  * :-O %%:-O%%
+  * :-X %%:-X%%
+  * :-| %%:-|%%
+  * ;-) %%;-)%%
+  * ^_^ %%^_^%%
+  * :?: %%:?:%%
+  * :!: %%:!:%%
+  * LOL %%LOL%%
+  * FIXME %%FIXME%%
+  * DELETEME %%DELETEME%%
+===== Типографские символы =====
+«Докувики» может переделывать символы, набранные простым текстом, в их типографски корректные эквиваленты. Распознаются следующие символы.
+-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...\\
+"Александр Сергеевич(tm) --- это наше всё (c) не я"
+<code>
+-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...
+"Александр Сергеевич(tm) --- это наше всё (c) не я"
+</code>
+Примечание: это конвертирование можно отключить в файле конфигурации ''[[ru:entities|conf/entities.conf]]''.
+===== Цитирование =====
+Иногда требуется пометить какой-либо текст, чтобы показать, что это ответ или комментарий. Вы можете использовать следующий синтаксис:
+<code>
+Я думаю, мы должны это сделать
+> Нет, не должны
+>> Ну, а я говорю, что должны
+> Правда?
+>> Да!
+>>> Тогда давайте сделаем это!
+</code>
+Я думаю, мы должны это сделать
+> Нет, не должны
+>> Ну, а я говорю, что должны
+> Правда?
+>> Да!
+>>> Тогда давайте сделаем это!
+===== Таблицы =====
+«Докувики» поддерживает упрощённый синтаксис создания таблиц.
+^ Заголовок 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  | Ряд 3 Колонка 2  | Ряд 3 Колонка 3  |
+Как легко увидеть, разделитель, стоящий перед клеткой, определяет форматирование:
+  |              ^ Заголовок 1       ^ Заголовок 2      ^
+  ^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  |
+  ^ Заголовок 4  | Объединения нет   |                  |
+  ^ Заголовок 5  | Ряд 3 Колонка 2   | Ряд 3 Колонка 3  |
+Можно сделать вертикально объединённые ячейки добавлением трёх двоеточий '':::'' в объединяемые нижележащие ячейки.
+^ Заголовок 1      ^ Заголовок 2                        ^ Заголовок 3      ^
+| Ряд 1 Колонка 1  | эта ячейка объединена вертикально  | Ряд 1 Колонка 3  |
+| Ряд 2 Колонка 1  | :::                                | Ряд 2 Колонка 3  |
+| Ряд 3 Колонка 1  | :::                                | Ряд 3 Колонка 3  |
+В этих ячейках не должно быть ничего, кроме синтаксиса объединения ('':::'').
+  ^ Заголовок 1        ^ Заголовок 2                       ^ Заголовок 3            ^
+  | Ряд 1 Колонка 1    | эта ячейка объединена вертикально | Ряд 1 Колонка 3        |
+  | Ряд 2 Колонка 1    | :::                               | Ряд 2 Колонка 3        |
+  | Ряд 3 Колонка 1    | :::                               | Ряд 2 Колонка 3        |
+Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа — если надо выравнять влево, и по два с каждой стороны — если по центру.
+^           Таблица с выравниванием        ^^^
+|        вправо|   по центру  |влево         |
+|влево         |        вправо|   по центру  |
+| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
+  ^           Таблица с выравниванием        ^^^
+  |        вправо|   по центру  |влево         |
+  |влево         |        вправо|   по центру  |
+  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
+Примечание: вертикальное выравнивание не поддерживается.
+===== Неформатируемые блоки =====
+Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах), либо используя тэги ''%%<code>%%'' или ''%%<file>%%''.
+<code>Это неформатированный текст, в котором сохранены все пробелы: вот             <- так.</code>
+<file>В принципе то же самое, но этим выделением можно показать, что цитируется содержимое файла.</file>
+Чтобы парсер полностью проигнорировал некий текст (т. е. не форматировал его), либо заключите его в тэги ''nowiki'', либо ещё проще --- в двойные знаки процента ''<nowiki>%%</nowiki>''.
+Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%%
+и %%**форматирование**%% --- но ничего не происходит.
+<code>Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%%
+и %%**форматирование**%% --- но ничего не происходит.</code>
+Чтобы увидеть, как используются эти блоки, смотрите код страницы.
+===== Подсветка синтаксиса =====
+«Докувики» может подсвечивать программный код, чтобы его было проще читать. Для этого используется библиотека [[http://qbnz.com/highlighter/|GeSHi]] — соответственно подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в блоке ''code'' в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например %%<code java>%%.
+<code 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.
+    }
+}
+</code>
+На данный момент распознаются следующие языки: 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,  rpmspec,  rsplus,  ruby,  rust,  sas,  sass,  scala,  scheme,  scilab,  scl,  sdlbasic,  smalltalk,  smarty,  spark,  sparql,  sql,  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,  xbasic,  xml,  xojo,  xorg_conf,  xpp,  yaml,  z80,  zxbasic.
+==== Скачиваемые блоки кода ====
+Используя тэги ''%%<code>%%'' или ''%%<file>%%'', как показано выше, вы можете сделать отображаемый код доступным для загрузки. Для этого определите имя файла после кода языка вот так:
+<code>
+<file php myexample.php>
+<?php echo "hello world!"; ?>
+</file>
+</code>
+<file php myexample.php>
+<?php echo "hello world!"; ?>
+</file>
+Если вам не нужна подсветка, но нужен загружаемый файл, поставьте прочерк (дефис) (''-'') на месте кода языка: ''%%<code - myfile.foo>%%''.
+**Особенность:** при написании имени файла на русском языке для формирования корректного имени файла обрамляйте название файла двойными кавычками. Например, %%"Фоо Бар.php"%%.
+<file php "Фоо Бар.php">
+<?php echo "hello world!"; ?>
+</file>
+===== Вставка HTML и PHP =====
+Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов ''html'' и ''php''. Используйте заглавные буквы для блочных элементов.
+<code html>
+<html>
+Тут вставлен <font color="red" size="+1">код HTML</font>
+</html>
+<HTML>
+<p style="border:2px dashed red;">И здесь блочная вставка HTML</p>
+</HTML>
+</code>
+Получается:
+<html>
+Тут вставлен <font color="red" size="+1">HTML-код</font>
+</html>
+<HTML>
+<p style="border:2px dashed red;">И здесь блочная вставка HTML</p>
+</HTML>
+----
+<code>
+<php>
+echo 'Версия PHP: ';
+echo phpversion();
+echo ' (прямая вставка в HTML).';
+</php>
+<PHP>
+echo '<table class="inline"><tr><td>То же самое — в элементе блочного уровня:</td>';
+echo '<td>'.phpversion().'</td>';
+echo '</tr></table>';
+</PHP>
+</code>
+Получается:
+<php>
+echo 'Версия PHP: ';
+echo phpversion();
+echo ' (прямая вставка в HTML).';
+</php>
+<PHP>
+echo '<table class="inline"><tr><td>То же самое — в элементе блочного уровня:</td>';
+echo '<td>'.phpversion().'</td>';
+echo '</tr></table>';
+</PHP>
+**Примечание:** по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде.
+===== RSS/ATOM Feed Aggregation =====
+===== Агрегация каналов RSS/ATOM =====
+Докувики может интегрировать данные из внешних XML-каналов. Для анализа XML-каналов, используется [[http://simplepie.org/|SimplePie]]. Все форматы, понятные SimplePie, также могут быть использованы в Докувики. Вы можете влиять на рендеринг с помощью нескольких дополнительных параметров, разделенных пробелами:
+^ Параметр  ^ Описание ^
+| any number | Отображается максимальное количество элиментов, по умолчанию 8 |
+| reverse    | Сначала отобразите последние элементы в ленте |
+| author     | Показывать имена авторов элементов |
+| date       | Показывать даты элиментов |
+| description| Покажите описание элиментов. Если HTML отключен, все теги будут удалены |
+| nosort     | Не сортируйте элементы в ленте |
+| //n//[dhm] | Период обновления, где d=дни, h=часы, m=минуты. (например 12h = 12 часов). |
+Период обновления по умолчанию равен 4 часам. Любое значение ниже 10 минут будет рассматриваться как 10 минут. Докувики обычно пытается предоставить кэшированную версию страницы, очевидно, что это неуместно, когда страница содержит динамический внешний контент. Параметр указывает Докувики повторно отобразить страницу, если прошло больше //периода обновления// с момента последнего отображения страницы.
+По умолчанию лента будет отсортирована по дате, сначала по самым новым элементам. Вы можете сначала отсортировать его по возрасту, используя параметр "reverse", или отобразить ленту как есть с "nosort".
+**Пример:**
+  {{rss>http://slashdot.org/index.rss 5 author date 1h }}
+{{rss>http://slashdot.org/index.rss 5 author date 1h }}
 ===== Управляющие макросы =====
-Некоторые синтаксические конструкции влияют на то, как DokuWiki отображает страницу, сами не создавая вывода. Доступны следующие управляющие макросы:
+Некоторый синтаксис влияет на то, как «Докувики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:
-^ Макрос ^ Описание |
+^ Макрос          ^ Описание      |
-| %%~~NOTOC~~%% | Если этот макрос присутствует на странице, оглавление не будет создано |
+| %%~~NOTOC~~%%   | Если этот макрос присутствует в статье, оглавление не будет создано.  |
-| %%~~NOCACHE~~%% | DokuWiki по умолчанию кэширует весь вывод. Иногда это нежелательно (например, при использовании синтаксиса %%<php>%%), добавление этого макроса заставляет DokuWiki перерендеривать страницу при каждом запросе |
+| %%~~NOCACHE~~%% | «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синтаксис %%<php>%%), добавление этого макроса заставит «Докувики» обрабатывать статью при каждом вызове.  |
 ===== Синтаксические плагины =====
-Синтаксис DokuWiki может быть расширен с помощью [[doku>plugins|плагинов]]. Как использовать установленные плагины, описано на их соответствующих страницах описания. В данной конкретной установке DokuWiki доступны следующие синтаксические плагины:
+Синтаксис «Докувики» может быть расширен за счёт [[ru:plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте:
 ~~INFO:syntaxplugins~~