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

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


wiki:sintaksis_formatirovanija

Различия

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

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

Следующая версия
Предыдущая версия
wiki:sintaksis_formatirovanija [2020/03/10 16:34]
rshukayl создано
wiki:sintaksis_formatirovanija [2020/10/10 15:38] (текущий)
Строка 1: Строка 1:
 ====== Синтаксис форматирования ====== ====== Синтаксис форматирования ======
  
 +«Докувики» поддерживает простой язык разметки,​ который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции,​ которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи,​ нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться,​ просто используйте «[[playground:​playground|песочницу]]». Простую разметку также можно легко сделать с помощью [[ru:​toolbar|панели инструментов]].
 +
 +===== Основные конструкции форматирования =====
 +
 +«Докувики» поддерживает выделение текста **жирным шрифтом**,​ //​курсивом//,​ __подчёркнутый текст__ и вывод текста ''​моноширинным шрифтом''​. Все эти конструкции можно **__//''​объединить''//​__**.
 +
 +<​code>​
 +«Докувики» поддерживает выделение текста **жирным шрифтом**,​ //​курсивом//, ​
 +__подчёркнутый текст__ и вывод текста ''​моноширинным шрифтом''​. ​
 +Все эти конструкции можно **__//''​объединить''//​__**. ​
 +</​code>​
 +
 +Также можно использовать <​sub>​подстрочный</​sub>​ и <​sup>​надстрочный</​sup>​ индексы.
 +
 +<​code>​
 +Также можно использовать <​sub>​подстрочный</​sub>​ и <​sup>​надстрочный</​sup>​ индексы.
 +</​code>​
 +
 +Ещё можно <​del>​зачеркнуть текст</​del>​.
 +
 +<​code>​
 +Ещё можно <​del>​зачеркнуть текст</​del>​.
 +</​code>​
 +
 +**Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**,​ не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке.
 +
 +Просто текст с разрывом строк\\ Обратите внимание, ​
 +что два обратных слэша действуют только в конце строки\\
 +или если за ними стоит\\ пробел. Если его не поставить,​ \\получится вот так.
 +
 +<​code>​Просто текст с разрывом строк\\ Обратите внимание,​
 +что два обратных слэша действуют только в конце строки\\
 +или если за ними стоит\\ пробел. Если его не поставить,​ \\получится вот так.
 +</​code>​
 +
 +Принудительные переносы следует использовать только в случае крайней необходимости.
 +
 +===== Ссылки =====
 +
 +Ссылки в «Докувики» бывают разные и создавать их можно тоже по-разному.
 +
 +==== Внешние ====
 +
 +Внешние ссылки распознаются автоматически:​ http://​www.google.com или
 +просто www.google.com --- также можно указывать текст ссылки:​
 +[[http://​www.google.com|Это ссылка на Google]]. Адреса электронной почты
 +тоже распознаются:​ <​andi@splitbrain.org>​.
 +
 +<​code>​Внешние ссылки распознаются автоматически:​ http://​www.google.com или
 +просто www.google.com --- также можно указывать текст ссылки:​
 +[[http://​www.google.com|Это ссылка на Google]]. Адреса электронной почты
 +тоже распознаются:​ <​andi@splitbrain.org>​.</​code>​
 +
 +==== Внутренние ====
 +
 +Внутренние ссылки создаются посредством квадратных скобок.
 +Можно либо просто указать [[ru:​pagename|имя страницы]],​ либо
 +дополнительно прописать [[ru:​pagename|текст ссылки]]. Имена
 +вики-статей автоматически ​ переводятся в нижний регистр,​
 +спецсимволы использовать нельзя.
 +
 +<​code>​Внутренние ссылки создаются посредством квадратных скобок.
 +Можно либо просто указать [[ru:​pagename]],​ либо
 +дополнительно прописать [[ru:​pagename|текст ссылки]]. Имена
 +вики-статей автоматически ​ переводятся в нижний регистр,​
 +спецсимволы использовать нельзя.</​code>​
 +
 +Можно использовать в ссылке [[ru:​namespaces|пространства имён]] через двоеточие.
 +
 +<​code>​Можно использовать в ссылке [[ru:​namespaces|пространства имён]] через двоеточие.</​code>​
 +
 +Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела,​ так же, как это делается в HTML. Ссылка на [[#​внутренние|этот раздел]].
 +
 +<​code>​Ссылка на [[#​внутренние|этот раздел]].</​code>​
 +
 +Примечания:​
 +
 +  * Ссылки на [[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>​
 +
 +Примечания:​
 +
 +  * Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»).
 +  * В браузерах Mozilla эту возможность можно включить с помощью опции [[http://​www.mozilla.org/​quality/​networking/​docs/​netprefs.html#​file|security.checkloaduri]],​ но делать это не рекомендуется.
 +  * Подробней читайте здесь: [[bug>​151]].
 +
 +==== Картинки-ссылки ====
 +
 +Совместив синтаксис ссылки и [[#​картинки и другие файлы|картинки]],​ можно вставить в текст картинку,​ которая будет внутренней или внешней ссылкой:​
 +
 +<​code>​[[http://​www.php.net/​|{{wiki:​dokuwiki-128.png}}]]</​code>​
 +
 +[[http://​www.php.net/​|{{wiki:​dokuwiki-128.png}}]]
 +
 +Учтите:​ форматирование картинок --- это единственная синтаксическая конструкция,​ которую можно использовать в тексте ссылки.
 +
 +==== Сноски ====
 +
 +С помощью двойных скобок можно добавить сноску((Сноска — помещаемые внизу страницы примечание,​ ссылка,​ перевод.)).
 +
 +<​code>​С помощью двойных скобок можно добавить сноску((Сноска —
 +помещаемые внизу страницы примечание,​ ссылка,​ перевод.)).</​code>​
 +
 +===== Разбивка на разделы =====
 +
 +Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков,​ автоматически создаётся список содержимого. Его можно отключить,​ вставив в документ строку %%~~NOTOC~~%%.
 +
 +
 +==== Заголовок 3 уровня ====
 +=== Заголовок 4 уровня ===
 +== Заголовок 5 уровня ==
 +
 +<​code>​==== Заголовок 3 уровня ====
 +=== Заголовок 4 уровня ===
 +== Заголовок 5 уровня ==</​code>​
 +
 +Четыре и более тире преобразуются в горизонтальную черту:
 +
 +----
 +
 +===== Картинки и другие файлы =====
 +
 +См. также: «[[ru:​images|Работа с изображениями и медиафайлами]]».
 +
 +С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[ru:​images|картинки]]. По желанию можно указать их размер.
 +
 +Нормальный размер: ​                       {{wiki:​dokuwiki-128.png}}
 +
 +Отмасштабированная до заданной ширины: ​   {{wiki:​dokuwiki-128.png?​50}}
 +
 +Отмасштабированная до заданных размеров: ​ {{wiki:​dokuwiki-128.png?​200x50}}
 +
 +Отмасштабированная внешняя картинка: ​     {{http://​de3.php.net/​images/​php.gif?​200x50}}
 +
 +<​code>​
 +Нормальный размер: ​                       {{wiki:​dokuwiki-128.png}}
 +Отмасштабированная до заданной ширины: ​   {{wiki:​dokuwiki-128.png?​50}}
 +Отмасштабированная до заданных размеров: ​ {{wiki:​dokuwiki-128.png?​200x50}}
 +Отмасштабированная внешняя картинка: ​     {{http://​de3.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,​ jpeg, png''​),​ оно будет отображаться в виде ссылки.
 +
 +Узнать,​ как вставить картинку со ссылкой можно в [[#​картинки-ссылки|разделе выше]].
 +
 +===== Списки =====
 +
 +«Докувики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка,​ поставьте в начале строки два пробела и потом звёздочку (*) в случае маркированного списка,​ или дефис (-) --- в случае нумерованного.
 +
 +  * Первый элемент маркированного списка
 +    * Второй элемент списка
 +      * Можно сделать вложенный список
 +    * Ещё один элемент
 +
 +  - Тот же список,​ только нумерованный
 +    - Ещё элемент
 +      - Чем больше пробелов в начале,​ тем глубже вложенность
 +    - Всё просто
 +
 +<​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]]''​.
 +
 +===== Таблицы =====
 +
 +«Докувики» поддерживает упрощённый синтаксис создания таблиц.
 +
 +^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
 +| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        |
 +| Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту) ​ ||
 +| Ряд 3 Колонка 1  | Ряд 2 Колонка 2     | Ряд 2 Колонка 3        |
 +
 +Обычные ряды должны начинаться и заканчиваться вертикальной чертой --- %%|%%, а заголовки «крышечкой» (циркумфлекс) — %%^%%.
 +
 +  ^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
 +  | Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        |
 +  | Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту) ​ ||
 +  | Ряд 3 Колонка 1  | Ряд 2 Колонка 2     | Ряд 2 Колонка 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 |
 +
 +Примечание:​ вертикальное выравнивание не поддерживается.
 +
 +===== Неформатируемые блоки =====
 +
 +Неформатируемые блоки можно вставлять в документ,​ либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах),​ либо используя тэги ''​%%<​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 =====
 +
 +[[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http://​simplepie.org/​|SimplePie]] is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:
 +
 +^ Параметр ​  ^ Описание ^
 +| any number | will be used as maximum number items to show, defaults to 8 |
 +| reverse ​   | display the last items in the feed first |
 +| author ​    | show item authors names |
 +| date       | show item dates |
 +| description| show the item description. If [[doku>​config:​htmlok|HTML]] is disabled all tags will be stripped |
 +| nosort ​    | do not sort the items in the feed |
 +| //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |
 +
 +The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:​DokuWiki]] will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells [[wiki:​DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered.
 +
 +By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the ''​reverse''​ parameter, or display the feed as is with ''​nosort''​.
 +
 +**Example:​**
 +
 +  {{rss>​http://​slashdot.org/​index.rss 5 author date 1h }}
 +
 +{{rss>​http://​slashdot.org/​index.rss 5 author date 1h }}
 +
 +
 +===== Управляющие макросы =====
 +
 +Некоторый синтаксис влияет на то, как «Докувики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:​
 +
 +^ Макрос ​         ^ Описание ​     |
 +| %%~~NOTOC~~%% ​  | Если этот макрос присутствует в статье,​ оглавление не будет создано. ​ |
 +| %%~~NOCACHE~~%% | «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например,​ когда выше был использован синтаксис %%<​php>​%%),​ добавление этого макроса заставит «Докувики» обрабатывать статью при каждом вызове. ​ |
 +
 +===== Синтаксические плагины =====
 +
 +Синтаксис «Докувики» может быть расширен за счёт [[ru:​plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте:
 +
 +~~INFO:​syntaxplugins~~
wiki/sintaksis_formatirovanija.1583858052.txt.gz · Последние изменения: 2020/10/10 15:38 (внешнее изменение)