Различия

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

--- wiki:syntax [2026/07/13 21:36] – 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>
 ==== Внутренние ====
-Внутренние ссылки создаются с помощью квадратных скобок. Вы можете просто указать [[имя_страницы]] или использовать дополнительный [[имя_страницы|текст ссылки]].
+Внутренние ссылки создаются посредством квадратных скобок.
+Можно либо просто указать [[ru:pagename|имя страницы]], либо
+дополнительно прописать [[ru:pagename|текст ссылки]]. Имена
+вики-статей автоматически  переводятся в нижний регистр,
+спецсимволы использовать нельзя.
-Внутренние ссылки создаются с помощью квадратных скобок. Вы можете просто указать
+<code>Внутренние ссылки создаются посредством квадратных скобок.
-[[имя_страницы]] или использовать дополнительный [[имя_страницы|текст ссылки]].
+Можно либо просто указать [[ru:pagename]], либо
+дополнительно прописать [[ru:pagename|текст ссылки]]. Имена
+вики-статей автоматически  переводятся в нижний регистр,
+спецсимволы использовать нельзя.</code>
-[[doku>pagename|Имена страниц вики]] автоматически приводятся к нижнему регистру, специальные символы не допускаются.
+Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.
-Вы можете использовать [[пространства:имён]] с помощью двоеточия в имени страницы.
+<code>Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.</code>
-Вы можете использовать [[пространства:имён]] с помощью двоеточия в имени страницы.
+Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в 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, например [[\сервер\папка|эта]], также распознаются. Обратите внимание, что они имеют смысл только в однородной группе пользователей, например, в корпоративном [[wp>Intranet|интранете]].
+С помощью двойных скобок можно добавить сноску((Сноска — помещаемые внизу страницы примечание, ссылка, перевод.)).
-Сетевые папки Windows, например [[\сервер\папка|эта]], также распознаются.
+<code>С помощью двойных скобок можно добавить сноску((Сноска —
+помещаемые внизу страницы примечание, ссылка, перевод.)).</code>
-Примечания:
+===== Разбивка на разделы =====
-По соображениям безопасности прямой просмотр сетевых папок Windows по умолчанию работает только в Microsoft Internet Explorer (и только в «локальной зоне»).
+Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку %%~~NOTOC~~%%.
-Для Mozilla и Firefox это можно включить с помощью различных обходных путей, описанных в [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|базе знаний Mozilla]]. Однако всё равно будет появляться предупреждение JavaScript о попытке открыть сетевую папку. Чтобы убрать это предупреждение (для всех пользователей), добавьте следующую строку в файл ''conf/lang/en/lang.php'' (подробнее в [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|локализации]]): <code - conf/lang/en/lang.php>
-<?php /** * Настройка английского языкового файла * Копируйте только те строки, которые нужно изменить */ $lang['js']['nosmblinks'] = ''; </code> ==== Ссылки-картинки ==== Вы также можете использовать изображение для ссылки на другую внутреннюю или внешнюю страницу, комбинируя синтаксис ссылок и [[#изображения_и_другие_файлы|изображений]] (см. ниже) следующим образом: [[http://php.net|{{wiki:dokuwiki-128.png}}]] [[http://php.net|{{wiki:dokuwiki-128.png}}]] Обратите внимание: форматирование изображения — это единственный синтаксис форматирования, допустимый в тексте ссылки. Поддерживается полный синтаксис [[#изображения_и_другие_файлы|изображений]] и [[#ссылки|ссылок]] (включая изменение размера, внутренние и внешние изображения, 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 |Это подпись}} Для создания ссылки из изображения на другую страницу см. [[#Ссылки-картинки]] выше. ==== Поддерживаемые форматы мультимедиа ==== 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.webm'' и ''video.ogv'' рядом с указанным ''video.mp4'', 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) "He thought 'It's a man's world'..." <code> -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..." </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 | Вы можете объединять ячейки по вертикали, добавляя ''%%:::%%'' в ячейки ниже той, с которой они должны быть соединены. ^ Заголовок 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>%%'' или, что ещё проще, в двойные знаки процента ''<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> /** * Класс HelloWorldApp реализует приложение, * которое просто выводит "Hello World!" в стандартный вывод. */ class HelloWorldApp { public static void main(String[] args) { System.out.println("Hello World!"); // Вывод строки. } } </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 уровня ====
+=== Заголовок 4 уровня ===
+== Заголовок 5 уровня ==</code>
-[[DokuWiki]] может интегрировать данные из внешних XML-лент. Для разбора XML-лент используется [[http://simplepie.org/|SimplePie]]. Все форматы, понимаемые SimplePie, могут использоваться и в DokuWiki. Вы можете влиять на отображение с помощью нескольких дополнительных параметров, разделённых пробелами:
+Четыре и более тире преобразуются в горизонтальную черту:
-^ Параметр ^ Описание ^
+----
-| любое число | будет использоваться как максимальное количество элементов для отображения, по умолчанию 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|Работа с изображениями и медиафайлами]]».
-Пример:
+С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[ru:images|картинки]]. По желанию можно указать их размер.
-{{rss>http://slashdot.org/index.rss 5 author date 1h }}
+Нормальный размер:                        {{wiki:dokuwiki-128.png}}
-{{rss>http://slashdot.org/index.rss 5 author date 1h }}
+Отмасштабированная до заданной ширины:    {{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~~