Синтаксис форматирования

DokuWiki поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании страниц. Просто посмотрите на исходный код этой странцы, нажав кнопку Править страницу вверху или внизу страницы. Если хотите поупражняться, используйте Песочницу. Простую разметку также можно легко сделать с помощью Панели инструментов.

DokuWiki поддерживает полужирное, курсивное, подчеркнутое начертания текста и моноширинный шрифт. Все эти конструкции можно комбинировать.

DokuWiki поддерживает **полужирное**, //курсивное//, __подчеркнутое__
начертания текста и ''моноширинный'' шрифт. Все эти конструкции можно
**__//''комбинировать''//__**.

Также можно использовать _{подстрочный} и ^{надстрочный} индексы.

Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.

Можно зачеркнуть текст.

Можно <del>зачеркнуть</del> текст.

Параграфы разделяются пустой строкой. Если нужно начать новую строку, не создавая параграф, вставьте два обратных слэша с пробелом или с переходом на новую строку.

Это просто текст с разрывом строки
Обратите внимание, что два обратных слэша действуют только в конце строки
или если за ними стоит
пробел. Если его не поставить, \\получится вот так.

Это просто текст с разрывом строки\\ Обратите внимание, 
что два обратных слэша действуют только в конце строки\\
или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.

Принудительные переносы следует использовать только в случае крайней необходимости.

Ссылки в DokuWiki бывают разные, и создавать их можно тоже по-разному.

Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com — также можно указывать текст ссылки: Это ссылка на Google. Адреса электронной почты тоже распознаются: andi@splitbrain.org.

Внешние ссылки распознаются автоматически: http://www.google.com или
просто www.google.com --- также можно указывать текст ссылки:
[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
тоже распознаются: <andi@splitbrain.org>.

Внутренние ссылки создаются посредством квадратных скобок. Можно либо просто указать имя страницы: syntax, либо дополнительно прописать текст ссылки: Синтаксис форматирования. Имена Wiki-страниц автоматически переводятся в нижний регистр, спецсимволы использовать нельзя.

Внутренние ссылки создаются посредством квадратных скобок.
Можно либо просто указать имя страницы: [[syntax]],
либо дополнительно прописать текст ссылки: [[syntax|Синтаксис форматирования]].
Имена Wiki-страниц автоматически переводятся в нижний регистр,
спецсимволы использовать нельзя.

В ссылке можно использовать Пространства имён через двоеточие.

В ссылке можно использовать [[doku>wiki:ru:namespaces|Пространства имён]] через двоеточие.

Можно задать ссылку на определённый раздел страницы. Просто добавьте через решётку имя раздела, также как это делается в HTML. Ссылка на Этот раздел.

Ссылка на [[syntax#Внутренние|Этот раздел]].

Примечания:

• Ссылки на существующие страницы отображаются иначе, чем ссылки на несуществующие.
• Внутренние ссылки без указания текста ссылки могут отображаться по разному, в зависимости от настроек — в качестве текста ссылки может использоваться название страницы или заголовок первого уровня. Так что лучше каждый раз указывать текст ссылки.
• DokuWiki по умолчанию не использует CamelCase для автоматического создания ссылок, но эту возможность можно включить в файле wiki:config. Проверка: Если DokuWiki — ссылка, значит эта возможность включена.
• Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.

DokuWiki поддерживает InterWiki-ссылки. Это короткие ссылки на другие Wiki. Например, вот ссылка на страницу Википедии о Вики: Вики.

Например, вот ссылка на страницу Википедии о Вики: [[wpru>Вики]].

Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, что такие ссылки имеют смысл только в гомогенных группах пользователей, например в корпоративном Интранете.

Ссылки на сетевые ресурсы вида [[\\server\share]] тоже распознаются.

Примечания:

• Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»).
• В Mozilla и Firefox эту возможность можно включить с помощью опции security.checkloaduri, но делать это не рекомендуется.
• Подробней читайте здесь: 151.

Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Please note: The image formatting is the only formatting syntax accepted in link names.
Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.

The whole image and link syntax is supported (including image resizing, internal and external images and URLs and interwiki links).

С помощью двойных скобок можно добавить сноску¹⁾.

С помощью двойных скобок можно добавить сноску((Это сноска)).

Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку ~~NOTOC~~.

==== Заголовок 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 поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом * в случае маркированного списка, или - в случае нумерованного.

• Это список
• Второй элемент списка
  • Можно сделать вложенный список
• Ещё один элемент

1. Тот же список, только нумерованный
2. Ещё элемент
   1. Чем больше пробелов в начале, тем глубже вложенность
3. Всё просто

  * Это список
  * Второй элемент списка
    * Можно сделать вложенный список
  * Ещё один элемент

  - Тот же список, только нумерованный
  - Ещё элемент
    - Чем больше пробелов в начале, тем глубже вложенность
  - Всё просто

DokuWiki показывает наиболее употребляемые смайлики в их графическом эквиваленте. Дополнительные смайлики можно положить в директорию smiley и внести изменения в файл conf/smileys.conf. Здесь представлены смайлики, которые включены в DokuWiki.

• 8-)
• 8-O
• :-(
• :-)
• =)
• :-/
• :-\
• :-?
• :-D
• :-P
• :-O
• :-X
• :-|
• ;-)
• ^_^
• :?:
• :!:
• LOL
• FIXME
• DELETEME

DokuWiki DokuWiki может переделывать символы, набранные простым текстом, в их типографски корректные эквиваленты. Распознаются следующие символы.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ®
«Он подумал: 'Это мужское общество'…»

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"Он подумал: 'Это мужское общество'..."

Примечание: Это конвертирование можно отключить в файле конфигурации (см. config option и pattern file).

Some times you want to mark some text to show it's a reply or comment. You can use the following syntax:

I think we should do it

> No we shouldn't

>> Well, I say we should

> Really?

>> Yes!

>>> Then lets do it!

I think we should do it

No we shouldn't

Well, I say we should

Really?

Yes!

Then lets do it!

DokuWiki поддерживает несложный синтаксис создания таблиц.

Обычные строки должны начинаться и заканчиваться символом |, а заголовки — ^.

^ Заголовок 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  |

Примечание: Вертикальное объединение (rowspan) не поддерживается.

Текст в ячейке таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа — если надо выравнять влево, и по два с каждой стороны — если по центру.

Так выглядит исходный текст:

^           Таблица с выравниванием        ^^^
|        вправо|   по центру  |влево         |
|влево         |        вправо|   по центру  |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

You can include non-parsed blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags code or file.

This is preformatted code all spaces are preserved: like              <-this

This is pretty much the same, but you could use it to show that you quoted a file.  

To let the parser ignore an area completely (ie. do no formatting on it), enclose the area either with nowiki tags or even simpler, with double percent signs %%.

This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.

See the source of this page to see how to use these blocks.

DokuWiki can highlight sourcecode, which makes it easier to read. It uses the GeSHi Generic Syntax Highlighter – so any language supported by GeSHi is supported. The syntax is the same like in the code block in the previous section, but this time the name of the used language is inserted inside the tag. Eg. <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.
    }
}

The following language strings are currently recognized: 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

DokuWiki can integrate data from external XML feeds. For parsing the XML feeds, 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:

The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. 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 DokuWiki to re-render the page if it is more than refresh period since the page was last rendered.

Example:

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

• Произошла ошибка при получении следующей новостной ленты: http://slashdot.org/index.rss

You can embed raw HTML or PHP code into your documents by using the html or php tags like this:

<html>
This is some <font color="red" size="+1">HTML</font>
</html>

This is some HTML

<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>

echo 'A logo generated by PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';

Please Note: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed.

Оформляет текст как заметку ( Выглядит по-разному в Explorer'е и Firefox'е)

• Использование плагина —

  <note>обычная заметка</note>
  <note tip>заметка-подсказка</note>
  <note important>важная заметка</note>
  <note warning>заметка-предупреждение</note>
  

DokuWiki's syntax can be extended by Plugins. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:

• Discussion Plugin (threads component) 2007-01-16 От Esther Brunner
  Displays a list of recently active discussions
• Info Plugin 2008-09-12 От Andreas Gohr
  Displays information about various DokuWiki internals
• Note Plugin 2006-03-29 От Olivier Cortès / Eric Hameleers / Christopher Smith
  Add Note/Important/Tip/Warning Capability (DIV+CSS box)