Содержание

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

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

Основные конструкции форматирования

«Докувики» поддерживает выделение текста жирным шрифтом, курсивом, подчёркнутый текст и вывод текста моноширинным шрифтом. Все эти конструкции можно объединить.

«Докувики» поддерживает выделение текста **жирным шрифтом**, //курсивом//, 
__подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''. 
Все эти конструкции можно **__//''объединить''//__**. 

Также можно использовать подстрочный и надстрочный индексы.

Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.

Ещё можно зачеркнуть текст.

Ещё можно <del>зачеркнуть текст</del>.

Выделение цветом (маркер)

Текст можно выделять цветом.
<wrap hi>выделить (маркер)</wrap>
<wrap lo>Пометить не важным</wrap> или же наоборот <wrap em>паметить важным</wrap>

Текст можно выделять цветом. выделить (маркер) Пометить не важным или же наоборот паметить важным

:!: Цветной текст при установленном плагине Color или Typography

plugin Color
<color green>text</color>
<color blue/lightgrey>text</color>
<color #FF0000>text</color>
<color /#FFff00>text</color>
<color rgb(80%,0%,0%)/rgb(100%,80%,100%)>text</color>
<color hsl(120,100%,30%):hsl(180,50%,90%)>text</color>
plugin Typography
<fc #800000>Maroon</fc>
<fc red>Aquamarine</fc>
<fc green>text</fc>
<fc #ffff00>Yellow</fc>
<fc #800000>Maroon</fc>
<fc #9400d3>Dark Violet</fc>
<fc rgb(80%,0%,0%)>text</fc>
<fc hsl(120,100%,30%)>text</fc>

и вы увидите что-то вроде этого:

Maroon Aquamarine text Yellow Maroon Dark Violet text text

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

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

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

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

Это огромный текст
зеленая заметка

Ссылки

Внешние

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

В данном экземпляре wiki внешние ссылки распознаются автоматически, но дефолтные иконки ссылок отключены: http://www.google.com или просто www.google.com — также можно указывать текст ссылки: Это ссылка на Google. Адреса электронной почты тоже распознаются: andi [at] splitbrain [dot] org. При необходимости используются иконки ссылок Интервики следующего вида ubuntu, www.hq.vevo.com или это ссылка на vevo и google, так же применяются иконкт ссылок в виде смайлов :&: См. подробнее wiki и Внешняя ссылка:&14: или rambler.ru ну и на конец Dokuwiki + Apache на GitHub

Внутренние

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

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

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

Можно использовать в ссылке [[:namespaces|пространства имён]] через двоеточие.

Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на этот раздел.

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

Примечания:

Интервики

«Докувики» поддерживает doku-ссылки. Это короткие ссылки на другие вики. Например, вот ссылка на статью Википедии о вики: Wiki, а это на ubuntu или на открыть страницу google или пустая на страницу интернета world
899256985
polskiyvn@gmail.com
Poliarniy
doku.php
github
gitlab
yandex.ru
google.ru

«Докувики» поддерживает [[doku>doku]]-ссылки. Это короткие ссылки
на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]], а это на [[ubuntu>ubuntu]] или на [[google>открыть страницу google]] или пустая на страницу интернета [[world>world]]

Изменить или назначить свои можно:

  1. Добавив иконку png или svg в папку lib/images/interwiki
  2. Добавив запись в conf/interwiki.conf
  3. пересохранив файл conf/local.php для очистки кеша

Сетевые ресурсы Windows

Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, что такие ссылки имеют смысл только в гомогенных группах пользователей, например в корпоративном интранете.

Ссылки на сетевые ресурсы вида \\server\share тоже распознаются.

Примечания:

Картинки-ссылки

Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:

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

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

Отключить иконки ссылок

Отключить значки у ссылок можно в файле _links.css или design.css в каталоге используемого вами шаблона lib\tpl\имя_шаблона\css. Для отключения отображения значков внешних ссылок достаточно закомментировать всю секцию external link

/* external link */
div.dokuwiki a.urlextern {
  background: transparent url(images/link_icon.gif) 0px 1px no-repeat;
  padding: 1px 0px 1px 16px;
}

Сноски

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

С помощью двойных скобок можно добавить сноску((Сноска —
помещаемые внизу страницы примечание, ссылка, перевод.)).

Разбивка на разделы

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

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

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

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

Четыре и более тире преобразуются в горизонтальную черту:


----

Картинки и другие файлы

См. также: «Работа с изображениями и медиафайлами».

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

Нормальный размер:
Отмасштабированная до заданной ширины:
Отмасштабированная до заданных размеров:
задать название Логотип «Blender»
— картинка слева
— справа
— посередине

Если задать имя файла (внутреннее или внешнее), который не является картинкой (gif, jpeg, png), оно будет отображаться в виде ссылки.

Узнать, как вставить картинку со ссылкой можно в разделе выше.

Списки

«Докувики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом звёздочку (*) в случае маркированного списка, или дефис (-) — в случае нумерованного.

  1. Тот же список, только нумерованный
    1. Ещё элемент
      1. Чем больше пробелов в начале, тем глубже вложенность
    2. Всё просто
  * Первый элемент маркированного списка
    * Второй элемент списка
      * Можно сделать вложенный список
    * Ещё один элемент

  - Тот же список, только нумерованный
    - Ещё элемент
      - Чем больше пробелов в начале, тем глубже вложенность
    - Всё просто

См. также FAQ по элементам списка.

Цитирование

Иногда нужно пометить некоторый текст в качестве ответа или комментария. Для этого можно использовать следующий синтаксис:

Я думаю, мы должны это сделать.
> Нет, мы не должны.
>> Ну, я говорю, что мы должны.
> Действительно?
>> Да!
>>> Тогда сделаем это!

Я думаю, мы должны это сделать.

Нет, мы не должны.
Ну, я говорю, что мы должны.

Действительно?

Да!
Тогда сделаем это!

Смайлики

«Докувики» переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию smiley и добавить их в файл conf/smileys.local.conf. Вот смайлики, которые есть в «Докувики»:

Можно расширить возможности данного расширения, своими смайликами или часто добавляемыми вставками, добавив в файл conf/smileys.local.conf картинки png:

:&ctrl+o: / :&ok: :&sbros: = :&dalee: и :&nazad: :&gal:

Иконки

icons code
{{:icons:16:hourglass-select.png?|Устаревший. Не для использования на новых web-сайтах.}} - Устаревший. Не для использования на новых web-сайтах.
{{:icons:16:flask.png?|Экспериментальный. Возможно изменение в будущем.}} - Экспериментальный. Возможно изменение в будущем.
{{:icons:16:jar.png?|Нестандартный. Проверьте поддержку браузером.}} - Нестандартный. Проверьте поддержку браузером.

Устаревший. Не для использования на новых web-сайтах. - Устаревший. Не для использования на новых web-сайтах.
Экспериментальный. Возможно изменение в будущем. - Экспериментальный. Возможно изменение в будущем.
Нестандартный. Проверьте поддержку браузером. - Нестандартный. Проверьте поддержку браузером.

icons text
{{:icons:16:book-open.png?|book-open.png.}} - book-open.png
{{:icons:16:tick.png?|tick.png}} - tick.png
icons text book-open.png. - {{:icons:16:book-open.png?|book-open.png.}}
book-open.png. - book-open.png book-open-bookmark.png - book-open-bookmark.png wand-hat.png - wand-hat.png balloon.png - balloon.png
exclamation--frame.png - exclamation–frame.png exclamation-red.png - exclamation-red.png information.png - information.png light-bulb-off.png - light-bulb-off.png
light-bulb.png - light-bulb.png magnifier-left.png - magnifier-left.png navigation-000-button-white.png - navigation-white.png notify.png - notify.png
pin.png - pin.png tick.png - tick.png tick-red.png - tick-red.png leaf.png - leaf.png
leaf-yellow.png - leaf-yellow.png leaf-red.png - leaf-red.png lightning.png - lightning.png box.png - box.png

Иконки Font Awesome

icons Font Awesome
{{fa>home?16|My Home}}{{fa>refresh?16&fa-spin}}
{{icon>home?24&circle&padding=10px&background=#DDD&color=#CCC}}
{{fa>home|My Home}}
{{fugue>user?24}}
{{flag>fr}}
{{silk>anchor}}
{{flag>ru}}
[[:wiki:welcome|{{fa>home?24|Welcome to DokuWiki}}]]
[[https://github.com/LotarProject/dokuwiki-plugin-icons|{{fa>github-square?24|Icons DokuWiki plugin on GitHub}}]] 
[[https://gitlab.com/|{{fa>gitlab?24|Icons DokuWiki plugin on GitLab}}]] 
[[https://github.com/|{{fa>github?24|Icons DokuWiki plugin on GitHub}}]] 
{{flag>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 |

Примечание: вертикальное выравнивание не поддерживается.

:!: С установленным плагином tablelayout.

Следующий пример синтаксиса сделает первую фиксированной и покажет около 2 других строк в прокручиваемом контейнере ниже. Это сделает первый столбец шириной 100 пикселей, а второй — 200 пикселей. Сам стол будет плавать вправо.

{{tablelayout?colwidth="100px,200px"&rowsHeaderSource=2&rowsVisible=2&float=left}}
^ header 1 ^ header 2 ^
| cell A1 | cell B1 |
| cell A2 | cell B2 |
| cell A3 | cell B3 |
header 1 header 2
cell A1 cell B1
cell A2 cell B2
cell A3 cell B3
{{tablelayout?colwidth="100px"}}
^ header 1 ^ header 2 ^
| cell A1 | cell B1 |
| cell A2 | cell B2 |
| cell A3 | cell B3 |
header 1 header 2
cell A1 cell B1
cell A2 cell B2
cell A3 cell B3

:!: С установленным плагином Cellbg.

Плагин фона ячейки. Позволяет определять ячейки фонового цвета, определяемые пользователем, в таблицах

^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^
| @lightgreen:**Диапазон** || |
| @#6495ed:Линия 1 | Да | Да, действительно |
| линия 2 | Да | @orange: Да |
| @:Линия 3 | Да | @red: Нет |
Заголовок 1 Заголовок 2 Заголовок 3
Диапазон
Линия 1 Да Да, действительно
линия 2 Да Да
Линия 3 Да Нет

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

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

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

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

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

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

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

Блоки и примечания

round box 570px center

  • box создаёт блок вокруг контейнера, по умолчанию используя цвета из файла шаблона style.ini (__background_alt__ и __text__);
  • любой из классов info, tip, important, alert, help, download, todo создаёт специальный контейнер с предупреждением, помеченным соответствующей иконкой;
  • для классов danger, warning, caution, notice, safety используются цвета сигнальной маркировки (без иконок);
  • round может добавляться к чему-угодно, имеющему цветную подложку или границу, однако работать такой код будет только в современных браузерах (не в Internet Explorer).

Дополнительные конфигурационные файлы находятся в /var/lib/dokuwiki/lib/tpl/dokuwiki (Debian), например style.ini. Style.ini – это текстовый файл, который считывается темой по умолчанию, и пользователь может настроить, например, цвет фона.

Информация Простой левосторонний блок на длину страницы

Простой левосторонний блок на 30%

Важно! Простой левосторонний блок на 60%

Предупреждение!

<WRAP alert></WRAP>

блок «Тревога»

<WRAP round help></WRAP>

Помощь

<WRAP round help></WRAP>

Скачать

<WRAP download></WRAP>

Список дел

<WRAP todo></WRAP>

Оповещения об опасности:

Опасность

<WRAP danger></WRAP>

Предупреждение

<WRAP warning></WRAP>

Осторожно!

<WRAP caution></WRAP>

Внимание!

<WRAP round notice></WRAP>

Безопасно

<WRAP round safety></WRAP>

Также блоки и примечания можно использовать внутри текстов со спанами, подобных этим: info, help, alert, important, tip, download, todo иround box, а также danger, warning, caution, notice, safety.

<wrap info>info</wrap>, <wrap help>help</wrap>, ...

См. подробнее о плагине Wrap

Блоки модифицированного плагина Note

:&12: желтая заметка
Свойства CSS margin используются для создания пространства вокруг элементов за пределами определенных границ. С CSS у вас есть полный контроль над полями. Существуют свойства для установки полей для каждой стороны элемента (сверху, справа, снизу и слева).
черная заметка с примером иконки и текста (Существуют свойства для установки полей для каждой стороны элемента (сверху, справа, снизу и слева))

См. подробнее о плагине Note

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

«Докувики» может программный код, чтобы его было проще читать. Для этого используется библиотека 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.
    }
}
«Список поддерживаемых языков»

~~COL:7~~

, 4cs
, **a**bap
, actionscript-french
, actionscript
, actionscript3
, ada
, apache
, applescript
, asm
, asp
, autoconf
, autohotkey
, autoit
, avisynth
, awk
, **b**ash
, 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
, **e**cmascript
, eiffel
, email
, erlang
, **f**o
, fortran
, freebasic
, fsharp
, **g**ambas
, genero
, genie
, gdb
, glsl
, gml
, gnuplot
, groovy
, gettext
, gwbasic
, **h**askell
, hicest
, hq9plus
, html
, **i**con
, idl
, ini
, inno
, intercal
, io
, **j**
, java5
, java
, javascript
, jquery
, **k**ixtart
, klonec
, klonecpp
, **l**atex
, lisp
, locobasic
, logtalk
, lolcode
, lotusformulas
, lotusscript
, lscript
, lsl2
, lua
, **m**68k
, magiksf
, make
, mapbasic
, matlab
, mirc
, modula2
, modula3
, mmix
, mpasm
, mxml
, mysql
, **n**ewlisp
, nsis
, **o**beron2
, objc
, ocaml-brief
, ocaml
, oobas
, oracle8
, oracle11
, oxygene
, oz
, **p**ascal
, pcre
, perl
, perl6
, per
, pf
, php-brief
, php
, pike
, pic16
, pixelbender
, plsql
, postgresql
, povray
, powerbuilder
, powershell
, progress
, prolog
, properties
, providex
, purebasic
, python
, **q**
, qbasic
, **r**ails
, rebol
, reg
, robots
, rpmspec
, rsplus
, ruby
, **s**as
, scala
, scheme
, scilab
, sdlbasic
, smalltalk
, smarty
, sql
, systemverilog
, **t**cl
, teraterm
, text
, thinbasic
, tsql
, typoscript
, **u**nicon
, **v**ala
, vbnet
, vb
, verilog
, vhdl
, vim
, visualfoxpro
, visualprolog
, **w**hitespace
, winbatch
, whois
, **x**basic
, xml
, xorg_conf
, xpp
, **z**80

Скачиваемые блоки кода

Используя тэги <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!"; ?>
  1. var de = function() {
  2. return (typeof(window.de) == 'object') ? window.de : {};
  3. }();
"Фоо Бар.php"
  1. var de = function() {
  2. return (typeof(window.de) == 'object') ? window.de : {};
  3. }();
  4. <?php echo "hello world!"; ?>
  1. var de = function() {
  2. return (typeof(window.de) == 'object') ? window.de : {};
  3. }();
<code php Lexer.php [enable_line_numbers="true", start_line_numbers_at="42",highlight_lines_extra="43"]>
void main () {
    printf ("Hello World!");
    exit(0);
}
</code>
Lexer.php
  1. void main () {
  2. printf ("Hello World!");
  3. exit(0);
  4. }
  1. var de = function() {
  2. return (typeof(window.de) == 'object') ? window.de : {};
  3. }();

Вставка HTML и PHP

Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов html и php. Используйте заглавные буквы для блочных элементов.

<html>
Тут вставлен <font color="red" size="+1">код HTML</font>
</html>
 
<HTML>
<p style="border:2px dashed red;">И здесь блочная вставка HTML</p>
</HTML>

Получается:

Тут вставлен HTML-код

И здесь блочная вставка HTML


<php>
echo 'Версия PHP: ';
echo phpversion();
echo ' (прямая вставка в HTML).';
</php>

<PHP>
echo '<table class="inline"><tr><td>То же самое — в элементе блочного уровня:</td>';
echo '<td>'.phpversion().'</td>';
echo '</tr></table>';
</PHP>

Получается:

Версия PHP: 8.2.21 (прямая вставка в HTML).

То же самое — в элементе блочного уровня:8.2.21

Примечание: по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде.

Вставка видео

{{video.mp4|}}    block 
{{video.mp4 |}}   left
{{ video.mp4 |}}  center
{{ video.mp4|}}   right
{{video.mp4?200x50|}} [widht]x[height]
{{video.mp4?400x&:wiki:dokuwiki-128.png|}} preview image
{{video.mp4?400x&:wiki:dokuwiki-128.png|video}} alternate text

Вставка HTML страниц

:!: при установленном плагине htmlok

HTTP
<html>
<iframe height="350" style="width: 100%;" scrolling="no" title="Untitled" src="https://book51.ru" frameborder="no" loading="lazy" allowtransparency="true" allowfullscreen="true">
</iframe>
</html>

ROOT
<html>
<iframe height="350" style="width: 100%;" scrolling="no" title="Untitled" src="https://media.wwoss.ru/view?m=imH9g8mYl" frameborder="no" loading="lazy" allowtransparency="true" allowfullscreen="true">
</iframe>
</html>

Wiki
<html>
<iframe height="300" style="width: 100%;" scrolling="no" title="Untitled" src="./" frameborder="no" loading="lazy" allowtransparency="true" allowfullscreen="true">
</iframe>
</html>

HTML+CSS
<html>
<iframe height="350" style="width: 100%;" scrolling="no" title="Untitled" src="./demo/code-docs/pages/getting_started/getting_started_em.html" frameborder="no" loading="lazy" allowtransparency="true" allowfullscreen="true">
</iframe>
</html>

HTML+CSS+JavaScript
<html>
<iframe height="350" style="width: 100%;" scrolling="no" title="Untitled" src="./demo/code-docs/pages/js/playground.html" frameborder="no" loading="lazy" allowtransparency="true" allowfullscreen="true">
</iframe>
</html>

Диаграммы

:!: При установленном плагине diagram

<diagram>
| | | Dad |y| Mom | | |Dad=Папа|Mom=Мама
| |,|-|-|-|+|-|-|-|.| |
| Sys | |  Me | | Bro |Sys=Сестра|Bro=Брат
| |,|-|-|-|(||||| |
| AAA |-| BBB |AAA=<fc #22b14c>**примеры**</fc>|BBB=1<sup>st</sup> верхний //регистр// и <del>ссылка</del> (see [[wp>Branch]])
| |:| | | | | |
| |L|~|~| CCC |CCC=2<sub>nd</sub> <fc #ed1c24>нижний регистр</fc>\\ **(жирный текст)**
</diagram>
Папа Мама
Сестра Me Брат
примеры 1st верхний регистр и ссылка (see Branch)
2nd нижний регистр
(жирный текст)
<diagram>
| AAA | | | | |F|~|~|~|7| |AAA{border-color:blue;background-color:lightgreen}=Border is blue,\\ background is lightgreen
| |!| | | | | CCC | | DDD |CCC{border-color:#a9c}=Border is #a9c,\\ background is transparent|DDD{border-color:silver;background-color:silver;}=Border is silver,\\ background is silver
| BBB | | | | | | | | | | |BBB{border-color:rgb(0%,50%,0%);background-color:#abcdef}=Border is green,\\ background is #abcdef
</diagram>


Border is blue,
background is lightgreen
Border is #a9c,
background is transparent
Border is silver,
background is silver
Border is green,
background is #abcdef

Диаграмма без рамки с картинками

<diagram>
|AAA||AAA{text-align:left;border-color:white}={{fa>folder?}} Handler
|)|BBB|BBB{text-align:left;border-color:white}={{fa>file?}} AbstractRewriter.php
|)|CCC|CCC{text-align:left;border-color:white}={{fa>file?}} Block.php
|)|DDD|DDD{text-align:left;border-color:white}={{fa>file?}} Lists.php
|)|EEE|EEE{text-align:left;border-color:white}={{fa>file?}} Nest.php
|)|FFF|FFF{text-align:left;border-color:white}={{fa>file?}} ReWriterInterface.php
|)|GGG|GGG{text-align:left;border-color:white}={{fa>file?}} Table.php
|)|KKK|KKK{text-align:left;border-color:white}={{fa>file?}} CallWriter.php
|)|LLL|LLL{text-align:left;border-color:white}={{fa>file?}} CallWriterInterface.php
|)|MMM|MMM{text-align:left;border-color:white}={{fa>file?}} Preformatted.php
|`|NNN|NNN{text-align:left;border-color:white}={{fa>file?}} Quote.php
</diagram>
Handler
AbstractRewriter.php
Block.php
Lists.php
Nest.php
ReWriterInterface.php
Table.php
CallWriter.php
CallWriterInterface.php
Preformatted.php
Quote.php

Звезды

:!: При установленном плагине Stars2

{{stars>num}}
{{stars>}}
{{stars>-1/5}}
{{stars>-5/5}}
{{stars>1/5}}
{{stars>2/5}}
{{stars>3/5}}
{{stars>4/5}}
{{stars>5/5}}
{{stars>5.5/7}}
{{stars>700/1000}}


Скрытый текст

:!: При установленном плагине Details Tag

<details>
<summary>«Подробности»</summary>
Скрытый текст
</details>
«Подробности»

Скрытый текст

<details open>
<summary>«Подробности»</summary>
Скрытый текст
</details>
«Подробности»

Скрытый текст

:!: При установленном плагине StepByStep

Вот еще информация о последней книге, которую я прочитал.

…здесь можно писать много о содержании

Lorem ipsum dolor сидеть amet…

Duis autem vel eum iriure…

Ut wisi enim ad minim veniam, …

Мне это очень понравилось!


Название:1984
Автор:Оруэлл, Джордж

Начало:

Содержание content Конец

https://www.dokuwiki.org/plugin:stepbystep#table

Ширина столбцов таблицы

:!: При установленном плагине Tablelayout

{{tablelayout?colwidth="100px,200px"&rowsHeaderSource=2&rowsVisible=2&float=left}}
^ header 1 ^ header 2 ^
| cell A1 | cell B1 |
| cell A2 | cell B2 |
| cell A3 | cell B3 |
header 1 header 2
cell A1 cell B1
cell A2 cell B2
cell A3 cell B3

Меню-вкладки на странице

Содержимое 1... Lorem ipsum (/ˌlɔː.rəm ˈɪp.səm/ LOR-əm IP-səm) is a dummy or placeholder text commonly used in graphic design, publishing, and web development. Its purpose is to permit a page layout to be designed, independently of the copy that will subsequently populate it, or to demonstrate various fonts of a typeface without meaningful text that could be distracting.
Содержимое 2... Lorem ipsum dolor sit, amet consectetur adipisicing elit. Similique eaque iure debitis nostrum, vero ad totam ratione sequi! Suscipit, labore repellat cum soluta ullam dignissimos perspiciatis sequi rerum sapiente ex.
Содержимое 3... Lorem ipsum dolor sit, amet consectetur adipisicing elit. Similique eaque iure debitis nostrum, vero ad totam ratione sequi! Suscipit, labore repellat cum soluta ullam dignissimos perspiciatis sequi rerum sapiente ex.

RSS/ATOM Feed Aggregation

Агрегация каналов RSS/ATOM

Докувики может интегрировать данные из внешних XML-каналов. Для анализа XML-каналов, используется SimplePie. Все форматы, понятные SimplePie, также могут быть использованы в Докувики. Вы можете влиять на рендеринг с помощью нескольких дополнительных параметров, разделенных пробелами:

Параметр Описание
any number Отображается максимальное количество элиментов, по умолчанию 8
reverse Сначала отобразите последние элементы в ленте
author Показывать имена авторов элементов
date Показывать даты элиментов
description Покажите описание элиментов. Если HTML отключен, все теги будут удалены
nosort Не сортируйте элементы в ленте
n[dhm] Период обновления, где d=дни, h=часы, m=минуты. (например 12h = 12 часов).

Период обновления по умолчанию равен 4 часам. Любое значение ниже 10 минут будет рассматриваться как 10 минут. Докувики обычно пытается предоставить кэшированную версию страницы, очевидно, что это неуместно, когда страница содержит динамический внешний контент. Параметр указывает Докувики повторно отобразить страницу, если прошло больше периода обновления с момента последнего отображения страницы.

По умолчанию лента будет отсортирована по дате, сначала по самым новым элементам. Вы можете сначала отсортировать его по возрасту, используя параметр «reverse», или отобразить ленту как есть с «nosort».

Пример:

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

Управляющие макросы

Некоторый синтаксис влияет на то, как «Докувики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:

Макрос Описание
~~NOTOC~~ Если этот макрос присутствует в статье, оглавление не будет создано.
~~NOCACHE~~ «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синтаксис <php>), добавление этого макроса заставит «Докувики» обрабатывать статью при каждом вызове.


#Хештеги

Dokuwiki Синтаксис форматирования Форматирование текста в Dokuwiki <meta name=«description» content=«Узнайте о нестандартных способах форматирования текста в Dokuwiki»>

{{description>Узнайте о нестандартных способах форматирования текста в Dokuwiki}}

Синтаксические плагины

Синтаксис «Докувики» может быть расширен за счёт плагинов. Как их устанавливать и использовать — описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте:

1)
Сноска — помещаемые внизу страницы примечание, ссылка, перевод.