Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
wiki:syntax [27.10.2016 14:40] admin |
— (текущий) | ||
---|---|---|---|
Строка 1: | Строка 1: | ||
- | ====== Синтаксис форматирования ====== | ||
- | DokuWiki поддерживает язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании страниц. Если хотите поупражняться, используйте [[playground:playground|песочницу]]. Простую разметку также можно легко сделать с помощью панели инструментов (открывается в режиме редактирования страницы) | ||
- | |||
- | ===== Основные конструкции форматирования ===== | ||
- | |||
- | DokuWiki поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчеркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**. | ||
- | |||
- | <code> | ||
- | DokuWiki поддерживает выделение текста | ||
- | **жирным шрифтом**, | ||
- | //курсивом//, | ||
- | __подчеркниванием текста__ | ||
- | и вывод текста ''моноширинным шрифтом''. | ||
- | Все эти конструкции можно **__//''объединить''//__**. | ||
- | </code> | ||
- | |||
- | Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы. | ||
- | |||
- | <code> | ||
- | Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы. | ||
- | </code> | ||
- | |||
- | Ещё можно <del>зачеркнуть текст</del>. | ||
- | |||
- | <code> | ||
- | Ещё можно <del>зачеркнуть текст</del>. | ||
- | </code> | ||
- | |||
- | |||
- | ===== Ссылки ===== | ||
- | |||
- | Ссылки в DokuWiki бывают разные, и создавать их можно тоже по-разному. | ||
- | |||
- | ==== Внешние ==== | ||
- | |||
- | Внешние ссылки распознаются автоматически: http://www.google.com или | ||
- | просто www.google.com --- также можно указывать текст ссылки: | ||
- | [[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты | ||
- | тоже распознаются: <andi@splitbrain.org>. | ||
- | {{:dokuwiki-128.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|{{dokuwiki-128.png}}]]</code> | ||
- | |||
- | [[http://www.php.net|{{dokuwiki-128.png}}]] | ||
- | |||
- | Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки. | ||
- | |||
- | ===== Сноски ===== | ||
- | |||
- | С помощью двойных скобок можно добавить сноску((Это сноска)). | ||
- | |||
- | <code>С помощью двойных скобок можно добавить сноску ((Это сноска)).</code> | ||
- | |||
- | ===== Разбивка на разделы ===== | ||
- | |||
- | Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков 3-го уровня и выше, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку %%~~NOTOC~~%%. | ||
- | |||
- | |||
- | |||
- | ==== Заголовок 3-го уровня ==== | ||
- | === Заголовок 4-го уровня === | ||
- | == Заголовок 5-го уровня == | ||
- | |||
- | <code>==== Заголовок 3-го уровня ==== | ||
- | === Заголовок 4-го уровня === | ||
- | == Заголовок 5-го уровня ==</code> | ||
- | |||
- | Четыре и более тире преобразуются в горизонтальную черту: | ||
- | |||
- | ---- | ||
- | \\ | ||
- | |||
- | <code> | ||
- | ---- | ||
- | </code> | ||
- | |||
- | |||
- | ===== Картинки и другие файлы ===== | ||
- | |||
- | С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[doku>wiki:images|картинки]]. По желанию можно указать их размер. | ||
- | |||
- | Нормальный размер: {{dokuwiki-128.png}} | ||
- | |||
- | Отмасштабированная до заданной ширины: {{dokuwiki-128.png?50}} | ||
- | |||
- | Отмасштабированная до заданных размеров:{{dokuwiki-128.png?200x50}} | ||
- | |||
- | Отмасштабированная внешняя картинка: {{http://de3.php.net/images/php.gif?200x50}} | ||
- | |||
- | <code> | ||
- | Нормальный размер: {{dokuwiki-128.png}} | ||
- | Отмасштабированная до заданной ширины: {{dokuwiki-128.png?50}} | ||
- | Отмасштабированная до заданных размеров: {{dokuwiki-128.png?200x50}} | ||
- | Отмасштабированная внешняя картинка: {{http://de3.php.net/images/php.gif?200x50}} | ||
- | </code> | ||
- | |||
- | Поставив слева или справа пробел можно задать выравнивание картинки: | ||
- | |||
- | {{dokuwiki-128.png }} | ||
- | {{ dokuwiki-128.png}} | ||
- | {{ dokuwiki-128.png }} | ||
- | |||
- | <code>{{dokuwiki-128.png }} | ||
- | {{ dokuwiki-128.png}} | ||
- | {{ dokuwiki-128.png }} | ||
- | </code> | ||
- | |||
- | И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки). | ||
- | |||
- | {{ dokuwiki-128.png |Название картинки}} | ||
- | |||
- | <code>{{ dokuwiki-128.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 может подсвечивать <hi>программный код</hi>, чтобы его было проще читать. Для этого используется библиотека [[http://qbnz.com/highlighter/|GeSHi]] — соответственно подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в блоке ''code'' в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например %%<code java>%%. | ||
- | <code> | ||
- | <hi>текст</hi> | ||
- | </code> | ||
- | <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 | ||
- | |||
- | , 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~~ | ||
- | |||
- | ===== Выделение цветом (маркер) ===== | ||
- | |||
- | Текст можно выделять цветом. | ||
- | <hi>Цвет по умолчанию</hi> может быть заменён на какой-либо другой, | ||
- | например <hi red>красный</hi> или <hi lightblue>голубой</hi>. | ||
- | |||
- | <code> | ||
- | Текст можно выделять цветом. | ||
- | <hi>Цвет по умолчанию</hi> может быть заменён на какой-либо другой, | ||
- | например <hi red>красный</hi> или <hi lightblue>голубой</hi>. | ||
- | </code> | ||
- | |||
- | ===== Форматирование химических формул ===== | ||
- | |||
- | С помощью плагина **chem** простые химические формулы форматируются автоматически, например: <chem>10C2H5OH, 2H3PO4, Al(OH)3, Fe3+, 15[Cat]3|2+[Anion]2|3-, 238^Pu, N0, N+1, N-3, e-</chem> | ||
- | |||
- | <chem>10C2H5OH, 2H3PO4, Al(OH)3, Fe3+, 15[Cat]3|2+[Anion]2|3-, 238^Pu, N0, N+1, N-3, e-</chem> | ||
- | |||
- | |||
- | |||
- | ===== Заметки ===== | ||
- | |||
- | Плагин **Note** позволяет легко оформлять всевозможные комментарии и заметки: | ||
- | |||
- | <note>обычная заметка </note> | ||
- | <note tip>заметка-подсказка</note> | ||
- | <note important>важная заметка</note> | ||
- | <note warning>заметка-предупреждение</note> | ||
- | |||
- | <code> | ||
- | <note>обычная заметка</note> | ||
- | <note tip>заметка-подсказка</note> | ||
- | <note important>важная заметка</note> | ||
- | <note warning>заметка-предупреждение</note> | ||
- | </code> | ||
- | |||
- | ссылка на плагин: [[http://www.dokuwiki.org/plugin:note]] |