Warning: Call-time pass-by-reference has been deprecated in /home/exampleo/public_html/lib/plugins/result/ChempParser.php on line 31

Warning: Call-time pass-by-reference has been deprecated in /home/exampleo/public_html/lib/plugins/result/ChempParser.php on line 38

Warning: Call-time pass-by-reference has been deprecated in /home/exampleo/public_html/lib/plugins/result/ChempParser.php on line 147

Warning: Call-time pass-by-reference has been deprecated in /home/exampleo/public_html/lib/plugins/dir/syntax.php on line 428

Warning: Call-time pass-by-reference has been deprecated in /home/exampleo/public_html/lib/plugins/dir/syntax.php on line 436

Warning: Call-time pass-by-reference has been deprecated in /home/exampleo/public_html/lib/plugins/dir/syntax.php on line 509

Warning: Call-time pass-by-reference has been deprecated in /home/exampleo/public_html/lib/plugins/dir/syntax.php on line 571

Warning: Call-time pass-by-reference has been deprecated in /home/exampleo/public_html/lib/plugins/dir/syntax.php on line 711

Warning: Call-time pass-by-reference has been deprecated in /home/exampleo/public_html/lib/plugins/dir/syntax.php on line 718

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

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

Базовое форматирование текста

DokuWiki поддерживает жирный, курсивный, подчёркнутый and моноширинный тексты. Конечно же, вы можете их комбинировать.

DokuWiki поддерживает  **жирный**, //курсивный//, __подчёркнутый__
и ''моноширинный'' тексты.
Конечно же, вы можете их **__//''комбинировать''//__**.

Можно использовать верхние и нижние индексы.

Можно использовать <sup>верхние</sup> и <sub>нижние</sub> индексы.

Что-то можно помечать как удалённое.

Что-то можно помечать как <del>удалённое</del>.

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

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

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

Но используйте эту возможность, пожалуйста, только при крайней необходимости.

Ссылки

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

Внешние

Внешние ссылки распознаются автоматически: http://www.google.com и даже просто www.google.com - но вы можете дать им названия: Эта ссылка указывает на google. Адреса email в таком виде: andi [at] splitbrain [dot] org также распознаются.

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

Внутренние

Внутренние ссылки создаются при помощи квадратных скобок. Вы можно просто ввести wiki:pagename, или дополнительно указать текст ссылки. Названия страниц Wiki автоматически конвертируются в нижний регистр, и специальные символы не допускаются.

Внутренние ссылки создаются при помощи квадратных скобок. Вы можно просто ввести [[doku>wiki:pagename]],
или дополнительно указать [[doku>wiki:pagename|текст ссылки]]. Названия страниц Wiki автоматически
конвертируются в нижний регистр, и специальные символы не допускаются.

Вы можете использовать группы страниц, используя двоеточие в названии страницы.

Вы можете использовать [[doku>wiki:namespaces|группы страниц]], используя двоеточие в названии страницы.

Можно даже ссылаться на определённый раздел страницы. Просто добавьте знак диез # и название раздела после названия страницы, как в HTML. Вот эта ссылка ведёт этот раздел.

 Вот эта ссылка ведёт прямо на [[syntax#Внутренние|этот раздел]].

Примечания:

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

Interwiki

DokuWiki умеет делать Interwiki-ссылки. Это такие простые ссылки для связи с другими Wiki. Например, чтобы поставить ссылку на страницу в Википедии про то, что такое Wiki: Wiki.

DokuWiki умеет делать [[doku>wiki:interwiki|Interwiki]]-ссылки. Это такие
простые ссылки для связи с другими Wiki. Например, чтобы поставить ссылку
на страницу в Википедии про то, что такое Wiki: [[wp>Wiki]].

Ресурсы Windows

Также распознаются ресурсы Windows вида this. Это, правда, может быть полезно только для гомогенной группы пользователей, в зоне интрасети.

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

Замечания:

  • Из соображений безопасности, прямой просмотр ресурсов Windows по умолчанию работает только в Microsoft Internet Explorer (и то, только в «локальной зоне»).
  • Эту возможность в Mozilla Firefox можно включить в настройке security.checkloaduri, но это не рекомендуется делать.
  • Подробнее об этом можно почитать здесь.

Ссылки-изображения

Можно также сделать изображение, которое было бы ссылкой на другую внутреннюю или внешнюю страницу, объединяя синтаксис ссылок и изображений (см. ниже) вот таким образом:

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

Заметьте, что форматирование изображений - это единственный синтаксис фоматирования, который DokuWiki распознаёт внутри имён ссылок.

Поддерживаются все возможности синтаксиса для изображений и для ссылок, включая изменение размеров изображения, внешние и внутренние изображения, URL и ссылки Interwiki.

Сноски

Вы можете создавать сноски 1), используя двойные скобки.

Вы можете создавать сноски ((Вроде вот этой)), используя двойные скобки.

Разделы

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

Заголовок уровня 3

Заголовок уровня 4

Заголовок уровня 5
==== Заголовок уровня 3 ====
=== Заголовок уровня 4 ===
== Заголовок уровня 5 ==

Используя четыре или более тире 2), вы создаёте горизонтальную линию:


Изображения и другие файлы

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

Настоящий размер:

Подгон под заданную ширину:

Подгон под заданную ширину и высоту:

Подогнанная внешняя картинка:

Настоящий размер:                    {{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.confe. Список смайлов, которые распознаются DokuWiki:

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME 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:

Это - предварительно
 форматированный
  текст,
   Все
    пробелы
     остались                    на                месте
<code>
Это - предварительно
 форматированный
  текст,
   Все
    пробелы
     остались                    на                месте
</code>
Это то же самое, но чтобы специально показать, что вы вставили сюда содержимое файла
<file>
Это то же самое, но чтобы специально показать, что вы вставили сюда содержимое файла
</file>

Чтобы парсер просто проигнорировал область, либо заключите её в теги nowiki, либо в двойные проценты %%.

Этот текст содержит адреса http://www.splitbrain.org и **форматирование**, но они остались без именений.

<nowiki>
Этот текст содержит адреса http://www.splitbrain.org и **форматирование**, но они остались без именений.
</nowiki>

Подсветка синтаксиса

DokuWiki умеет подсвечивать синтаксис в исходных текстах программ, что облегчает их чтение. Для этого используется GeSHi Generic Syntax Highlighter – так что будет подсвечен любой язык, который поддерживается GeSHi. Синтаксис такой же как для блока 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.
    }
}

На данный момент, распознаются такие названия языков: 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.

RSS/ATOM Feed Aggregation

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:

Parameter Description
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 HTML is disabled all tags will be stripped
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. 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 }}

Embedding HTML and PHP

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 <font color="red" size="+1">HTML</font>
<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.

Плагины, расширяющие синтаксис

Синтаксис форматирования в DokuWiki может быть расширен плагинами. Как именно эти плагины использовать, написано в соответствующих местах на страницах описания плагинов. На данный момент, в DokuWiki установлены следующие плагины синтаксиса:

1) Вроде вот этой
2) Вот так: —-
wiki/syntax.txt · Последние изменения: 09.12.2007 16:43 (внешнее изменение)
www.chimeric.de Creative Commons License Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0