Nixland.org

[[wiki:syntax]]

Вы посетили: » syntax

Авторизация

В данный момент вы не в системе. Авторизируйтесь при помощи следующей формы. Замечание: для работы у вас должны быть включены cookies.

Войти

У вас еще нет аккаунта? Извольте получить: Зарегистрироваться

Nixland.org

Valid XHTML 1.0 Transitional

Правила форматирования текста

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

Основные элементы форматирования текста

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

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

Текст может быть в нижнем и верхнем индексе.

Текст может быть в <sub>нижнем</sub> и <sup>верхнем</sup> индексе.

Также можно помечать текст как удаленный

Также можно помечать текст как <del>удаленный</del>

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

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

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

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

Ссылки

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

Внешние ссылки

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

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

Внутренние ссылки

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

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

В ссылке можно использовать namespaces (пространства имен), разделяя название пространства имен и название страницы двоеточием.

В ссылке можно использовать [[wiki:namespaces]] (пространства имен), разделяя название пространства имен и название страницы двоеточием.

Подробнее о пространствах имен можно узнать здесь.

Так же можно создать ссылку на определенный раздел на странице. Для этого нужно к ссылке добавить знак ‘#’ и название раздела, как это делается в HTML. Ссылка на этот раздел.

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

Примечания:

  • Ссылки на существующие страницы отображаються иначе, чем ссылки на несуществующие.
  • Если меняется название раздела, ссылки на него автоматически не меняются. Так что по возможности избегайте привязки ссылок к разделам страницы.

Interwiki

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

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

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

Любое изображение может выступать в качестве ссылки на внутреннюю или внешнюю страницу с помощью совмещения синтаксиса изображения и ссылки, как это сделано ниже:

[[http://www.nixland.org|{{wiki:dokuwiki-128.png}}]]

Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.

Сноски

Сноски могут быть добавлены с помощью двойных круглых скобок 1).

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

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

Типографские символы

DokuWiki может преобразовывать некоторые символы, набранные текстом, в их типографски корректные эквиваленты. Вот примеры таких символов:

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “He thought ‘It’s a man’s world’...”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

Цитирование

В некоторых случаях требуется оформить текст таким образом, чтобы показать, что это ответ на вопрос или комментарий. В таких случаях используется следующий метод:

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 Столбец 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        |

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

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

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

А так выглядит код:

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

Неформатируемые блоки

Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в предыдущих примерах), либо используя тэги code или file.

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

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

Это просто текст, в котором есть адрес http://www.splitbrain.org и **форматирование** --- но ничего не происходит.

Чтобы увидеть, как используются эти блоки, смотрите код страницы.

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

DokuWiki может подсвечивать исходный код для разных языков программирования, тем самым облегчая его чтение и понимание. Для этого используется библиотека GeSHi - то есть все языки, поддерживаемые ею, подсвечиваются в DokuWiki. Для подсветки используется тэг <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, actionscript-french, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, caddcl, cadlisp, c, c_mac, cfm, cpp, csharp, css, delphi, diff, d, div, dos, eiffel, freebasic, gml, html4strict, ini, inno, java, java5, javascript, lisp, lua, matlab, mpasm, mysql, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, scheme, sdlbasic, smarty, sql, tsql, robots, ruby, vb, vbnet, vhdl, visualfoxpro, xml.

1) 1
 
© 2006 Права принадлежат творческой группе Nixland.org