• Онлайн: 2
−Содержание
Синтаксис форматирования
«Докувики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «песочницу». Простую разметку также можно легко сделать с помощью панели инструментов.
Основные конструкции форматирования
«Докувики» поддерживает выделение текста жирным шрифтом, курсивом, подчёркнутый текст и вывод текста моноширинным шрифтом
. Все эти конструкции можно объединить
.
«Докувики» поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**.
Также можно использовать подстрочный и надстрочный индексы.
Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.
Ещё можно зачеркнуть текст.
Ещё можно <del>зачеркнуть текст</del>.
Абзацы отбиваются пустой строкой. Если нужно принудительно вставить перенос строки, не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке.
Просто текст с разрывом строк
Обратите внимание,
что два обратных слэша действуют только в конце строки
или если за ними стоит
пробел. Если его не поставить, \\получится вот так.
Просто текст с разрывом строк\\ Обратите внимание, что два обратных слэша действуют только в конце строки\\ или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.
Принудительные переносы следует использовать только в случае крайней необходимости.
А ещё текст можно прятать, если он большой или чтобы не сразу было видно:
Ссылки
Ссылки в «Докувики» бывают разные и создавать их можно тоже по-разному.
Внешние
Внешние ссылки распознаются автоматически: 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>.
Внутренние
Внутренние ссылки создаются посредством квадратных скобок. Можно либо просто указать имя страницы, либо дополнительно прописать текст ссылки. Имена вики-статей автоматически переводятся в нижний регистр, спецсимволы использовать нельзя.
Внутренние ссылки создаются посредством квадратных скобок. Можно либо просто указать [[ru:pagename]], либо дополнительно прописать [[ru:pagename|текст ссылки]]. Имена вики-статей автоматически переводятся в нижний регистр, спецсимволы использовать нельзя.
Можно использовать в ссылке пространства имён через двоеточие.
Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.
Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на этот раздел.
Ссылка на [[#внутренние|этот раздел]].
Примечания:
- Ссылки на существующие статьи отображаются иначе, чем ссылки на несуществующие.
- Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.
- Ссылки на разделы делаются именно на разделы.
Интервики
«Докувики» поддерживает интервики-ссылки. Это короткие ссылки на другие вики. Например, вот ссылка на статью Википедии о вики: Wiki.
«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки на другие вики. Например, вот ссылка на статью Википедии о вики: [[wpru>Wiki]].
Сетевые ресурсы Windows
Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, что такие ссылки имеют смысл только в гомогенных группах пользователей, например в корпоративном интранете.
Ссылки на сетевые ресурсы вида \\server\share тоже распознаются.
Примечания:
- Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»).
- В браузерах Mozilla эту возможность можно включить с помощью опции security.checkloaduri, но делать это не рекомендуется.
- Подробней читайте здесь: 151.
Картинки-ссылки
Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:
[[http://www.php.net/|{{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}} Отмасштабированная внешняя картинка: {{https://ru.wikipedia.org/static/images/project-logos/ruwiki-2x.png?100}}
Поставив слева или справа пробел, можно задать выравнивание картинки:
{{wiki:dokuwiki-128.png }} — картинка слева {{ wiki:dokuwiki-128.png }} — посередине {{ wiki:dokuwiki-128.png}} — справа
И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).
{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}
Если задать имя файла (внутреннее или внешнее), который не является картинкой (gif, jpeg, png
), оно будет отображаться в виде ссылки.
Узнать, как вставить картинку со ссылкой можно в разделе выше.
Списки
«Докувики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом звёздочку (*) в случае маркированного списка, или дефис (-) — в случае нумерованного.
- Первый элемент маркированного списка
- Второй элемент списка
- Можно сделать вложенный список
- Ещё один элемент
- Тот же список, только нумерованный
- Ещё элемент
- Чем больше пробелов в начале, тем глубже вложенность
- Всё просто
* Первый элемент маркированного списка * Второй элемент списка * Можно сделать вложенный список * Ещё один элемент - Тот же список, только нумерованный - Ещё элемент - Чем больше пробелов в начале, тем глубже вложенность - Всё просто
Многострочные списки элементов
Как я могу добавить блок кода или несколько строк в элемент списка?
Синтаксис списка ожидает, что Вы поместите каждый элемент в одну строку и Вы не можете прерывать нумерованные списки или индекс такого списка начнется с единицы. Это делает невозможным, например, добавлять таблицы в элемент списка. Тем не менее, Вы можете добавить code/file блок или перенос строки в элемент списка. Для блоков кода убедитесь, что они начинаются на той же строке, что и Ваш элемент, для переноса строки используйте форсированный перенос строки
\\
.
Пример:
- Первый элемент - Второй элемент с переносом строки\\ вторая строка - Третий элемент с тэгом code: <code> Немного кода здесь </code> - Четвертый элемент
Это будет выглядеть следующим образом:
- Первый элемент
- Второй элемент с переносом строки
вторая строка - Третий элемент с тэгом code:
Немного кода здесь
- Четвертый элемент
Вы можете использовать этот трюк, чтобы включить в список другой синтаксис, например таблицы, используя плагин wrap.
Смайлики
«Докувики» переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию smiley
и добавить их в файл conf/smileys.local.conf
. Вот смайлики, которые есть в «Докувики»:
8-)
8-O
:-(
:-)
=)
:-/
:-\
:-?
:-D
:-P
:-O
:-X
:-|
;-)
^_^
:?:
:!:
:+:
:err:
LOL
FIXME
DELETEME
:YES:
:NO:
Типографские символы
«Докувики» может переделывать символы, набранные простым текстом, в их типографски корректные эквиваленты. Распознаются следующие символы.
→ ← ↔ ⇒ ⇐ ⇔ » « – — '640×480' © ™ ® …
«Александр Сергеевич™ — это наше всё © не я»
-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ... "Александр Сергеевич(tm) --- это наше всё (c) не я"
Примечание: это конвертирование можно отключить в файле конфигурации conf/entities.conf
.
Таблицы
«Докувики» поддерживает упрощённый синтаксис создания таблиц.
Заголовок 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 |
Можно сделать вертикально объединённые ячейки добавлением трёх двоеточий :::
в объединяемые нижележащие ячейки.
Заголовок 1 | Заголовок 2 | Заголовок 3 |
---|---|---|
Ряд 1 Колонка 1 | эта ячейка объединена вертикально | Ряд 1 Колонка 3 |
Ряд 2 Колонка 1 | Ряд 2 Колонка 3 | |
Ряд 3 Колонка 1 | Ряд 2 Колонка 3 |
В этих ячейках не должно быть ничего, кроме синтаксиса объединения (:::
).
^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | Ряд 1 Колонка 1 | эта ячейка объединена вертикально | Ряд 1 Колонка 3 | | Ряд 2 Колонка 1 | ::: | Ряд 2 Колонка 3 | | Ряд 3 Колонка 1 | ::: | Ряд 2 Колонка 3 |
Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа — если надо выравнять влево, и по два с каждой стороны — если по центру.
Таблица с выравниванием | ||
---|---|---|
вправо | по центру | влево |
влево | вправо | по центру |
xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
^ Таблица с выравниванием ^^^ | вправо| по центру |влево | |влево | вправо| по центру | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Примечание: вертикальное выравнивание не поддерживается.
А саму таблицу можно отцентрировать вот так:
Таблица с выравниванием | ||
---|---|---|
вправо | по центру | влево |
влево | вправо | по центру |
xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
<html><center></html> ^ Таблица с выравниванием ^^^ | вправо| по центру |влево | |влево | вправо| по центру | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | <html></center></html>
Неформатируемые блоки
Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах), либо используя тэги <code>
или <file>
.
<cоde>Это неформатированный текст, в котором сохранены все пробелы: вот <- так.</cоde> <file txt myexample.txt>А так можно дать возможность скачать весь текст в виде файла</file>
Результат:
Это неформатированный текст, в котором сохранены все пробелы: вот <- так.
- myexample.txt
А так можно дать возможность скачать весь текст в виде файла
Чтобы парсер полностью проигнорировал некий текст (т. е. не форматировал его), либо заключите его в тэги nowiki
, либо ещё проще — в двойные знаки процента %%
.
Это просто текст, в котором есть адрес http://www.splitbrain.org/ и **форматирование** — но ничего не происходит.
Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%% и %%**форматирование**%% --- но ничего не происходит.
Чтобы увидеть, как используются эти блоки, смотрите код статьи.
Подсветка синтаксиса
«Докувики» может подсвечивать программный код, чтобы его было проще читать. Для этого используется библиотека GeSHi — соответственно подсвечиваются все языки, поддерживаемые 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. } }
На данный момент распознаются следующие языки:
4cs | abap | actionscript-french | actionscript |
actionscript3 | ada | apache | applescript |
asm | asp | autoconf | autohotkey |
autoit | avisynth | awk | bash |
basic4gl | bf | bibtex | blitzbasic |
bnf | boo | c | c_mac |
caddcl | cadlisp | cfdg | cfm |
chaiscript | cil | clojure | cmake |
cobol | cpp | cpp-qt | csharp |
css | cuesheet | d | dcs |
delphi | diff | div | dos |
dot | ecmascript | eiffel | |
erlang | fo | fortran | freebasic |
fsharp | gambas | genero | genie |
gdb | glsl | gml | gnuplot |
groovy | gettext | gwbasic | haskell |
hicest | hq9plus | html | icon |
idl | ini | inno | intercal |
io | j | java5 | java |
javascript | jquery | kixtart | klonec |
klonecpp | latex | lisp | locobasic |
logtalk | lolcode | lotusformulas | lotusscript |
lscript | lsl2 | lua | m68k |
magiksf | make | mapbasic | matlab |
mirc | modula2 | modula3 | mmix |
mpasm | mxml | mysql | newlisp |
nsis | oberon2 | objc | ocaml-brief |
ocaml | oobas | oracle8 | oracle11 |
oxygene | oz | pascal | pcre |
perl | perl6 | per | pf |
php-brief | php | pike | pic16 |
pixelbender | plsql | postgresql | povray |
powerbuilder | powershell | progress | prolog |
properties | providex | purebasic | python |
q | qbasic | rails | rebol |
reg | robots | rpmspec | rsplus |
ruby | sas | scala | scheme |
scilab | sdlbasic | smalltalk | smarty |
sql | systemverilog | tcl | teraterm |
text | thinbasic | tsql | typoscript |
unicon | vala | vbnet | vb |
verilog | vhdl | vim | visualfoxpro |
visualprolog | whitespace | winbatch | whois |
xbasic | xml | xorg_conf | xpp |
z80 |
Скачиваемые блоки кода
Используя тэги <code>
или <file>
, как показано выше, вы можете сделать отображаемый код доступным для загрузки. Для этого определите имя файла после кода языка вот так:
<file php myexample.php> <?php echo "hello world!"; ?> </file>
- myexample.php
<?php echo "hello world!"; ?>
Если вам не нужна подсветка, но нужен загружаемый файл, поставьте прочерк (-
) на месте кода языка: <code - myfile.foo>
.
Особенность: при написании имени файла на русском языке для формирования корректного имени файла обрамляйте название файла двойными кавычками например «Фоо Бар.php».
- "Фоо Бар.php"
<?php echo "hello world!"; ?>
Вставка HTML и PHP
Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов html
2) и php
:
Тут вставлен <html><font color="red">html-код</font></html> внутри строки.
Тут вставлен html-код внутри строки.
А тут вставлен <HTML><font color="green">блок HTML-кода</font></HTML> внутри текста.
А тут вставлен
внутри текста.
<php> echo 'Логотип, сгенерированный PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />'; </php>
Примечание: по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде.
Управляющие макросы
Некоторый синтаксис влияет на то, как «Докувики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:
Макрос | Описание |
---|---|
~~NOTOC~~ | Если этот макрос присутствует в статье, оглавление не будет создано. |
~~NOCACHE~~ | «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синтаксис <php>), добавление этого макроса заставит «Докувики» обрабатывать статью при каждом вызове. |
Дополнительные плагины
Химические формулы
C2H5OH C2H5O2-Na+ Cl2H6N2Pt2+
<chem>C2H5OH C2H5O2|-Na+ Cl2H6N2Pt2+</chem>
ISBN
~~isbn:978-5-04-111759-7~~
Раскраска ячеек таблиц
Header 1 | Header 2 | Header 3 |
---|---|---|
Span | ||
Ligne 1 | Oui | Oui, à valider |
Ligne 2 | Oui | Oui |
Ligne 3 | Oui | Non |
^ Header 1 ^ Header 2 ^ Header 3 ^ | @lightgreen:**Span** || | | @#6495ed:Ligne 1 | Oui | Oui, à valider | | Ligne 2 | Oui | @orange: Oui | | @:Ligne 3 | Oui | @red:Non |
Validé | À valider | Non fonctionnel |
| @palegreen:Validé | @orange:À valider | @red:Non fonctionnel |
Синтаксические плагины
Синтаксис «Докувики» может быть расширен за счёт плагинов. Как их устанавливать и использовать — описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте:
- asciimathml plugin 2011-06-23 — Mohammad Rahmani
ASCIIMathML is an easy way of writing mathematics to go on the web. - Chem plugin 2017-10-19 — Ikuo Obataya
Format chemical formula in DokuWiki. Example: <chem>H+ + OH- <-> H2O</chem> - Cloud Plugin 2023-02-11 — Michael Hamann, Michael Klier, Gina Haeussge
Displays the most used words in a word cloud. - Column List Plugin Sat, Feb 03, 2007 — Tom N Harris
Display a list of items formatted as columns. Syntax: <tab>, ... Default formatting is 4 columns. Add ~~COL:<num>~~ before the first item to change this. - description plugin 2012-07-02 — Ikuo Obataya, Matthias Schulte
Add a specified string to a description meta header - feedaggregator plugin 2015-12-17 — Sam Wilson
A DokuWiki plugin for aggregating multiple news feeds onto a single wiki page. - Gallery Plugin 2023-09-03 — Andreas Gohr
Creates a gallery of images from a namespace or RSS/ATOM feed - Color Highlight Plugin 2013-10-24 — Joseph Nahmias
Highlight text with a specific color - Syntax: <hi color>highlighted content</hi> - Indexmenu Plugin 2022-08-01 — Samuele Tognini
Show a customizable and sortable index for a namespace - ISBN Plugin 2012-01-24 — NoZDR
Пределывает ISBN в ссылку на страницу поиска книги через Wiki - keyboard 2023-02-23 — Gina Häußge
The keyboard plugin provides a combined syntax and action plugin in order to markup text as keyboard keys, similar to (and making use of) the existing (X)HTML tag <kbd>…</kbd>. A quick button for the markup is automatically inserted into the toolbar of the edit form. - MediaList Plugin 2016-08-24 — Satoshi Sahara
show a list of media files referred in a given page or stored in a given namespace. - nFilelist Plugin 2013-01-13 — NoZDR
Делает список файлов указанной директории. - nGallery Plugin 2023-09-03 — Andreas Gohr
Creates a gallery of images from a namespace or RSS/ATOM feed - Note Plugin 2020-06-28 — Olivier Cortès, Eric Hameleers, Christopher Smith, Aurélien Bompard, LarsDW223
Add Note/Important/Tip/Warning Capability (DIV+CSS box) - The Number of Online Plugin 2019-11-19 — HokkaidoPerson
Export the current number of those who is browsing your wiki, in plain text. This plugin is ported from that of PukiWiki (with some customizing). - Pagelist Plugin 2023-08-27 — Matthias Schulte, Michael Hamann, Michael Klier, Gina Haeussge
Lists pages in a nice formatted way - PhotoGallery Plugin 2023-06-25 — Anna Dabrowska, Marco Nolletti
Creates a gallery of images from a namespace - rss 2017-11-17 — Algorys
display rss feed in your wiki - Tag Plugin 2023-09-10 — Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
tag wiki pages
html
— для строчного кода; HTML
— для блочного кода