Инструменты пользователя

Инструменты сайта


wiki:syntax

Различия

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

Ссылка на это сравнение

wiki:syntax [2019/08/28 12:32] (текущий)
Строка 1: Строка 1:
 +====== Синтаксис форматирования ======
 +
 +DokuWiki поддерживает язык разметки,​ который по возможности сохраняет файлы данных как можно более читабельными! Здесь перечислены все возможные синтаксические конструкции,​ которые можно использовать при редактировании страниц. Просто посмотрите на исходный код этой страницы,​ нажав кнопку Отредактировать страницу вверху или внизу страницы. Если хотите поупражняться,​ используйте [[playground:​playground|песочницу]]. Простую разметку также можно легко сделать с помощью [[toolbar|панели инструментов]]
 +
 +===== Основные конструкции форматирования =====
 +
 +DokuWiki поддерживает выделение текста **жирным шрифтом**,​ //​курсивом//,​ __подчеркнутый текст__ и вывод текста ''​моноширинным шрифтом''​. Все эти конструкции можно **__//''​объединить''//​__**.
 +
 +<​code>​
 +DokuWiki поддерживает выделение текста
 +**жирным шрифтом**,​
 +//​курсивом//,​
 +__подчеркниванием текста__
 +и вывод текста ''​моноширинным шрифтом''​. ​
 +Все эти конструкции можно **__//''​объединить''//​__**.
 +</​code>​
 +
 +Также можно использовать <​sub>​подстрочный</​sub>​ и <​sup>​надстрочный</​sup>​ индексы.
 +
 +<​code>​
 +Также можно использовать <​sub>​подстрочный</​sub>​ и <​sup>​надстрочный</​sup>​ индексы.
 +</​code>​
 +
 +Ещё можно <​del>​зачеркнуть текст</​del>​.
 +
 +<​code>​
 +Ещё можно <​del>​зачеркнуть текст</​del>​.
 +</​code>​
 +
 + ​**Параграфы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**,​ не создавая параграф,​ вставьте два обратных слэша и за ним пробел или энтер.
 +
 +Просто текст с разрывом строк\\ Обратите внимание, ​
 +что два обратных слэша действуют только в конце строки\\
 +или если за ними стоит\\ пробел. Если его не поставить,​ \\получится вот так.
 +
 +<​code>​Просто текст с разрывом строк\\ Обратите внимание,​
 +что два обратных слэша действуют только в конце строки\\
 +или если за ними стоит\\ пробел. Если его не поставить,​ \\получится вот так.
 +</​code>​
 +
 +:!: Принудительные переносы следует использовать только в случае крайней необходимости.
 +
 +===== Ссылки =====
 +
 +Ссылки в DokuWiki бывают разные,​ и создавать их можно тоже по-разному.
 +
 +==== Внешние ====
 +
 +Внешние ссылки распознаются автоматически:​ http://​www.google.com или
 +просто www.google.com --- также можно указывать текст ссылки:​
 +[[http://​www.google.com|Это ссылка на Google]]. Адреса электронной почты
 +тоже распознаются:​ <​andi@splitbrain.org>​.
 +{{:​wiki:​wikizone.png|}}
 +<​code>​Внешние ссылки распознаются автоматически:​ http://​www.google.com или
 +просто www.google.com --- также можно указывать текст ссылки:​
 +[[http://​www.google.com|Это ссылка на Google]]. Адреса электронной почты
 +тоже распознаются:​ <​andi@splitbrain.org>​.</​code>​
 +
 +
 +==== Внутренние ====
 +
 +Внутренние ссылки создаются посредством квадратных скобок.
 +Можно либо просто указать [[Имя страницы]],​ либо дополнительно прописать
 +[[Имя страницы|Текст ссылки]]. Имена Wiki-страниц автоматически ​
 +переводятся в нижний регистр,​ спецсимволы использовать нельзя.
 +
 +<​code>​Внутренние ссылки создаются посредством квадратных скобок.
 +Можно либо просто указать [[Имя страницы]],​ либо дополнительно прописать
 +[[Имя страницы|Текст ссылки]]. Имена Wiki-страниц автоматически ​
 +переводятся в нижний регистр,​ спецсимволы использовать нельзя.</​code>​
 +
 +Можно использовать в ссылке [[namespaces]] (пространство имён) через двоеточие.
 +
 +<​code>​Можно использовать в ссылке [[namespaces]] (пространство имён) через двоеточие.</​code>​
 +
 +Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку имя раздела,​ также как это делается в HTML. Ссылка на [[syntax#​внутренние|этот раздел]].
 +
 +<​code>​Ссылка на [[syntax#​внутренние|этот раздел]].</​code>​
 +
 +Примечания:​
 +
 +  * Ссылки на [[syntax|существующие страницы]] отображаются иначе, чем ссылки на [[несуществующие страницы]]
 +  * Внутренние ссылки без указанного текста могут отображаться по разному в зависимости от настроек - в качестве текста может использоваться название страницы или заголовок первого уровня((именно такая настройка используется на этом сайте)). Так что лучше каждый раз указывать текст ссылки.
 +  * DokuWiki по умолчанию не использует [[wp>​CamelCase]] для автоматического создания ссылок,​ но эту возможность можно включить в файле [[doku>​wiki:​config]]. Проверка:​ Если DokuWiki — ссылка,​ значит эта возможность включена.
 +  * Если меняется название раздела,​ ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.
 +
 +
 +
 +
 +==== InterWiki ====
 +
 +DokuWiki поддерживает [[doku>​wiki:​interwiki|InterWiki]]-ссылки. Это короткие ссылки
 +на другие Wiki. Например,​ вот ссылка на страницу Википедии о Wiki: [[wp>​Wiki]].
 +
 +<​code>​
 +Например,​ вот ссылка на страницу Википедии о Wiki: [[wp>​Wiki]].
 +</​code>​
 +
 +==== Сетевые ресурсы Windows ====
 +
 +Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите,​ что такие ссылки имеют смысл только в гомогенных группах пользователей,​ например в корпоративном Интранете.
 +
 +<​code>​Ссылки на виндовые шары вида \\server\share тоже распознаются.</​code>​
 +
 +Примечания:​
 +
 +  * Из соображений безопасности непосредственный просмотр виндовых шар работает по умолчанию только в Internet Explorer (и только в “локальной зоне”).
 +  * В Mozilla и Firefox эту возможность можно включить с помощью опции [[http://​www.mozilla.org/​quality/​networking/​docs/​netprefs.html#​file|security.checkloaduri]],​ но делать это не рекомендуется.
 +  * Подробней читайте здесь: [[bug>​151]].
 +
 +
 +==== Картинки-ссылки ====
 +
 +Совместив синтаксис ссылки и [[syntax#​картинки и другие файлы|картинки]],​ можно вставить в текст картинку,​ которая будет внутренней или внешней ссылкой:​
 +
 +<​code>​[[http://​www.php.net|{{:​wiki:​wikizone.png}}]]</​code>​
 +
 +[[http://​www.php.net|{{:​wiki:​wikizone.png}}]]
 +
 +Учтите:​ форматирование картинок это единственная синтаксическая конструкция,​ которую можно использовать в тексте ссылки.
 +
 +===== Сноски =====
 +
 +С помощью двойных скобок можно добавить сноску((Это сноска)).
 +
 +<​code>​С помощью двойных скобок можно добавить сноску ((Это сноска)).</​code>​
 +
 +===== Разбивка на разделы =====
 +
 +Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков 3-го уровня и выше, автоматически создаётся список содержимого. Его можно отключить,​ вставив в документ строку %%~~NOTOC~~%%.
 +
 +
 +
 +==== Заголовок 3-го уровня ====
 +=== Заголовок 4-го уровня ===
 +== Заголовок 5-го уровня ==
 +
 +<​code>​==== Заголовок 3-го уровня ====
 +=== Заголовок 4-го уровня ===
 +== Заголовок 5-го уровня ==</​code>​
 +
 +Четыре и более тире преобразуются в горизонтальную черту:
 +
 +----
 +\\
 +
 +<​code>​
 +----
 +</​code>​
 +
 +
 +===== Картинки и другие файлы =====
 +
 +С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[doku>​wiki:​images|картинки]]. По желанию можно указать их размер.
 +
 +Нормальный размер: ​                       {{:​wiki:​wikizone.png}}
 +
 +Отмасштабированная до заданной ширины: ​   {{:​wiki:​wikizone.png?​50}}
 +
 +Отмасштабированная до заданных размеров:​{{:​wiki:​wikizone.png?​200x50}}
 +
 +Отмасштабированная внешняя картинка: ​     {{http://​forum.vegalab.ru/​images/​misc/​vegalab_logo.png?​300x100}}
 +
 +<​code>​
 +Нормальный размер: ​                       {{:​wiki:​wikizone.png}}
 +Отмасштабированная до заданной ширины: ​   {{:​wiki:​wikizone.png?​50}}
 +Отмасштабированная до заданных размеров: ​ {{:​wiki:​wikizone.png?​200x50}}
 +Отмасштабированная внешняя картинка: ​     {{http://​forum.vegalab.ru/​images/​misc/​vegalab_logo.png?​300x100}}
 +</​code>​
 +
 +Поставив слева или справа пробел можно задать выравнивание картинки:​
 +
 +{{:​wiki:​wikizone.png }}
 +{{ :​wiki:​wikizone.png}}
 +{{ :​wiki:​wikizone.png }}
 +
 +<​code>​
 +
 +{{:​wiki:​wikizone.png }}
 +{{ :​wiki:​wikizone.png}}
 +{{ :​wiki:​wikizone.png }}
 +</​code>​
 +
 +И, конечно,​ картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).
 +
 +{{ :​wiki:​wikizone.png |Название картинки}}
 +
 +<​code>​
 +
 +{{ :​wiki:​wikizone.png |Название картинки}}</​code>​
 +
 +Если задать имя файла (внутреннее или внешнее),​ который не является картинкой (''​gif,​ jpeg, png''​),​ оно будет отображаться в виде ссылки.
 +
 +
 +
 +
 +===== Списки =====
 +
 +Dokuwiki поддерживает нумерованные и ненумерованные списки. Чтобы создать элемент списка,​ поставьте в начале строки два пробела и потом * в случае ненумерованного списка,​ или - в случае нумерованного.
 +
 +  * Это список
 +    * Второй элемент списка
 +      * Можно сделать вложенный список
 +    * Ещё один элемент
 +
 +  - Тот же список,​ только нумерованный
 +  - Ещё элемент
 +    - Чем больше пробелов в начале,​ тем глубже вложенность
 +  - Всё просто
 +
 +<​code>​
 +  * Это список
 +    * Второй элемент списка
 +      * Можно сделать вложенный список
 +    * Ещё один элемент
 +
 +  - Тот же список,​ только нумерованный
 +  - Ещё элемент
 +    - Чем больше пробелов в начале,​ тем глубже вложенность
 +  - Всё просто
 +</​code>​
 +
 +
 +
 +===== Смайлики =====
 +
 +DokuWiki преобразует наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию ''​smiley''​ и внести изменения в файл ''​conf/​smileys.conf''​. Вот смайлики,​ которые есть в DokuWiki:
 +
 +  * 8-) %%8-)%%
 +  * 8-O %%8-O%%
 +  * :-( %%:-(%%
 +  * :-) %%:-)%%
 +  * =) %%=)%%
 +  * :-/ %%:-/%%
 +  * :-\ %%:-\%%
 +  * :-? %%:-?%%
 +  * :-D %%:-D%%
 +  * :-P %%:-P%%
 +  * :-O %%:-O%%
 +  * :-X %%:-X%%
 +  * :-| %%:-|%%
 +  * ;-) %%;-)%%
 +  * ^_^ %%^_^%%
 +  * :?: %%:?:%%
 +  * :!: %%:!:%%
 +  * LOL %%LOL%%
 +  * FIXME %%FIXME%%
 +  * DELETEME %%DELETEME%%
 +
 +
 +
 +===== Типографские символы =====
 +
 +DokuWiki может переделывать символы,​ набранные простым текстом,​ в их типографски корректные эквиваленты. Распознаются следующие символы.
 +
 +-> <- <-> => <= <=> >> << -- --- '​640x480'​ (c) (tm) (r)\\
 +"​Владимир Владимирович(tm) --- это наше всё (c) не я"
 +
 +<​code>​
 +-> <- <-> => <= <=> >> << -- --- '​640x480'​ (c) (tm) (r)
 +"​Владимир Владимирович(tm) --- это наше всё (c) не я"
 +</​code>​
 +
 +Примечание:​ Это конвертирование можно отключить в файле конфигурации.\\
 +Примечание 2: Если потребуется вставить двойные кавычки (%%"%% или ''​%%"​%%''​),​ например как знак дюйма :-), можно их экранировать ''<​nowiki>​%%</​nowiki>'':​
 +  %%"%% или ''​%%"​%%''​
 + 
 +
 +===== Цитирование =====
 +
 +Иногда нужно пометить некоторый текст в качестве ответа или комментария. Для этого можно использовать следующий синтаксис:​
 +
 +  Я думаю, мы должны это сделать.
 +  > Нет, мы не должны.
 +  >> Ну, я говорю,​ что мы должны.
 +  > Действительно?​
 +  >> Да!
 +  >>>​ Тогда сделаем это!
 +
 +Я думаю, мы должны это сделать.
 +> Нет, мы не должны.
 +>> Ну, я говорю,​ что мы должны.
 +> Действительно?​
 +>> Да!
 +>>>​ Тогда сделаем это!
 +
 +===== Таблицы =====
 +
 +DokuWiki поддерживает упрощённый синтаксис создания таблиц.
 +
 +^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
 +| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        |
 +| Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту) ​ ||
 +| Ряд 3 Колонка 1  | Ряд 2 Колонка 2     | Ряд 2 Колонка 3        |
 +
 +Нормальные ряды должны начинаться и заканчиваться символом |, а заголовки — ^.
 +
 +<​code>​
 +^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
 +| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        |
 +| Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту) ​ ||
 +| Ряд 3 Колонка 1  | Ряд 2 Колонка 2     | Ряд 2 Колонка 3        |
 +</​code>​
 +
 +Чтобы объединить две соседние клетки в ряду, просто оставьте соседнюю клетку полностью пустой,​ как показано выше. Следите,​ чтобы количество разделителей клеток было одинаковым!
 +
 +Вертикальные заголовки тоже можно сделать.
 +
 +|              ^ Заголовок 1       ^ Заголовок 2      ^
 +^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  |
 +^ Заголовок 4  | Объединения нет ​  ​| ​                 |
 +^ Заголовок 5  | Ряд 2 Колонка 2   | Ряд 2 Колонка 3  |
 +
 +Как легко увидеть,​ разделитель стоящий перед клеткой определяет форматирование:​
 +
 +<​code>​
 +|              ^ Заголовок 1       ^ Заголовок 2      ^
 +^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  |
 +^ Заголовок 4  | Объединения нет ​  ​| ​                 |
 +^ Заголовок 5  | Ряд 2 Колонка 2   | Ряд 2 Колонка 3  |
 +</​code>​
 +
 +Можно сделать вертикально объединённые ячейки добавлением трёх двоеточий '':::''​ в объединяемые нижележащие ячейки.
 +
 +^ Заголовок 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 |
 +
 +===== Неформатируемые блоки =====
 +
 +Неформатируемые блоки можно вставлять в документ,​ либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах),​ либо используя тэги ''​%%<​code>​%%''​ или ''​%%<​file>​%%''​. При этом пробелы в начале строки являются эквивалентом применения тега ''​%%<​code>​%%''​ к одной строке,​ но без подсветки кода. Если несколько подряд идущих строк начинаются более чем с одного пробела,​ они объединяются в один блок ''​%%<​code>​%%''​.
 +
 +Пример использования ''​%%<​code>​%%''​..''​%%</​code>​%%''​.
 +<​code>​Это неформатированный текст, в котором сохранены все пробелы:​ вот ​            <- так.</​code>​
 +
 +Пример использования ''​%%<​file>​%%''​..''​%%</​file>​%%''​.
 +<​file>​В принципе то же самое, но этим выделением можно показать, ​
 +что цитируется содержимое файла.</​file>​
 +
 +Чтобы парсер полностью проигнорировал некий текст (т.е. не форматировал его), либо заключите его в тэги ''​%%<​nowiki>​%%'',​ либо ещё проще — в двойные знаки процента ''<​nowiki>​%%</​nowiki>''​.
 +
 +Это просто текст, в котором есть адрес %%http://​www.splitbrain.org%% ​
 +и %%**форматирование**%% --- но ничего не происходит.
 +
 +<​code>​Это просто текст, в котором есть адрес %%http://​www.splitbrain.org%% ​
 +и %%**форматирование**%% --- но ничего не происходит.</​code>​
 +
 +Чтобы увидеть,​ как используются эти блоки, смотрите код страницы.
 +
 +
 +
 +===== Подсветка синтаксиса =====
 +
 +DokuWiki может подсвечивать <wrap hi>​программный код</​wrap>,​ чтобы его было проще читать. Для этого используется библиотека [[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>​
 +
 +На данный момент распознаются следующие языки: ​
 +
 +~~COL:7~~
 +  , 4cs
 +  , **a**bap
 +  , actionscript-french
 +  , actionscript
 +  , actionscript3
 +  , ada
 +  , apache
 +  , applescript
 +  , asm
 +  , asp
 +  , autoconf
 +  , autohotkey
 +  , autoit
 +  , avisynth
 +  , awk
 +  , **b**ash
 +  , basic4gl
 +  , bf
 +  , bibtex
 +  , blitzbasic
 +  , bnf
 +  , boo
 +  , **c**
 +  , c_mac
 +  , caddcl
 +  , cadlisp
 +  , cfdg
 +  , cfm
 +  , chaiscript
 +  , cil
 +  , clojure
 +  , cmake
 +  , cobol
 +  , cpp
 +  , cpp-qt
 +  , csharp
 +  , css
 +  , cuesheet
 +  , **d**
 +  , dcs
 +  , delphi
 +  , diff
 +  , div
 +  , dos
 +  , dot
 +  , **e**cmascript
 +  , eiffel
 +  , email
 +  , erlang
 +  , **f**o
 +  , fortran
 +  , freebasic
 +  , fsharp
 +  , **g**ambas
 +  , genero
 +  , genie
 +  , gdb
 +  , glsl
 +  , gml
 +  , gnuplot
 +  , groovy
 +  , gettext
 +  , gwbasic
 +  , **h**askell
 +  , hicest
 +  , hq9plus
 +  , html
 +  , **i**con
 +  , idl
 +  , ini
 +  , inno
 +  , intercal
 +  , io
 +  , **j**
 +  , java5
 +  , java
 +  , javascript
 +  , jquery
 +  , **k**ixtart
 +  , klonec
 +  , klonecpp
 +  , **l**atex
 +  , lisp
 +  , locobasic
 +  , logtalk
 +  , lolcode
 +  , lotusformulas
 +  , lotusscript
 +  , lscript
 +  , lsl2
 +  , lua
 +  , **m**68k
 +  , magiksf
 +  , make
 +  , mapbasic
 +  , matlab
 +  , mirc
 +  , modula2
 +  , modula3
 +  , mmix
 +  , mpasm
 +  , mxml
 +  , mysql
 +  , **n**ewlisp
 +  , nsis
 +  , **o**beron2
 +  , objc
 +  , ocaml-brief
 +  , ocaml
 +  , oobas
 +  , oracle8
 +  , oracle11
 +  , oxygene
 +  , oz
 +  , **p**ascal
 +  , pcre
 +  , perl
 +  , perl6
 +  , per
 +  , pf
 +  , php-brief
 +  , php
 +  , pike
 +  , pic16
 +  , pixelbender
 +  , plsql
 +  , postgresql
 +  , povray
 +  , powerbuilder
 +  , powershell
 +  , progress
 +  , prolog
 +  , properties
 +  , providex
 +  , purebasic
 +  , python
 +  , **q**
 +  , qbasic
 +  , **r**ails
 +  , rebol
 +  , reg
 +  , robots
 +  , rpmspec
 +  , rsplus
 +  , ruby
 +  , **s**as
 +  , scala
 +  , scheme
 +  , scilab
 +  , sdlbasic
 +  , smalltalk
 +  , smarty
 +  , sql
 +  , systemverilog
 +  , **t**cl
 +  , teraterm
 +  , text
 +  , thinbasic
 +  , tsql
 +  , typoscript
 +  , **u**nicon
 +  , **v**ala
 +  , vbnet
 +  , vb
 +  , verilog
 +  , vhdl
 +  , vim
 +  , visualfoxpro
 +  , visualprolog
 +  , **w**hitespace
 +  , winbatch
 +  , whois
 +  , **x**basic
 +  , xml
 +  , xorg_conf
 +  , xpp
 +  , **z**80
 +
 +
 +==== Скачиваемые блоки кода ====
 +Используя тэги ''​%%<​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>​%%''​.
 +
 +===== Вставка HTML и PHP =====
 +
 +Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов ''​html''​ и ''​php'':​
 +
 +<code html>
 +<​html>​
 +Тут вставлен <font color="​red"​ size="​+1">​HTML-код</​font>​
 +</​html>​
 +</​code>​
 +
 +<​html>​
 +Тут вставлен <font color="​red"​ size="​+1">​HTML-код</​font>​
 +</​html>​
 +
 +<code php>
 +<php>
 +echo '​Логотип,​ сгенерированный PHP:';
 +echo '<​img src="'​ . $_SERVER['​PHP_SELF'​] . '?​='​ . php_logo_guid() . '"​ alt="​Логотип PHP!" />';​
 +</​php>​
 +</​code>​
 +
 +<php>
 +echo '​Логотип,​ сгенерированный PHP:';
 +echo '<​img src="'​ . $_SERVER['​PHP_SELF'​] . '?​='​ . php_logo_guid() . '"​ alt="​Логотип PHP!" />';​
 +</​php>​
 +
 +**Примечание**:​ по умолчанию вставка HTML и PHP запрещена. Когда она запрещена,​ код не исполняется,​ а выводится в исходном виде.
 +
 +===== Управляющие макросы =====
 +
 +Некоторый синтаксис влияет на то, как «ДокуВики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:​
 +
 +^ Макрос ​         ^ Описание ​     |
 +| %%~~NOTOC~~%% ​  | Если этот макрос присутствует в статье,​ оглавление не будет создано. ​ |
 +| %%~~NOCACHE~~%% | «ДокуВики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например,​ когда выше был использован синтаксис %%<​php>​%%),​ добавление этого макроса заставит «ДокуВики» обрабатывать статью при каждом вызове. ​ |
 +
 +===== Интеграция с RSS/ATOM фидами ​ =====
 +
 +DokuWiki может отображать на своих страницах данные из внешних XML-фидов. Для парсинга XML-фидов используется библиотека [[http://​simplepie.org/​|SimplePie]],​ соответственно,​ все форматы,​ распознаваемые этой библиотекой поддерживаются в DokuWiki. Вывод информации можно настроить,​ используя следующие параметры (параметры надо разделять пробелами):​
 +
 +^ Параметр ^ Описание ^
 +| любое число | максимальное кол-во отображаемых элементов,​ по умолчанию - 8 |
 +| reverse ​   | вывести список новостей в обратном порядке - самые старые записи выводятся первыми |
 +| author ​    | показывать имена авторов (если указаны в фиде) |
 +| date       | показывать даты записей (если указаны в фиде) |
 +| description| показывать описание записи. Если в настройках DokuWiki выключено отображение HTML кодов, то из описания будут удалены все HTML коды |
 +| //n//[dhm] | период обновления фида, где d=дни, h=часы, m=минуты. (т.е. 12h = 12 часов, а 2d = 2 дня). |
 +
 +По умолчанию период обновления равен 4 часам. Если указать значение меньше 10 минут, то DokuWiki всё-равно будет обновлять не чаще, чем раз в 10 минут. По умолчанию DokuWiki выдаёт пользователю сохранённую версию страницы,​ однако указание периода обновления фида приводит к повторному рендерингу страницы.
 +
 +**Пример:​**
 +
 +  {{rss>​http://​wsrss.bbc.co.uk/​russian/​index.xml 7 author date 10h }}
 +
 +{{rss>​http://​wsrss.bbc.co.uk/​russian/​index.xml 7 author date 10h }}
 +
 +====== Дополнительное форматирование (синтаксические плагины) ======
 +
 +Синтаксис «ДокуВики» может быть расширен за счёт [[doku>​plugins|плагинов]]. ​
 +Как их устанавливать и использовать --- описывается на страницах описания. На этом сайте установлены следующие модули,​ которые расширяют стандартное форматирование DokuWiki:
 +
 +~~INFO:​syntaxplugins~~
 +
  
wiki/syntax.txt · Последние изменения: 2019/08/28 12:32 (внешнее изменение)