Энциклопедия Tolkien.su

Реклама на Tolkien.su. Хостинг не окупает, но пытается!




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

В 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 поддерживает маркированные и нумерованные списки. Строка списка создается с помощью отступа в два пробела и символа * (для маркированных) или - (для нумерованных).

  • Это список
  • Вторая строка
    • Многоуровневая структура
  • И так далее
  1. Нумерованный список
  2. Вторая строка
    1. Для следующего уровня используется отступ еще на два пробела
  3. Вот и всё
  * Это список
  * Вторая строка
    * Многоуровневая структура
  * И так далее

  - Нумерованный список
  - Вторая строка
    - Для следующего уровня используется отступ еще на два пробела
  - Вот и всё

Смайлики

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.

Это неотформатированный текст, все пробелы показываются как есть: типа              <-так
Это почти то же самое, но для цитирования какого-нибудь файла.  

Чтобы парсер проигнорировал просто часть строки (т.е. не форматировал её), нужно обрамить нужную часть тэгом 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

1) Это сноска
wiki/синтаксис.txt · Последние изменения: 2007/10/22 18:49 (внешнее изменение)
Реклама на Tolkien.su. Хостинг не окупает, но пытается!