Дополнения реализуются подключаемыми модулями-плагинами.
Красиво оформляет цитату в тексте. Добавляет кнопку в виде двойной кавычки на панель инструментов.
В отличии от стандартной разметки dokuwiki для цитат (при помощи символов »>»), содержимое цитаты может содержать любую вики-разметку, которая воспринимается так же хорошо, как и вне цитаты. Также допустимы вложенные цитаты.
Плагин предоставляет в ваше распоряжение две дополнительные пары тэгов -- blockquote
и cite
.
Цитата позволяет дополнительно указать источник цитирования, который можно расположить в открывающем тэге <blockquote>
. Тэг cite
был создан, чтобы позволить добавлять более сложную разметку (включая ссылки, форматированный текст и т.п.) в качестве источника цитирования.
Следующий код
<blockquote> Проверим работу разметки... Ещё один абзац с маленькой [[http://никуда|ссылкой]] в никуда. Кстати, пока мы здесь, как насчёт немного **жирного**, //курсивного// и __подчёркнутого__ текста? И, наконец, списки: * пункт 1 * пункт 1.1 * пункт 1.2 * пункт 2 - нумерованный пункт 2.1 - нумерованный пункт 2.2 - нумерованный пункт 2.2.1 * пункт 3 Работает :-) </blockquote>
возвращает
Проверим работу разметки…
Ещё один абзац с маленькой ссылкой в никуда. Кстати, пока мы здесь, как насчёт немного жирного, курсивного и подчёркнутого текста? И, наконец, списки:
пункт 1
пункт 1.1 пункт 1.2 пункт 2
нумерованный пункт 2.1 нумерованный пункт 2.2
нумерованный пункт 2.2.1 пункт 3Работает
Следующий код
<blockquote J. Random Hacker>Проверка свойств цитаты...</blockquote>
возвращает
Проверка свойств цитаты…
Следующий код
<blockquote>Проверка команды cite...<cite>J. Random Hacker, [[http://localhost/~jrhacker]]</cite></blockquote>
возвращает
Проверка команды cite…
J. Random Hacker, http://localhost/~jrhacker
Плагин помещает красиво оформленные прямоугольники в текст, позволяя выделить важные части текста. Плагин позволяет создавать простые прямоугольники, прямоугольники со скругленными углами, прямоугольники с заголовками и прямоугольники разной ширины. Разметка DokuWiki распознаётся внутри прямоугольника, где она неплохо выглядит; внутри заголовка допускается только текстовая разметка, ссылки и смайлики.
Простой прямоугольник:
<box>содержимое прямоугольника</box>
Более сложные прямоугольники:
<box 80% round orange|заголовок>содержимое прямоугольника</box>
заголовок
<box 50% left blue>содержимое прямоугольника</box|подпись>
Текст, текст, просто текст. Текст, текст, просто текст. Текст, текст, просто текст. Текст, текст, просто текст. Текст, текст, просто текст. Текст, текст, просто текст. Текст, текст, просто текст. Текст, текст, просто текст. Текст, текст, просто текст. Текст, текст, просто текст. Текст, текст, просто текст. Текст, текст, просто текст.
<box 60% round #f99 #fc9 #fcc #f60|заголовок>содержимое прямоугольника</box|подпись>
заголовок
Полный синтаксис:
<box ширина классы цвета | текст заголовка> текст содержимого </box | текст подписи>
Открывающий тэг <box … >
, включая заголовок, должен располагаться на одной строке. Содержимое прямоугольника может располагаться на любом необходимом количестве строк.
Плагин в действии можно посмотреть здесь. На этой странице отображаются все возможные стили.
Плагин позволяет раскрасить текст и фон в произвольный цвет. Не добавляет кнопку на панель инструментов.
<color цвет текста/цвет фона>произвольный текст</color>
Цвет можно задавать одним из трёх способов:
#RGB
или #RRGGBB
, где R
, G
, B
— шестнадцатеричные цифры (0-F). R
определяет красную компоненту цвета, G
— зелёную, B
— синюю. Цвет получается смешиванием этих трёх компонент. Например, #F8F даёт ярко-фиолетовый цвет.rgb(красный, зелёный, синий)
(значения каждой компоненты должно быть в диапазоне от 0 до 255) или rgb(красный%, зелёный%, синий%)
(значения каждой компоненты должно быть в диапазоне от 0% до 100%). Предыдущий пример в этом виде можно записать как rgb(255,128,128)
или rgb(100%,50%,100%)
.Вы можете выбрать цвет из таблицы цветов.
Можно указывать одновременно оба цвета (как текста, так и фона), но можно и один, по необходимости.
<color blue/lightgrey>синий текст на светло-сером фоне</color>
синий текст на светло-сером фоне
<color blue>синий текст на обычном фоне</color>
синий текст на обычном фоне
<color /lightgrey>обычный текст на светло-сером фоне</color>
обычный текст на светло-сером фоне
Этот маленький плагин позволяет вам оставлять заметки себе (и другим авторам вашей вики) в исходном вики-коде страниц. Эти заметки не видны на вики-странице. Синтаксис сходен с C и PHP:
Текст /* между слэш-астериск и астериск-слэш */ скрыт.
Даёт:
Текст скрыт.
Также вы можете использовать многострочные комментарии:
/** * @todo: переписать этот раздел, чтобы отразить изменения, сделанные ранее * * это длинная заметка */
Но этот однострочный пример также работает:
/********** добавлено Esther **********/
Позволяет вставлять в вики-разметку списки определений. Это один из нескольких плагинов подобного рода, но он отличается простым синтаксисом.
Список определений создаётся из одной и более строк в формате, показанном ниже:
; термин : определение ; второй термин : второе определение
Отметьте, что должно быть два пробела в начале каждой строки.
Строки могут использоваться в любом порядке. Единственным требованием является то, что список должен начинаться с одной из двух строк (показанных выше), начинающихся с точки с запятой »;». Список заканчивается полностью пустой строкой.
Небольшая разница по сравнению со стандартными списками DokuWiki состоит в том, что вы можете использовать переход на новую строку в вики-разметке. Данные с новой строки добавляются в конец предыдущей строки при обработке списков определения.
Здесь вы можете увидеть плагин в действии.
Данный плагин позволяет на странице сворачивать и разворачивать содержимое, которое может быть как фрагментом абзаца, так и блоком текста.
Встроенное в абзац:
Это пример ++текста | с частью, которую вы можете увидеть только развернув её++. И после этого текст просто продолжает абзац.
Это пример текста . И после этого текст просто продолжает абзац.
Блочное:
Это пример текста. ++++ Заголовок | | Эта таблица | видна только тогда, | когда вы развернёте блок | {{page>Другая вики-страница}} ++++
Это пример текста.
Плагин обеспечивает красивый показ клавиатурных сочетаний. Добавляет кнопку в виде клавиатуры на панель инструментов.
Заключите имя клавиши или комбинации клавиш (разделённых дефисом (-)) в тэг <key>...</key>
, например так:
<key>клавиша</key> или <key>C-x</key>
key
разделяется сиволом - (дефис).C
становится Ctrl
, Left
становится ←
и т.п.C
становится Strg
и Del
становится Entf
. На данный момент поддерживаются только английский и немецкий языки. Вы можете свободно написать дополнительные языковые файлы и послать их для включения в будущие версии плагина.Minus
.<key>C-A-del</key>
)<key>C - c</key>
)<key>C-x</key>
)<key>C-v</key>
)<key>C-enter</key>
)<key>C-S-Right</key>
)<key>C-S-Left</key>
)<key>C-PageUp</key>
)<key>C-Minus</key>
)<key>'любую клавишу'</key>
)Позволяет вставлять в текст красиво оформленные заметки. Добавляет на панель инструментов 4 кнопки (заметка, лампочка, восклицательный знак, знак 'стоп!').
<note> Это моя заметка! Запомните её! </note>
<note important> Внимание! Похоже, Вы лишились ума ;-) </note>
<note tip> Ключ к пониманию --- в картинках. </note>
<note warning> Остерегайтесь злую собаку, когда открываете дверь! </note>