====== Синтаксис форматирования ====== В [[wiki:DokuWiki]] существует некий простой язык разметки, предназначенный для улучшения восприятия при чтении статей. На этой странице рассмотрены все возможные формы синтаксиса. Представления о них можно получить нажав на кнопку //Показать исходный текст// сверху или снизу. Для баловства и экспериментов есть специальная [[playground:playground|испытательная площадка]]. Также разметку можно легко вставлять в текст с помощью панели [[doku>wiki:quickbuttons|быстрых кнопок]]. ===== Основные виды форматирования ===== Есть **полужирный**, //курсив//, __подчеркнутый__ и ''моноширинный'' способы оформления текста. Естественно, можно их все **__//''комбинировать''//__**. Есть **полужирный**, //курсив//, __подчеркнутый__ и ''моноширинный'' способы оформления текста. Естественно, можно их все **__//''комбинировать''//__**. Можно использовать подстрочный и надстрочный текст. А еще зачеркнутый. Можно использовать подстрочный и надстрочный текст. А еще зачеркнутый. **Параграфы** создаются переводом каретки. Для создания **разрыва строки** без параграфа необходимо использовать две обратных косых, стоящих либо перед пробелом, либо в конце строки. Это какой-то текст с разрывами строк\\ Обратите внимание: две обратных косых распознаются только в конце строк\\ или перед\\ пробелом \\; после пробела этого не происходит. Это какой-то текст с разрывами строк\\ Обратите внимание: две обратных косых распознаются только в конце строк\\ или перед\\ пробелом \\; после пробела этого не происходит. Разрыв строки рекомендуется использовать только в случаях крайней необходимости. ===== Ссылки ===== ==== Внешние ==== Внешние ссылки распознаются автоматически: http://www.tolkien.su или даже www.tolkien.su - Ссылкам можно назначать заголовок: [[http://www.tolkien.su|Мир Зелёного Солнца]]. Адреса email также распознаются: . Внешние ссылки распознаются автоматически: http://www.tolkien.su или даже www.tolkien.su - Ссылкам можно назначать заголовок: [[http://www.tolkien.su|Мир Зелёного Солнца]]. Адреса email также распознаются: . ==== Внутренние ==== Внутренние ссылки обрамляются квадратными скобками. Можно просто указать [[имя_страницы]] или добавить [[имя_страницы|заголовок]]. Имена wiki-страниц преобразуются в нижний регистр автоматически, спецсимволы не поддерживаются. Внутренние ссылки обрамляются квадратными скобками. Можно просто указать [[имя_страницы]] или добавить [[имя_страницы|заголовок]]. Имена wiki-страниц преобразуются в нижний регистр автоматически, спецсимволы не поддерживаются. [[Название_категории:имя_страницы]] можно указать при помощи двоеточия. [[Название_категории:имя_страницы]] можно указать при помощи двоеточия. Подробнее о внутренних ссылках см. [[doku>wiki:namespaces]]. Ссылки по разделам страницы также возможны. Просто добавьте имя раздела после знака "диез". Эта ссылка ведет на [[syntax#внутренние|этот раздел]]. Эта ссылка ведет на [[syntax#внутренние|этот раздел]]. Примечания: * Ссылки на [[wiki:syntax|существующие страницы]] внешне отличаются от ссылок на [[wiki:несуществующие]]. * DokuWiki does not use [[wp>CamelCase]] to automatically create links by default, but this behaviour can be enabled in the [[doku>wiki:config]] file. Hint: If DokuWiki is a link, then it's enabled. * При изменении заголовка раздела изменяется и его якорь, поэтому не злоупотребляйте такими ссылками. ==== Interwiki ==== DokuWiki поддерживает [[doku>wiki:interwiki|Interwiki]]-ссылки - специальные ссылки на другие вики. Например, это ссылка на страничку Википедии, посвященной вики: [[wp>Wiki]]. DokuWiki поддерживает [[doku>wiki:interwiki|Interwiki]]-ссылки - специальные ссылки на другие вики. Например, это ссылка на страничку Википедии, посвященной вики: [[wp>Wiki]]. ==== Ссылки-изображения ==== Картинки в качестве внутренних или внешних ссылок используются посредством комбинирования конструкций для ссылок и [[#картинки_и_прочие_файлы|картинок]] (см. ниже): [[http://www.tolkien su|{{wiki:dokuwiki-128.png}}]] [[http://www.tolkien su|{{wiki:dokuwiki-128.png}}]] Обратите внимание: форматирование внутри ссылочных конструкций работает только с изображениями. ===== Сноски ===== Сноски ((Это сноска)) создаются с помощью двойных круглых скобок. Сноски ((Это сноска)) создаются с помощью двойных круглых скобок. ===== Разделы ===== Существуют пять уровней структуризации. Если на странице более трех разделов, то содержание формируется автоматически (это можно запретить, включив в текст специальную метку ''~~NOTOC~~''. ==== Заголовок 3 ==== === Заголовок 4 === == Заголовок 5 == ==== Заголовок 3 ==== === Заголовок 4 === == Заголовок 5 == Горизонтальная линия ставится с помощью четырех (или более) дефисов, идущих подряд: ---- ===== Картинки и прочие файлы ===== [[doku>wiki:images|Картинки]] могут быть также внутренние и внешние. Оформляются фигурными скобками. Опционально можно указать разрешение. Оригинальное разрешение: {{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?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}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} И конечно вы можете добавить заголовок (отображаемый большинством браузеров как всплывающая подсказка). {{ wiki:dokuwiki-128.png |Это заголовок}} {{ wiki:dokuwiki-128.png |Это заголовок}} Если вместо картинки (''gif, jpeg, png'') в фигурных скобках был указан другой файл, то он отображается просто в виде ссылки. ===== Списки ===== Dokuwiki поддерживает маркированные и нумерованные списки. Строка списка создается с помощью отступа в два пробела и символа ''*'' (для маркированных) или ''-'' (для нумерованных). * Это список * Вторая строка * Многоуровневая структура * И так далее - Нумерованный список - Вторая строка - Для следующего уровня используется отступ еще на два пробела - Вот и всё * Это список * Вторая строка * Многоуровневая структура * И так далее - Нумерованный список - Вторая строка - Для следующего уровня используется отступ еще на два пробела - Вот и всё ===== Смайлики ===== DokuWiki преобразовывает основные виды текстовых [[wp>emoticon|смайлов]] в их графические эквиваленты. * 8-) %% 8-) %% * 8-O %% 8-O %% * :-( %% :-( %% * :-) %% :-) %% * =) %% =) %% * :-/ %% :-/ %% * :-\ %% :-\ %% * :-? %% :-? %% * :-D %% :-D %% * :-P %% :-P %% * :-O %% :-O %% * :-X %% :-X %% * :-| %% :-| %% * ;-) %% ;-) %% * ^_^ %% ^_^ %% * :?: %% :?: %% * :!: %% :!: %% * LOL %% LOL %% * FIXME %% FIXME %% * DELETEME %% DELETEME %% ===== Спецсимволы ===== [[DokuWiki]] может преобразовать набор простых символов в их специальные аналоги. Пример: -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "ЧП 'Рога-и-Копыта'" -> <- <-> => <= <=> >> << -- --- 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]] может раскрашивать сырцы используя [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- так что любой язык, поддерживаемый GeSHi, поддерживается и вики. Синтаксис такой же, как в болках с кодом (см. предыдущий пример), но в этом случае имя используемого языка вставляется в тэг: ''''. /** * 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//