Содержание
Синтаксис форматирования
В DokuWiki существует некий простой язык разметки, предназначенный для улучшения восприятия при чтении статей. На этой странице рассмотрены все возможные формы синтаксиса. Представления о них можно получить нажав на кнопку Показать исходный текст сверху или снизу. Для баловства и экспериментов есть специальная испытательная площадка. Также разметку можно легко вставлять в текст с помощью панели быстрых кнопок.
Основные виды форматирования
Есть полужирный, курсив, подчеркнутый и моноширинный
способы оформления текста. Естественно, можно их все комбинировать
.
Есть **полужирный**, //курсив//, __подчеркнутый__ и ''моноширинный'' способы оформления текста. Естественно, можно их все **__//''комбинировать''//__**.
Можно использовать подстрочный и надстрочный текст. А еще зачеркнутый.
Можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> текст. А еще <del>зачеркнутый</del>.
Параграфы создаются переводом каретки. Для создания разрыва строки без параграфа необходимо использовать две обратных косых, стоящих либо перед пробелом, либо в конце строки.
Это какой-то текст с разрывами строк
Обратите внимание:
две обратных косых распознаются только в конце строк
или перед
пробелом \\; после пробела этого не происходит.
Это какой-то текст с разрывами строк\\ Обратите внимание: две обратных косых распознаются только в конце строк\\ или перед\\ пробелом \\; после пробела этого не происходит.
Разрыв строки рекомендуется использовать только в случаях крайней необходимости.
Ссылки
Внешние
Внешние ссылки распознаются автоматически: http://www.tolkien.su или даже www.tolkien.su - Ссылкам можно назначать заголовок: Мир Зелёного Солнца. Адреса email также распознаются: vasya@pupkin.org.
Внешние ссылки распознаются автоматически: http://www.tolkien.su или даже www.tolkien.su - Ссылкам можно назначать заголовок: [[http://www.tolkien.su|Мир Зелёного Солнца]]. Адреса email также распознаются: <vasya@pupkin.org>.
Внутренние
Внутренние ссылки обрамляются квадратными скобками. Можно просто указать имя_страницы или добавить заголовок. Имена wiki-страниц преобразуются в нижний регистр автоматически, спецсимволы не поддерживаются.
Внутренние ссылки обрамляются квадратными скобками. Можно просто указать [[имя_страницы]] или добавить [[имя_страницы|заголовок]]. Имена wiki-страниц преобразуются в нижний регистр автоматически, спецсимволы не поддерживаются.
имя_страницы можно указать при помощи двоеточия.
[[Название_категории:имя_страницы]] можно указать при помощи двоеточия.
Подробнее о внутренних ссылках см. wiki:namespaces.
Ссылки по разделам страницы также возможны. Просто добавьте имя раздела после знака «диез». Эта ссылка ведет на этот раздел.
Эта ссылка ведет на [[syntax#внутренние|этот раздел]].
Примечания:
- Ссылки на существующие страницы внешне отличаются от ссылок на несуществующие.
- DokuWiki does not use CamelCase to automatically create links by default, but this behaviour can be enabled in the wiki:config file. Hint: If DokuWiki is a link, then it's enabled.
- При изменении заголовка раздела изменяется и его якорь, поэтому не злоупотребляйте такими ссылками.
Interwiki
DokuWiki поддерживает Interwiki-ссылки - специальные ссылки на другие вики. Например, это ссылка на страничку Википедии, посвященной вики: Wiki.
DokuWiki поддерживает [[doku>wiki:interwiki|Interwiki]]-ссылки - специальные ссылки на другие вики. Например, это ссылка на страничку Википедии, посвященной вики: [[wp>Wiki]].
Ссылки-изображения
Картинки в качестве внутренних или внешних ссылок используются посредством комбинирования конструкций для ссылок и картинок (см. ниже):
[[http://www.tolkien su|{{wiki:dokuwiki-128.png}}]]
Обратите внимание: форматирование внутри ссылочных конструкций работает только с изображениями.
Сноски
Сноски 1) создаются с помощью двойных круглых скобок.
Сноски ((Это сноска)) создаются с помощью двойных круглых скобок.
Разделы
Существуют пять уровней структуризации. Если на странице более трех разделов, то содержание формируется автоматически (это можно запретить, включив в текст специальную метку ~~NOTOC~~
.
Заголовок 3
Заголовок 4
Заголовок 5
==== Заголовок 3 ==== === Заголовок 4 === == Заголовок 5 ==
Горизонтальная линия ставится с помощью четырех (или более) дефисов, идущих подряд:
Картинки и прочие файлы
Картинки могут быть также внутренние и внешние. Оформляются фигурными скобками. Опционально можно указать разрешение.
Аналогично с внешней картинкой:
Оригинальное разрешение: {{wiki:dokuwiki-128.png}} Изменение размера по ширине: {{wiki:dokuwiki-128.png?50}} По ширине и высоте: {{wiki:dokuwiki-128.png?200x50}} Аналогично с внешней картинкой: {{http://de3.php.net/images/php.gif?200x50}}
Пробелы служат для указания выравнивания.
{{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }}
И конечно вы можете добавить заголовок (отображаемый большинством браузеров как всплывающая подсказка).
{{ wiki:dokuwiki-128.png |Это заголовок}}
Если вместо картинки (gif, jpeg, png
) в фигурных скобках был указан другой файл, то он отображается просто в виде ссылки.
Списки
Dokuwiki поддерживает маркированные и нумерованные списки. Строка списка создается с помощью отступа в два пробела и символа *
(для маркированных) или -
(для нумерованных).
- Это список
- Вторая строка
- Многоуровневая структура
- И так далее
- Нумерованный список
- Вторая строка
- Для следующего уровня используется отступ еще на два пробела
- Вот и всё
* Это список * Вторая строка * Многоуровневая структура * И так далее - Нумерованный список - Вторая строка - Для следующего уровня используется отступ еще на два пробела - Вот и всё
Смайлики
DokuWiki преобразовывает основные виды текстовых смайлов в их графические эквиваленты.
8-)
8-O
:-(
:-)
=)
:-/
:-\
:-?
:-D
:-P
:-O
:-X
:-|
;-)
^_^
:?:
:!:
LOL
FIXME
DELETEME
Спецсимволы
DokuWiki может преобразовать набор простых символов в их специальные аналоги. Пример:
→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® «ЧП 'Рога-и-Копыта'»
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "ЧП 'Рога-и-Копыта'"
Цитирование
Давайте насвинячим здесь! > Чёта я очкую, Димоон >> Не сцы, баклан > А вдруг прийдет злобный модер? >> Да ты лошааара >>> Бу-га-га!
Давайте насвинячим здесь!
> Чёта я очкую, Димоон
» Не сцы, баклан
> А вдруг прийдет злобный модер?
» Да ты лошааара
»> Бу-га-га!
Таблицы
DokuWiki поддерживает простые таблицы.
Заголовок 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 |
Примечание: Вертикальное объединение ячеек (строк) не работает.
Используя как минимум два пробела подряд можно выравнивать содержимое таблицы: два пробела слева для выравнивания по правому краю, два пробела справа для выравнивания по левому краю и по два пробела с обеих сторон для выравнивания по центру.
Таблица с выравниванием | ||
---|---|---|
право | центр | лево |
лево | право | центр |
xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Это исходник:
^ Таблица с выравниванием ^^^ | право| центр |лево | |лево | право| центр | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Неформатируемый текст
Можно вставлять блоки с неформатированным текстом, делая отступ с минимум двумя пробелами (как в предыдущем примере) или с помощью тэгов code
или file
.
Это неотформатированный текст, все пробелы показываются как есть: типа <-так
Это почти то же самое, но для цитирования какого-нибудь файла.
Чтобы парсер проигнорировал просто часть строки (т.е. не форматировал её), нужно обрамить нужную часть тэгом nowiki
или двойными знаками %%
.
Какой-то текст с линком http://www.tolkien.su и **форматированием**, которое, как вы видите, не работает.
Подсветка синтекса
DokuWiki может раскрашивать сырцы используя GeSHi Generic Syntax Highlighter – так что любой язык, поддерживаемый GeSHi, поддерживается и вики. Синтаксис такой же, как в болках с кодом (см. предыдущий пример), но в этом случае имя используемого языка вставляется в тэг: <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. } }
Распознаются такие идентификаторы языков: actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, cpp-qt, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, plsql, python, qbasic, rails, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml, xpp, z80