worldwide open-source software - wiki:plugin

accscounter

anonymous@undisclosed.example.com (Anonymous) — Wed, 26 Mar 2025 20:02:17 +0000

Счетчик доступа и плагин популярности для «ДокуВики»

Совместим с «Докувики»

2024-02-06 "Kaos" да
2023-04-04 "Jack Jackrum" да
2022-07-31 "Igor" да
2020-07-29 "Hogfather" да

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

Последнее обновление:: 2020-06-11
Предоставляет: Syntax
Репозиторий: исходный код

Это расширение не находится в пространстве имен 'plugin' или 'template' и поэтому игнорируется.

Похож на top

Теги: counter, statistics, users

- HokkaidoPerson

Примечания

このページを日本語でご覧頂けます。(Эта страница также доступна на японском языке.)
Я не являюсь носителем английского языка, поэтому эта страница может содержать некоторые ошибки в английских предложениях.

Краткое содержание

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

Я портировал плагин Counter и плагин Popular из PukiWiki.¹⁾

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

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

Счетчик доступа

{{counter}} человек посетили эту страницу до сих пор.

Затем экспортируется как 15 person(s) visited this page until now. (если страницу посетило 15 посетителей).

Также вы можете ввести так:

К этой странице обращались:
Сегодня: {{counter|сегодня}} / Вчера: {{counter|вчера}}
До сих пор: {{counter|total}}

Другой пример:

{{counter|total| человек посетил эту страницу до сих пор.| люди посетили эту страницу до сих пор.}}

Посмотрите, как работает плагин

Посмотреть плагин в действии можно здесь (извините, но эта страница доступна только на японском языке).

Синтаксис

code.php

{{counter|argument|message A|message B}}

{{счетчик|аргумент|сообщение A|сообщение B}}

аргумент: today, yesterday, или total(по умолчанию)
сообщение A: текст, следующий за числом (когда число равно 0 или 1)
сообщение B: текст, следующий за числом (когда число равно 2 или больше)

{{POPULAR number argument blacklist}}

number: количество элементов, которые будут показаны
argument: today, yesterday, или allperiod (по умолчанию)
blacklist: страницы, которые не будут показаны в списке (разделить на |)

Менеджер данных

Вы можете выбрать «Диспетчер данных» в меню администратора вашей вики и легко просматривать и контролировать данные журнала!

Конфигурация и настройки

Вы можете изменить следующие настройки с помощью диспетчера конфигураций.

Параметры	Описание	Тип значения	Значение по умолчанию
`timezone`	Часовой пояс (используется для определения изменений даты. Если оставить поле пустым, будет использоваться часовой пояс, установленный на сервере. Идентификаторы, которые можно указать, указаны в «Списке поддерживаемых часовых поясов» в руководстве по PHP .)	Однострочная строка	²⁾
`excludeMgAndSp`	Учитывать ли менеджеров и суперпользователей (см. настройки «Менеджеры» и «Суперпользователи	`0` Выберите из выпадающего меню: (Количество), `sp` (Суперпользователи не учитываются), (Менеджеры (включая суперпользователей) не учитываются) `mg`	`0`
`exclusionList`	Исключенные IP-адреса/удалённые хосты Доступ с этих IP-адресов или удаленных хостов учитываться не будет. Используйте эту функцию, если у вас много роботов, получающих доступ с определенного IP-адреса или удаленного хоста. Удаленный хост получается путем обратного поиска IP-адреса (gethostbyaddr). Введите IP-адреса или удаленные хосты, которые необходимо исключить, по одному в каждой строке. Можно использовать следующие подстановочные знаки: ? = 1 символ (буквы и цифры половинной ширины, точка ».«, дефис »-«) * = 1 или более символов (буквы и цифры половинной ширины, точка ».«, дефис »-«) ! = 1 символ (только полуширинные числа) ~ = 1 или более символов (только полуширинные числа) Пример: «123.456.???.123» ⇒ 123.456.789.123 и т. д. (123.456.78.123 не исключается) Пример: «*.example.com» ⇒ 123.456.789.123.example.com, 1-2-3-4.rooter.example.com и т. д.	Текстовая область	³⁾
`usrExclusion`	Исключенные пользователи и группы пользователей Доступ от пользователей и пользователей, принадлежащих к указанным здесь группам пользователей, учитываться не будет. Введите пользователей или группы пользователей, которых следует исключить, разделив их запятыми.	Однострочная строка	⁴⁾
`cntrExclusion`	Исключенные страны Визиты из этих стран учитываться не будут. Используйте эту опцию, если у вас много роботов из определенной страны. Код страны получен из DNS-сервиса «cc.wariate.jp» (подробности на японском языке). Введите двухбуквенные коды стран (ISO 3166-1 alpha-2), разделенные запятыми.	Однострочная строка	⁵⁾
`cntrInclusion`	Указание стран для подсчета Если вы укажете страны с помощью этой опции, будут учитываться только посещения из этих стран. Код страны получен из DNS-сервиса «cc.wariate.jp» (подробности на японском языке). Введите двухбуквенные коды стран (ISO 3166-1 alpha-2), разделенные запятыми.	Однострочная строка	⁶⁾
`reverseLookupFailed`	Если обратный поиск IP → удаленный хост не удается, он будет исключен из счетчика (обратный поиск IP-адресов роботов часто отклоняется)	Булевы типы	`0`
`reverseLookupException`	IP-адреса, которые являются исключениями для параметра «reverseLookupFailed» выше Введите целевые IP-адреса, по одному в каждой строке. Можно использовать следующие подстановочные знаки: ? = 1 символ * = 1 или более символов Пример: «123.456.???.123» ⇒ 123.456.789.123 и т.д. (123.456.78.123 не исключается) Пример: «123.*.789.123» ⇒ 123.456.789.123, 123.9.789.123 и т.д.	Текстовая область	⁷⁾
`reverseLookupCntrException`	Исключения из параметра «reverseLookupFailed» выше: Код страны получен из DNS-сервиса «cc.wariate.jp» (подробности на японском языке). Введите двухбуквенные коды стран (ISO 3166-1 alpha-2), разделенные запятыми.	string	⁸⁾
`sfsExFreq`	Проверять ли показатель частоты IP-адреса посетителя и исключать спам из счетчика (требуется плагин Stopforumspam2). Введите «0», чтобы отключить проверку. Проверьте, не равно ли оно 0. Вы можете указать пороговое значение, специфичное для этой опции. Если ввести «-1», то в качестве базового значения будет использоваться значение, указанное в настройке «freqBorder» плагина Stopforumspam2, но если ввести значение больше 0, то это значение будет использоваться в качестве базового значения.	Числа (-1 или больше)	`0`
`sfsExConf`	Проверять ли рейтинг доверия IP-адреса посетителя и исключать его из счетчика спама (требуется плагин Stopforumspam2). Введите «0», чтобы отключить проверку. Проверьте, не равно ли оно 0. Вы можете указать пороговое значение, специфичное для этой опции. Если ввести «-1», в качестве контрольного значения будет использоваться значение, указанное в настройке «confidenceBorder» плагина Stopforumspam2, но если ввести значение больше 0 (меньше 100), это значение будет использоваться в качестве контрольного значения.	Числа (1-100)	`0`
`saveLog`	Запишите IP-адрес, дату и время доступа к Wiki. Журналы сохраняются для каждой страницы. Пожалуйста, используйте это при принятии решения о том, какие IP-адреса, удаленные хосты или страны следует исключить из счетчика. Файлы журнала хранятся в каталоге, называемом каталогом кэша (который по умолчанию находится в каталоге данных `accscounterlog`). При необходимости извлеките или удалите файлы.	`0` Выберите из выпадающего меню : (Не записывать), `ppage` (Записывать (Не разделять файлы по дате)), `pdate` (Записывать (Разделять файлы по дате))	`0`

разработка

История изменений

2018-07-02
Первоначальный выпуск
2018-07-17
Исправления ошибок (при работе плагина операции (запись журнала, отображение порядка популярности) иногда выполнялись в завтрашнюю дату)
2018-08-08
Исправлена ошибка (я совершил элементарную ошибку, пытаясь записать файл, не создав предварительно каталог)
2018-08-29
Добавление файла htaccess
2018-10-30
МАСШТАБНОЕ ОБНОВЛЕНИЕ! ! Добавлена функция черного списка и система хранения журналов.
2019-02-10
- Изменено место хранения данных плагина для обеспечения совместимости с плагинами, такими как farmer. Любые данные, оставшиеся в исходном месте хранения, можно переместить или удалить. Пожалуйста, ознакомьтесь с уведомлением, которое появляется после обновления плагина..
- Добавлен функционал с использованием плагина stopforumspam2.
2019-03-12
Чтобы упростить удаление плагинов, мы снова изменили место хранения данных плагинов . Любые данные, оставшиеся в исходном месте хранения, можно переместить или удалить. Пожалуйста, ознакомьтесь с уведомлением, которое появляется после обновления плагина.
Добавлен функционал менеджера данных.
2019-10-21
cntrInclusionДобавлены опции .
2019-11-07
Исправления ошибок.

Известные ошибки и проблемы

(В настоящее время нет)

Список дел и пожеланий

Я сделаю все возможное, если вы считаете, что это оставляет желать лучшего.

Неплохо было бы использовать форматирование CSS . В моем случае счетчик на широкой боковой панели выглядит плохо, номера страниц отображаются только на боковой панели под названием страницы, а не рядом с ней. Это не имеет никакого отношения к боковой панели. Может быть, конфликтует с форматированием боковой панели шаблона Bootstrap3?

Свяжитесь со мной

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

dosankomali@yahoo.co.jp
Мой Twitter (аккаунт на японском языке, но английский язык приемлем)

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Дополнения и Файлы

Лицензия

Author: HokkaidoPerson
License: GNU GPL v2

¹⁾

согласно лицензии оригинального плагина

²⁾ , ³⁾ , ⁴⁾ , ⁵⁾ , ⁶⁾ , ⁷⁾ , ⁸⁾

empty

actionlink

anonymous@undisclosed.example.com (Anonymous) — Tue, 03 Dec 2024 22:11:10 +0000

Actionlink plugin

Совместим с «Докувики»

Нет информации о совместимости!

Скачать

This plugin lets you use actionlinks in your wiki syntax. It's based on the DokuWiki's core function tpl_actionlink().

Предоставляет: Syntax

Это расширение не находится в пространстве имен 'plugin' или 'template' и поэтому игнорируется.

Теги: links

- nowotny

amazon

anonymous@undisclosed.example.com (Anonymous) — Tue, 03 Dec 2024 22:11:10 +0000

Amazon Plugin

More by Andi

Can't find any other plugins or templates

Совместим с «Докувики»

2009-02-14, LeMmings ,,

Display product information fetched from Amazon for single products or lists

Последнее обновление:: 2010-08-07
Предоставляет: Syntax
Репозиторий: исходный код

Это расширение не обновлялось более двух лет. Возможно, оно больше не разрабатывается или не поддерживается; возможны проблемы совместимости.

Это расширение не находится в пространстве имен 'plugin' или 'template' и поэтому игнорируется.

Похож на isbn

Теги: books, embed, images, listing, media, music, video

- Andreas Gohr

This plugin allows you to include information and cover art form Amazon into a wiki page. This is somewhat similar to the ISBN plugin but it uses Amazon's WebService API to fetch the data. You can adjust the plugin's output by changing the format function of the plugin.

Headline

Headline2

Headline3

Headline4

Headline5

autotooltip

anonymous@undisclosed.example.com (Anonymous) — Tue, 29 Aug 2023 09:14:48 +0000

Создавайте всплывающие подсказки вручную или генерируйте их на основе заголовка и аннотации вики-ссылки. Этот плагин позволяет создавать всплывающие подсказки для текста и ссылок на странице или автоматически генерировать всплывающие подсказки на основе заголовка и аннотации вики-ссылки. Если вы включите плагин рендеринга или установите ActionRenderer , он даже сможет добавить всплывающую подсказку к каждой внутренней вики-ссылке на вашем сайте!

Релиз: 2020-11-22.
Репозиторий:https://github.com/zioth/dokuwiki-autotooltip
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

описание : если вы добавите описание на страницу с помощью этого плагина, во всплывающих подсказках будет показано описание, а не сгенерированное «ДокуВики» резюме.

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Этот плагин позволяет вам вручную вставлять всплывающие подсказки одну за другой или автоматически генерировать их для каждой вики-ссылки на вашем сайте (или ее подмножества, ограниченного пространством имен).

Примеры:
Автоматическое создание из викиссылки

<autott>wiki:syntax</autott>

Formatting Syntaxplugin-autotooltip__default plugin-autotooltip_bigFormatting Syntax

DokuWiki supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing

Автоматическое создание из вики-ссылки с пользовательским текстом

<autott>wiki:syntax|Переименованная страница синтаксиса</autott>

Переименованная страница синтаксисаplugin-autotooltip__default plugin-autotooltip_bigFormatting Syntax

DokuWiki supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing

Построить вручную

<autott>
  <content>Простая подсказка</content>
  <tip>Я — подсказка!</tip>
</autott>

Простая подсказкаplugin-autotooltip__defaultЯ — подсказка!

Кастомизация: Синий

<autott blue>wiki:syntax</autott>

Formatting Syntaxplugin-autotooltip__blue plugin-autotooltip_bigFormatting Syntax

DokuWiki supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing

Кастомизация: Обычный

<autott plain>wiki:syntax</autott>

Formatting Syntaxplugin-autotooltip__plain plugin-autotooltip_bigFormatting Syntax

DokuWiki supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing

Кастомизация: Маленький

<autott small>wiki:syntax</autott>

Formatting Syntaxplugin-autotooltip__small plugin-autotooltip_bigFormatting Syntax

DokuWiki supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing

Есть три способа включить эту функцию:

Если вы уже используете ActionRenderer в качестве средства визуализации, вам не нужно ничего делать.
Перейдите в «Администратор » → «Конфигурация» → «Дополнительно» → «renderer_xhtml » и выберите «Автоматическая подсказка».
Если ни один из этих вариантов не соответствует вашим потребностям, рассмотрите Auto-link 4 , который может добавлять всплывающие подсказки к генерируемым ссылкам при установке вместе с AutoTooltip.

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

Подсказки вручную

<autott>
  <content>Это текст по ссылке на странице.</content>
  <tip>Тело всплывающей подсказки.</tip>
  <title>Необязательный заголовок всплывающей подсказки</title>
</autott>

Это текст по ссылке на странице.plugin-autotooltip__default plugin-autotooltip_bigНеобязательный заголовок всплывающей подсказки

Тело всплывающей подсказки.

Это создаст простую всплывающую подсказку для текста на странице.

Настройка всплывающей подсказки

<autott style1 style2>...</autott>

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

по умолчанию: полупрозрачная черная подсказка с закругленной рамкой.
синий: то же, что и по умолчанию, но синий.
Обычный: белая подсказка с черным текстом и черной рамкой.
small: Меньший размер шрифта. Его можно комбинировать с любым из вышеперечисленных стилей.

Вы можете добавить дополнительные стили в свой CSS . Имена классов имеют вид плагин - autotooltip__MYNAME. Например, чтобы создать всплывающую подсказку с изображением фона и белым текстом, добавьте этот CSS :

.plugin-autotooltip__picture {
  background: url(/path/to/image.jpg);
  color: #fff;
}

а затем создайте всплывающую подсказку следующим образом:

<autott picture>...</autott>

Создание всплывающей подсказки

<autott>вики:синтаксис</autott>

синтаксис

Это создаст ссылку на wiki:syntax, используя заголовок страницы в качестве текста ссылки. Всплывающая подсказка будет включать заголовок и аннотацию страницы.

<autott>wiki:syntax|Пользовательский заголовок</autott>

Пользовательский заголовокplugin-autotooltip__default plugin-autotooltip_bigFormatting Syntax

DokuWiki supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing

То же, что и выше, но текст ссылки будет «Пользовательский заголовок»

Конфигурация и настройки

стиль: набор классов по умолчанию, разделенных пробелами. Это могут быть встроенные стили или любой созданный вами класс CSS , который начинается с «plugin-autotooltip__».
задержка: время ожидания в миллисекундах перед отображением всплывающей подсказки.
linkall_inclusions: при использовании плагина рендеринга для добавления всплывающих подсказок ко всем ссылкам это регулярное выражение для включения страниц или пространств имен. Например, «^wiki:|^stuff:» включает только ссылки из пространств имен wiki и «stuff». Оставьте пустым, чтобы включить все страницы.
linkall_exclusions: регулярное выражение для исключаемых страниц или пространств имен. В сочетании с linkall_inclusions это означает «Включить эти страницы, кроме этих страниц». Это хорошо работает с Include и подобными плагинами, позволяя, например, исключить всплывающие подсказки на всех боковых панелях, но оставить их на странице.

Вспомогательный плагин

Помощник предоставляет следующие методы:

для текста
Создайте вручную всплывающую подсказку для произвольного текста.

$tooltip->forText($content, $tooltip, $title='', $preTitle='', $classes='', $textStyle='');

$content: текст на странице.
$tooltip: содержимое всплывающей подсказки. Новые строки будут отображаться как разрывы строк.
$title: заголовок внутри всплывающей подсказки.
$preTitle: Текст, отображаемый перед заголовком. Новые строки будут отображаться как разрывы строк.
$classes: классы CSS , которые можно добавить в эту подсказку. «dokuwiki-plugin__» будет добавлен к каждому классу.
$textStyle — стили CSS для связанного контента.

для Wikilink
Создайте викиссылку со всплывающей подсказкой.

$tooltip->forWikilink($id, $content=null, $classes='', $linkStyle='');

$id — идентификатор страницы.
$content — содержимое страницы. Новые строки будут отображаться как разрывы строк. Не используйте заголовок страницы.
$preTitle — текст, отображаемый перед заголовком во всплывающей подсказке. Новые строки будут отображаться как разрывы строк.
$classes — классы CSS , которые нужно добавить в эту подсказку. «dokuwiki-plugin__» будет добавлен к каждому классу.
$linkStyle — атрибут стиля ссылки.

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

zioth-dokuwiki-autotooltip-413232e.zip

Лицензия

Author: Eli Fenton
License: GNU GPL v2

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

backuptool

anonymous@undisclosed.example.com (Anonymous) — Thu, 10 Aug 2023 21:00:31 +0000

BackupTool для «ДокуВики»

Резервное копирование вашего сайта и данных конфигурации в файл. Это плагин для «Докувики», который позволяет вамсоздавать резервные копии наиболее важных частей вашего сайта; это включает в себя все ваши страницы, все старые версии, метаданные, подписки, медиафайлы (ваши загрузки), а также ваши плагины и шаблоны. Это на случай, если по какой-то странной причине ваш хост случайно потеряет все ваши файлы; лично со мной это случилось дважды, на двух разных хостах с тех пор, как я начал использовать «ДокуВики», и резервное копирование вручную может быть настоящим кошмаром.

Релиз: 2020-10-21.
Репозиторий:https://github.com/tatewake/dokuwiki-plugin-backup.
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»
Автор плагина объявил о прекращении поддержки, поэтому будущее этого плагина неопределенно.

Совместимость

2017-02-19 «Манеры Фрустерика»
- Не работает: Synology NAS под управлением DSM 5 / PHP 5.5.3 — JoeT 2022-07-14
  - Симптомы: Постоянная ошибка PHP при попытке доступа к меню администратора после обновления или установки этого плагина. ( ⇒ возможно несовместимость версии PHP )
    Parse error: syntax error, unexpected '.', expecting ',' or ';' in /volume1/web/dokuwiki/lib/plugins/backup/admin.php on line 15
    15: protected $prefFile = DOKU_CONF . 'backup.json';
  - Обходной путь: вернулся к предыдущей версии (2016-06-29), так как промежуточные версии недоступны.

Монтаж

Найдите и установите плагин с помощью Менеджера расширений . Обратитесь к Плагины для того, чтобы установить плагины вручную.

Как и в случае любого инструмента резервного копирования данных, всегда существует вероятность непреднамеренной потери данных. Ни я, ни этот сайт не несут ответственности за любую потерю данных, вызванную этим продуктом. Так что скачивайте и используйте на свой страх и риск!

Применение

Чтобы получить доступ к плагину, убедитесь, что вы находитесь в учетной записи администратора, и нажмите кнопку администратора на своем вики-сайте.

Запись с именем «Инструмент резервного копирования» должна быть указана в доступных административных задачах. Щелкните ее, и вы увидите список компонентов для резервного копирования.

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

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

Файл резервной копии создается и помещается в ваш каталог мультимедиа. Таким образом, вы сможете загрузить его оттуда, а затем, возможно, захотите удалить его.

Восстановление резервной копии

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

Начните установку последней версии «ДокуВики», как если бы вы начали с новой вики.
Разархивируйте резервную копию и скопируйте три каталога (conf, data and lib) в папку назначения вики, перезаписав все возможные существующие файлы.
Теперь вы должны иметь возможность войти в систему с ранее использовавшейся учетной записью администратора.

Файл для загрузки

backuptool.zip

blog

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2024 05:40:04 +0000

Blog для «ДокуВики»

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

Релиз: 2024-02-06.
Репозиторий: https://github.com/dokufreaks/plugin-blog
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Сообщайте об ошибках или просьбах о новых функциях в системе отслеживания ошибок

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Installation

Download	plugin-blog.tgz
BundleHub	Configure your own DokuWiki blogsuite install package, consisting of all mandatory plugins plus any optional features you want to include: BlogSuite BundleHub The Bundle Hub is currently out of date and not updated any more, please install the plugins individually Site seems to be down for sime time, here is the archived version if you want to see possible optional plugins & features.
Tips	If you intend to use this plugin be sure to take a look at the blogging tips page

Syntax

Blog

{{blog>[namespace]?[number]&[flags]}}

[namespace]	namespace for the blog; subspaces will be searched as well; `*` is the whole wiki, `.` is the same namespace as the page lies in	optional; default is the blog namespace set in the configuration
[number]	number of entries to show per page	optional; default is 5
[flags]	flags are delimited by `&`
	all Include plugin flags are supported	optional
	Form placement: `topform`/`bottomform`/`noform`	optional, default is `topform`
	Custom new-entry form title: `newentrytitle=Custom title`	optional, can also be set as a configuration option
	Hide paging controls: `nopagingcontrols`	optional

This includes a specified number of most recent blog entries from the given namespace into the current page. Below the entries a link to the page (permalink), the author, the creation date and the number of comments are shown. Link, author, date and comments info can be hidden. At the end of the blog a link to older entries lets you navigate in the history of the blog. At the very end, if you have enough rights to create new pages, a form for new blog entries is displayed.

Note that when the page with the blog syntax is in the specified namespace, content my be shown twice. At some point, the loop will be detected and stopped. You should therefore make sure that either the page with the listing is in a different namespace or use the excluded_pages-option to explicitly exclude the blog page from the blog listing.

[namespace]	the namespace for which you want an archive list; `*` is the whole wiki, `.` is the same namespace as the page lies in	optional; default is the namespace specified in the configuration
[month]	the month for the archive list in YYYY-MM format; `*` for all pages	required
[flags]	pagelist flags delimited by `&`, see flags	optional
[username]	username of an author	optional

Configuration and Settings

The blog plugin can be configured using the DokuWiki configuration manager available in the admin menu.

`namespace`	The default namespace which is used if no namespace was given in the syntax
`formposition`	You can choose to display the new entry form either above or below the blog entries
`newentrytitle`	Set a custom title for all new entry forms. This can also be set on individual blog forms.
`dateprefix`	A date prefix that automatically gets added to pages created with the new entry form. You can use the options from the strftime PHP function; namespace separators work as well, e.g. `%Y:%m%d`
`sortkey`	Defines how the blog entries are sorted. Available options are creation date, modification date, page name, page ID and page title (first headline)
`sortorder`	Sort the blog entries ascending/descending
`excluded_pages`	Exclude certain pages from the blog listing. Requires a regular expression. Use for example `!(^\|:)start$!` in order to exclude start pages from all blog listings. To exclude both start and rightsidebar directly below :blog use `!(^\|:)blog:(start\|rightsidebar)$!`
`showhistogram`	Display a histogram in normal archive mode (not for autoarchive)
`max_months`	Maximum number of months to show in the histogram
`histogram_height`	Height of the histogram (in pixels)

Changes

2013-10-20: Translation updates, fix cache handling for empty blog listings
2013-03-27: Better cache handling for the archive syntax
- the syntax that lists everything till now correctly updates the cache now whenever a page is changed or a comment or linkback is added.
- the cache is not used anymore when it contains an archive listing with a page that the current user can't access. The excluded pages won't be included again automatically unless the cache expires for other reasons, the ~~NOCACHE~~ macro can be used if this is needed.

Development

Change Log

Merge pull request #126 from dokuwiki-translate/lang_update_848_17143… (2024/05/01 18:45)
translation update (2024/04/29 09:20)
Version upped (2023/10/25 00:50)
Merge pull request #121 from fiwswe/fix_issue_120 (2023/10/24 20:51)
Rename constructor (2023/10/24 13:10)
Merge pull request #118 from dokuwiki-translate/lang_update_564_16764… (2023/02/16 22:25)
translation update (2023/02/15 03:35)
Merge pull request #117 from dokuwiki-translate/lang_update_551_16745… (2023/01/24 23:45)

Bugs / Feature Requests

Please report bugs or feature requests at the Bug tracker.

FAQ

Please also have a look at the blogging tips page!

My dates are shown wrong. What can I do?

Make sure you run the latest version of all required plugins and DokuWiki.

Is it possible to change the way the date is displayed?

Yes, the plugin uses the dformat option to format the date.

How can I alter the date of a blog post?

You can use the meta plugin to manually set the creation date (and modification date) in the page source, then select the modification date in the blog plugins order setting. An alternative solution would be to alter the timestamps of the created files.

Is it possible to show table of contents?

The table of contents is shown automatically (depending on the settings in DokuWiki itself) from version 2013-02-07 on.

The header is always a link to the page even though it's disabled in the include plugin settings

The blog plugin assumes that in the context of a blog the header should be a link. However from version 2013-02-26 on it is possible to disable this behavior by using the nolink-flag, the blog plugin now only sets a default without overriding the nolink flag.

Is it possible to show just the first lines of each post with a 'Read more' link to view the full post?

I think I solved myself. In the blog mark, use the following flags

{{blog>?5&firstseconly&readmore}}

This will work if you add an H2 header (in the full post) where you want to make appear the 'Read more' link. If you don't need or want an H2 header in your post, you can add a empty H2 header, just as a delimiter for the text you want to show in the Blog's headlines

the excluded_pages does not work

In the blog mark ,use the following flags

{{blog>*?5&!(^|:)index$!}}
or
{{blog>*?5&excluded_pages=!(^|:)index$!}}

all above flags does not work, the index pages in sub namespace is still included .

This is global configuration, you should configure it in Configuration Manager. — Siyuan Liu 2023-08-17

Discussion

Please report bugs or feature requests at the Bug tracker.

Is it possible to make a blog in one namespace be in ascending order, and a blog in a different namespace to be in descending order?

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

plugin-blog-master.zip

Лицензия

Author: Dokufreaks (previous authors: Michael Hamann, Gina Häußge, Michael Klier, Esther Brunner)
License: GNU GPL v2

camelcase

anonymous@undisclosed.example.com (Anonymous) — Fri, 17 Jan 2025 11:27:22 +0000

CamelCase для «ДокуВики»

Замена синтаксиса DokuWiki CamelCase, использует «_» для разделения слов в названиях страниц.

Этот плагин был разработан Кристофер Смит.

Релиз: 2005-09-19.
Правка: 2008-08-13.
Репозиторий:http://dokuwiki.jalakai.co.uk/plugin-camelcase.tar.gz
Совместимость с «Докувики»: 2005-09-19+

Совместимость

2005-09-19+

Внимание: Это расширение не обновлялось более 2 лет. Возможно, оно больше не поддерживается и может иметь проблемы с совместимостью.

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в <dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Примеры/Использование

Этот плагин заменяет текущие обработчики DokuWiki для разметки CamelCase. Он создаст ссылку на страницу с подчеркиваниями между словами CamelCase.

например

index.php

CamelCase => camel_case

Стандартное поведение DokuWiki заключается в создании ссылки на страницу с CamelCase, преобразованным в нижний регистр (например, camelcase). Это может привести к снижению читаемости названий страниц. Альтернативой является установка параметра конфигурации useheading в вашем conf/local.php файле.

Синтаксис

как описано в синтаксисе DokuWiki

Подробности

PHP-источник

lib/plugins/camelcase/syntax.php

<?php
/**
 * CamelCase Plugin: replaces DokuWiki's own code syntax
 * 
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     Christopher Smith <chris@jalakai.co.uk>  
 */
 
if(!defined('DOKU_INC')) die();
 
/**
 * All DokuWiki plugins to extend the parser/rendering mechanism
 * need to inherit from this class
 */
class  syntax_plugin_camelcase extends DokuWiki_Syntax_Plugin {
 
 
    /**
     * return some info
     */
    function getInfo(){
      return array(
        'author' => 'Christopher Smith',
        'email'  => 'chris@jalakai.co.uk',
        'date'   => '2008-08-13',
        'name'   => 'Camel Case',
        'desc'   => 'Override default DokuWiki CamelCase syntax',
        'url'    => 'http://www.dokuwiki.org/plugin:camelcase',
      );
    }
 
    /**
     * Syntax Type
     *
     * Needs to return one of the mode types defined in $PARSER_MODES in parser.php
     */
    function getType(){
        return('substition');
    }
 
    function connectTo($mode) {
        $this->Lexer->addSpecialPattern(
                '\b[A-Z]+[a-z]+[A-Z][A-Za-z]*\b',$mode,'plugin_camelcase'
            );
    }
 
    function getSort() {
        return 275;   // needs to be lower than 290
    }
 
    /**
     * Handler to prepare matched data for the rendering process
     */
    function handle($match, $state, $pos, Doku_Handler $handler){
 
        preg_match_all('/[A-Z][^A-Z]*/u',$match, $matches);
        $link = implode('_',$matches[0]);
        return array($link, $match);
    }
 
    /**
     * Handles the actual output creation.
     */
    function render($format, Doku_Renderer $renderer, $data) {
      $renderer->internallink($data[0],$data[1]); 
    }
 
}
//Setup VIM: ex: et ts=4 enc=utf-8 :

Файл для загрузки

plugin-camelcase.tar.gz

Лицензия

Author: Christopher Smith
License: GNU GPL v2
Donate: Click here.

cellbg

anonymous@undisclosed.example.com (Anonymous) — Sat, 26 Aug 2023 22:12:51 +0000

Cellbg для «ДокуВики»

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

Это хак, позволяющий редактировать ранее отформатированный текст:

определить наличие в таблице, найдя <td…> разметку в ранее отформатированном тексте ( $renderer→doc);
отредактируйте отформатированный текст и добавьте bgcolor = внутрь предыдущую <td> разметку;
если не в таблице: добавьте текст в форматированный текст как есть.

Релиз: 2013-09-10.
Репозиторий:https://github.com/dr4Ke/cellbg/
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Его следует удалить перед обновлением до последней версии Hogfather (если нет, вы получите пустую страницу), но, что удивительно, после его переустановки он работает хорошо (проверено на двух вики) без журнала ошибок на веб-сервере.
Плагин не работает с плагином-оберткой
Описание проблемы и решение: https://github.com/dr4Ke/cellbg/pull/17 .

@: синтаксис

@: синтаксис не работает с DokuWiki в Debian. Ленни: 0.0.20080505-4+lenny1
Ошибка: https://github.com/dr4Ke/cellbg/issues/issue/1

| @green:Col 1 |<WRAP>
   * first point
   * next point
</WRAP>

@green:Col 1

Ограничения

Не работает со строками заголовков (символ ^), поэтому просто не используйте их, если вам нужен определенный цвет для этих строк.
Может не работать с плагинами, в которых синтаксис таблиц отличается от синтаксиса DokuWiki.
Если шаблон «@…:» обнаружен в таблице, он может отключить другой синтаксис внутри нее (не уверен в этом).

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Синтаксис и использование

Цвет фона начинается @ и заканчивается :.
Вы можете использовать все имена и цветовые коды из HTML .
Если вы не укажете цвет, используется желтый.
См. примеры ниже:

Примеры

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

Заголовок 1	Заголовок 2	Заголовок 3
Диапазон
Линия 1	Да	Да, действительно
линия 2	Да	Да
Линия 3	Да	Нет

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

dr4ke-cellbg-1.0.1-4-gb29e555.tar.gz

Лицензия

Author: dr4Ke
License: GNU GPL v2

citations

anonymous@undisclosed.example.com (Anonymous) — Thu, 10 Aug 2023 20:59:55 +0000

Citations для «ДокуВики»

создает цитаты разных форматов для ваших вики-страниц. Этот плагин дает вам возможность разрешить пользователям цитировать вашу работу. Это требуется довольно часто в научных кругах и журналистике.

Это делается путем добавления «&do=cite» к URL-адресу вики-страницы в дополнение к необязательному номеру редакции, например «rev=123456789».

Плагин также экспортирует две функции для использования с вашим шаблоном: URL-адреса для постоянной ссылки ( cite_getPermURL ) на версию страницы и ссылку для цитирования ( cite_getCiteURL ), чтобы вы могли позволить другим легко цитировать вашу работу.

Релиз: 2020-09-22.
Репозиторий:https://github.com/tatewake/dokuwiki-plugin-cite
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

2009-05-28 «Манеры Фрустерика»
- Не работает: auth_aclquickcheck не может обрабатывать начальные двоеточия в идентификаторах, поэтому я чувствую, что это все еще не работает в «ДокуВики», но, по крайней мере, плагин может правильно учитывать ACL .

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Если вы не добавите следующий код в файл main.php вашего шаблона, ссылки для цитирования не появятся!

В main.php добавьте следующее в начало файла:

<?php if (file_exists(DOKU_PLUGIN.'cite/code.php')) include_once(DOKU_PLUGIN.'cite/code.php'); ?>

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

<?php if (function_exists('cite_getPermURL')) { ?><a href="<?php echo cite_getPermURL(); ?>" rel="nofollow">Permanent Link</a><?php } ?>
<?php if (function_exists('cite_getCiteURL')) { ?><a href="<?php echo cite_getCiteURL(); ?>" rel="nofollow">Cite this Page</a><?php } ?>

Мой совет — сохранить rel="nofollow"нетронутым, так как это гарантирует, что поисковые системы не будут индексировать цитаты.

Установите параметры для этого плагина через меню «Настройки конфигурации» в меню администратора «ДокуВики». (Он будет внизу страницы.)

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

citations.zip

Лицензия

Author: Terence J. Grant
License: GNU GPL v2
Donate: Click here.

codeprettify

anonymous@undisclosed.example.com (Anonymous) — Fri, 18 Aug 2023 22:04:17 +0000

CodePrettifier для «ДокуВики»

Подсветка синтаксиса фрагментов исходного кода на вики-странице с использованием google-code-prettify (модуль javascript с файлами CSS).

Этот плагин включает подсветку синтаксиса фрагментов кода на вашей странице с помощью преттификатора кода Javascript (бывший «google-code-prettify»). Этот пакет плагинов включает подмножество преттификаторов кода Javascript, они лицензируются отдельно в соответствии с лицензией Apache, версия 2.0.

Вы можете настроить плагин Code Prettifier, чтобы переопределить встроенный синтаксис «Докувики» <code> для блоков кода. вы можете использовать скин (файл css) для блока кода.

Релиз: 2019-09-29.
Репозиторий:https://github.com/ssahara/dw-plugin-codeprettify
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Не работает: Требуется PHP 7.0.x или выше!

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Прикрепите фрагменты кода, используя теги <Code> и </Code>, чтобы они отображались красиво на вики-странице.
Модуль Prettify делает все возможное, чтобы угадать язык, но лучше всего работает с C-подобными и HTML -подобными языками.
Чтобы указать языковую подсказку для Prettify, вы можете использовать
<Code:ext> (расширение файла, вы должны указать его сразу после ключевого слова «Код:»)
<Code lang-ext> вариант
Например, используйте <Code:css> или , <Code lang-css> чтобы указать, что код представляет собой каскадные таблицы стилей ( CSS ).
используйте linenums или nolinenums для включения/выключения нумерации строк. Вы можете добавить двоеточие и число в конце опции, например. linenums:12 указать номер начальной строки.
Если вы хотите добавить заголовок для блока кода, вы можете указать его после |того, как он будет отображаться прямо над полем кода.
Теги <Code> и </Code> пишутся с Большой буквы.

<Code:php linenums:1 |Example #1 Our first PHP script: //hello.php//>
<html>
  <head>
  <title>PHP Test</title>
 </head>
 <body>
 <?php echo '<p>Hello World</p>'; ?> 
 </body>
</html>
</Code>

Example #1 Our first PHP script: hello.php

<html>
  <head>
  <title>PHP Test</title>
 </head>
 <body>
 <?php echo '<p>Hello World</p>'; ?> 
 </body>
</html>

Конфигурация и настройки

Config key	Description
`override`	переопределить встроенный в «Докувики» синтаксис <code> for для блоков кода.
`linenums`	включить нумерацию строк неявно.
`url_loader`	URL загрузчика prettify (по умолчанию пустой) устарел с выпуска 2015-09-12
`url_prettify_handlers`	Базовый URL-адрес для prettify.js и необязательных сценариев обработчика языка, например: https://cdn.rawgit.com/google/code-prettify/master/src/ (по умолчанию пусто) доступно в выпуске 2015-09-12.
`url_prettify_skins`	Базовый URL-адрес для цветовой темы для code-prettify (css), например: https://cdn.rawgit.com/google/code-prettify/master/styles/ (по умолчанию пусто) доступно в версии 2015-09-12.
`lang_handlers`	дополнительный обработчик языка (через запятую)
`skin`	цветовая тема/скин для code-prettify ( имя файла CSS в code-prettify/styles/)

Подробная информация о преттификаторе кода Javascript доступна по адресу:

https://github.com/google/code-prettify/blob/master/docs/getting_started.md

Этот пакет плагинов содержит некоторые скины, найденные в галерее Prettify Themes. Вы можете установить одно из следующих имен файла css в skin поле.

desert.css
doxy.css
sons-of-obsidian.css
sunburst.css

Другие цветовые темы для Prettify можно найти по адресу: http://jmblog.github.io/color-themes-for-google-code-prettify/

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

ssahara-dw-plugin-codeprettify-2019-03-09-10-g914e649.zip

Лицензия

Author: s.sahara
License: GNU GPL v2

Click here. Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на эту страницу с вашего сайта, если вам нравится этот продукт.

color

anonymous@undisclosed.example.com (Anonymous) — Sat, 01 Feb 2025 06:57:17 +0000

Color для «ДокуВики»

Возможность писать цветной текст в «ДокуВики»

Релиз: 2022-10-19.
Репозиторий:https://github.com/hanche/dokuwiki_color_plugin
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Кристофер Смит, похоже, оставил плагин без поддержки. Пользователь leeyc0 предоставил хостинг плагина на github, но у него нет времени на его поддержку.

Харальд Ханче-Ольсен занял его в октябре 2018 года. Однако плагин считается довольно стабильным, и новый сопровождающий не предвидит очень активного графика поддержки. Запросы на новые функции, скорее всего, будут отклонены.

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Поместите этот пример кода на свою игровую площадку:

<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>

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

text text text text text text

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

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

Точный синтаксис выглядит следующим образом. Квадратные скобки ([]) обозначают необязательные части и не должны включаться буквально:

<color [⟨fg-color⟩][/⟨bg-color⟩]>⟨text⟩</color>
<color [⟨fg-color⟩]:[⟨bg-color⟩]>⟨text⟩</color>

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

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

В результате отображается ⟨текст⟩ с цветом переднего плана ⟨fg-color⟩ и цветом фона ⟨bg-color⟩. Если какой-либо цвет опущен или пуст, используется цвет переднего плана или фона окружающего текста.

Пример — обратите внимание на обязательное двоеточие здесь:

<color hwb(120 20% 30% / 50%):>some faded dark green semi-transparent text</color>

Безобидное ограничение: этот плагин теперь допускает любую спецификацию цвета, не содержащую одинарные или двойные кавычки или какие-либо символы < > & ; . Он не пытается проверить, является ли спецификация допустимой для CSS . Это сделано для соответствия цветовым спецификациям CSS 4, а также любым будущим цветовым спецификациям — до тех пор, пока они не используют какие-либо «запрещенные» символы.

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

Плагин работает, заключая содержимое в элемент <span> с подходящим атрибутом стиля. Поэтому вы не можете обернуть его вокруг элементов уровня блока, таких как заголовки, списки и таблицы.
Вы также не можете использовать его внутри заголовков, так как вы не можете использовать синтаксис вики внутри заголовка.
Использование двух или более разделителей (косая черта в первом синтаксисе, двоеточие во втором) внутри <color …> приводит к неопределенному поведению.

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Обсуждение

Исходный код этого плагина показан в плагина#sample_plugin_2_-_color|учебном пособии по образцу.

Разработка

Файл для загрузки

color.gz color.tar

Лицензия

License: GNU GPL v2

config

anonymous@undisclosed.example.com (Anonymous) — Fri, 03 Jan 2025 13:48:51 +0000

Configuration Manager Plugin

Совместим с «Докувики»

(bundled)

Manage your wiki's configuration settings (bundled with DokuWiki)

Последнее обновление:: 2014-03-18
Предоставляет: Admin

Это расширение не находится в пространстве имен 'plugin' или 'template' и поэтому игнорируется.

Теги: !bundled, configuration, options, settings

- Christopher Smith

Description

The Config Manager allows wiki administrators to easily alter the wiki configuration settings online from the comfort of their favorite web browser. This plugin manages basic DokuWiki configurations as well as other settings for installed plugins and currently used template.

Usage

The Config Manager is accessible from the admin screen (Login as superuser, click «Admin» and choose « Configuration Settings»).

Settings are shown with different backgrounds to highlight their current status.

A blue background is used to show default values (conf/dokuwiki.php), eg. values that have not been modified by the user.
A white background indicates local changes (conf/local.php).
A light red background shows protected settings (conf/local.protected.php) which can not be modified.

Modify settings to your needs and save it by using the Save button at bottom of the page, by pressing 'Enter' in a textbox or by using the accesskey of your browser: <accesskey> + S

How is your config saved

On saving changed settings this plugin will copy the current local settings file (conf/local.php) to conf/local.php.bak and save the updated settings to conf/local.php. It will never make any changes to the default settings stored in conf/dokuwiki.php. However, any settings found in conf/local.php will override the default settings as explained in the configuration options page.

The plugin adds the following lines to the top of conf/local.php when it updates it:

conf/local.php

/*
 * DokuWiki's Main Configuration File - Local Settings 
 * Auto-generated by config plugin 
 * Run for user: <username>
 * Date: <current date/time, rfc 2822 format (day, dd MMM YYYY hh:mm:ss TZ)>
 */

Protecting Settings

You can protect certain settings by placing them in conf/local.protected.php (create the file if it doesn't exist).

By default DokuWiki loads its configuration files in the following order:

conf/dokuwiki.php
conf/local.php
conf/local.protected.php

This way, it is ensured that any values previously set from conf/dokuwiki.php and conf/local.php will be overridden by protected values from conf/local.protected.php. Any settings found in conf/local.protected.php will be displayed by the plugin surrounded in light-red to indicate their protected status. Editing of protected values is disabled.

The loading order of configuration files is controlled by the global $config_cascade variable.

Example

conf/local.protected.php

<?php
/**
 * Protected settings
 * Do override DokuWiki default settings and local settings from Config Manager
 */
$conf['useacl'] = 1;

File Permissions

To be able to save the configuration data, the file permissions of conf/local.php needs to be writable by the webserver, as well as the configuration directory itself. Refer to permissions on details how set file permissions on various systems.

When the plugin detects that the config file can not be written, it will show a message box at the top of the page that says

«The settings file can not be updated, if this is unintentional, ensure the local settings file name and permissions are correct.»

When this happens, the save button won't be shown.

Triangle, Exclamation and Padlock Mark

Some fields in the configuration page show:

A yellow warning sign () , or
An exclamation mark in a red circle (), or
The drawing of a padlock ()

These are the meanings of these three symbols:
Yellow Mark ⇒ changing this option may result in undesirable behaviors.
Red circle ⇒ changing this option could make your wiki and the configuration menu inaccessible.
Padlock ⇒ changing this option could present a security risk.

Please, keep attention when you change these fields.

Источник инфорации

https://www.dokuwiki.org/plugin:config

cookiebanner

anonymous@undisclosed.example.com (Anonymous) — Fri, 20 Dec 2024 13:45:55 +0000

Cookiebanner для «ДокуВики»

После установки плагин будет показывать посетителям баннер согласия. Посетители могут нажать «Принять» или «Отклонить». Выбор сохраняется в файле cookie настроек «ДокуВики».

Конфигурация позволяет вам определить произвольный JavaScript, который должен выполняться при каждой загрузке страницы, как только посетитель согласится. Например, здесь вы можете разместить свой код отслеживания.

Примечание. Этот баннер не повлияет на файлы cookie, установленные ядром «ДокуВики», поскольку они считаются функционально необходимыми и не отслеживают пользователей на разных устройствах. См. FAQ on Cookies.

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

Релиз: 2021-07-21.
Репозиторий:https://github.com/cosmocode/dokuwiki-plugin-cookiebanner/
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Нет информации о несовместимости.

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

cookiebanner

Лицензия

Author: Andreas Gohr
License: GNU GPL v2

copy2clipboard

anonymous@undisclosed.example.com (Anonymous) — Sat, 19 Aug 2023 00:43:46 +0000

Copy2clipboard для «ДокуВики»

Добавьте кнопку буфера обмена в блоки <code> и <file>, которая копирует текст в буфер обмена. Этот плагин не требует компонентов DokuWiki или PHP. Поскольку он сделан из чистого javascript, он должен работать с любой версией «ДокуВики»

Релиз: 2023-04-17
Репозиторий:https://github.com/schplurtz/dokuwiki-plugin-copy2clipboard/
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

одиночные НЕРАЗРЫВНЫЕ ПРОБЕЛЫ (он же NBSP, он же U+00A0 ) в строке сами по себе не копируются в буфер обмена.
- Это не баг, а фича. Одиночный NBSP почти никогда не появляется намеренно в исходном коде, так что это практически не нарушит код. С другой стороны, geshi, который используется в «Докувики», добавляет его к каждой пустой строке, делая пустые строки непустыми. Кроме того, U + 00A0 не является пробелом и вызывает синтаксическую ошибку в языках программирования или форматированном текстовом файле, таком как YAML или LDIF. Польза от удаления этого символа намного больше, чем недостаток его сохранения.

~~У него пока нет известных ошибок.~~⁹⁾

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

После установки он автоматически добавит кнопку «копировать в буфер обмена» к каждому <code> или <file> блоку кода , как показано на скриншоте ниже. На самом деле, в настольном браузере кнопки становятся видимыми только тогда, когда курсор мыши входит в область <code> или <file>. В мобильных браузерах кнопки видны всегда.

Это расширение добавляет кнопку буфера обмена <code> и <file> блоки, которые копируют текст в буфер обмена.

Это уже сделано другими расширениями, copycode и codeclipboard . Тем не менее, у него есть следующие преимущества перед другими расширениями (здесь они ужасно частичны ;-)):

сделан из чистого javascript, нет требований PHP, нет требований DokuWiki. Он будет работать с любой версией «ДокуВики», с любой версией PHP,
Он использует относительно новый, но стабильный API javacript , поэтому он должен работать годами, прежде чем станет несовместимым с навигаторами,
- Таким образом, насколько я понимаю, в ближайшие тысячелетия не будет необходимости обновлять это расширение,
Корректно копирует коды, отформатированные geshi ¹⁰⁾ . если вы столкнулись со страшной ошибкой «Нераспознанный символ \xC2» при копировании кода в perl или python вручную или с помощью других расширений, тогда copy2clipboard — это расширение, которое вам нужно,
Это гарантирует, что окончания строк адаптированы к ОС, на которой работает навигатор. Это устраняет ошибку powershell 496 и3816когда строки вставляются в обратном порядке.
~~У него пока нет известных ошибок~~¹¹⁾

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

dokuteaser copy2clipboard.zip

Лицензия

Author: Schplurtz le Déboulonné
License: GNU GPL v2

⁹⁾ , ¹¹⁾

Такое заявление долго не выдержит…

¹⁰⁾

Это библиотечный компонент, используемый «ДокуВики» для подсветки синтаксиса.

details

anonymous@undisclosed.example.com (Anonymous) — Sat, 01 Feb 2025 06:59:29 +0000

Details Tag для «ДокуВики»

Используйте теги HTML <details> и <summary> для скрытия информации на странице, которое можно сделать видимым, щелкнув текст сводки. Вы можете использовать это, чтобы скрыть спойлеры или большой контент. Так же возможно сделать контент видимым изначально с возможность пользователем его скрыть.

Релиз: 2021-03-18.
Репозиторий:https://github.com/revolution-arts/dokuwiki-plugin-htmldetailstag/
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

У него пока нет известных ошибок.¹²⁾

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Настраивать нечего.

<details>
<summary>Резюме</summary>
Основной текст
</details>

Приведенный выше текст приводит к: Показу кнопки «Подробности» и скрытию основного текста После нажатия на стрелку отображается содержимое: Основной текст

Синтаксис

Блок, который нужно скрыть, начинается с <details> и заканчивается на </details>.
- Если содержимое должно быть видимым по умолчанию, используйте <details open> вместо этого.
Первым элементом контента должен быть <summary> TEXT </summary>.
- Если его не указать, вместо него будет использоваться текст сводки «Подробности».
Остальное содержимое будет невидимым по умолчанию.

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

Пример

«Подробности»

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

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

Пример

«Подробности»

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

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

detail.zip

Лицензия

Author: Sascha Klawohn
License: GNU GPL v2

¹²⁾

Такое заявление долго не выдержит…

diagram

anonymous@undisclosed.example.com (Anonymous) — Sat, 19 Aug 2023 11:43:43 +0000

Diagram для «ДокуВики»

Построение схем и генеалогических деревьев, состоящих из блоков и линий соединения. Плагин расширяет синтаксис «Докувики» и позволяет строить диаграммы.

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

<diagram> 
Спецификация диаграммы 
</diagram>

Релиз: 2021-02-21.
Репозиторий:http://nikita.melnichenko.name/projects/dokuwiki-diagram/?lang=en
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

2009-05-28 «Манеры Фрустерика»
- Не работает: auth_aclquickcheck не может обрабатывать начальные двоеточия в идентификаторах, поэтому я чувствую, что это все еще не работает в «ДокуВики», но, по крайней мере, плагин может правильно учитывать ACL .

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Спецификация диаграммы представляет собой многострочное выражение. Каждая строка состоит из управляющих символов, определяющих связи между блоками, и последовательностей букв, определяющих блоки. Эти сущности разделяются специальным символом `|'. Например, следующая спецификация

<diagram>
| AAA |-| BBB |
| |:| | | | | |
| |L|~|~| CCC |
</diagram>

определяет эту диаграмму:

AAA

BBB

CCC

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

<diagram>
| root |-| 1-st branch |
| |:| | | | | |
| |L|~|~| 2-nd branch |
</diagram>

root

1-st branch

2-nd branch

К сожалению, этот метод ломает текстовое представление диаграммы (для больших диаграмм это приводит к сложности изменения вики-кода), а также не позволяет использовать вики-синтаксис внутри блока. Чтобы преодолеть это, вы должны рассматривать последовательности букв, цифр и подчеркивания как аббревиатуры и расшифровывать их в конце строки, используя знак равенства и `|' символ в качестве разделителя. Например:

<diagram>
| AAA |-| BBB |AAA=root|BBB=1<sup>st</sup> branch (see [[wp>Branch]])
| |:| | | | | |
| |L|~|~| CCC |CCC=2<sup>nd</sup> branch\\ **(very important branch)**
</diagram>

root

1^st branch (see Branch)

2^nd branch
(very important branch)

С помощью таких диаграмм можно описать генеалогическое древо.

<diagram>
| | | Dad |y| Mom | | |Dad=Daddy|Mom=Mommy
| |,|-|-|-|+|-|-|-|.| |
| Sys | |  Me | | Bro |Sys=Syster|Bro=Brother
</diagram>

Daddy

Mommy

Syster

Brother

Все типы соединений показаны в следующей таблице:

,	.	`	'		v	(	)	-	!	+

F	7	L	J	A	V	C	D	~	:	%

y	h	}	{	p	b	]	[	*	#

Мы будем называть эти элементы тайлами соединения.

Стиль элементов диаграммы Вы можете изменить цвет границы и цвет фона блока. Это делается путем указания параметров блока в описании аббревиатуры непосредственно перед знаком равенства и в фигурных скобках. Параметры должны быть отформатированы как ключ:значение и разделены точкой с запятой. В текущей версии плагина поддерживаются два ключа: border-colorдля цвета рамки и background-colorдля цвета фона. Значения цвета должны быть указаны в формате CSS2 , включая ключевые слова цвета SVG .

<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

Также можно настроить выравнивание текста и внутренний отступ с помощью text-align и padding свойств:

<diagram>
|Left|                 |Left{text-align:left;}=Text is\\ aligned to the left
| |!|
| |`|-|-|Center|       |Center=By default text is aligned\\ to the center
| | | | |  |!|
| | | | |  |`|-|-|Right|Right{text-align:right;padding:1em}=Align text\\ to the right\\ and setup indents
</diagram>

Text is
aligned to the left

By default text is aligned
to the center

Align text
to the right
and setup indents

Здесь можно заметить, что разрешено пропускать пустые секции в конце строки, как в последнем примере. Но следует помнить о некоторых сложностях при дальнейшем редактировании схемы и влиянии на ширину блока. Кроме того, вы можете изменить расстояние между блоками, добавив больше столбцов и строк (это работает из-за минимальной высоты и ширины каждого пустого блока). Сравнивать

<diagram>
| AAA |-| BBB |
| |:| | | | | | | DDD |
| |L|~|~| CCC |
</diagram>

AAA

BBB

DDD

CCC

<diagram>
| AAA |-|-|-| BBB | | | | | | |
| |:|
| |:| | | | | | | | | | | DDD |
| |:|
| |L|~|~|~|~| CCC |
</diagram>

AAA

BBB

DDD

CCC

Стрелки

Вы можете использовать стрелки на диаграммах. Например,

<diagram>
|  AAA  |-@2|  BBB  |-@a|  EEE   |
| |:@1| |   | |!@4| |   | |}@72|-|-| GGG |
|  DDD  |~@8|  CCC  |   |  FFF   |
</diagram>

AAA

BBB

EEE

GGG

DDD

CCC

FFF

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

Up	Right	Down	Left
1	2	4	8

Если вы получили число, которое больше девяти, то замените его на букву согласно таблице:

10	11	12	13	14	15
a	b	c	d	e	f

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

Пример: генеалогическое древо Кеннеди. Основной синтаксис для диаграмм был заимствован из Википедии. Сравните генеалогическое древо Кеннеди с генеалогическим древом ниже.

<diagram>
| | | | | JAK |y| MAK | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |JAK=James Kennedy\\ (c. 1770 - c. 1840)|MAK=Maria Kennedy\\ (c. 1775 - 1835)
| | | | | | | |!| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | PAK |y| BMK | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |PAK=[[wp>Patrick Kennedy (1823–1858)|Patrick Kennedy]]\\ (c. 1823 - 1858)|BMK=[[wp>Bridget Murphy Kennedy|Bridget Murphy]]\\ (1824 - 1888)
| |,|-|-|-|v|-|-|-|+|-|-|-|v|-|-|-|.| | | | | | | | | | | | | | | | | | | | | | | | | |
| MLK | | JLK | | JOK | | MMK | | PJK |y| MAH | | | | | | | | | | | | | | | | | | | | |MLK=Mary L. Kennedy\\ (1851 - 1926)|JLK=Joanna L. Kennedy\\ (1852 - 1926)|JOK=John Kennedy\\ (1854 - 1855)|MMK=Margaret M. Kennedy\\ (1855 - 1929)|PJK=[[wp>P. J. Kennedy|Patrick Joseph Kennedy]]\\ (1858 - 1929)|MAH=[[wp>Mary Augusta Hickey Kennedy|Mary Augusta Hickey]]\\ (1857 - 1923)
| | | | | | | | | | | | | | | | | | | |!| | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | JPK |y| RFK | | | | | | | | | | | | | | | | | | |JPK=[[wp>Joseph P. Kennedy, Sr.]]\\ (1888 - 1969)|RFK=[[wp>Rose Fitzgerald Kennedy|Rose Elizabeth Fitzgerald]]\\ (1890 - 1995)
| | | | | |,|-|-|-|v|-|-|-|v|-|-|-|v|-|-|-|+|-|-|-|v|-|-|-|v|-|-|-|v|-|-|-|.| | | | | |
| | | | | JPK | | JFK |7| ROK | | KAK |7| EMK |F| PAK |F| RFK |F| JAK |F| EDK | | | | |JPK=[[wp>Joseph Patrick Kennedy Jr.]]\\ (1915 - 1944)|JFK=[[wp>John Fitzgerald Kennedy]]\\ (1917 - 1963)|ROK=[[wp>Rosemary Kennedy]]\\ (1918 - 2005)|KAK=[[wp>Kathleen Cavendish, Marchioness of Hartington]]\\ (1920 - 1948)|EMK=[[wp>Eunice Kennedy Shriver]]\\ (b. 1921)|PAK=[[wp>Patricia Kennedy Lawford]]\\ (1924 - 2006)|RFK=[[wp>Robert Francis Kennedy]]\\ (1925 – 1968)|JAK=[[wp>Jean Kennedy Smith]]\\ (b. 1928)|EDK=[[wp>Edward Moore Kennedy]]\\ (b. 1932)
| | | | | | | | | | | |:| | | | | | | |:| |:| |:| |F|~|J| | | |:| | | |:| | | | | | | |
| | | | | | | | JLB |y|J| | | | WJC |~|J| |:| |:| |:|F|~|~|~|~|J| | | |:| | | | | | | |JLB=[[wp>Jacqueline Kennedy Onassis|Jacqueline Lee Bouvier]]\\ (1929 - 1994)|WJC=[[wp>William John Robert Cavendish, Marquess of Hartington]]\\ (1917 - 1944)
| | | | |,|-|-|-|v|-|^|-|v|-|-|-|.| | | | |:| |:| |:|:| | | | | JBK |y|J| | | | | | | |JBK=[[wp>Joan Bennett Kennedy|Virginia Joan Bennett]]\\ (b. 1936)
| | | | ARK | | CBK | | JKJ | | PBK | | | |:| |:| |:|:| | |,|-|-|-|v|^|-|-|.| | | | | |ARK=Arabella Kennedy\\ (1956 - 1956)|CBK=[[wp>Caroline Kennedy]]\\ (b. 1957)|JKJ=[[wp>John F. Kennedy, Jr.]]\\ (1960 - 1999)|PBK=[[wp>Patrick Bouvier Kennedy]]\\ (1963 - 1963)
| | | | | | | | | | | | | | | | | | | | | |:| |:| |:|:| | KAK | | EMK | | PJK | | | | |KAK=[[wp>Kara Anne Kennedy]]\\ (b. 1960)|EMK=[[wp>Edward Kennedy, Jr.]]\\ (b. 1961)|PJK=[[wp>Patrick J. Kennedy]]\\ (b. 1967)
| | | | | | | | | SAS |y|~|~|~|~|~|~|~|~|~|J| |:| |:|:| | | | | | | | | | | | | | | | |SAS=[[wp>Sargent Shriver]]\\ (b. 1915)
| |,|-|-|-|v|-|-|-|v|-|^|-|v|-|-|-|.| | |F|~|~|J| |:|L|~|~|~|~|y| SES | | | | | | | | |SES=[[wp>Stephen Edward Smith]]\\ (1927-1990)
| RSS | | MOS | | TPS | | MKS | | APS | |:| |F|~|~|J| | | | | |!| | | | | | | | | | | |RSS=[[wp>Robert Sargent Shriver III]]\\ (b. 1954)|MOS=[[wp>Maria Shriver]]\\ (b. 1955)|TPS=[[wp>Timothy Perry Shriver]]\\ (b. 1959)|MKS=[[wp>Mark Kennedy Shriver]]\\ (b. 1964)|APS=[[wp>Anthony Paul Kennedy Shriver]]\\ (b. 1965)
| | | | | | | | | | | | | | | | | | | | |:| |:| | |,|-|-|-|v|-|^|-|v|-|-|-|.| | | | | |
| | | | | | | | | | PEL |y|~|~|~|~|~|~|~|J| |:| | SEJ | | WKS | | AMS | | KMS | | | | |PEL=[[wp>Peter Lawford]]\\ (1923 - 1984)|SEJ=Stephen Edward Smith, Jr.\\ (b. 1957)|WKS=[[wp>William Kennedy Smith]]\\ (b. 1960)|AMS=Amanda Mary Smith\\ (b. 1967)|KMS=Kym Maria Smith\\ (b. 1972)
| | | | | | |,|-|-|-|v|-|^|-|v|-|-|-|.| | | |:| | | | | | | | | | | | | | | | | | | | |
| | | | | | CKL | | SML | | VFL | | REL | | |L|y| ETS | | | | | | | | | | | | | | | | |CKL=[[wp>Christopher Lawford]]\\ (b. 1955)|SML=Sydney Maleia Lawford\\ (b.1956)|VFL=Victoria Francis Lawford\\ (b. 1958)|REL=Robin Elizabeth Lawford\\ (b. 1961)|ETS=[[wp>Ethel Skakel Kennedy|Ethel Skakel]]\\ (b. 1928)
| |,|-|-|-|v|-|-|-|v|-|-|-|v|-|-|-|v|-|-|-|v|-|^|-|v|-|-|-|v|-|-|-|v|-|-|-|v|-|-|-|.| |
| KHK | | JPK | | RFK | | DAK | | MCK | | MLK | | MKK | | CGK | | MMK | | DHK | | REK |KHK=[[wp>Kathleen Kennedy Townsend]]\\ (b. 1951)|JPK=[[wp>Joseph Patrick Kennedy II]]\\ (b. 1952)|RFK=[[wp>Robert F. Kennedy, Jr.]]\\ (b. 1954)|DAK=[[wp>David Kennedy]]\\ (1955 - 1984)|MCK=[[wp>Courtney Kennedy Hill]]\\ (b. 1956)|MLK=[[wp>Michael LeMoyne Kennedy]]\\ (1958 - 1997)|MKK=[[wp>Kerry Kennedy]]\\ (b. 1959)|CGK=[[wp>Christopher George Kennedy]]\\ b. 1963)|MMK=[[wp>Matthew Maxwell Taylor Kennedy]]\\ (b. 1965)|DHK=[[wp>Douglas Harriman Kennedy]]\\ (b. 1967)|REK=[[wp>Rory Kennedy]]\\ (b. 1968)
</diagram>

James Kennedy
(c. 1770 - c. 1840)

Maria Kennedy
(c. 1775 - 1835)

Patrick Kennedy
(c. 1823 - 1858)

Bridget Murphy
(1824 - 1888)

Mary L. Kennedy
(1851 - 1926)

Joanna L. Kennedy
(1852 - 1926)

John Kennedy
(1854 - 1855)

Margaret M. Kennedy
(1855 - 1929)

Patrick Joseph Kennedy
(1858 - 1929)

Mary Augusta Hickey
(1857 - 1923)

Joseph P. Kennedy, Sr.
(1888 - 1969)

Rose Elizabeth Fitzgerald
(1890 - 1995)

Joseph Patrick Kennedy Jr.
(1915 - 1944)

John Fitzgerald Kennedy
(1917 - 1963)

Rosemary Kennedy
(1918 - 2005)

Kathleen Cavendish, Marchioness of Hartington
(1920 - 1948)

Eunice Kennedy Shriver
(b. 1921)

Patricia Kennedy Lawford
(1924 - 2006)

Robert Francis Kennedy
(1925 – 1968)

Jean Kennedy Smith
(b. 1928)

Edward Moore Kennedy
(b. 1932)

Jacqueline Lee Bouvier
(1929 - 1994)

William John Robert Cavendish, Marquess of Hartington
(1917 - 1944)

Virginia Joan Bennett
(b. 1936)

Arabella Kennedy
(1956 - 1956)

Caroline Kennedy
(b. 1957)

John F. Kennedy, Jr.
(1960 - 1999)

Patrick Bouvier Kennedy
(1963 - 1963)

Kara Anne Kennedy
(b. 1960)

Edward Kennedy, Jr.
(b. 1961)

Patrick J. Kennedy
(b. 1967)

Sargent Shriver
(b. 1915)

Stephen Edward Smith
(1927-1990)

Robert Sargent Shriver III
(b. 1954)

Maria Shriver
(b. 1955)

Timothy Perry Shriver
(b. 1959)

Mark Kennedy Shriver
(b. 1964)

Anthony Paul Kennedy Shriver
(b. 1965)

Peter Lawford
(1923 - 1984)

Stephen Edward Smith, Jr.
(b. 1957)

William Kennedy Smith
(b. 1960)

Amanda Mary Smith
(b. 1967)

Kym Maria Smith
(b. 1972)

Christopher Lawford
(b. 1955)

Sydney Maleia Lawford
(b.1956)

Victoria Francis Lawford
(b. 1958)

Robin Elizabeth Lawford
(b. 1961)

Ethel Skakel
(b. 1928)

Kathleen Kennedy Townsend
(b. 1951)

Joseph Patrick Kennedy II
(b. 1952)

Robert F. Kennedy, Jr.
(b. 1954)

David Kennedy
(1955 - 1984)

Courtney Kennedy Hill
(b. 1956)

Michael LeMoyne Kennedy
(1958 - 1997)

Kerry Kennedy
(b. 1959)

Christopher George Kennedy
b. 1963)

Matthew Maxwell Taylor Kennedy
(b. 1965)

Douglas Harriman Kennedy
(b. 1967)

Rory Kennedy
(b. 1968)

Визуализированное дерево

Пример: Генеалогическое древо Кеннеди со стрелками Теперь добавим стрелки. Здесь они немного избыточны, но это для большего разнообразия.

<diagram>
| |   | | |    JAK    |y@aa|     MAK     |    |    |   |   | |   |   |   |    | |    | |    | |   |   |    | |   | |    | |   |    |    | |   | | | |   | |JAK=James Kennedy\\ (c. 1770 - c. 1840)|MAK=Maria Kennedy\\ (c. 1775 - 1835)
| |   | | |   |   |   |!@4 |   |    |    |    |    |   |   | |   |   |   |    | |    | |    | |   |   |    | |   | |    | |   |    |    | |   | | | |   | |
| |   | | |   |   |    PAK     |y@aa|     BMK      |   |   | |   |   |   |    | |    | |    | |   |   |    | |   | |    | |   |    |    | |   | | | |   | |PAK=[[wp>Patrick Kennedy (1823–1858)|Patrick Kennedy]]\\ (c. 1823 - 1858)|BMK=[[wp>Bridget Murphy Kennedy|Bridget Murphy]]\\ (1824 - 1888)
| |,@4|-|-|-  |v@4|-  |-   |-  |+@e |-   |-   |-   |v@4|-  |-|-  |.@4|   |    | |    | |    | |   |   |    | |   | |    | |   |    |    | |   | | | |   | |
|  MLK  | |    JLK    |    |     JOK     |    |    MMK     | |    PJK    |y@aa|  MAH   |    | |   |   |    | |   | |    | |   |    |    | |   | | | |   | |MLK=Mary L. Kennedy\\ (1851 - 1926)|JLK=Joanna L. Kennedy\\ (1852 - 1926)|JOK=John Kennedy\\ (1854 - 1855)|MMK=Margaret M. Kennedy\\ (1855 - 1929)|PJK=[[wp>P. J. Kennedy|Patrick Joseph Kennedy]]\\ (1858 - 1929)|MAH=[[wp>Mary Augusta Hickey Kennedy|Mary Augusta Hickey]]\\ (1857 - 1923)
| |   | | |   |   |   |    |   |    |    |    |    |   |   | |   |   |   |!@4 | |    | |    | |   |   |    | |   | |    | |   |    |    | |   | | | |   | |
| |   | | |   |   |   |    |   |    |    |    |    |   |   | |   |   |   JPK    |y@aa|  RFK   |   |   |    | |   | |    | |   |    |    | |   | | | |   | |JPK=[[wp>Joseph P. Kennedy, Sr.]]\\ (1888 - 1969)|RFK=[[wp>Rose Fitzgerald Kennedy|Rose Elizabeth Fitzgerald]]\\ (1890 - 1995)
| |   | | |   |,@4|-  |-   |-  |v@4 |-   |-   |-   |v@4|-  |-|-  |v@4|-  |-   |-|+@e |-|-   |-|v@4|-  |-   |-|v@4|-|-   |-|v@4|-   |-   |-|.@4| | | |   | |
| |   | | |    JPK    |    |     JFK     |7@88|    ROK     | |    KAK    |7@88|  EMK   |F@22|   PAK   |F@22|  RFK  |F@22|   JAK    |F@22|  EDK  | | |   | |JPK=[[wp>Joseph Patrick Kennedy Jr.]]\\ (1915 - 1944)|JFK=[[wp>John Fitzgerald Kennedy]]\\ (1917 - 1963)|ROK=[[wp>Rosemary Kennedy]]\\ (1918 - 2005)|KAK=[[wp>Kathleen Cavendish, Marchioness of Hartington]]\\ (1920 - 1948)|EMK=[[wp>Eunice Kennedy Shriver]]\\ (b. 1921)|PAK=[[wp>Patricia Kennedy Lawford]]\\ (1924 - 2006)|RFK=[[wp>Robert Francis Kennedy]]\\ (1925 – 1968)|JAK=[[wp>Jean Kennedy Smith]]\\ (b. 1928)|EDK=[[wp>Edward Moore Kennedy]]\\ (b. 1932)
| |   | | |   |   |   |    |   |    |    |:   |    |   |   | |   |   |   |:   | |:@4 | |:   | |F  |~  |J   | |   | |:   | |   |    |:   | |   | | | |   | |
| |   | | |   |   |   |     JLB     |y@aa|J   |    |   |   |   WJC   |~@2|J   | |:   | |:   | |:  |F  |~   |~|~  |~|J   | |   |    |:   | |   | | | |   | |JLB=[[wp>Jacqueline Kennedy Onassis|Jacqueline Lee Bouvier]]\\ (1929 - 1994)|WJC=[[wp>William John Robert Cavendish, Marquess of Hartington]]\\ (1917 - 1944)
| |   | | |,@4|-  |-  |-   |v@4|-   |^@a |-   |v@4 |-  |-  |-|.@4|   |   |    | |:   | |:   | |:  |:  |    | |   | |   JBK    |y@aa|J   | |   | | | |   | |JBK=[[wp>Joan Bennett Kennedy|Virginia Joan Bennett]]\\ (b. 1936)
| |   | |   ARK   |   |     CBK     |    |     JKJ     |   |   PBK   |   |    | |:   | |:   | |:  |:  |    | |,@4|-|-   |-|v@4|^@a |-   |-|.@4| | | |   | |ARK=Arabella Kennedy\\ (1956 - 1956)|CBK=[[wp>Caroline Kennedy]]\\ (b. 1957)|JKJ=[[wp>John F. Kennedy, Jr.]]\\ (1960 - 1999)|PBK=[[wp>Patrick Bouvier Kennedy]]\\ (1963 - 1963)
| |   | | |   |   |   |    |   |    |    |    |    |   |   | |   |   |   |    | |:@4 | |:@4 | |:@4|:@4|    |  KAK  |    |   EMK    |    |  PJK  | | |   | |KAK=[[wp>Kara Anne Kennedy]]\\ (b. 1960)|EMK=[[wp>Edward Kennedy, Jr.]]\\ (b. 1961)|PJK=[[wp>Patrick J. Kennedy]]\\ (b. 1967)
| |   | | |   |   |   |    |     SAS     |y@aa|~   |~  |~  |~|~  |~  |~  |~   |~|J   | |:   | |:  |:  |    | |   | |    | |   |    |    | |   | | | |   | |SAS=[[wp>Sargent Shriver]]\\ (b. 1915)
| |,@4|-|-|-  |v@4|-  |-   |-  |v@4 |-   |^@a |-   |v@4|-  |-|-  |.@4|   |    |F|~   |~|J   | |:  |L  |~   |~|~  |~|y@aa|   SES    |    | |   | | | |   | |SES=[[wp>Stephen Edward Smith]]\\ (1927-1990)
|  RSS  | |    MOS    |    |     TPS     |    |    MKS     | |    APS    |    |:|    |F|~   |~|J  |   |    | |   | |!   | |   |    |    | |   | | | |   | |RSS=[[wp>Robert Sargent Shriver III]]\\ (b. 1954)|MOS=[[wp>Maria Shriver]]\\ (b. 1955)|TPS=[[wp>Timothy Perry Shriver]]\\ (b. 1959)|MKS=[[wp>Mark Kennedy Shriver]]\\ (b. 1964)|APS=[[wp>Anthony Paul Kennedy Shriver]]\\ (b. 1965)
| |   | | |   |   |   |    |   |    |    |    |    |   |   | |   |   |   |    |:|    |:|    | |,@4|-  |-   |-|v@4|-|^@a |-|v@4|-   |-   |-|.@4| | | |   | |
| |   | | |   |   |   |    |   |     PEL      |y@aa|~  |~  |~|~  |~  |~  |~   |J|    |:|    |   SEJ   |    |  WKS  |    |   AMS    |    |  KMS  | | |   | |PEL=[[wp>Peter Lawford]]\\ (1923 - 1984)|SEJ=Stephen Edward Smith, Jr.\\ (b. 1957)|WKS=[[wp>William Kennedy Smith]]\\ (b. 1960)|AMS=Amanda Mary Smith\\ (b. 1967)|KMS=Kym Maria Smith\\ (b. 1972)
| |   | | |   |   |,@4|-   |-  |-   |v@4 |-   |^@a |-  |v@4|-|-  |-  |.@4|    | |    |:|    | |   |   |    | |   | |    | |   |    |    | |   | | | |   | |
| |   | | |   |    CKL     |   |     SML      |    |   VFL   |   |    REL     | |    |L|y@aa|   ETS   |    | |   | |    | |   |    |    | |   | | | |   | |CKL=[[wp>Christopher Lawford]]\\ (b. 1955)|SML=Sydney Maleia Lawford\\ (b.1956)|VFL=Victoria Francis Lawford\\ (b. 1958)|REL=Robin Elizabeth Lawford\\ (b. 1961)|ETS=[[wp>Ethel Skakel Kennedy|Ethel Skakel]]\\ (b. 1928)
| |,@4|-|-|-  |v@4|-  |-   |-  |v@4 |-   |-   |-   |v@4|-  |-|-  |v@4|-  |-   |-|v@4 |-|^@a |-|v@4|-  |-   |-|v@4|-|-   |-|v@4|-   |-   |-|v@4|-|-|-|.@4| |
|  KHK  | |    JPK    |    |     RFK     |    |    DAK     | |    MCK    |    |  MLK   |    |   MKK   |    |  CGK  |    |   MMK    |    |  DHK  | |  REK  |KHK=[[wp>Kathleen Kennedy Townsend]]\\ (b. 1951)|JPK=[[wp>Joseph Patrick Kennedy II]]\\ (b. 1952)|RFK=[[wp>Robert F. Kennedy, Jr.]]\\ (b. 1954)|DAK=[[wp>David Kennedy]]\\ (1955 - 1984)|MCK=[[wp>Courtney Kennedy Hill]]\\ (b. 1956)|MLK=[[wp>Michael LeMoyne Kennedy]]\\ (1958 - 1997)|MKK=[[wp>Kerry Kennedy]]\\ (b. 1959)|CGK=[[wp>Christopher George Kennedy]]\\ b. 1963)|MMK=[[wp>Matthew Maxwell Taylor Kennedy]]\\ (b. 1965)|DHK=[[wp>Douglas Harriman Kennedy]]\\ (b. 1967)|REK=[[wp>Rory Kennedy]]\\ (b. 1968)
</diagram>

James Kennedy
(c. 1770 - c. 1840)

Maria Kennedy
(c. 1775 - 1835)

Patrick Kennedy
(c. 1823 - 1858)

Bridget Murphy
(1824 - 1888)

Mary L. Kennedy
(1851 - 1926)

Joanna L. Kennedy
(1852 - 1926)

John Kennedy
(1854 - 1855)

Margaret M. Kennedy
(1855 - 1929)

Patrick Joseph Kennedy
(1858 - 1929)

Mary Augusta Hickey
(1857 - 1923)

Joseph P. Kennedy, Sr.
(1888 - 1969)

Rose Elizabeth Fitzgerald
(1890 - 1995)

Joseph Patrick Kennedy Jr.
(1915 - 1944)

John Fitzgerald Kennedy
(1917 - 1963)

Rosemary Kennedy
(1918 - 2005)

Kathleen Cavendish, Marchioness of Hartington
(1920 - 1948)

Eunice Kennedy Shriver
(b. 1921)

Patricia Kennedy Lawford
(1924 - 2006)

Robert Francis Kennedy
(1925 – 1968)

Jean Kennedy Smith
(b. 1928)

Edward Moore Kennedy
(b. 1932)

Jacqueline Lee Bouvier
(1929 - 1994)

William John Robert Cavendish, Marquess of Hartington
(1917 - 1944)

Virginia Joan Bennett
(b. 1936)

Arabella Kennedy
(1956 - 1956)

Caroline Kennedy
(b. 1957)

John F. Kennedy, Jr.
(1960 - 1999)

Patrick Bouvier Kennedy
(1963 - 1963)

Kara Anne Kennedy
(b. 1960)

Edward Kennedy, Jr.
(b. 1961)

Patrick J. Kennedy
(b. 1967)

Sargent Shriver
(b. 1915)

Stephen Edward Smith
(1927-1990)

Robert Sargent Shriver III
(b. 1954)

Maria Shriver
(b. 1955)

Timothy Perry Shriver
(b. 1959)

Mark Kennedy Shriver
(b. 1964)

Anthony Paul Kennedy Shriver
(b. 1965)

Peter Lawford
(1923 - 1984)

Stephen Edward Smith, Jr.
(b. 1957)

William Kennedy Smith
(b. 1960)

Amanda Mary Smith
(b. 1967)

Kym Maria Smith
(b. 1972)

Christopher Lawford
(b. 1955)

Sydney Maleia Lawford
(b.1956)

Victoria Francis Lawford
(b. 1958)

Robin Elizabeth Lawford
(b. 1961)

Ethel Skakel
(b. 1928)

Kathleen Kennedy Townsend
(b. 1951)

Joseph Patrick Kennedy II
(b. 1952)

Robert F. Kennedy, Jr.
(b. 1954)

David Kennedy
(1955 - 1984)

Courtney Kennedy Hill
(b. 1956)

Michael LeMoyne Kennedy
(1958 - 1997)

Kerry Kennedy
(b. 1959)

Christopher George Kennedy
b. 1963)

Matthew Maxwell Taylor Kennedy
(b. 1965)

Douglas Harriman Kennedy
(b. 1967)

Rory Kennedy
(b. 1968)

Визуализированное дерево

Дополнительные тесты Использование всех типов подключения:

<diagram>
| | |v| | | | |V| | |
| |,|!|.| | |F|:|7| | | |y| | |p| |
|)|-|+|-|(|D|~|%|~|C| |}| |{|]| |[| |*| |#|
| |`|!|'| | |L|:|J| | | |h| | |b| |
| | |^| | | | |A| | |
</diagram>

Использование всех типов стрелок:

c@0

c@1

c@2

c@3

c@4

c@5

c@6

c@7

c@8

c@9

c@a

c@b

c@c

c@d

c@e

c@f

c@00

c@10

c@20

c@30

c@40

c@50

c@60

c@70

c@80

c@90

c@a0

c@b0

c@c0

c@d0

c@e0

c@f0

c@01

c@11

c@21

c@31

c@41

c@51

c@61

c@71

c@81

c@91

c@a1

c@b1

c@c1

c@d1

c@e1

c@f1

c@02

c@12

c@22

c@32

c@42

c@52

c@62

c@72

c@82

c@92

c@a2

c@b2

c@c2

c@d2

c@e2

c@f2

c@03

c@13

c@23

c@33

c@43

c@53

c@63

c@73

c@83

c@93

c@a3

c@b3

c@c3

c@d3

c@e3

c@f3

c@04

c@14

c@24

c@34

c@44

c@54

c@64

c@74

c@84

c@94

c@a4

c@b4

c@c4

c@d4

c@e4

c@f4

c@05

c@15

c@25

c@35

c@45

c@55

c@65

c@75

c@85

c@95

c@a5

c@b5

c@c5

c@d5

c@e5

c@f5

c@06

c@16

c@26

c@36

c@46

c@56

c@66

c@76

c@86

c@96

c@a6

c@b6

c@c6

c@d6

c@e6

c@f6

c@07

c@17

c@27

c@37

c@47

c@57

c@67

c@77

c@87

c@97

c@a7

c@b7

c@c7

c@d7

c@e7

c@f7

c@08

c@18

c@28

c@38

c@48

c@58

c@68

c@78

c@88

c@98

c@a8

c@b8

c@c8

c@d8

c@e8

c@f8

c@09

c@19

c@29

c@39

c@49

c@59

c@69

c@79

c@89

c@99

c@a9

c@b9

c@c9

c@d9

c@e9

c@f9

c@0a

c@1a

c@2a

c@3a

c@4a

c@5a

c@6a

c@7a

c@8a

c@9a

c@aa

c@ba

c@ca

c@da

c@ea

c@fa

c@0b

c@1b

c@2b

c@3b

c@4b

c@5b

c@6b

c@7b

c@8b

c@9b

c@ab

c@bb

c@cb

c@db

c@eb

c@fb

c@0c

c@1c

c@2c

c@3c

c@4c

c@5c

c@6c

c@7c

c@8c

c@9c

c@ac

c@bc

c@cc

c@dc

c@ec

c@fc

c@0d

c@1d

c@2d

c@3d

c@4d

c@5d

c@6d

c@7d

c@8d

c@9d

c@ad

c@bd

c@cd

c@dd

c@ed

c@fd

c@0e

c@1e

c@2e

c@3e

c@4e

c@5e

c@6e

c@7e

c@8e

c@9e

c@ae

c@be

c@ce

c@de

c@ee

c@fe

c@0f

c@1f

c@2f

c@3f

c@4f

c@5f

c@6f

c@7f

c@8f

c@9f

c@af

c@bf

c@cf

c@df

c@ef

c@ff

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Script viewer-static.min

В случае блокировки ресурса https://viewer.diagrams.net в загрузке ниже находиться файл viewer-static.min.js для запуска Диаграммы со своего сервера.

Файл для загрузки

Plugin Diagram
Script viewer-static.min.js для для запуска диаграмм в случае блокировки ресурса.
draw.io версия для windows ПК

Лицензия

Author: nikita.melnichenko
License: GNU GPL v2

discussion

anonymous@undisclosed.example.com (Anonymous) — Thu, 10 Aug 2023 18:17:03 +0000

Discussion для «ДокуВики»

Добавляет раздел комментариев на вики-страницы. Плагин обсуждения добавляет раздел обсуждения после вашей вики-страницы для комментариев пользователей. Это полезно для разделения содержимого страницы и его обсуждения, а также, если вы не хотите давать обычным пользователям право редактировать страницу, но по-прежнему хотите, чтобы заметки добавлялись пользователями.

Второй компонент этого подключаемого модуля показывает список всех страниц в пространстве имен с разделом обсуждения (называемым ветками обсуждения), упорядоченным по самым последним комментариям. Это позволяет вам создать очень простой дискуссионный форум в вашей вики.

Релиз: 2020-09-22.
Репозиторий:https://github.com/dokufreaks/plugin-discussion
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Пожалуйста, сообщайте об ошибках или пожеланиях в Bug tracker.

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Компоненты

Раздел комментариев

Это основная часть плагина. При включении ~~DISCUSSION~~ инструкции на вашу вики-страницу раздел обсуждения будет добавлен после обычного содержимого вики-страницы. Чтобы снова отключить его, используйте ~~DISCUSSION:off~~. Если вы хотите показать существующее обсуждение, но не хотите разрешать новые комментарии/ответы, используйте ~~DISCUSSION:closed~~.

~~DISCUSSION~~
~~DISCUSSION:off~~
~~DISCUSSION:closed~~

Пользовательский заголовок может быть добавлен после разделителя |.

~~DISCUSSION|Custom Title String~~
~~DISCUSSION:closed|Custom Title String~~

После каждого комментария в разделе обсуждения может быть до трех кнопок (в зависимости от ваших прав):

Ответ: Чтобы ответить на комментарий (вместо комментирования содержимого вики-страницы), нажмите кнопку Reply Затем форма ввода комментариев будет размещена соответствующим образом.
Редактировать: зарегистрированные пользователи могут редактировать свои комментарии; администраторы могут редактировать все комментарии. Чтобы удалить комментарий, просто отредактируйте его, очистите текст и сохраните пустой комментарий, как если бы вы делали это со страницей вики.

Удалить: Зарегистрированные пользователи и администратор всех комментариев.

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

Конечно, весь синтаксис «ДокуВики» можно использовать и в комментариях. Но есть проблемы с заголовками и сносками, поскольку они могут создавать конфликтующие идентификаторы и, следовательно, неверный XHTML. Я ищу способ либо разрешить только часть синтаксиса вики, либо автоматически создавать уникальные идентификаторы.

Синтаксис потоков

Это отображает список всех страниц данного пространства имен с разделом обсуждения. Список отсортирован по последнему комментарию.

{{threads>[namespace]&[count=n]&[flags]&skipempty}}

[namespace]	пространство имен, для которого вы хотите список потоков обсуждения; `:` это верхнее пространство имен, `.` это то же пространство имен, в котором находится страница `*` вся вики	необходимый
[count=n]	количество обсуждений, которые должны отображаться (допустимые значения: n > 0)	необязательный
[flags]	флаги списка страниц, разделенные `&`см. флаги	необязательный
skipempty	Не печатать обсуждения без комментариев	необязательный
nonewthreadform	Не показывать новую форму формы темы под таблицей	необязательный

По умолчанию новая форма потока отображается под списком. См. threads_formposition настройку, чтобы переместить его в начало списка или отключить эту форму.

Применение

Если вы не добавите следующий код в файл main.php вашего шаблона, ссылки для цитирования не появятся!

В main.php добавьте следующее в начало файла:

<?php if (file_exists(DOKU_PLUGIN.'cite/code.php')) include_once(DOKU_PLUGIN.'cite/code.php'); ?>

<?php if (function_exists('cite_getPermURL')) { ?><a href="<?php echo cite_getPermURL(); ?>" rel="nofollow">Permanent Link</a><?php } ?>
<?php if (function_exists('cite_getCiteURL')) { ?><a href="<?php echo cite_getCiteURL(); ?>" rel="nofollow">Cite this Page</a><?php } ?>

Конфигурация

Плагин можно настроить с помощью менеджера конфигурации «ДокуВики», доступного в меню администратора.

`automatic`	автоматически включает обсуждения на всех страницах
`excluded_ns`	список пространств имен, для которых нужно отменить `automatic` настройку конфигурации (регулярное выражение, например `/(playground\|wiki)/`, разделитель должен быть включен, например, '/' в начале и в конце)
`visibilityButton`	Включить кнопку для переключения видимости всего раздела обсуждения
`allowguests`	allow/disallow (разрешить/запретить) незарегистрированным пользователям оставлять комментарии
`showguests`	show/hide (показать/скрыть) комментарии для незарегистрированных пользователей
`linkmail`	связать имя пользователя с указанным почтовым адресом
`useavatar`	отображать аватары (требуется плагин Avatar)
`urlfield`	разрешить отправку URL-адреса домашней страницы (будет связан с именем, если не `linkmail` установлено)
`addressfield`	разрешите указать адрес
`adminimport`	администратор может заполнить все поля (только для импорта)
`wikisyntaxok`	allow wiki syntax in comments¹⁾
`threads_formposition`	позиция новой формы потока, показанная с синтаксисомe {{threads> }} (до или под списком потоков)
`subscribe`	разрешить подписку на комментарии (использует двойную подписку), если используются подписки на страницы , они используются только для незарегистрированных пользователей.
`newestfirst`	Инвертировать порядок отображения комментариев
`usethreading`	включить/отключить цепочку комментариев
`userealname`	отображать настоящее имя вместо имени пользователя зарегистрированных пользователей вики
`moderate`	модерировать новые комментарии
`moderatorgroups`	добавить группы для делегирования административного контроля (например `@coadmins,@mods`)
`moderatorsnotify`	отправлять уведомление всем указанным модераторам всякий раз, когда был отправлен новый комментарий

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

discussion.zip

Лицензия

Author: Michael Hamann, Gina Häußge, Michael Klier
License: GNU GPL v2

¹⁾

Снимите флажок с этого параметра, чтобы избежать проблем с плагином Struct.

display

anonymous@undisclosed.example.com (Anonymous) — Thu, 10 Aug 2023 21:00:47 +0000

Display Wiki Page для «ДокуВики»

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

Релиз: 2020-09-19.
Репозиторий:https://github.com/tatewake/dokuwiki-plugin-displaywikipage
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

2009-05-28 «Манеры Фрустерика»
- Не работает: auth_aclquickcheck не может обрабатывать начальные двоеточия в идентификаторах, поэтому я чувствую, что это все еще не работает в «ДокуВики», но, по крайней мере, плагин может правильно учитывать ACL .

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Плагин также экспортирует функцию для использования с вашим шаблоном, поэтому вам нужно будет вставить следующий код в свой шаблон где-то внутри тегов <head></head> .

Обычно вы захотите сделать это для любых файлов PHP (или HTML) содержащих строку «<head>»; как минимум вы можете сделать только main.php.¹³⁾

<?php if (file_exists(DOKU_PLUGIN.'displaywikipage/code.php')) include_once(DOKU_PLUGIN.'displaywikipage/code.php'); ?>

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

Чтобы отобразить вики-страницу в любой точке вашего документа, используйте следующий код:

<?php if (function_exists('dwp_display_wiki_page')) dwp_display_wiki_page(":path:to:page"); ?>

Выполнение этого таким образом позволит вашим пользователям использовать шаблон независимо от того, установлен ли у вас плагин.

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

displaywikipage.zip

Лицензия

Author: Terence J. Grant
License: GNU GPL v2
Donate: Click here.

¹³⁾

Если вы делаете только main.php, вы пропустите некоторые типы страниц (например, файл загрузки), поэтому я предлагаю искать теги заголовка во всех файлах PHP в шаблоне, чтобы убедиться, что вы их все получили.

docnavigation

anonymous@undisclosed.example.com (Anonymous) — Wed, 30 Aug 2023 07:50:32 +0000

DocNavigation для «ДокуВики»

Добавьте навигационные ссылки на предыдущую и следующую страницу вверху и внизу вики-страницы.

Релиз: 2023-01-23.
Репозиторий:https://github.com/Klap-in/dokuwiki-plugin-docnavigation/
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Пожалуйста, сообщайте обо всех своих ошибках и пожеланиях в системе отслеживания ошибок.

Пример работы виден на этой странице внизу и вверху, ссылки работают, но, несмотря на все тесты совместимости у меня дает ошибку <doctoc>: страница wiki:plugin:dokuteaser не ссылается на wiki:plugin:docnavigation.

<- wiki:plugin:display|Display Wiki Page для «ДокуВики» ^ wiki:plugin:plugins|основные_плагены ^ wiki:plugin:dokuteaser|Dokuteaser для «ДокуВики» ->

Пример ошибки:

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

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

<- namespace:previous_page ^ namespace:startpage ^ namespace:next page ->

или, как вариант, только другой синтаксис (например, нужен в сочетании с плагином ckgedit)

<< namespace:previous_page ^ namespace:startpage ^ namespace:next page >>

А на стартовой странице можно поставить автогенерируемое оглавление с помощью

<doctoc start= yournamespace:firstpage>

Конфигурация и настройки

Навигация по страницам URL-адреса отображаются с именами ссылок по умолчанию, полученными из URL-адреса или настройки useheading.

<-namespace:previous^namespace:startpage^namespace:next->

URL-адреса отображаются с указанными именами.

<-previous|Your previous page^startpage|Overview^other_page|Navigate to next page ->

Пример навигации, добавленной плагином DocNavigation. Здесь включена конфигурация useheading, так что заголовки страниц используются в качестве имени ссылки.

Оглавление, созданное из связанных страниц

Оглавление связанных страниц может быть создано с помощью <doctoc optionname=value[, more=..]>.

<doctoc>
<doctoc start=firstpage, includeheadings=2-3>

возможные варианты:

Вариант	Описание
`start=<pageid>`	Идентификатор страницы первой страницы с постраничной навигацией, если он не указан, поиск постраничной навигации осуществляется на текущей странице.
`includeheadings=<topheading>-<maxheading>`	Включает заданные уровни заголовков страницы в оглавление. например `2-3` По умолчанию: `2` (уровни пронумерованы от 1 до 5)
`hidepagelink=<0 or 1>`	Скрыть ссылки на страницы, но показать по умолчанию первые два уровня оглавления. С помощью `includeheadings` настройки можно изменить количество уровней. Если используется only `includeheadings`, отображаются ссылки на страницы, что может привести к дублированию заголовков, если отображается уровень 1.
`useheading=<0 or 1>`	Отменяет «навигацию» в настройке useheading .

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

dokuwiki-plugin-docnavigation-master.zip

Лицензия

Author: Gerrit Uitslag
License: GNU GPL v2

dokuteaser

anonymous@undisclosed.example.com (Anonymous) — Sat, 19 Aug 2023 00:28:50 +0000

Dokuteaser для «ДокуВики»

Дает возможность использовать блок заключенный между <dokuteaser> и </dokuteaser>, который помещает текст в заданную часть без применения таблиц и прочего. Он отсутствует в официальной странице плагинов, но его можно найти на странице автора и создателя «Докувики».

Релиз: н.д.
Репозиторий:https://github.com/splitbrain/dokuwiki-plugin-dokuteaser
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

~~У него пока нет известных ошибок.~~¹⁾

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Настраивать нечего не нужно.

<dokuteaser>
==== Почему «Докувики»? ====
{{ :wiki:dokuwiki-128.png?nolink&80|Логотип «Докувики»}}
«Докувики» --- популярный выбор, когда вам нужна вики, и она имеет много преимуществ перед аналогичным программным обеспечением.
 
  * Легко установить и использовать
  * Низкие системные требования
  * Встроенный контроль доступа (ACL)
  * Большой выбор расширений
  * Поддерживаются более 50 языков
  * Аппаратно-независимое ПО
  * Открытый исходный код
 
[[:features|Узнайте больше о возможностях «Докувики»]]
</dokuteaser>

Пример вывода блока

Почему «Докувики»?

«Докувики» — популярный выбор, когда вам нужна вики, и она имеет много преимуществ перед аналогичным программным обеспечением.

Легко установить и использовать
Низкие системные требования
Встроенный контроль доступа (ACL)
Большой выбор расширений
Поддерживаются более 50 языков
Аппаратно-независимое ПО
Открытый исходный код

Узнайте больше о возможностях «Докувики»

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

dokuteaser

Лицензия

Author: Andreas Gohr
License: GNU GPL v2

¹⁾

Такое заявление долго не выдержит…

dw2pdf

anonymous@undisclosed.example.com (Anonymous) — Sat, 02 Sep 2023 16:28:37 +0000

DW2PDF для «ДокуВики»

Экспортирует страницы вики в формат PDF.

Задача плагина - создать простой и готовый работе конвертер PDF, который почти точно копирует экранное изображение ваших вики-страниц (то есть не конвертирует их в формат печатного документа, как плагин Latex). Он также объединяет в себе необходимые шрифты и библиотеки (отсюда размер 48 МБ), поэтому вам не нужно выполнять какие-либо настройки, чтобы запустить его.

Релиз: 2019-06-19.
Репозиторий:https://github.com/splitbrain/dokuwiki-plugin-dw2pdf
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Плагин не может быть установлен через менеджер плагинов в версиях вики, предшествующих Angua, потому что он слишком много весит, и менеджер плагинов потерпит неудачу при загрузке. Пожалуйста, установите его вручную и убедитесь, что установленный каталог называется dw2pdf.

Поддерживается только PHP 5.6 и новее для dw2pdf plugin.

Чтобы экспортировать изображения с альфа-каналом (используется для прозрачности), вам необходимо установить библиотеку GD для PHP. Пример для Debian:

sudo apt-get install php5-gd

Также смотри PHP with gd.

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

По ссылке:

Скопируйте адрес из ссылки «Скачать» из формы вверху этой страницы. Вставьте его в Менеджере Плагинов вашего сайта во вкладке «Ручная установка» в первое поле. Нажмите кнопку «Установить».

Применение

Существует три способа экспорта:

Экспорт одной страницы
Вам нужно открыть страницу с дополнительным параметром в URL: do=export_pdf. Начнется экспорт страницы в PDF. Некоторые вики-шаблоны позволяют плагину автоматически расширять pagetools. Для других шаблонов вам нужно самостоятельно добавлять кнопку или что-то подобное для быстрого вызова плагина.

Экспорт всего пространства имен
Существует параметр URL do=export_pdfns, который позволяет экспортировать выбранное целое пространство имен как один PDF (например, используйте &do=export_pdfns&book_ns=my:namespace&book_title=Mytitle (См. Параметры конфигурации о том, как исключить определенные страницы. Или создайте ссылку с синтаксисом).

Экспорт выбранных страниц
Если вам нужно выбрать только несколько страниц для экспорта в один PDF, вы можете использовать плагин Bookcreator, который предлагает интерфейс для плагина dw2pdf.

Практические рекомендации

Особенности

Использует PHP-библиотекуmPDF. Обрабатывает разные языки (в плагин входит большой, но относительно полный шрифт Unicode). Простая настройка верхних и нижних колонтитулов и CSS Автоматический индекс закладок Работает с плагином BookCreator для создания PDF из набора выбранных страниц.

Конфигурация и настройки

Пожалуйста, ознакомьтесь со следующими страницами, чтобы узнать, как использовать или поддерживать плагин:

Установите Опции конфигурации через URL или через Менеджер конфигурации
Как добавить кнопку экспорта в pagetools/menu's
Макет и настройка экспортированного PDF для вашего (корпоративного) шаблона
Разработчики плагинов: Как поддерживать экспорт в PDF в вашем плагине

Синтаксис

Чтобы создать ссылку на любой вики-странице для экспорта любого пространства имен, вы можете использовать следующий синтаксис:

~~PDFNS>namespace|pdftitle~~

namespace - это пространство имен, которое вы хотите экспортировать
pdftitle - заголовок будущего PDF
Вы можете добавить дополнительные параметры (например, &book_order=pagename) просто добавив их в pdftitle.

Обработка startpages: Если страницы <namespace>:start нет, то проверяется, существует ли пространство имен с названием <namespace>, и добавляет его в PDF.

Проблемы и запросы

Пожалуйста, сообщайте о проблемах и запросах в трекере:
https://github.com/splitbrain/dokuwiki-plugin-dw2pdf/issues/

Как собрать больше информации для отладки?

Если вы используете плагин dw2pdf и не получаете желаемый результат, вы можете исследовать данные во время его работы. Плагин dw2pdf использует HTML-код печатной версии статьи вики (стиль которого более скромный, чем у экранной версии) и преобразует этот код с библиотекой mPDF в pdf-файл.

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

Как вывести простой HTML (непосредственно перед его подачей в библиотеку mPDF):

Включите режим отладки вики с помощью настройки allowdebug (также см. debugging)
Добавьте параметр url к URL-адресу, используемому для запуска экспорта в PDF-файл (скопируйте и измените ссылку на кнопку или URL-адрес, который вы используете):
- При добавлении &debughtml=text HTML отображается в виде обычного текста в браузере.
- При добавлении &debughtml=html отображается HTML, отрендеренный браузером.

См. Параметры отладки библиотеки mPDF, связанные с изображениями в mPDF: images documentation.

Связанные изображения

Картинки не всех форматов успешно встраиваются в PDF, даже если они отображаются в DokuWiki. Если в PDF отсутствуют изображения, попробуйте удалить альфа-канал из ваших (например, PNG) изображений.

* Библиотека mPDF, используемая этим плагином для построения PDF, требует библиотеки GD для обработки изображений .png с альфа-каналами.

Если вы размещаете изображения через полные ссылки http, то убедитесь, что права доступа настроены для непосредственного получения изображения (тест в браузере). DokuWiki может запретить внешний доступ к изображениям в каталоге data/media.

Защита паролем сгенерированных документов

Чтобы установить фиксированный пароль для сгенерированных документов, отредактируйте:

dokuwiki/lib/plugins/dw2pdf/mpdf/config.php

и добавьте следующие строки:

$this->setUserRights();
$this->SetProtection(array('print','copy', 'modify'),'password','password');

где password - ваш пароль :) (filips)

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

dokuwiki-plugin-dw2pdf-master.zip

Лицензия

Author: Andreas Gohr and Gerrit Uitslag
License: GNU GPL v2

edittable

anonymous@undisclosed.example.com (Anonymous) — Thu, 10 Aug 2023 18:47:27 +0000

EditTable для «ДокуВики»

Предоставляет визуальный интерфейс редактирования и вставки таблиц. Этот плагин добавляет дополнительную кнопку редактирования в каждую таблицу. С помощью этой кнопки можно редактировать таблицу в визуальном интерфейсе, подобном Excel. Плагин также добавляет на стандартную панель инструментов кнопку для вставки новых таблиц с помощью этого редактора.

Этот плагин был первоначально разработан Адрианом Лангом. Плагин был в основном переписан и теперь основан на плагине Handsontable jQuery , который входит в комплект и не требует отдельной загрузки.

Релиз: 2023-01-14.
Репозиторий:https://github.com/cosmocode/edittable/
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Не совместим с IE8.

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

При обновлении с версии до 2014 года вам необходимо удалить и переустановить плагин. В противном случае старые файлы могут помешать правильной работе плагина. Убедитесь, что у вас нет каталога action.php.

Применение

После установки плагина все таблицы будут иметь свою кнопку редактирования. Это откроет таблицу в плагине editTable.

При редактировании текста в обычном редакторе новую таблицу можно вставить с помощью кнопки .

Редактирование

Выберите ячейку клавишей табуляции, клавишами курсора или щелчком мыши. Чтобы перезаписать содержимое ячейки, просто начните печатать, чтобы изменить содержимое ячейки, нажмите Enter или дважды щелкните ячейку. Чтобы подтвердить редактирование, нажмите Enter или перейдите к другой ячейке.

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

Управление ячейками

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

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

Передвижения

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

Чтобы переместить строку, возьмитесь за ручку в верхней части ее ячейки заголовка, а затем переместите ее в нужное место.

Для перемещения столбцов возьмитесь за ручку слева от ячейки заголовка.

Изменение размера

В целях редактирования размер столбцов можно изменить вручную, перетащив маркер справа от ячейки заголовка. Обратите внимание, что это не сохраняется в «ДокуВики» (поскольку «ДокуВики» не имеет ширины или других свойств для таблиц), но может быть хорошим подспорьем при редактировании больших таблиц с большим количеством столбцов, которые могут поместиться на экранной странице с меньшей прокруткой, путем изменения ширины столбца.

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

edittable.zip

Лицензия

Author: Andreas Gohr
License: GNU GPL v2

htmlmetatags

anonymous@undisclosed.example.com (Anonymous) — Tue, 29 Aug 2023 18:57:06 +0000

HtmlMetaTags для «ДокуВики»

Добавляет некоторые метатеги (открытый график) в заголовок html (например, ключевые слова, описание или любые другие). Этот плагин обогащает html-страницу всеми метатегами, которые вы хотите, например, ключевыми словами, описанием и любыми другими. Некоторая метаинформация очень полезна веб-сканерам для индексации и категоризации страницы.

Расширяется с версией V2.0: эта версия позволяет добавлять:

открывайте метатеги графа, такие как og:description , og:image …
ссылка на медиафайл. теги должны начинаться с media-
media-og:image=(:wiki:image.jpg)
несколько вызовов htmlmetatags, все значения будут добавлены

Релиз: 2023-06-12.
Репозиторий:https://github.com/heikoS2C/htmlmetatags
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Примечание. Начальная версия этого плагина несовместима с новой версией V2.xy. Разница между атрибутом и разделителем значений изменена с «:» на «=».

  {{htmlmetatags>metatag-keywords=(values) metatag-og:description=(open graph description.)}}

Примечание. Разрывы строк можно без проблем добавлять внутри {{ }}.

  {{htmlmetatags>metatag-keywords=(values)
    metatag-og:description=(open graph description.)
  }}

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

С помощью строки {{htmlmetatags>...}} на уровне страницы вы активируете плагин. Начальная строка «metatag-» обозначает тег веб-сайта. После этой ведущей строки следует ключ из тега. В =(...) пропишите значение тега.

Кроме того, плагин находится на уровне страницы.

Пример активации плагина на вашей странице напишите:

{{htmlmetatags>metatag-mytag=(some usefull text)}}

Метатег: mytag — любое слово. Это слово является именем нового метатега, например ключевого слова. Далее это имя следует писать = с помощью ('...'). В этих скобках содержится текст, необходимый для значения нового метатега.

Вы можете написать более одного метатега на странице через пробел.

{{htmlmetatags>metatag-robots=() 
metatag-keywords=(apfel,bananne,birne) 
metatag-description=(Allgemeiner Obstbauer)
metatag-media-og:image=(:wiki:image.jpg)
metatag-og:description=(anything else)
metatag-og:any=(anything else 2)
}}

Результат на веб - странице:

<meta name="robots" content="noindex,nofollow"/>
<meta name="keywords" content="apfel,bananne,birne"/>
<meta name="description" content="Allgemeiner Obstbauer"/>
<meta property="og:image" content="http://localhost/lib/exe/fetch.php?media=wiki:image.jpg"/>
<meta property="og:description" content="anything else"/>
<meta property="og:any" content="anything else 2"/>

Конфигурация и настройки

В этом разделе объясняются некоторые полезные советы по использованию плагина. Проверьте сгенерированный HTML-код на наличие правильного метатега и оптимизируйте его с помощью этого плагина. Сканеры (например, Google) собирают свои данные, считывая метатег, а затем — содержимое. Разумеется, каждый сканер использует собственный алгоритм индексации веб-страниц.

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

htmlmetatags-master.zip

Лицензия

Author: Soft2C.de
License: GNU GPL v2

htmlok

anonymous@undisclosed.example.com (Anonymous) — Sat, 01 Feb 2025 06:58:17 +0000

htmlok для «ДокуВики»

Позволяет встраивать HTML и PHP в вики-страницы. Предупреждение о безопасности (пожалуйста, ознакомьтесь с рекомендациями по безопасности плагинов ): это расширение позволяет выполнять сценарии. Его следует использовать только в том случае, если вы доверяете ВСЕМ редакторам, что лучше всего подходит для частных личных вики.

Релиз: 2023-05-10.
Репозиторий:https://github.com/saggi-dw/dokuwiki-plugin-htmlok/
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Этот плагин позволяет использовать HTML и PHP в релизах после «Игоря». В ядре «Докувики» поддержка HTML и PHP была удалена с момента выпуска « Джек Джекрам » по соображениям безопасности. В этом аспекте этот плагин также следует рассматривать критически!

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

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Одновременно установленный конфигхтмок ( htmlokalt ) с отключенной обработкой ведет к исходникам а не результат выводится!

Обратите внимание : встраивание HTML и PHP по умолчанию отключено в конфигурации. Если отключено, код отображается, а не выполняется.

Код плагина был взят из оригинальной реализации в ядре «ДокуВики». Таким образом, использование также такое же:

Синтаксис

Вы можете вставлять необработанный код HTML или PHP в свои документы, используя теги <html> or <php> tags. (Используйте теги в верхнем регистре, если вам нужно заключить элементы блочного уровня.)

Пример HTML :

<html>
This is some <span style="color:red;font-size:150%;">inline HTML</span>
</html>

<HTML>
<p style="border:2px dashed red;">And this is some block HTML</p>
</HTML>

Пример PHP:

<php>
echo 'The PHP version: ';
echo phpversion();
echo ' (generated inline HTML)';
</php>

<PHP>
echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
echo '<td>'.phpversion().'</td>';
echo '</tr></table>';
</PHP>

Конфигурация и настройки

Для HTML	Вы должны активировать в конфигурации плагина `Allow embedded HTML`.
Для PHP	Вы должны активировать `Allow embedded PHP` в конфигурации плагина.

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

dokuwiki-plugin-htmlok-2023-05-10.zip

Лицензия

Author: saggi, glen
License: GNU GPL v2

icons

anonymous@undisclosed.example.com (Anonymous) — Sun, 19 Jan 2025 09:18:16 +0000

Icons для «ДокуВики»

Предоставляет визуальный интерфейс вставки иконок Font-Awesome, Glyphicons, Material Design Icons, Typicons, Font-Linux и RPG-Awesome. Этот плагин добавляет дополнительную кнопку в редактор страниц. С помощью этой кнопки можно выбирать иконки в визуальном интерфейсе.

Этот плагин был разработан Ди Терлицци.

Релиз: 2024-10-30.
Репозиторий:https://github.com/LotarProject/dokuwiki-plugin-icons/
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

2024-02-06 «Kaos» да
2023-04-04 «Jack Jackrum» да
2022-07-31 «Igor» да
2020-07-29 «Hogfather» да

Примечание: При возникновении ошибки вида Error: Call to undefined function trigger_event() в 2024-02-06 «Kaos» смотрите вариант исправления ниже в разделе Часто задаваемых вопросов.

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в <dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Дополнительные внешние требования: Для этого плагина требуются следующие дополнительные компоненты, которые необходимо установить отдельно:

Примеры/Использование

Посмотрите на плагин в действии здесьздесь. На странице-образце показаны все стили, доступные в плагине.

Простое использование:

{{icon>home}}

Некоторые более сложные варианты использования:

{{icon>home?24&circle&padding=10px&background=#DDD&color=#CCC}}
{{fa>home|My Home}}
{{fugue>user?24}}
{{silk>anchor}}
{{flag>no}}
[[:wiki:welcome|{{fa>home?24|Welcome to DokuWiki}}]]
[[https://github.com/LotarProject/dokuwiki-plugin-icons|{{fa>github-square?24|Icons DokuWiki plugin on GitHub}}]]

Синтаксис

Базовый синтаксис

{{icon>icon-name&flags|title}}

Синтаксис ссылки DokuWiki

[[:dokuwiki:page|{{icon>icon-name&flags|title}}]]

Синтаксис внешней ссылки

[[protocol://host/path|{{icon>icon-name&flags|title}}]]

Доступные пакеты иконок

Пакет
`icon`	стандартный набор иконок (см. defaultPack)
`fa`	Font-Awesome	font icon
`ra`	RPG-Awesome	font icon
`glyphicon`	Glyphicons	font icon
`typcn`	Typicons	font icon
`mdi`	Material Design Icons	font icon
`fl`	Font-Linux	font icon
`fugue`	Fugue
`oxygen`	KDE Oxygen
`breeze`	KDE Plasma Breeze

Всплывающий помощник

Icons plugin provide a popup helper to easy add the icons in your page. To open the popup click to DokuWiki icon in the toolbar in edit page.

The popup support this icon packs:

Font-Awesome
RPG-Awesome
Typicons
Material Design Icons
Glyphicons

Конфигурация и настройки

Вариант конфигурации	Значение по умолчанию	Описание
`defaultSize`	`16`	Значение по умолчанию, если размер не указан
`defaultPack`	`fa`	Пакет иконок по умолчанию, если не указано иное
`loadFontAwesome`	`On`	Font Awesome : разрешить/запретить загрузку CSS (отключите, если у вас шаблон на основе Bootstrap3)
`loadTypicons`	`Off`	Typicons : включить значок шрифта
`loadFontlinux`	`Off`	Font-Linux : включить значок шрифта
`loadMaterialDesignIcons`	`On`	Иконки материалов : включить значок шрифта
`loadRpgAwesome`	`On`	Font-Linux : включить значок шрифта
`fugueURL`	(CDN URL)	Fugue CDN или локальный URL
`oxygenURL`	(CDN URL)	KDE Oxygen CDN или локальный URL
`breezeURL`	(CDN URL)	KDE Plasma Breeze CDN или локальный URL
`silkURL`	(CDN URL)	Silk CDN или локальный URL
`flagURL`	(CDN URL)	Флаг CDN или локальный URL

ПРИМЕЧАНИЕ для пакета значков флагов: по умолчанию используются флаги из плагина перевода присутствующего в вашей установке DokuWiki..

Флаги

Флаг	Значение	Описание
`size`	(см. defaultSizeвариант)	Размер значка (в пикселях)
`pack`	(см. defaultPackвариант)	Набор иконок (fa, glyphicon, fugue, oxygen)
`circle`	-	Создайте круг вокруг значка.
`border`	-	Добавьте рамку вокруг значка
`borderColor`	-	Установить цветную границу
`padding`	-	Применить отступ к иконке (в пикселях)
`background`	-	Применить фон к значку (в шестнадцатеричном формате или в виде названия цвета)
`color`	-	Применить цвет к значку (в шестнадцатеричном формате или в виде названия цвета)
`class`	-	Добавляет дополнительные CSS- классы к значку (полезно для Font Awesome или Glyphicon)
`align`	`left\|center\|right`	Выровнять значок ( по левому краю , по правому краю или по центру)
`left`	-	Выровнять значок по левому краю
`right`	-	Выровнять значок по правому краю
`center`	-	Выровнять значок по центру

Флаги Font Awesome

Флаг	Значение	Описание
`lg`	-	Увеличение размера иконки на 33%
`2x\|3x\|4x\|5x`	-	Увеличить размер значка
`border`	-	Добавить границу к значку
`spin`	-	Добавить анимацию вращения
`pulse`	-	Добавить анимацию пульса
`rotate`	`90\|180\|270`	Повернуть значок
`flip`	`horizontal\|vertical`	Перевернуть значок
`pull-left`	-	Потяните значок влево
`pull-right`	-	Потяните значок вправо

Демо

Демонстрация и примеры доступны по адресу http://www.lotar.altervista.org/dokuwiki/wiki/plugin/icons.

Часто задаваемые вопросы

Как установить Font Awesome и Glyphicon в портативную версию Dokuwiki?

Первый шаг, скачайте пакет Font Awesome и создайте в вашей установке DokuWiki каталог (например, assets/font-awesome) и поместите все файлы. Следующий шаг в Configuration Manager, установите loadFontAwesome и введите url вашего локального пакета font awesome в fontAwesomeURL (например, /dokuwiki/assets/font-awesome/css/font-awesome.min.css).

Не работает ли плагин-помощник?

Это происходит потому, что скрипт, который использует jQuery в /lib/plugins/icons/exe/popup.php, вызывает jQuery до загрузки jQuery. Весь jQuery встроен с тегом defer, поэтому и возникает эта ошибка.

безопасное решение:

сделайте резервную копию popup.php
скопируйте скрипт, который находится внутри popup.php (скрипт для справки находится внизу этого комментария)
создайте файл popup_script.js в том же каталоге и вставьте в него этот скопированный скрипт
удалите этот скрипт из popup.php.
на место удаленного скрипта вставте скрипт следующего вида <script src=«/lib/plugins/icons/exe/popup_script.js» defer=«defer»></script>
и сохраните.

примечание: браузер игнорирует, defer если <script> не имеет src директивы. Вот о чем эта суета. Скрипт для вставки в popup.php:

<script src="/lib/plugins/icons/exe/popup_script.js" defer="defer"></script>

перезагрузите страницу, вызовите всплывающее меню, теперь все работает.

Скрипт для справки:

popup_script.js

jQuery(document).ready(function() {
 
      var is_bootstrap = (typeof jQuery.fn.modal !== "undefined");
 
      var $icon_pack    = jQuery('#icon_pack'),
          $icon_name    = jQuery('#icon_name'),
          $icon_size    = jQuery('#icon_size'),
          $icon_align   = jQuery('#icon_align'),
          $output       = jQuery('#output'),
          $preview      = jQuery('#preview');
 
      if (! is_bootstrap) {
        jQuery('.tab-pane').hide();
      }
 
      jQuery('button[data-icon-size]').on('click', function() {
 
        jQuery('button[data-icon-size]').removeClass('active');
        jQuery(this).addClass('active');
 
        $icon_size.val(jQuery(this).data('icon-size'));
        jQuery(document).trigger('popup:build');
 
      });
 
      jQuery('button[data-icon-align]').on('click', function() {
 
        jQuery('button[data-icon-align]').removeClass('active');
        jQuery(this).addClass('active');
 
        $icon_align.val(jQuery(this).data('icon-align'));
        jQuery(document).trigger('popup:build');
 
      });
 
      jQuery('ul.nav a').on('click', function() {
 
        if (! is_bootstrap) {
          jQuery('.tab-pane').hide();
          jQuery('ul.nav li.active').removeClass('active');
          jQuery(jQuery(this).attr('href')).show();
          jQuery(this).parent().addClass('active');
        }
 
        $icon_pack.val(jQuery(this).data('pack'));
        jQuery('.preview-box').removeClass('hide');
 
        jQuery(document).trigger('popup:reset');
 
      });
 
      jQuery('.btn-icon').on('click', function() {
        $icon_name.val(jQuery(this).data('icon-name'));
        jQuery(document).trigger('popup:build');
      });
 
      jQuery(document).on('popup:build', function() {
 
        var icon_pack  = $icon_pack.val(),
            icon_size  = $icon_size.val(),
            icon_align = $icon_align.val(),
            icon_name  = $icon_name.val();
 
        if (! icon_name) {
          return false;
        }
 
        var syntax = [ '{{' ];
 
        syntax.push(icon_pack);
        syntax.push('>' + icon_name);
 
        var icon_size_pixel = 0;
 
        switch (icon_size) {
          case 'small':
            icon_size_pixel = 24;
            break;
          case 'medium':
            icon_size_pixel = 32;
            break;
          case 'large':
            icon_size_pixel = 48;
            break;
        }
 
        if (icon_size_pixel) {
          syntax.push('?' + icon_size_pixel);
        }
 
        if (icon_align) {
          syntax.push('&align=' + icon_align);
        }
 
        syntax.push('}}');
 
        $output.val(syntax.join(''));
        $preview.text(syntax.join(''));
 
      });
 
      jQuery('#btn-reset').on('click', function() {
        jQuery(document).trigger('popup:reset');
      });
 
      jQuery(document).on('popup:reset', function() {
        jQuery('form').each(function(){
          jQuery(this)[0].reset();
        });
        $output.val('');
        $preview.text('');
      });
 
      jQuery('#btn-preview, #btn-insert').on('click', function() {
 
        if (jQuery(this).attr('id') === 'btn-insert') {
          opener.insertAtCarret('wiki__text', $output.val());
          opener.focus();
        }
 
      });
 
    });

Ссылка на решение проблеммы на форуме wiki

Альтернативный способ

загрузить измененный popup.php и файл popup_script.js
распакуйте в папку /lib/plugins/icons/exe/ с заменой файлов.

Настройка и поддержка Fontawesome 6.71

jasonwch модифицировал этот плагин для поддержки последнего набора иконок Fontawesome 6.71.

P.S. Этот ZIP-архив содержит ТОЛЬКО измененные/добавленные файлы. ОБЯЗАТЕЛЬНО установите оригинальный плагин, а затем замените/добавьте эти файлы. dw_icons_fa6.zip

Что изменено в модифицированной версии:

заменен набор иконок на Fontawesome 6.71. Поскольку 6.71 отделил иконки брендов, для таких иконок есть дополнительная вкладка/префикс
(должно быть) совместимым с уже добавленными значками FA из предыдущей версии, поэтому старые страницы не нужно обновлять вручную
добавить дополнительную вкладку руководства во всплывающем окне для более удобного использования тегов
В сочетании с исправлением js defer, оригинальный скрипт расширения должен отключить defer JS со страницы конфигурации для работы. Из issue#26, «inbsp» предоставил исправление для разделения JS, чтобы исправить эту ошибку. Однако, когда всплывающее окно появляется, вам все равно нужно переключить страницу один раз, чтобы отобразить значки.

Техническое примечание:

Я использовал Node.js для извлечения нового имени значка в виде списка для замены оригинального list-font-awesome.php ( https://github.com/mackilroy007/font-awesome-v6 )

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

Ссылка на оригинальный текст icons_plugens_new.rar

Ошибка вида Error: Call to undefined function trigger_event()

Данная ошибка может возникнуть при обновлении dokuwiki с 2023-04-04 «Jack Jackrum» на 2024-02-06 «Kaos» и означает Вызов неопределенной функции trigger_event().

Имя класса dokuwiki\Extension\Event
Публичный метод trigger()- автоматическая сигнализация событий. Этот метод принимает два необязательных параметра: действие по умолчанию (обратный вызов) и то, можно ли его предотвратить (bool), и возвращает результаты события. Он отслеживает весь процесс события, сигнализируя совет «ДО», запуская действие по умолчанию и сигнализируя совет «ПОСЛЕ».

popur.php

$tmp = array();
trigger_event('MEDIAMANAGER_STARTED', $tmp);
session_write_close();  //close session

безопасное решение:
в начале добавляем класс Event use dokuwiki\Extension\Event;

popur.php

require_once(DOKU_INC.'inc/init.php');
require_once(DOKU_INC.'inc/template.php');
require_once(DOKU_INC.'inc/lang/en/lang.php');
require_once(DOKU_INC.'inc/lang/'.$conf['lang'].'/lang.php');
use dokuwiki\Extension\Event;

Меняем код вызова функции trigger_event('MEDIAMANAGER_STARTED', $tmp); на Event::createAndTrigger('MEDIAMANAGER_STARTED', $tmp);

popur.php

$tmp = array();
Event::createAndTrigger('MEDIAMANAGER_STARTED', $tmp);
session_write_close();  //close session

Сохраняем, очищаем кэш local.php и перегружаем страницу редактора dokuwiki в раскрывшемся окне выбираем понравившуюся иконку и вставляем в тело страницы

«См.подробности редактирования файла popur.php»

popur.php

<?php
/**
 * Plugin Icons: Popup helper
 * 
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     Giuseppe Di Terlizzi <giuseppe.diterlizzi@gmail.com>
 * @copyright  (C) 2015-2019, Giuseppe Di Terlizzi
 */
 
if (!defined('DOKU_INC')) define('DOKU_INC', dirname(__FILE__).'/../../../../');
define('DOKU_MEDIAMANAGER', 1); // needed to get proper CSS/JS
 
global $lang;
global $conf;
global $JSINFO;
 
require_once(DOKU_INC.'inc/init.php');
require_once(DOKU_INC.'inc/template.php');
require_once(DOKU_INC.'inc/lang/en/lang.php');
require_once(DOKU_INC.'inc/lang/'.$conf['lang'].'/lang.php');
use dokuwiki\Extension\Event;
$JSINFO['id']        = '';
$JSINFO['namespace'] = '';
 
$tmp = array();
Event::createAndTrigger('MEDIAMANAGER_STARTED', $tmp);
session_write_close();  //close session
 
 
$icons_plugin = plugin_load('action','icons');
 
$use_font_awesome          = $icons_plugin->getConf('loadFontAwesome');
$use_material_design_icons = $icons_plugin->getConf('loadMaterialDesignIcons');
$use_typicons              = $icons_plugin->getConf('loadTypicons');
$use_font_linux            = $icons_plugin->getConf('loadFontlinux');
$use_rpg_awesome           = $icons_plugin->getConf('loadRpgAwesome');
$use_glyphicons            = false;
 
# Load Bootstrap3 Template assets
if ($conf['template'] == 'bootstrap3') {
 
  include_once(DOKU_INC.'lib/tpl/bootstrap3/tpl_functions.php');
  include_once(DOKU_INC.'lib/tpl/bootstrap3/tpl_global.php');
 
  # Glyphicons is bundled into Bootstrap 3.x
  $use_glyphicons = true;
 
}
 
$list_material_design_icons = include(dirname(__FILE__) . '/list-material-design-icons.php');
$list_font_awesome          = include(dirname(__FILE__) . '/list-font-awesome.php');
# add V6 brand icons
$list_font_awesome_br       = include(dirname(__FILE__) . '/list-font-awesome-br.php');
# add V6 brand icons 
$list_glyphicon             = include(dirname(__FILE__) . '/list-glyphicon.php');
$list_typicons              = include(dirname(__FILE__) . '/list-typicons.php');
$list_font_linux            = include(dirname(__FILE__) . '/list-font-linux.php');
$list_rpg_awesome           = include(dirname(__FILE__) . '/list-rpg-awesome.php');
 
header('Content-Type: text/html; charset=utf-8');
header('X-UA-Compatible: IE=edge,chrome=1');
 
?><!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="<?php echo $conf['lang'] ?>" lang="<?php echo $conf['lang'] ?>" dir="<?php echo $lang['direction'] ?>" class="no-js">
<head>
  <meta charset="UTF-8" />
  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  <title>Icons Plugin</title>
  <script>(function(H){H.className=H.className.replace(/\bno-js\b/,'js')})(document.documentElement)</script>
  <meta name="viewport" content="width=device-width,initial-scale=1" />
  <?php echo tpl_favicon(array('favicon', 'mobile')) ?>
  <?php tpl_metaheaders() ?>
  <style type="text/css">
    body { padding: 20px; }
    .btn-icon { margin: 4px; padding: 4px; }
    .tab-icons { overflow-y: auto; height: 300px; }
    .icon { font-size: 2em; width: 1.28571429em;
 text-align: center; }
    <?php if (! $use_glyphicons): ?>
    footer { bottom: 20px; position: fixed; }
    .col-sm-6 { width:50%; float: left; }
    .col-sm-4 { width:33.3%; float: left; }
    .tab-pane, .hide { display: none; }
    button.active { border-style: inset; }
    <?php endif; ?>
  </style>
<!-- <script type="text/javascript"> -->
 
<script src="popup_script.js" defer="defer"></script>
<!--  </script> -->
</head>
<body class="container-fluid dokuwiki">
 
  <ul class="tabs nav nav-tabs" role="tablist">
 
    <?php if ($use_font_awesome): ?>
	<!-- add FA6 brand icons + modify naming -->
    <li>
      <a data-toggle="tab" href="#tab-font-awesome" data-pack="fa">FA-Solid</a>
    </li>
	<li>
      <a data-toggle="tab" href="#tab-font-awesome-br" data-pack="fab">FA-Brands</a>
    </li>
	<!-- add FA6 brand icons -->
    <?php endif; ?>
    <?php if ($use_glyphicons): ?>
    <li>
      <a data-toggle="tab" href="#tab-glyphicon" data-pack="glyphicon">Glyphicons</a>
    </li>
    <?php endif; ?>
    <?php if ($use_material_design_icons): ?>
    <li>
      <a data-toggle="tab" href="#tab-mdi" data-pack="mdi">Material Design Icons</a>
    </li>
    <?php endif; ?>
    <?php if ($use_typicons): ?>
    <li>
      <a data-toggle="tab" href="#tab-typicons" data-pack="typcn">Typicons</a>
    </li>
    <?php endif; ?>
    <?php if ($use_font_linux): ?>
    <li>
      <a data-toggle="tab" href="#tab-font-linux" data-pack="fl">Font-Linux</a>
    </li>
    <?php endif; ?>
    <?php if ($use_rpg_awesome): ?>
    <li>
	 <!-- bug fix for wrong tag of RPG-Awesome
     <a data-toggle="tab" href="#tab-rpg-awesome" data-pack="fa">RPG-Awesome</a> -->
	 <a data-toggle="tab" href="#tab-rpg-awesome" data-pack="ra">RPG-Awesome</a>
    </li>
    <?php endif; ?>
 
<!-- add guideling page -->
	<li>
	 <a data-toggle="tab" href="#tab-guide" data-pack="">Guide</a>
    </li>
<!-- add guideling page -->
  </ul>
 
  <main class="tab-content">
 
<!-- add guideling page -->
    <div id="tab-guide" class="tab-pane fade">
<p>
<table>
    <thead>
        <tr>
            <th>Flag</th>
            <th>Flag (FA)</th>
            <th>Values</th>
            <th>Description </th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>size</td>
            <td>-</td>
            <td>(see&nbsp;defaultSize&nbsp;option)</td>
            <td>Size of icon (in pixel) </td>
        </tr>
        <tr>
            <td>pack</td>
            <td>-</td>
            <td>(see&nbsp;defaultPack&nbsp;option)</td>
            <td>Icon pack (fa, glyphicon, fugue, oxygen)</td>
            <td>
            </td>
        </tr>
        <tr>
            <td>circle</td>
            <td>-</td>
            <td>-</td>
            <td>Create a&nbsp;circle&nbsp;around the icon </td>
        </tr>
        <tr>
            <td>border</td>
            <td>-</td>
            <td>-</td>
            <td>Add a&nbsp;border&nbsp;around the icon </td>
        </tr>
        <tr>
            <td>borderColor</td>
            <td>-</td>
            <td>-</td>
            <td>Set the color border </td>
        </tr>
        <tr>
            <td>padding</td>
            <td>-</td>
            <td>-</td>
            <td>Apply a&nbsp;padding&nbsp;to the icon (in pixel) </td>
        </tr>
        <tr>
            <td>background</td>
            <td>-</td>
            <td>-</td>
            <td>Apply a&nbsp;background&nbsp;to the icon (in hex or color name) </td>
        </tr>
        <tr>
            <td>color</td>
            <td>-</td>
            <td>-</td>
            <td>Apply a&nbsp;color&nbsp;to the icon (in hex or color name) </td>
        </tr>
        <tr>
            <td>class</td>
            <td>-</td>
            <td>-</td>
            <td>Adds additional&nbsp;CSS&nbsp;classes to the icon (useful for Font Awesome or Glyphicon) </td>
        </tr>
        <tr>
            <td>align</td>
            <td>-</td>
            <td>left|center|right</td>
            <td>Align icon (left,&nbsp;right&nbsp;or&nbsp;center)</td>
            <td>
            </td>
        </tr>
        <tr>
            <td>left</td>
            <td>-</td>
            <td>-</td>
            <td>Align icon to&nbsp;left </td>
        </tr>
        <tr>
            <td>right</td>
            <td>-</td>
            <td>-</td>
            <td>Align icon to&nbsp;right </td>
        </tr>
        <tr>
            <td>center</td>
            <td>-</td>
            <td>-</td>
            <td>Align icon to&nbsp;center </td>
        </tr>
        <tr>
            <td>-</td>
            <td>lg</td>
            <td>-</td>
            <td>Increase of 33% the size of icon </td>
        </tr>
        <tr>
            <td>-</td>
            <td>2x|3x|4x|5x</td>
            <td>-</td>
            <td>Increase the size of icon </td>
        </tr>
        <tr>
            <td>-</td>
            <td>border</td>
            <td>-</td>
            <td>Add border to icon </td>
        </tr>
        <tr>
            <td>-</td>
            <td>spin</td>
            <td>-</td>
            <td>Add spin animation </td>
        </tr>
        <tr>
            <td>-</td>
            <td>pulse</td>
            <td>-</td>
            <td>Add pulse animation </td>
        </tr>
        <tr>
            <td>-</td>
            <td>rotate</td>
            <td>90|180|270</td>
            <td>Rotate the icon </td>
        </tr>
        <tr>
            <td>-</td>
            <td>flip</td>
            <td>horizontal|vertical</td>
            <td>Flip the icon </td>
        </tr>
        <tr>
            <td>-</td>
            <td>pull-left</td>
            <td>-</td>
            <td>Pull the icon to left </td>
        </tr>
        <tr>
            <td>-</td>
            <td>pull-right</td>
            <td>-</td>
            <td>Pull the icon to right </td>
        </tr>
        <tr></tr>
    </tbody>
</table>
 
 
    </div>
<!-- add guideling page -->
 
 
 
    <div id="tab-font-awesome" class="tab-pane fade">
 
      <div class="row tab-icons">
        <?php foreach($list_font_awesome as $icon): ?>
          <div class="col-sm-4">
            <button class="btn btn-default btn-xs btn-icon" title="<?php echo $icon ?>" data-icon-name="<?php echo $icon ?>">
			<!-- modify FA6 new coding
              <i class="fa fa-fw fa-2x fa-<?php echo $icon ?>"></i>
			  -->
			  <i class="fa-solid fa-fw fa-2x fa-<?php echo $icon ?>"></i>
            </button>
            <small><?php echo $icon ?></small>
          </div>
        <?php endforeach ?>
      </div>
 
    </div>
<!-- add FA6 brand icons -->
	<div id="tab-font-awesome-br" class="tab-pane fade">
 
      <div class="row tab-icons">
        <?php foreach($list_font_awesome_br as $icon): ?>
          <div class="col-sm-4">
            <button class="btn btn-default btn-xs btn-icon" title="<?php echo $icon ?>" data-icon-name="<?php echo $icon ?>">
              <i class="fa-brands fa-fw fa-2x fa-<?php echo $icon ?>"></i>
            </button>
            <small><?php echo $icon ?></small>
          </div>
        <?php endforeach ?>
      </div>
    </div>
<!-- add FA6 brand icons -->
 
    <div id="tab-rpg-awesome" class="tab-pane fade">
 
      <div class="row tab-icons">
        <?php foreach($list_rpg_awesome as $icon): ?>
          <div class="col-sm-4">
            <button class="btn btn-default btn-xs btn-icon" title="<?php echo $icon ?>" data-icon-name="<?php echo $icon ?>">
              <i class="ra ra-fw ra-2x ra-<?php echo $icon ?>"></i>
            </button>
            <small><?php echo $icon ?></small>
          </div>
        <?php endforeach ?>
      </div>
 
    </div>
 
    <div id="tab-mdi" class="tab-pane fade">
 
      <div class="row tab-icons">
        <?php foreach($list_material_design_icons as $icon): ?>
          <div class="col-sm-4">
            <button class="btn btn-default btn-xs btn-icon" title="<?php echo $icon ?>" data-icon-name="<?php echo $icon ?>">
              <i class="icon mdi mdi-<?php echo $icon ?>"></i>
            </button>
            <small><?php echo $icon ?></small>
          </div>
        <?php endforeach ?>
      </div>
 
    </div>
 
    <div id="tab-glyphicon" class="tab-pane fade">
 
      <div class="row tab-icons">
        <?php foreach($list_glyphicon as $icon): ?>
          <div class="col-sm-4">
            <button class="btn btn-default btn-xs btn-icon" title="<?php echo $icon ?>" data-icon-name="<?php echo $icon ?>">
              <i class="icon glyphicon glyphicon-<?php echo $icon ?>"></i>
            </button>
            <small><?php echo $icon ?></small>
          </div>
        <?php endforeach ?>
      </div>
 
    </div>
 
    <div id="tab-typicons" class="tab-pane fade">
 
      <div class="row tab-icons">
        <?php foreach($list_typicons as $icon): ?>
          <div class="col-sm-4">
            <button class="btn btn-default btn-xs btn-icon" title="<?php echo $icon ?>" data-icon-name="<?php echo $icon ?>">
              <i class="fa-fw fa-2x typcn typcn-<?php echo $icon ?>"></i>
            </button>
            <small><?php echo $icon ?></small>
          </div>
        <?php endforeach ?>
      </div>
 
    </div>
 
    <div id="tab-font-linux" class="tab-pane fade">
 
      <div class="row tab-icons">
        <?php foreach($list_font_linux as $icon): ?>
          <div class="col-sm-4">
            <button class="btn btn-default btn-xs btn-icon" title="<?php echo $icon ?>" data-icon-name="<?php echo $icon ?>">
              <i class="icon fl fl-<?php echo $icon ?>"></i>
            </button>
            <small><?php echo $icon ?></small>
          </div>
        <?php endforeach ?>
      </div>
 
    </div>
 
    <div class="preview-box hide">
 
      <hr/>
 
      <div class="row">
 
        <div class="box-alignment col-sm-6">
          <label>Alignment</label>
          <div class="btn-group btn-group-xs">
            <button class="button btn btn-default active" data-icon-align="" title="Use no align">
              <img src="../../../images/media_align_noalign.png" />
            </button><button class="button btn btn-default" data-icon-align="left" title="Align the icon on the left">
              <img src="../../../images/media_align_left.png" />
            </button><button class="button btn btn-default" data-icon-align="center" title="Align the icon in the center">
              <img src="../../../images/media_align_center.png" />
            </button><button class="button btn btn-default" data-icon-align="right" title="Align the icon on the right">
              <img src="../../../images/media_align_right.png" />
            </button>
          </div>
        </div>
 
        <div class="box-size col-sm-6">
          <label>Image size</label>
          <div class="btn-group btn-group-xs">
            <button class="button btn btn-default" data-icon-size="small" title="Small size">
              <img src="../../../images/media_size_small.png" />
            </button><button class="button btn btn-default" data-icon-size="medium" title="Medium size">
              <img src="../../../images/media_size_medium.png" />
            </button><button class="button btn btn-default" data-icon-size="large" title="Large size">
              <img src="../../../images/media_size_large.png" />
            </button><button class="button btn btn-default active" data-icon-size="original" title="Original size">
              <img src="../../../images/media_size_original.png" />
            </button>
          </div>
        </div>
 
      </div>
 
      <p>&nbsp;</p>
 
      <label>Preview</label>
      <pre id="preview"></pre>
 
      <input type="hidden" id="output" />
      <input type="hidden" id="icon_pack" />
      <input type="hidden" id="icon_name" />
      <input type="hidden" id="icon_size" />
      <input type="hidden" id="icon_align" />
 
    </div>
 
  </main>
 
  <footer>
    <nav class="navbar navbar-default navbar-fixed-bottom">
      <div class="container-fluid">
        <div class="navbar-text">
          <button type="button" id="btn-preview" class="hidden btn btn-default">Preview code</button>
          <button type="button" id="btn-insert" class="btn btn-success">Insert</button>
          <button type="button" id="btn-reset" class="btn btn-default">Reset</button>
        </div>
      </div>
    </nav>
  </footer>
 
</body>
</html>

Скачайте мод архив icons_kaos.zip и разорхивируйте
Установите плагин icons.zip через менеджер плагинов

Обновление

Для обновления удалите исходную папку lib/plugins/icons и установите новую версию, как указано выше.

Файл для загрузки

Плагин иконок icons

FortAwesome/Шрифт-Awesome Выпуск 6.7.2

Лицензия

Author: Giuseppe Di Terlizzi
License: GNU GPL v2

include

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2024 05:49:48 +0000

Include Plugin

Совместим с «Докувики»

2024-02-06 "Kaos" да
2023-04-04 "Jack Jackrum" да
2022-07-31 "Igor" да
2020-07-29 "Hogfather" да

Include another wiki page into the current one

Последнее обновление:: 2023-09-22
Предоставляет: Syntax, Helper
Репозиторий: исходный код
Конфликтует с: mediasyntax, photogallery

Это расширение не находится в пространстве имен 'plugin' или 'template' и поэтому игнорируется.

Похож на wst

Теги: embed, include

- Dokufreaks (previous authors: Michael Hamann, Gina Häußge, Michael Klier, Esther Brunner)

The 2018-11-29 release fixes a security issue where ACLs were ignored for pages in namespace includes with DokuWiki version Greebo. If you rely on ACL checks in namespace includes or allow edits from users who must not see all pages, please upgrade ASAP!

This is a handy plugin with which you can include another wiki page into the current one. Just including certain sections of a page or even whole namespaces is supported, too.

Installation

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

If you need support for older version of DokuWiki you can try the 2009-11-27 version of the include plugin, but please note that this old version has known bugs. If you need support for older versions of DokuWiki in the current include plugin version please open a feature request in the issue tracker.

Examples

{{page>wiki:syntax#Tables}} will include the section about tables of the syntax page.

{{namespace>project_foo}} will include all pages in the project_foo namespace.

{{page>blog:mypage&tags&comments}} will include the page blog:mypage and show the tags from the tag plugin and the number of comments from the discussion plugin. Both plugins need to be installed for this example.

{{tagtopic>testtag}} will include all pages with the tag testtag, the tag plugin needs to be installed for this example.

Syntax

The plugin offers four syntaxes, {{page>...}} , {{section>...}} , {{namespace>...}} and {{tagtopic>...}}.

Section is aimed more at including sections, page at including whole pages and namespace at including whole namespaces. Tagtopic includes all pages with a tagtopic tag.

{{page>[id]&[flags]}}
{{section>[id]#[section]&[flags]}}
{{namespace>[namespace]#[section]&[flags]}}
{{tagtopic>[tag]&[flags]}}

[id]	page ID of the page to include; some macros are possible; shortcuts are resolved (`:`, `.`, `..`)	required
[section]	limits the included page to a specific section and its subsections	optional; default is the whole page , this can be used with namespace (if matches)
[tag]	include pages with tag topic tag, requires tag	required
[flags]	flags delimited by `&`, see flags	optional

Configuration and Flags

The plugin can be configured in the DokuWiki configuration manager available in the admin menu. These settings also affect the blog plugin which uses the include plugin to generate the blog page. For most settings there are flags that allow to override the setting. Some features are only available as flag.

Configuration option	Flags	Description
`noheader`	`noheader`/ (`show`)`header`	Don't display the header of the inserted section
`firstseconly`	`firstsec`(`tion`)`only`/ `fullpage`	Display only the first section of the included page
`readmore`	`readmore`/`noreadmore`	Show «read more» link in case of firstsection only
`showtaglogos`	-	Show/hide an image for the first tag (if the page has tags)
`showfooter`	`footer`/`nofooter`	Show/hide page footer below the included page
`showlink`	`link`/`nolink`	Makes the first headline of a included page/section a link to the included page/section
`showpermalink`	`permalink`/ `nopermalink`	Show/hide a permalink to the included page in the page footer
`showdate`	`date`/`nodate`	Show/hide creation date of the page in the page footer
`showmdate`	`mdate`/`nomdate`	Show/hide modification date of the page in the page footer
`showuser`	`user`/`nouser`	Show/hide user name of the page creator in the page footer
`showcomments`	`comments`/`nocomments`	Show/hide number of comments in the page footer (requires the discussion plugin)
`showlinkbacks`	`linkbacks`/`nolinkbacks`	Show/hide number of linkbacks in the page footer (requires the linkback or backlinks plugin)
`showtags`	`tags`/`notags`	Show/hide tags in the page footer (requires the tag plugin)
`showeditbtn`	`editbtn` or `editbutton`/`noeditbtn` or `noeditbutton`	Show/hide edit buttons (section edit buttons, edit button below the included page)
`doredirect`	`redirect`/`noredirect`	Redirect back to original page after an edit
`usernamespace`	-	Namespace for user pages (see `showuser` configuration) (default `user`)
`doindent`	`indent`/`noindent`	Indent included pages relative to the section of the page they get included in
`linkonly`	`linkonly`/`nolinkonly` or `include_content`	Display only a link instead of the whole page content
`title`	`title`/`notitle`	Show the title instead of the page id
`pageexists`	`pageexists`/ `nopageexists`	Only list page ids of existing pages (see `existlink`)
-	`existlink`	Display a link and do so only if page page-id exists (combination of `linkonly` and `pageexists`)
`parlink`	`parlink`/`noparlink`	(Don't) put the link into a paragraph environment (for inline lists)
`order`	`order=OPTION`	Ordering criteria for namespace includes, possible options: page ID (`id`), title (`title`), date created (`created`), date modified (`modified`), indexmenu sort order (`indexmenu`), custom sort order using the `{{include_n>[number]}}` on the pages that are included similar to the indexmenu tags (`custom`).
`rsort`	`rsort`/`sort`	Reverse the sort order in namespace includes.
`depth`	`depth=DEPTH`	The maximum depth of subnamespaces of which pages are included in namespace includes, default is `1` for only the specified namespace, `0` is for unlimited depth.
-	`inline`	Don't close/open sections when including a page. This flag should be used when the include syntax is used inside other syntax elements like lists or tables or inside other plugin syntax.
-	`beforeeach=ENTITY`/ `aftereach=ENTITY`	Display an entity before/after each included page. The entity is printed outside the section/include environment, this is mainly for adding custom HTML code (when the text isn't recognized as entity it is directly displayed but escaped so you can't directly use HTML code here).
`safeindex`	-	Don't index metadata of included pages that are non-public. This can cause problems with other plugins that use the metadata index and can be safely disabled in wikis where the permissions of the included pages match the permissions of the parent pages.
-	`exclude=/REGEX/`	Regular expression to exclude certain pages, will match on full page ID. E.g. to exclude `ns:page_name` use `/ns:page_name/` as value. Use a regex tester to debug complicated patterns.

Examples:

{{page>concept&firstseconly&footer}}
{{page>mypage&noindent}}
{{namespace>myns&order=modified}}
{{namespace>myns&exclude=/myns:subns:.+|myns:page/}}

Macros

Simple macros are possible to serve a page on a per user or per date base. These are:

@USER@	username
@NAME@	full name of user
@GROUP@	first group the user belongs to
@YEAR@	4-digit year
@MONTH@	2-digit month
@WEEK@	2-digit ISO week number
@DAY@	2-digit day
@DATE<expr>@	use a calculated date instead of today in date macros

<expr> in @DATE<expr>@ can be one of:

PYEAR	previous year
NYEAR	next year
PMONTH	previous month
NMONTH	next month
PWEEK	previous week
NWEEK	next week
YESTERDAY	yesterday's date
TOMORROW	tomorrow's date

Examples:

{{page>@MONTH@:@DAY@:birthdays}}

includes the page birthdays in namespace <month>:<day>: eg. 10:15: birthdays for the 15th of october.

{{page>@USER@:message}}

includes the page message from the namespace <user> of the logged in user

{{page>foo@DATENWEEK@@YEAR@:@WEEK@}}

includes the page <weekno> from the namespace foo<year> with next week's date e.g. foo2012:01 for the 27th of december 2011

Demo

There is currently no demo site available.

Use of the plugin is shown in this video here: https://www.youtube.com/watch?v=6RO8TSZBedU&t=8m47s Video not available (2021-03-20)

Development

Change Log

Version upped (2025/07/23 02:04)
fix tag for minimum php version (2025/07/22 22:38)
Version upped (2025/07/05 02:04)
Merge pull request #363 from dokufreaks/tests (2025/07/04 20:49)
replace strftime use with dformat (2025/07/04 18:20)
use newer DokuWiki test workflow (2025/07/04 18:15)
Merge pull request #360 from dokuwiki-translate/lang_update_1151_1748… (2025/07/04 18:10)
add minimum php requirement to plugin.info.txt (2025/07/04 18:05)

Bugs / Feature Requests

Please report bugs or feature requests at the Bug tracker.

Known Bugs and Issues

There are currently no known bugs and issues for which no workarounds exist (see FAQ).

FAQ

The include plugin breaks the wrap and folded (and similar) plugins when used inside them

This can be solved by using the inline flag of the include plugin. This mode strips all section from the included page and should solve issues with invalid HTML and thus no longer working wrap and folded plugins. This also solves problems with invalid HTML code when the include plugin is used inside tables or other syntax environments. When the page contains headers this might look strange depending on the template.

Addendum

If you are using the Wrap Plugin on both the page you are using the {{section>target&inline}} from and the page target, you need to make sure any pair of WRAP tags on target are either entirely within the included section or entirely outside of the section. For instance, including the FOO section into another page might break the other page:

<WRAP right 35%>
==== FOO ====

Content goes here

</WRAP>

==== BAR ====

FOO contains the </WRAP> end-tag, but not a corresponding start-tag. Thus, if the use of include is within a WRAPed block, that WRAP block will be ended early.

The simplest solution is to never use WRAP on both pages, only on included pages or only on pages that include others – however, that's not very realistic or useful. The other (somewhat brittle) solution is to make the section on target end before the WRAP close tag. You can do this by inserting a dokuwiki section header (at the same level) before the close tag, but after the section's content. However, I've not been able to determine if this is an intended behavior of dokuwiki, or if this is undocumented behavior and therefore subject to change at any time.

So, to make the above example work correctly, it should look like this:

<WRAP right 35%>
==== BAZ ====

Content goes here

==== ====
</WRAP>

==== QUX ====

Now {{section>whatever#BAZ}} will work fine.

Is it possible to include the same page twice?

Yes, this is possible since the 2011-01-01 version and hasn't been possible before. But you can't include the same page again inside a page in order to avoid endless recursion (and things like page1 > page2 > page1 doesn't work, too).

Does the include plugin respect ACLs of the included pages?

The include plugin tries its best to respect ACLs and it should work under normal circumstances. Whenever the view permissions of included pages change the cache is purged and the included pages are adapted according to the current permissions. Due to limitations in the caching system this might fail if a page is accessed very frequently with changing permissions. If this is an issue for you you can disable caching of the affected pages using the ~~NOCACHE~~ syntax. As always there is no guarantee that everything works as expected, please test if everything works and report a bug if you should notice anything unexpected.

As of version 2012-11-24, there is a new security feature called safeindex that is turned on by default, it's purpose is to prevent the indexer from indexing metadata of included pages that aren't public. That way links that are in protected pages won't be visible as link of a public page in the backlinks list.

Why does the include plugin first close the previous section and opens it again afterwards?

This is done because if there are headers in the included page they will close the current section. As the include plugin has its own container div this would produce strange results and possibly invalid HTML. You can use the inline flag in order to avoid this (but then also all sections of the included page are removed).

Has the include plugin feature XYZ/when will you implement XYZ?

The include plugin has many feature and is very flexible and I'm willing to add more features if they fit in the general purpose of the include plugin. However there is no guarantee that I will implement a certain feature at a certain time, this depends completely on my available time and my mood. You can add your wishes to the issue tracker.

How to avoid including of whole page content if section does not exist?

If using the flag firstsectiononly in addition, could be one solve. At least in regard of avoiding very large content to be displayed. If adding a header at the source page and using tools like the hiddenheader it might solve things at the source page, but in it's case seems to conflict and break certain include flag-tasks.

Discussion

Please don't report any bugs or feature requests here but instead use the bug tracker!

If you miss a comment you've created please have a look at the FAQ section and the issue tracker, I might have moved them there, if you can't find a bug report anymore that bug should be solved, please try the current version and report it again if it still doesn't work.

Discussions in DW-forum

plugin:include / Hide current page contents once user logs in
include plugin: development in direction to use it as a kind database tool, feature inspirations.

User comments

footer.php:

// author
if ($flags['user']) {
    $author   = $meta['creator'];
    if ($author) {
        $userpage = cleanID($this->getConf('usernamespace').':'.$author);

replaced to include the real user name in the link:

// author
if ($flags['user']) {
    $author   = $meta['creator'];
    $login = $meta["last_change"]['user'];
    if ($author) {
        $userpage = cleanID($this->getConf('usernamespace').':'.$login);

User Namespace

Hi, I'm using userpagecreate plugin's to create user's namespace instead of user's page. Then, to link correctly the include's page with his last member who edit it, i rewrite the previous lines like this :

        if ($flags['user']) {
            $login = $meta['last_change']['user'];
            $author = $auth->getUserData($login);
            $author = $author['name'];
            if ($author && $login) {
                if (strstr($this->getConf('usernamespace'), '@USER@')) {
                    $userpage = cleanID(str_replace('@USER@', $login, $this->getConf('usernamespace')));
                } else {
                    $userpage = cleanID($this->getConf('usernamespace').':'.$login);
                }
                resolve_pageid(getNS($ID), $userpage, $exists);
                $class = ($exists ? 'wikilink1' : 'wikilink2');
                $link = array(
                        'url'    => wl($userpage),
                        'title'  => $userpage,
                        'name'   => hsc($author),
                        'target' => $conf['target']['wiki'],
                        'class'  => $class.' url fn',
                        'pre'    => '<span class="vcard author">',
                        'suf'    => '</span>',
                        );
                $xhtml[]    = $renderer->_formatLink($link);
            }
       }

and change my conf into :

$conf['plugin']['include']['usernamespace'] = 'user:@USER@:start';

standard configuration still works.

$conf['plugin']['include']['usernamespace'] = 'user:';

If the @USER@ wildcard is using, replace it by the login name, otherwise, use the standard include's plugin rule.

— garlik 2011/10/24 14:10

— garlik 2011/11/07 11:32 - Summmary : Update the code. will display the right modif author.

showlink vs link flag

When including a page, the flag to make the first heading a link is link, not showlink. This confused me at first because I assumed the flags would have the same names as the configuration options. Example (displays the first section of a product page, with the page heading as a link):

{{page>products:sample&firstseconly&link}}

Controlling header size in included pages

By default, the headers in included pages start one level lower than the last header in the current page. For example, if the section before the include is a level-three header, then a level-6 header in the included page will become a wimply little level-2.

If you want higher-level headers, you can trick the plugin by putting an empty header above the include. In the following example, a level-6 header in the included page will show up as level-5:

=== Some Section ===
Stuff

====== ======
{{page>somepage}}

- Zioth

Including a paragraph or excerpt from a page

See the Hidden Header plugin. -Zioth

2012-01-25 "Angua"

Just tested with the current version and it works for me. — renux 2012/02/10 12:44

Include from same page?

Using it on my knowledge wiki and it works well. However, I'd like to be able to include a section from the current page - for use with the ItemTable Plugin (along with something to hide the inline text of course. — Julian Knight 2012-03-23

Does it still work? Can't make it on my wiki page.

— Piotr 2017-10-04

Align Feature

It'll be great to be able to align included pages. Because a lot of people are using this feature for infobox purposes and some would love to be able to control the alignment of the

{{page>people:obama}}

using the core syntax by adding spaces before of after the syntax.

— James 2014-05-13 20:38

Exclude Feature

It would be nice, if there would be an «exclude» option. When we use the namespace feature, we don't want certain pages in the included in the resulting page: for example exclude «sidebar» or «start».

— Manuel 2014-10-30 02:42

I would appreciate that feature too.

— Florian 2015-07-18 18:43

Same here, the possibility of the exclusion of listed namespaces would be much appreciated.

— Tommy 2016-2-19 21:18

I totally agree.

—- Chris 2016-2-21 09:12

blog plugin supports Exclude Feature

— HsinTang 2016-07-26

I created a PR for an exclude option! Testing or adding tests would be appreciated.

— sleeping 2020-04-11 07:57

The exclude flag has been merged!

— sleeping 2020-04-16 19:28

Empty Section

We are using the plugin a lot for technical documentation. If we include a named section (#title), and that section doesn't exist, the plugin includes the whole page. This really annoying. Would it be possible to change the behavior so that if a section doesn't exist it doesn't include anything (the same as when a page doesn't exist), please?

— Simon 2015-02-02 14:50

Just thought of asking about this issue. Is there any possibility to avoid that? — Samana Johann 2018-08-20 19:45

No Other data

I love this plugin but I have a question. How do I completely remove all other data included, such as user, mdate, etc.? If I do them as individual flags I still see the grey bar under the included content. There must be a flag that just excludes all the content, right? Am I just missing it somehow?

Thanks!

— Max 2017.03.21

Hi there, I think you are looking for

{{page>ID&nouser&nodate&nofooter}}

Namespace lists using &linkonly and &beforeeach/&aftereach

I've been trying to format a list of pages generated using namespace> with &linkonly - ideally as a simple unordered list. I'm adding this paragraph to help others searching for help because it took me several hours to find out that it is not possible and this is a known issue logged as a feature request.

— vt306 2017.03.29

Thanks to Michael Hamann for the advice. The pagequery plugin is the solution for this.

— vt306 2017.04.06

Option to pass revision of main page to includes pages

We are currently using DokuWiki for technical documentation. Within DokuWiki we use the 'date_at' function (https://www.dokuwiki.org/date_at) to go back to an old revision to see which version of the page a customer recieved. It would be very usefull if the included pages would honour the revision of the main page. To clarify: if the main page is shown at a specific revision, the included pages should also be shown at the last revision before the date of the main page. Would something like that be possible to incorporate?

Thanks in advance! Ruud

Translations

If it is of use, a paticular Translation of the Plugin's info page into German can be taken from here. — Samana Johann 2018-08-20 12:11

Display search results on a page?

Hi, I was wondering if it is possible to display the search result of a term or phrase on a page?

- OYMYO

Options/arguments

I think it would be cool if this plugin supported options/arguments like in MediaWiki.

Something like this:

page1.txt

Test by {{{1}}}

page2.txt

{{page>:page1|Me}}

And page2 would be parsed into:

Test by Me

— hasha2982 2020-08-19 17:12

Sorry, didn't know about the Templater Plugin — hasha2982 2020-08-19 17:25

* https://www.dokuwiki.org/plugin:include?do=

dokufreaks-plugin-include-2023-09-22-3-ga6cfd52.tar.gz

inks4pages

anonymous@undisclosed.example.com (Anonymous) — Sat, 02 Sep 2023 15:58:54 +0000

Link4pages для «ДокуВики»

Добавляйте пользовательские ссылки во все PageMenus.

Добавление новых страниц в «ДокуВики» может оказаться не очень удобным для ваших пользователей. Плагин addnewpage помогает, но потребуется добавить код newpage на каждую страницу, чтобы сделать ее легко доступной.

Релиз: 09.08.2018.
Репозиторий:https://github.com/albinou/dokuwiki-plugin-links4pages/
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Известные ошибки и проблемы

Элемент ненумерованного спискаПожалуйста, откройте страницу GitHub page.

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Итак, этот плагин позволяет добавить кнопку «Создать новую страницу» в PageMenu (справа в шаблоне по умолчанию):

Нажатие на эту кнопку открывает пользовательскую страницу, предлагающую возможность создать новую страницу ( для создания такой страницы требуется addnewpage):

Этот плагин можно использовать для создания таких типов ссылок на любой идентификатор страницы.

Конфигурация и настройки

Можно настроить следующие элементы:

Ссылка на идентификатор страницы (например, «wiki:new-page»)
Метка ссылки (например, «Создать новую страницу»)
Значок SVG (идентификатор носителя файла SVG, загруженного через медиа-менеджер. например, wiki:file-plus.svg)
Позиция ссылки (например, «1»)

Совет «ДокуВики» (скопирован отсюда) : Чтобы соответствовать стилю других значков, рекомендуется либо выбрать значок из огромного бесплатного выбора на https://materialdesignicons.com/ , либо придерживаться рекомендаций Material Design Guidelines при разработке собственного. икона.

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

dokuwiki-plugin-links4pages-master.zip

Лицензия

Author: albinou
License: GNU GPL v2

inserticon

anonymous@undisclosed.example.com (Anonymous) — Sat, 18 Jan 2025 09:52:15 +0000

Inserticon для «ДокуВики»

Добавляет маленькие иконки (16 пикселей) на любую страницу

Этот плагин был разработан Ди Терлицци.

Релиз: 2008-05-05.
Правка: 2025-01-05.
Репозиторий:https://www.dokuwiki.org/plugin:inserticon
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

2024-02-06 «Kaos» да
2023-04-04 «Jack Jackrum» да
2022-07-31 «Igor» да
2020-07-29 «Hogfather» да

Внимание: Данный плаген разработан Adolfo González Blázquez в 2008 году и не поддерживается автором проекта и не работает с Dokuwiki старше 2020 года. Внесенные небольшие правки в код автора (без его разрешения), следуя рекомендациям кода авторов Dokuwiki и этот замечательный плагин вновь функционирует в 2025 году.

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в <dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Внимание: Данный плаген разработан Adolfo González Blázquez в 2008 году и не поддерживается автором проекта и не устанавливается в Dokuwiki старше 2020 года. Внесенные небольшие правки в код автора (без его разрешения), следуя рекомендациям кода авторов Dokuwiki и этот замечательный плагин вновь функционирует в 2025 году.

Примеры/Использование

Синтаксис

{foldericon} will add
{imageicon} will add
{peopleicon} will add
{soundicon} will add
{videoicon} will add
{zipicon} will add

Редактирование

Плагин совсем небольшой и состоит из исполняющего код файла syntax.php, файла лицензии и папки images с иконками

Редактируем файл syntax.php (стр. 46 и 50)

index.php

    function handle($match, $state, $pos, &$handler) {  
    	return array($match, $state, $pos);
    }
 
    function render($mode, &$renderer, $data) {

заменим на

index.php

    function handle($match, $state, $pos, Doku_Handler $handler) {  
    	return array($match, $state, $pos);
    }
 
    function render($mode, Doku_Renderer $renderer, $data) {

Да, всего лишь & меняем на Doku_Renderer и сохраняем файл.
упаковываем в архив zip и устанавливаем через менеджер плагинов в Dokuwiki 2024-02-06 «Kaos» Мы видем подсказку об успешной установке плагина Используем синтаксис плагина в редакторе страниц для вставки иконки согласно документации автора И добавленные иконки при предварительном просмотре страницы.
На этом редактирование закончено и плагин можно использовать в Dokuwiki 2024-02-06 «Kaos»

Обновление

Для обновления удалите исходную папку lib/plugins/icons и установите новую версию, как указано выше.

Добавление плагина в меню

Создадим в папке плагина inserticon путь: dokuwiki/lib/plugins/inserticon файл скрипта script.js и запишем в него код для наших кнопок

script.js

/* JavaScript function to create color toolbar in Dokuwiki */
/* see http://www.dokuwiki.org/plugin:color for more info */
 
icon_icobase = "../../plugins/inserticon/images/";
 
if(window.toolbar != undefined) {
    toolbar[toolbar.length] = {
    "type":"picker",
    "title":"Insert icon",
    "icon":icon_icobase+"toolbar_icon.png",
    "list":[
{"type":"format", "title":"foldericon", "icon":icon_icobase+"folder.png", "open":"{", "close":"}" },
{"type":"format", "title":"imageicon", "icon":icon_icobase+"image.png", "open":"{", "close":"}" },
{"type":"format", "title":"soundicon", "icon":icon_icobase+"sound.png", "open":"{", "close":"}" },
{"type":"format", "title":"videoicon", "icon":icon_icobase+"video.png", "open":"{", "close":"}" },
{"type":"format", "title":"peopleicon", "icon":icon_icobase+"people.png", "open":"{", "close":"}" },
{"type":"format", "title":"zipicon", "icon":icon_icobase+"zip.png", "open":"{", "close":"}" }
	]
  };
}

Сохраним и очистим кэш local.php

Открываем панель редактирования страницы и раскрываем наше новое меню с иконками и вставляем на страницу Результат работы плагина с кнопкой в меню редактора

Дополнения и Файлы

Icons are from the Tango Project, licensed under the Creative Commons Attribution Share-Alike license, and from the GNOME project, licensed under the GPL-2. Далее приведена ссылка загрузки на оригинальный плагин (для ознакомления с кодом - не совместим с Dokuwiki в 2025году):

Оригинал плагина автора

Ссылка загрузки рабочей в 2025 году версии плагина. После загрузки

inserticon.zip edit for «Kaos»

Ссылка загрузки рабочей в 2025 году версии плагина со скриптом для меню

inserticon_nav_kaos.zip с меню

Примечание: После загрузки любого из архивов, его перед установкой необходимо переименовать в inserticon_1_.tar.gz –> inserticon.tar.gz
inserticonnavkaos.zip –> inserticon.zip

Лицензия

Author: Adolfo González Blázquez
License: GNU GPL v2

json

anonymous@undisclosed.example.com (Anonymous) — Fri, 07 Feb 2025 08:23:24 +0000

JSON Data Plugin

Совместим с «Докувики»

2024-02-06 "Kaos" да
2023-04-04 "Jack Jackrum" да
2022-07-31 "Igor" да
2020-07-29 "Hogfather" да

Build JSON database inside DokuWiki page and use the data in the page

Последнее обновление:: 2024-03-11
Предоставляет: Syntax, Helper, Action, Remote
Репозиторий: исходный код

Это расширение не находится в пространстве имен 'plugin' или 'template' и поэтому игнорируется.

Похож на data, jsoneditor, jsongendoc, jsontable, strata, struct

Теги: data, database, json, listing, tables, template, xmlrpc

- Janez Paternoster

Installation

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

You may want to install other related plugins:

Description

With JSON Data Plugin you can build JSON database inside DokuWiki page. JSON (JavaScript Object Notation) is a lightweight data-interchange format. It is easy for humans to read and write. It is easy for machines to parse and generate. It is a Document-oriented database, so no SQL is used.

To add JSON database into the wiki page write:

<json path=person>{
  "firstName": "James",
  "lastName": "Smith"
}</json>

With multiple <json> elements inside the page database is generated internally. There may also be external data sources.

Data from internal database can be used on the page, for example:

Person described here is %$person.firstName% %$person.lastName%.

will produce: «Person described here is James Smith.»

JSON data can be used in the following ways:

Extract specific JSON basic element.
Extract specific JSON object element as a list.
Extract specific JSON array element as a table.
Print specific part of data as JSON code.
Show or hide sections of DokuWiki page, based on value of specific JSON element.
As a datasource for a javascript widget.
JSON data can also be edited and safely stored back into the dokuwiki page via ajax call.

Demo

There is a DokuWiki JSON Demo Server with JSON database integrated into DokuWiki. Also source code of this plugin contains demo for JSON Data Definition and Usage. You can copy the contents of the demo files into your DokuWiki and experiment with them.

Support

For issues or just questions use Issues on Gitlab. Please don't email directly.

JSON Data Definition Syntax

Each page must define it's JSON data. Data are inline or are loaded from external (text) files on each page refresh. Only those data are loaded, which are defined inside a page. Data are defined with one or more '<json>' elements:

<json attributes>inline_json</json>

When the DokuWiki page is served, there is internally a variable, which is an empty object on the beginning. For example json_database = {}. After the above first <json> element is rendered, variable is something like this: json_database = {"person": {"firstname": "James", "lastName": "Smith"}}. After each subsequent <json> element data is added to that database. path attribute specifies, where in the json_database data are appended or replaced.

Inline JSON

Valid JSON data can be located between <json ...> and </json> tags. If both, inline data and data referenced by 'src' attribute are specified, then inline data have precedence. Inline data will replace overlapped data referenced by 'src' attribute.

Attribute 'id'

id attribute must be specified, when we want to access this json element from somewhere else or if we want to write inline JSON data via ajax call. It must be unique on one page.

Attribute 'path'

path attribute specifies, where in the 'json_database' data will be added. For example path=person1.address will write data into json_database.person1.address. . (dot) is used as a delimiter between tokens. If tokens contains spaces, then they must be inside quotes.

If token is number, then it points to n-th array member. 0 points to first array member and so on. Special token _FIRST_ or _LAST_ points to the first or to the last member.

If there are already data on the specified path, then new data will recursively replace overlapped original data. (For detailed rules see php function array_replace_recursive.) This is true, if the following two modifiers are not used.

Modifier -: if - (minus) is set in the beginning of the path attribute, then original data on the path will be erased before new data will be written. For example path=-person1.address.

Modifier []: open square bracket immediately followed by closing square bracket at the end of the path attribute means, that data will be appended (pushed) to the specified path on the 'json_database'. For example path=persons[] will put the data in the json_database.persons array in the next free index.

If path attribute is not specified, data is combined with the 'json_database' directly.

Attribute 'src'

src attribute contains a DokuWiki link to the external data. External data is a text file. It may be document from the same dokuwiki or it can be located anywhere on the net.

src=path:to:remote_document
src=https://www.example.com/file.json
src=path:to:remote_document#specific_element
src=persons:person*
src='{"JSON": "data", "can clone": %$pre-defined.data%}'

External data may be a pure JSON file, it begins with [ or {.

External data may be a text file with <json> elements inside - remote DokuWiki page. Remote DokuWiki page then first loads data according to the rules inside its <json> elements, builds its own database and then passes the generated database into our document. Please note, that <json> elements inside remote dokuwiki page may also contain 'src' attribute. In this case data from that 'src' are also loaded. Data are loaded recursively. How deep recursion goes is controlled in configuration setting 'src_recursive'.

External data may be a specific <json> element from remote dokuwiki page. In that case <json> element must have an 'id' attribute. It is referenced as in third example above. If target <json> element have a 'src' attribute, then data is loaded recursively.

Wildcards may be may be used in 'src' attribute. See fourth example above. In that case multiple files are read and integrated into our database. See glob() function.

Fifth example above shows, that 'src' attribute can not only be used for the file path, it can also contain JSON data. This way some already defined data from page can be «cloned» and reused. Similar as in Data snippets inside inline JSON. JSON data are automatically recognized, if 'src' attribute contains: [, { or % on the beginning and ], ] or % on the end.

Attribute 'src_ext'

This attribute is similar to 'src'. But the link to remote data is defined externally. Value of 'src_ext' contains a name, which must begin with json_. For example, 'our_document' contains:

<json src_ext=json_my_data></json>

In some other page we have a link to 'our_document' with one (or more) extra argument, like this:

[[somewhere:our_document?json_my_data=path:to:remote_document]]

'our_document' will be loaded with data as specified in Query string. Rules for the file link from Query string are the same as for the 'src' attribute. We can put multiple arguments separated by & in Query string. If we want to specify specific <json> element, then we can't use #, because it is reserved. We can use %23 instead.

If besides 'src_ext' also 'src' attribute is specified, then 'src_ext' has precedence. If link for 'src_ext' is not defined in query string, then link from 'src' is used.

Attribute 'src_path'

If attribute src_path is specified, then only part of database referenced by 'src' attribute is used. Path on 'src' specified by 'src_path' must exist. Rules for 'src_path' are the same as for 'path', except modifiers are not used.

Attribute 'src_path_ext'

This attribute is similar to 'src_path', but the value is defined externally in query string. It works the same way as attribute 'src_ext'.

Attribute 'display'

This attribute controls, which part of <json> element is rendered on html page. Multiple data can be displayed with jQuery UI Tabs widget. Attribute 'display' is a comma separated list of tokens. Default value for this attribute is specified in configuration setting 'json_display'. Tokens:

'original' - display data already in database combined with data from 'src' attribute. But not yet combined with 'inline' data.
'inline' - display inline_data from <json>inline_data</json> element in textarea.
'combined' - display original data combined with 'inline' data.
'log' - display log of data sources.
'error' - display log of data sources only, of there are errors.

There are also tokens 'orig-hidden', 'inl-hidden' and 'comb-hidden', which are similar to above three tokens. Each renders a hidden html 'div' element, which can be used for passing data to javascript widgets.

By default, if no 'display' attribute, only tabs menu will be shown with two tabs: 'inline' and 'log'. Both tabs will be collapsed. This can be changed in configuration settings.

If we want to add some tokens to default 'display' options, we can use comma in front of our token(s) in 'display' attribute.

If we want only to embed data into document and hide the element, we may set display='error' to show element only if there are errors or set display='' to unconditionally hide the element.

If we want to show contents of specific tab, then asterisk (*) should be added after the corresponding token. If 'display' contains only one token, followed by asterisk (*), then tabs menu will be hidden. For example 'display=combined*' will only show JSON data without the tabs menu.

If 'inline' token is specified, then inline data are shown in textarea. That data can be edited and saved to the document. When data is first changed, then 'Save' button is shown in tab area. There are some rules, which may prevent the saving. First, <json> element must have unique 'id' specified. Second, if someone else changed the data since last page reload, then data can not be written. It is necessary to reload the page first (in another browser tab?) and re-enter our data. If data is successfully saved, then 'Save' button disappears from tab area.

Attribute 'archive'

This attribute enables us to make archive of the JSON database loaded by 'src' or 'src_ext' attribute. Archive is stored into DokuWiki page itself as JSON string. This action is triggered, when user presses a button.

We can specify 'archive' attribute for each <jsonxxx> element on the page. We can specify 'archive=make' or 'archive=disable'. If at least one <jsonxxx> element has 'archive' attribute equal to 'make' or 'disable', then button 'Archive JSON database' appears on the top of DokuWiki page. When user presses that button, following procedure is triggered:

Verify for errors: user permission, file unmodified, lock, etc.
Search DokuWiki page and find all <jsonxxx archive=make ...> elements. Replace them with <jsonxxx archive='/JSON_encoded_string/' ...>.
Find all <jsonxxx archive=disable src=... src_ext=...> elements and replace them with <jsonxxx archive_disabled=disable src_disabled=... src_ext_disabled=...>. This disables 'src' and 'src_ext' attributes.
Save the DokuWiki page.

When DokuWiki page is archived, then 'archive' attribute of some or all <jsonxxx> elements contains JSON database. Data is then read from 'archive' attribute. 'src' and 'scr_ext' attributes are then ignored. Inline JSON data remain unchanged.

JSON Data Usage Syntax

Basic pattern for render JSON data in dokuwiki is: %$ ... %. JSON data can be displayed in multiple different ways, for example: simple string, as link, list of properties, table, json code, etc. Detailed description of pattern:

%$path [(table_row_filter)] {header} #format# (filter)%

Each of: path, table_row_filter, header, format, filter is optional. Order of the brackets is important. If square brackets are used, then table will be rendered. Else if curly brackets are used, then list will be rendered. Otherwise single variable will be rendered. If special character must be used inside the pattern, then use HTML code. Use % instead of %, for example.

path

'path' specifies part of the 'json_database', which will be rendered. . (dot) is used as a delimiter between tokens. Path may contain spaces, no quotes should be used. Following characters are not allowed inside path: '[]{}#()'. There are two special tokens, which may be used as part of the path: FIRST selects the first element inside the array and LAST selects the last element inside he array.

table_row_filter

Square brackets will render table. table_row_filter inside brackets is optional. It will display each row of the table, if filter is matched. Rules are the same as for filter below.

header is a comma separated list of key:value pairs, where key is a header description and value is a path to variable. It is used to render a header in a table or in a list of properties.

In header it is also possible to define tooltips, which can be displayed on mouse hover on specific table row or table cell. Tooltip is defined, if key is prepended with special string _tooltip_.

Example header for two column table and with tooltip on second column: "Header 1":data.1, "Header 2":data.2, "_tooltip_Header 2":data.2.tooltip. This example can also be used for a list of two properties with tooltip on second property.

If we want to use one tooltip for whole table row, then we use just _tooltip_ string for the key.

format

Format may be applied on any variable, list item or table column. It can render value of the variable to format other than text. Supported formats are:

code - render variable as json code.
headern - render header, where n is the number from 1-5 for header level.
link - render as internal or external or windows share link. If variable is external link, it must have protocol specified, for example 'http://...'. Variable may also have title specified, for example 'some:link|Some Title'.
email - render as email address. Variable may have title specified.
media?L200x300 - render as internal or external media file. ? and parameters are optional. First letter for parameter must be 'l' for left, 'c' for center or 'r' for right position of the media file. Other part of parameter is width x height. Parameter may also be just 'linkonly'. Variable may have title specified.
rss n nosort reverse author date details - Render as rss. Rules are the same as for DokuWiki syntax.
ejs?template - Use Embedded JavaScript templating. EJS will render data according to the template with usage of the powerful javaScript language. This option must be enabled in configuration settings, it is disabled by default. template is a string designed according to the rules for ejs, for example <$=d.toUpperCase()$>. Variable (data) is passed to javaScript as d. Because of string limitations not all characters may be passed to the template directly: characters %, #, :, ,, <%= and %> must be written as &percnt;, &num;, &colon;, ,, <$= and $>.

Format may be used to render single variable or specific member of list or specific table column. For list or table, format must be a comma separated list of key:value pairs, where key is header description (same as in header) and value is format.

filter

Filter may be applied inside brackets on any variable, list or table. If it evaluates to true, contents of the variable will be shown, otherwise not. Filter consists of one or multiple conditions separated by keywords or or and. Condition is a path compared to some value(string, numeric, boolean or null). Comparison operators are: ==, !=, <, >, <= or >=. Comparison operator and value may also be omitted. There is no precedence or brackets possible. Quotes should not be used.

Examples

Type	Example	Description
Basic variable	`%$path.to.var%`	If type of variable is string or number or boolean, it just prints it out. If it is null, it prints '(null)' by default. This can be changed in Configuration Settings. If type of the variable is array or object, this syntax prints printable members of the array or object. If there is nothing printable it prints '(array)'.
Use filter	`%$path.to.var (path.to.cond1 >= a and path.to.cond1 <b)%`	Print variable only, if filter evaluates to true.
Print JSON data	`%$path.to.var #code#%`	Print JSON raw data.
Variable is a link	`%$path.to.var #link#%`	Variable will render as link with optional title.
List all properties	`%$path.to.var {}%`	All properties of a variable will be displayed in two column table.
List specific properties	`%$path.to.var {"Property 1": subvar.path, "Property 2": subvar2.path2}%`	Similar as above, but only specific properties with custom name will be printed
List specific properties with format	`%$path.to.var { ... } #"Property 1": email#%`	Similar as above, but «Property 1» will be rendered as email.
Simple table	`%$path.to.var []%`	If path.to.var is well formed double array, then table without header will be rendered. If path.to.var is more complex, then result may be mixed.
Table with header	`%$path.to.var [] {"Column 1": subvar.path, "Column 2": subvar2.path2}%`	path.to.var should be array with similar members. header describes header names and members to be rendered in the table. If only blank `{}` is used, then header will be generated automatically.
Table with format	`%$path.to.var [] { ... } #"Column 2": link}#%`	Same as above, but «Column 2» will be rendered as a link.
Table with filter	`%$path.to.var [(subvar.in.row == something)] { ... }%`	Same as above, but only those rows will be rendered, which match the filter.
Conditionally hide section	`%$-start (path.to.cond1 == true)%``dokuwiki-contents``%$end%`	Evaluate filter inside brackets. If true, then any dokuwiki-contents will be normally rendered. If false, then dokuwiki-contents will be hidden and if dokuwiki-contents contains title, it won't be shown in TOC.
Conditionally hide inline text	`%$-starti ( ... )% ... %$end%`	Same as above, but for inline DokuWiki contents. Mind extra 'i' in 'starti'.

Data snippets inside inline JSON

<json path=renault>{
    "cars": %$cars[(row_filter)](filter)%
}</json>

Inside inline json we can use %$ path [( row_filter )]( filter )% syntax, which will be replaced by data from existing JSON database. [( row_filter )] and ( filter ) are optional and can be set according to the same rules, as described above.

If data is not defined, then null will be used.

If data is string, then double quotes must be used. Strings can also be concatenated. For example, "%$path.name%, %$path.age% years" can be used for json string concatenated from two predefined strings.

Insert referenced data into array elements

This is advanced feature. Let's say, we have two data definitions: one for items database and one for item purchase history. For example:

<json path=items_db>{
    "apple": { "Description": "Apple", "type": "fruit" },
    "salad": { "Description": "Salad", "type": "vegetable" }
}</json>

<json path=items_purchased>[
    { "item": "apple", "quantity": 5, "date":"2019-06-22" },
    { "item": "salad", "quantity": 1, "date":"2019-06-28" },
    { "item": "apple", "quantity": 3, "date":"2019-07-10" }
]</json>

We want to extend each item in items_purchased data with item type, which is available in items_db data definition. We can make this:

<json path=items_purchased_extended>
    %$items_purchased[{item_type: items_db.{item}.type}]%
</json>

And get this:

[{ "item": "apple", "quantity": 5, "date":"2019-06-22", "item_type": "fruit" },
 { "item": "salad", "quantity": 1, "date":"2019-06-28", "item_type": "vegetable" },
 { "item": "apple", "quantity": 3, "date":"2019-07-10", "item_type": "fruit" }]

Filters can also be used. Full definition for data snippet is:

%$path[(row_filter){property.path: data.path.1.{reference.path}.data.path.2, ...}](filter)%

Text macros

JSON define <json ...> ... </json> or extract %$ ... % patterns can be quite verbose and some lengthy attributes may repeat across multiple pages.

It is possible to use macros defined by textinsert Plugin. First install the plugin, then define some macros in it. Use #@macro_name@# patterns inside json define or extract patterns. JSON define or extract patterns are preprocessed for simple replacement of macros defined globally by textinsert Plugin.

For example, if macro table_header is defined as {"Part description": part, "Quantity of parts": quantity}, then you can use %$data [] #@table_header@# %.

Use JavaScript widgets with JSON data

JSON plugin has interface for other sub-plugins, which can use JSON data inside JavaScript widgets for example. It is relative simple to write such a plugin. For example JSONEditor plugin uses nice JSON Schema based Editor JavaScript library, which generates forms based on JSON Schema. It uses <jsoneditor> element, which is first rendered by JSON plugin. JSONeditor plugin has only helper.php script, which renders some additional html code into page. Data from the JSON database are already available for the widget as well as data saving mechanism.

Remote access to JSON data

DokuWiki has a XML-RPC API which can be used to access/interact with your wiki from other applications.

Available Functions

plugin.json.get

Name	plugin.json.get
Description	Generate JSON database on page and return data from the JSON_path.
Parameter (string) pagename	DokuWiki page name.
Parameter (string) JSON_path	Path on the JSON database, see attribute_path. Optional parameter, empty by default.
Parameter (boolean) addLog	If true, additional information about JSON generation will be returned. Optional parameter, false by default.
Return (object)	{'status': 'OK_or_error_description', 'data': 'JSON_data', 'log': 'JSON_loading_log' }

plugin.json.set

Name	plugin.json.set
Description	Find `<json id=…` element inside page and set its inline data.
Parameter (string) pagename	DokuWiki page name.
Parameter (string) json_id	Id of the json element, see attribute_id.
Parameter (array\|string) data	Data to be put inside json element. Must be an array, empty string or valid JSON string.
Parameter (boolean) overwrite	If true, existing data will be overwritten. Optional parameter, false by default.
Return (string)	'OK' on success or error description.

plugin.json.append

Name	plugin.json.append
Description	Find `<json id=…` element inside page and append data to its inline database. Inline JSON data must be an array or empty. If empty, new array will be initialized.
Parameter (string) pagename	DokuWiki page name.
Parameter (string) json_id	Id of the json element, see attribute_id. If empty, complete page will be treated as JSON database (page must be a JSON array, empty or non-existent).
Parameter (array\|string) data	JSON Data to be appended inside json element. Must be an array or valid JSON string.
Return (string)	'OK' on success or error description.

Example usage with Python

First enable DokuWiki's XML-RPC API as described. See also python-dokuwiki.

#pip install dokuwiki
import dokuwiki
wiki = dokuwiki.DokuWiki('https://path/to/dokuwiki', 'user', 'password')
wiki.send("plugin.json.get", "path:to:page")
 
person = {'firstName': 'James', 'lastName': 'Smith', 'age': 40}
wiki.send("plugin.json.set", "path:to:page", "id_attr", person)

myicon

anonymous@undisclosed.example.com (Anonymous) — Sat, 06 Dec 2025 16:58:49 +0000

MyIcon для «ДокуВики»

Данный плагин предоставляет визуальный интерфейс вставки более 3500 иконок размером 16х16 в формате .png из окна редактора страницы. Этот плагин добавляет дополнительную кнопку в редактор страниц. С помощью этой кнопки можно выбирать иконки в визуальном интерфейсе. Плагин работает с папкой менеджера загрузок ./data, что не нагружает сервер подменой кода в шаблона Lexer¹⁴⁾

Этот плагин был разработан VladPolskiy.

Релиз: 2025-01-12.
Репозиторий:https://wwoss.ru/lib/exe/fetch.php?media=wiki:plugin:myicon
Совместимость с «Докувики»: 2024-02-06 «Kaos»
myicon.zip

Совместимость

2024-02-06 «Kaos» да
2023-04-04 «Jack Jackrum» да
2022-07-31 «Igor» да
2020-07-29 «Hogfather» да

Монтаж

Используйте менеджер плагинов для установки или…

1. скачать zip-файл 2. распаковать его в <dokuwiki>/lib/plugins/

в папке ./data/media необходимо создать директорию с именем 16 для хранения иконок 16х16

распокавать архив myicon.zip и из папки 16 все файлы иконок копировать! в папку ./data/media/16 вашего сайта Dokuwiki

Этой копированием мы получим набор иконок в менеджере медиафайлов Dokuwiki

Примеры/Использование

Посмотрите на плагин в действии здесьздесь. На странице-образце показаны все доступные на сегодня иконки в размере 16х16 в плагине.

Откроем окно редактора страниц и выбирем кнопку Мои иконки (My Icons) В открывшемся окне выбора иконок выбираем и нажимаем на понравившуюся картинку иконки Получаем сообщение браузера о том, что код вставки иконки скапирован в буфер обмена и закрываем окно выбора иконок В редакторе страниц вставляем код с помощью мышки или сочетанием клавиш CTRL+V При сохранении страницы видим нашу иконку

Простой синтаксис использования:

{{:icons:16:auction-hammer--plus.png?|auction-hammer--plus.png.}}
где:
":icons" - начальная папка хранения иконок в менеджере ./data
":16" - папка размера иконок 16х16
":auction-hammer--plus.png?" - имя и расширение изображения иконки
"auction-hammer--plus.png." - всплывающий текст при навидении курсора на иконку

Синтаксис

Некоторые более сложные варианты использования:

/*Пример обычной вставки в тексте*/
{{:icons:16:address-book-open.png?|address-book-open.png.}} Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. {{:icons:16:balloon-left.png?|balloon-left.png.}} Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.{{:icons:16:tick.png?|tick.png.}} Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Пример обычной вставки в тексте

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

/*Пример измененной всплывающей подсказки при наведении курсора*/
{{:icons:16:address-book-open.png?|Прочитайте статью внимательно}}

Пример измененной всплывающей подсказки при наведении курсора

/*Пример измененния размера иконки*/
{{:icons:16:address-book-open.png?12|address-book-open.png.}}
{{:icons:16:address-book-open.png?24|address-book-open.png.}}

Пример измененния размера иконки

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

/*Пример добавления иконки ко внутренней ссылки*/
Посмотрите {{:icons:16:address-book-open.png?|просмотреть плагин блог}}[[wiki:plugin:blog|перейти на странице плагина]]

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

Посмотрите перейти на странице плагина

/*Пример иконки - внешней ссылки*/
[[http://example.com|{{:icons:16:address-book-open.png?|http://example.com}}]]

Пример иконки - внешней ссылки

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Конфигурация и настройки

Обновление

Для обновления удалите исходную папку lib/plugins/myicons и установите новую версию, как указано выше.

Файл для загрузки

Плагин иконок myicon

Лицензия

Author: VladPolskiy
License: GNU GPL v2

¹⁴⁾

Lexer сканирует документ DokuWiki и выводит последовательность «токенов», соответствующих синтаксису в документе

note

anonymous@undisclosed.example.com (Anonymous) — Sat, 08 Feb 2025 16:29:01 +0000

Note для «ДокуВики»

Совместим с «Докувики»

2024-02-06 "Kaos" да
2023-04-04 "Jack Jackrum" да
2022-07-31 "Igor" да
2020-07-29 "Hogfather" да

Этот плагин позволяет вам создавать на страницах DokuWiki такие красивые «заметки»

Последнее обновление:: 2024-04-15
Предоставляет: Syntax
Репозиторий: исходный код

Это расширение не находится в пространстве имен 'plugin' или 'template' и поэтому игнорируется.

Похож на admnote, bootswrapper, box, wrap

Теги: boxes, icons, toolbar

- Anael Mobilia

Примечания

В «пригодном для использования» шаблоне над примечанием имеется слишком много пробелов. Я смог решить эту проблему, закомментировав «clear: Both;» в «style.css». Ваш пробег может отличаться.
С шаблоном «DokuCMS» и с «clear: Both;» в «style.css» примечания «смещаются» полем оглавления , а не перекрываются с ним [откровенный]

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Когда он у вас установлен, используйте это:

<note>
This is my note! Remember it!!
</note>

<note important>
Warning! You're about to lose your mind ;-)
</note>

<note tip>
The clues are in the images.
</note>

<note warning>
Beware of the cat when you open the door!!
</note>

Вы можете использовать ключевые слова примечаний importantи warning. tipИли некоторые французские синонимы: importante(важно), bloquante, critique(предупреждение), tuyau, idée(совет), classique(классический). Добавлять новые типы заметок довольно легко, если вы немного разбираетесь в PHP и CSS .

Ограничения

Плагин не будет работать внутри нумерованного списка

~~Похоже, что он также не работает в сложенном разделе при использовании плагина « Fold ».~~

Исправление: Синтаксис следующий:

=== Note ===

++++Note dans un Folded|
<note critique>
Ça fonctionne seulement avec le //div// pas le //span//.
</note>
++++

Модификация

Основной файл внешнего вида плагина, это style.php. Отредактированно:

Количество заметок увеличенно до 9 шт.
Убраны иконки.
Добавленна цветовая полоса слева.
Уменьшино скругление углов.
Увеличена ширена на длину страницы.

style.php

.plugin_note {
  margin: 2em auto; /*Отступ от левого края элемента*/
  max-width: 100%; /* Максимальная ширина страницы в процентах */ 
  min-height: 10px; /* Минимальная высота */
  text-align: justify; /*горизонтальное выравнивание текста в пределах элемента (justify - по ширине)*/
  vertical-align: middle;/*Выравнивание средней точки элемента по базовой линии родителя плюс половина высоты родительского элемента.*/
  border-collapse: collapse; /* отображать границы вокруг ячеек таблицы*/
  padding: 12px 17px 12px 27px; /*Устанавливает значение полей вокруг содержимого элемента*/
  /*background-position: 20px 50%;*/
  background-repeat: no-repeat;/*Определяет, как будет повторяться фоновое изображение (no-repeat
Устанавливает одно фоновое изображение)*/
  -moz-border-radius: 3px; /*Устанавливает набор цветов для нижней границы элемента*/
  -khtml-border-radius: 3px;
  border-radius: 3px;
  color: black;
  overflow: hidden;
}
 
.plugin_note .li {
  color: black !important;
}
 
.noteclassic {
  /*серый grey #708090  #dcdcdc*/ /*набор цветов*/
  /*background-image: url(images/note.png);*/ /*путь к иконкам - не используется*/
  background: linear-gradient(
            to right,
            #708090 0%,
            #708090 1%,
            #dcdcdc 1%,
            #dcdcdc 100%
        );  
 
}
 
.noteblue {
  /*синий blue #0000ff  #eeeeff*/
  /*background-image: url(images/note.png);*/
  background: linear-gradient(
            to right,
            blue 0%,
            blue 1%,
            #eeeeff 1%,
            #eeeeff 100%
        );  
}
 
.noteyellow {
  /*желтый yellow #ffff00 #ffffcc*/
  /*background-image: url(images/important.png);*/
    background: linear-gradient(
            to right,
            #ffff00 0%,
            #ffff00 1%,
            #ffffcc 1%,
            #ffffcc 100%
        ); 
}
 
.notegreen {
  /*зеленый green #008000  #ddffdd*/
  /*background-image: url(images/warning.png);*/
    background: linear-gradient(
            to right,
            #008000 0%,
            #008000 1%,
            #ddffdd 1%,
            #ddffdd 100%
        ); 
}
 
.notered {
  /*красный red #ff0000* #ffdddd/
  /*background-image: url(images/tip.png);*/
    background: linear-gradient(
            to right,
            #ff0000 0%,
            #ff0000 1%,
            #ffdddd 1%,
            #ffdddd 100%
        ); 
}
 
.noteorange {
  /*оранжевый orange #ff8c00 #ffe2bd*/
  /*background-image: url(images/tip.png);*/
    background: linear-gradient(
            to right,
            #ff8c00 0%,
            #ff8c00 1%,
            #ffe2bd 1%,
            #ffe2bd 100%
        ); 
}
 
.notepurple {
  /*фиолетовый purple #800080 #ebc7eb*/
  /*background-image: url(images/tip.png);*/
    background: linear-gradient(
            to right,
            #800080 0%,
            #800080 1%,
            #ebc7eb 1%,
            #ebc7eb 100%
        ); 
}
 
.notebrown {
  /*коричневый brown #805c38  #f0d698*/
  /*background-image: url(images/tip.png);*/
    background: linear-gradient(
            to right,
            #805c38 0%,
            #805c38 1%,
            #f0d698 1%,
            #f0d698 100%
        ); 
}
 
.noteblack {
  /*черный black #000000  d3d3d3*/
  /*background-image: url(images/tip.png);*/
    background: linear-gradient(
            to right,
            black 0%,
            black 1%,
            #d3d3d3 1%,
            #d3d3d3 100%
        ); 
}
 
 
/*серый grey #708090  #dcdcdc*/
/*синий blue #0000ff  #eeeeff*/
/*желтый yellow #ffff00 #ffffcc*/
/*зеленый green #008000  #ddffdd*/
/*красный red #ff0000* #ffdddd/
/*оранжевый orange #ffda99 #ffe2bd*/
/*фиолетовый purple #800080 #ebc7eb*/
/*коричневый brown #805c38  #e8b37d*/
/*черный black #000000  e6e8e6*/

Основной файл меню выбора заметок плагина, это action.php. Отредактированно:

Количество кнопок заметок увеличенно до 9 шт.
Заменены иконки кнопок по цветовой схеме.

action.php

<?php
/**
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 */
 
class action_plugin_note extends DokuWiki_Action_Plugin
{
 
    /**
     * register the eventhandlers
     *
     * @author Andreas Gohr <andi@splitbrain.org>
     */
    function register(Doku_Event_Handler $controller)
    {
        $controller->register_hook('TOOLBAR_DEFINE', 'AFTER', $this, 'handle_toolbar', array());
    }
 
    function handle_toolbar(&$event, $param)
    {
        $event->data[] = array(
            'type' => 'picker',
            'title' => $this->getLang('note_picker'),
            'icon' => '../../plugins/note/images/note_picker.png',
            'list' => array(
                array(
                    'type' => 'format',
                    'title' => $this->getLang('tb_grey_note'),
                    'icon' => '../../plugins/note/images/tb_grey_note.png',
                    'open' => '<note>',
                    'close' => '</note>',
                ),
                array(
                    'type' => 'format',
                    'title' => $this->getLang('tb_blue_note'),
                    'icon' => '../../plugins/note/images/tb_blue_note.png',
                    'open' => '<note blue>',
                    'close' => '</note>',
                ),
                array(
                    'type' => 'format',
                    'title' => $this->getLang('tb_yellow_note'),
                    'icon' => '../../plugins/note/images/tb_yellow_note.png',
                    'open' => '<note yellow>',
                    'close' => '</note>',
                ),
                array(
                    'type' => 'format',
                    'title' => $this->getLang('tb_green_note'),
                    'icon' => '../../plugins/note/images/tb_green_note.png',
                    'open' => '<note green>',
                    'close' => '</note>',
                ),
                array(
                    'type' => 'format',
                    'title' => $this->getLang('tb_red_note'),
                    'icon' => '../../plugins/note/images/tb_red_note.png',
                    'open' => '<note red>',
                    'close' => '</note>',
                ),
                array(
                    'type' => 'format',
                    'title' => $this->getLang('tb_orange_note'),
                    'icon' => '../../plugins/note/images/tb_orange_note.png',
                    'open' => '<note orange>',
                    'close' => '</note>',
                ),
                array(
                    'type' => 'format',
                    'title' => $this->getLang('tb_purple_note'),
                    'icon' => '../../plugins/note/images/tb_purple_note.png',
                    'open' => '<note purple>',
                    'close' => '</note>',
                ),
                array(
                    'type' => 'format',
                    'title' => $this->getLang('tb_brown_note'),
                    'icon' => '../../plugins/note/images/tb_brown_note.png',
                    'open' => '<note brown>',
                    'close' => '</note>',
                ),
                array(
                    'type' => 'format',
                    'title' => $this->getLang('tb_black_note'),
                    'icon' => '../../plugins/note/images/tb_black_note.png',
                    'open' => '<note black>',
                    'close' => '</note>',
                ),
            )
        );
    }
}

Основной файл исполняемого кода, это syntax.php. Отредактированно (стр.40-50):

Количество заметок увеличенно до 9 шт.
Заменены названия заметок по цветовой схеме.

syntax.php

<?php
/**
 * Add Note capability to dokuwiki
 *
 * <note>This is note</note>
 * <note classic>This is note</note>
 * <note important>This is an important note</note>
 * <note warning>This is a big warning</note>
 * <note tip>This is a tip</note>
 *
 * by Olivier Cortès <olive@deep-ocean.net>
 * under the terms of the GNU GPL v2.
 *
 * Originaly derived from the work of :
 * Stephane Chamberland <stephane.chamberland@ec.gc.ca> (Side Notes PlugIn)
 * Carl-Christian Salvesen <calle@ioslo.net> (Graphviz plugin)
 *
 * Contributions by Eric Hameleers <alien [at] slackware [dot] com> :
 *   use <div> instead of <table>,
 *   contain the images and stylesheet inside the plugin,
 *   permit nesting of notes,
 *
 * Contributed by Christopher Smith <chris [at] jalakai [dot] co [dot] uk>
 *   fix some parsing problems and a security hole.
 *   make note types case independent
 *   simplify code reading
 *   modernise the plugin for changes/fixes/improvements to the underlying Dokuwiki plugin class,
 *   improve efficiency.
 *
 * Contributed by Aurélien Bompard <aurelien [at] bompard [dot] org>
 *   support for the ODT output format.
 *
 * @license    GNU_GPL_v2
 * @author     Olivier Cortes <olive@deep-ocean.net>
 */
 
class syntax_plugin_note extends DokuWiki_Syntax_Plugin
{
 
    protected $notes = array(
        'noteblue' => array('blue', 'bleue'),
        'noteyellow' => array('yellow', 'jaune'),
        'notegreen' => array('green', 'verte'),
        'notered' => array('red', 'rouge'),
		'noteorange' => array('orange', 'orange'),
        'notepurple' => array('purple', 'violette'),
        'notebrown' => array('brown', 'marron'),
		'noteblack' => array('black', 'noire'),
        'noteclassic' => array('', 'classic', 'classique')
    );
 
    protected $default = 'plugin_note noteclassic';
 
    function getType()
    {
        return 'container';
    }
 
    function getPType()
    {
        return 'block';
    }
 
    function getAllowedTypes()
    {
        return array('container', 'substition', 'protected', 'disabled', 'formatting', 'paragraphs');
    }
 
    function getSort()
    {
        return 195;
    }
 
    // override default accepts() method to allow nesting
    // - ie, to get the plugin accepts its own entry syntax
    function accepts($mode)
    {
        if ($mode == substr(get_class($this), 7)) {
            return true;
        }
        return parent::accepts($mode);
    }
 
    function connectTo($mode)
    {
        $this->Lexer->addEntryPattern('<note.*?>(?=.*?</note>)', $mode, 'plugin_note');
    }
 
    function postConnect()
    {
        $this->Lexer->addExitPattern('</note>', 'plugin_note');
    }
 
    function handle($match, $state, $pos, Doku_Handler $handler)
    {
        switch ($state) {
            case DOKU_LEXER_ENTER:
                $note = strtolower(trim(substr($match, 5, -1)));
 
                foreach ($this->notes as $class => $names) {
                    if (in_array($note, $names)) {
                        return array($state, $class);
                    }
                }
                return array($state, $this->default);
 
            case DOKU_LEXER_UNMATCHED:
                return array($state, $match);
 
            default:
                return array($state, null);
        }
    }
 
    function render($format, Doku_Renderer $renderer, $indata)
    {
        if ($format == 'xhtml') {
            list($state, $data) = $indata;
 
            switch ($state) {
                case DOKU_LEXER_ENTER :
                    $renderer->doc .= '<div class="plugin_note ' . htmlspecialchars($data) . '">';
                    break;
 
                case DOKU_LEXER_UNMATCHED :
                    $renderer->doc .= $renderer->_xmlEntities($data);
                    break;
 
                case DOKU_LEXER_EXIT :
                    $renderer->doc .= "\n</div>";
                    break;
            }
            return true;
        } elseif ($format == 'odt') {
            list($state, $data) = $indata;
 
            $this->render_odt($renderer, $state, $data);
            return true;
        }
 
        // unsupported $mode
        return false;
    }
 
    protected function render_odt($renderer, $state, $data)
    {
        static $first = true;
        static $new;
 
        if ($first == true) {
            $new = method_exists($renderer, 'getODTPropertiesFromElement');
            $first = false;
        }
 
        if (!$new) {
            // Render with older ODT plugin version.
            $this->render_odt_old($renderer, $state, $data);
        } else {
            // Render with newer ODT plugin version.
            $this->render_odt_new($renderer, $state, $data);
        }
    }
 
    protected function render_odt_old($renderer, $state, $data)
    {
        switch ($state) {
            case DOKU_LEXER_ENTER:
                $type = substr($data, 4);
                if ($type == 'classic') {
                    // The icon for classic notes is named note.png
                    $type = 'note';
                }
                $colors = array('note' => '#eeeeff', 'warning' => '#ffdddd', 'important' => '#ffffcc', 'tip' => '#ddffdd');
 
                // Content
                $properties = array();
                $properties ['width'] = '100%';
                $properties ['align'] = 'center';
                $properties ['shadow'] = '#808080 0.18cm 0.18cm';
                $renderer->_odtTableOpenUseProperties($properties);
 
                $properties = array();
                $properties ['width'] = '1.5cm';
                $renderer->_odtTableAddColumnUseProperties($properties);
 
                $properties = array();
                $properties ['width'] = '13.5cm';
                $renderer->_odtTableAddColumnUseProperties($properties);
 
                $renderer->tablerow_open();
 
                $properties = array();
                $properties ['vertical-align'] = 'middle';
                $properties ['text-align'] = 'center';
                $properties ['padding'] = '0.1cm';
                $properties ['border'] = '0.002cm solid #000000';
                $properties ['background-color'] = $colors[$type];
                $renderer->_odtTableCellOpenUseProperties($properties);
 
                $src = DOKU_PLUGIN . 'note/images/' . $type . '.png';
                $renderer->_odtAddImage($src);
 
                $renderer->tablecell_close();
 
                $properties = array();
                $properties ['vertical-align'] = 'middle';
                $properties ['padding'] = '0.3cm';
                $properties ['border'] = '0.002cm solid #000000';
                $properties ['background-color'] = $colors[$type];
                $renderer->_odtTableCellOpenUseProperties($properties);
                break;
 
            case DOKU_LEXER_UNMATCHED :
                $renderer->cdata($data);
                break;
 
            case DOKU_LEXER_EXIT :
                $renderer->tablecell_close();
                $renderer->tablerow_close();
                $renderer->_odtTableClose();
                $renderer->p_open();
                break;
        }
    }
 
    /**
     * ODT rendering for new versions of the ODT plugin.
     *
     * @param $renderer the renderer to use
     * @param $state    the current state
     * @param $data     data from handle()
     * @author LarsDW223
     */
    protected function render_odt_new($renderer, $state, $data)
    {
        switch ($state) {
            case DOKU_LEXER_ENTER:
                $css_properties = array();
 
                // Get CSS properties for ODT export.
                $renderer->getODTPropertiesNew($css_properties, 'div', 'class="' . $data . '"', null, true);
 
                // Create Content
                // (We only use the CSS parameters that are meaningful for creating the ODT table)
                $properties = array();
                $properties ['width'] = '100%';
                $properties ['align'] = 'center';
                $properties ['shadow'] = '#808080 0.18cm 0.18cm';
                $renderer->_odtTableOpenUseProperties($properties);
 
                $properties = array();
                $properties ['width'] = '1.5cm';
                $renderer->_odtTableAddColumnUseProperties($properties);
 
                $properties = array();
                $properties ['width'] = '13.5cm';
                $renderer->_odtTableAddColumnUseProperties($properties);
 
                $renderer->tablerow_open();
 
                $properties = array();
                $properties ['vertical-align'] = $css_properties ['vertical-align'];
                $properties ['text-align'] = 'center';
                $properties ['padding'] = '0.1cm';
                $properties ['border'] = '0.002cm solid #000000';
                $properties ['background-color'] = $css_properties ['background-color'];
                $renderer->_odtTableCellOpenUseProperties($properties);
 
                if ($css_properties ['background-image']) {
                    $renderer->_odtAddImage($css_properties ['background-image']);
                }
 
                $renderer->tablecell_close();
 
                $properties = array();
                $properties ['vertical-align'] = $css_properties ['vertical-align'];
                $properties ['text-align'] = $css_properties ['text-align'];
                $properties ['padding'] = '0.3cm';
                $properties ['border'] = '0.002cm solid #000000';
                $properties ['background-color'] = $css_properties ['background-color'];
                $renderer->_odtTableCellOpenUseProperties($properties);
                break;
 
            case DOKU_LEXER_UNMATCHED :
                $renderer->cdata($data);
                break;
 
            case DOKU_LEXER_EXIT :
                $renderer->tablecell_close();
                $renderer->tablerow_close();
                $renderer->_odtTableClose();
                $renderer->p_open();
                break;
        }
    }
}

Основной файл перевода, это lang.php. Отредактированно :

Файл «en»
Файл «fr»
Файл «ru»
Количество заметок увеличенно до 9 шт.
Заменены названия заметок по цветовой схеме.

lang.php

<?php
/**
 * English language file
 */
 
$lang['note_picker']  = 'Notes';
 
$lang['tb_grey_note']      = 'grey note';
$lang['tb_blue_note']       = 'blue_note';
$lang['tb_yellow_note'] = 'yellow note';
$lang['tb_green_note']   = 'green note';
$lang['tb_red_note']      = 'red note';
$lang['tb_orange_note']       = 'orange note';
$lang['tb_purple_note'] = 'purple note';
$lang['tb_brown_note']   = 'brown note';
$lang['tb_black_note']   = 'black note';

lang.php

<?php
/**
 * Russian language file
 */
 
$lang['note_picker'] = 'Заметки';
 
$lang['tb_grey_note'] = 'серая заметка';
$lang['tb_blue_note'] = 'синяя заметка';
$lang['tb_yellow_note'] = 'желтая заметка';
$lang['tb_green_note'] = 'зеленая заметка';
$lang['tb_red_note'] = 'красная заметка';
$lang['tb_orange_note'] = 'оранжевая заметка';
$lang['tb_purple_note'] = 'фиолетовая заметка';
$lang['tb_brown_note'] = 'коричневая заметка';
$lang['tb_black_note']   = 'черная заметка';

Пример № 1 отображения ссылок отредактированного плагина в русской локализации

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

Пример № 2 отображения ссылок отредактированного плагина в русской локализации

зеленая заметка

оранжевая заметка

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

Пример № 3 отображения ссылок отредактированного плагина в английской локализации

yellow note

orange note

black note

Ссылка на загрузку модефицированного плагина и в конце статьи в разделе «Дополнения и Файлы» с пометкой «mod»

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

Лицензия

Author: Anael Mobilia
License: GNU GPL v2

pagelist_development

anonymous@undisclosed.example.com (Anonymous) — Wed, 30 Aug 2023 08:35:57 +0000

⇐ Pagelist plugin

Как использовать список страниц в вашем плагине

Вы используете список страниц для вывода списка страниц. Вам нужен массив, в котором есть строки, по крайней мере, с 'id' набором записей.

Вы также можете добавить свои собственные столбцы. Ниже описаны два способа.

addColumn() с данными через addPage()/setHeader()

(Предпочтительный подход) Вы можете использовать плагин списка страниц в своем плагине. Вы также addColumn() можете (необязательно) добавить свой собственный столбец. Данные для этого столбца предоставляются с помощью addPage() и setHeader().

example/syntax/component.php

...
$flags = ['header']; //показать заголовок таблицы 
$header = [
    'yourcolumn' => 'Your Column'
];
$pages = [
    ['id' =>  'первая страница' ,  'ваша колонка'  => 'Text 1'],
    ['id' =>  'вторая страница' ,  'ваша колонка'  => 'Text 2'],
    ['id' => '3rd', 'yourcolumn' => '<em>3&amp;4</em> with user input escaping'],
];
if($pagelist = $this->loadHelper('pagelist')) {
    $pagelist->addColumn('example', 'yourcolumn');
    $pagelist->setHeader($header); //доступно с 17 октября 2022 г. 
    $pagelist->setFlags($flags);
    $pagelist->startList('plugin_example_class');
    foreach($pages as $page) {
        $pagelist->addPage($page);
    }
    $renderer->doc .= $pagelist->finishList();
}
...

addColumn() с данными через th()/td()

(Альтернативный подход) Если данные для дополнительного столбца не были предоставлены ранее, список страниц запросит их у вашего плагина th() и td() предоставит его. helper.php Часто этот подход требует временного хранения данных, что снижает его производительность.

example/helper.php

<?php
class helper_plugin_example extends DokuWiki_Plugin {
    /**
     * Возвращает текст заголовка столбца для плагина списка страниц.
     *
     * @param string $column имя столбца, заданное в addColumn()
     * @param string $class по ссылке, класс установлен в td таблицы. Заменяет это значение по умолчанию, имя столбца установлено как класс.
     * Текст строки @return, экранированный плагином Pagelist
     */ 
    public function th($column=null, &$class = null) {
        if($column == 'yourcolumn') {
            $content = 'Your Column';
        } else {
            $content = $this->getLang('othercolumn');
        }
    }
    //в конечном итоге это также возможно, если у вас есть только один столбец, а не класс CSS для каждой ячейки:
    public function th() {
        return $this->getLang('yourcolumn');
    }
 
    /**
     * Возвращает данные ячейки для плагина списка страниц.
     *
     * @param string $id идентификатор страницы
     * @param string $column имя столбца, заданное в addColumn()
     * @param string $class по ссылке, класс установлен в td таблицы. Заменяет это значение по умолчанию, имя столбца установлено как класс.
     * @return строка экранирует HTML-содержимое ячейки таблицы
     */ 
    public function td($id, $column=null, &$class = null) {
        $class .= 'special';
        if($column == 'yourcolumn') {
            $content = '...';
        } else {
            $content = '...';
        }
        return hsc($content);
    }
     //в конечном итоге это также возможно, если у вас есть только один столбец, а не класс на ячейку:: 
    public function td($id) {
        $content = '...';
        return hsc($content);
    }
}

Описание доступных функций списка страниц

(необязательно) addColumn($plugin, $column)добавьте в таблицу $column.
Получает данные через addPage()/setHeader() или использует хелпер из имени плагина $plugin для отображения:
- ячейки строки страницы сtd($id, $column=null, &$class = null)
- ячейки строки заголовка с th($column=null, &$class = null).
(необязательно) modifyColumn($column, $value)перезаписывает значение $column, для отключения которого установлено значение false.
(необязательно) setFlags($flags)с $flags — массив с флагами в виде строк. Вызовите эту функцию после addColumn().
- Рядом с флагами по умолчанию можно использовать дополнительный флаг defaultsortby=<property>для установки предпочтения сортировки без включения сортировки.
(необязательно) setHeader($header)с $header, содержащим записи html для каждого столбца, если не указаны значения списка страниц по умолчанию или используются плагин→th(). Вам нужно избежать пользовательского ввода с помощью hsc() .
(обязательно) startList($class = null)запускает список или таблицу, если включено, печатается также заголовок. $class может добавить класс таблицы.
(обязательно), для каждой строки addPage($page)со связанным массивом $page с записью для каждого столбца. Для ваших собственных столбцов вы должны предоставить HTML, вам нужно избежать пользовательского ввода .
- 'id' ⇒ строковый идентификатор страницы (обязательно).
- 'title' ⇒ строка Первый заголовок, иначе идентификатор страницы; исключение: если используется titleimage, это используется для атрибута title&alt изображения.
- 'titleimage' ⇒ строковый идентификатор носителя
- 'date' ⇒ int временная метка даты создания, в противном случае дата изменения (например, иногда требуется для плагина)
- 'пользователь' ⇒ строка $meta['создатель']
- 'desc' ⇒ строка $meta['description']['abstract']
- 'описание' ⇒ строковое описание, заданное с помощью синтаксиса списка страниц.
- 'symmary' ⇒ строковая сводка последнего изменения страницы $meta['last_change']['sum']
- 'существует' ⇒ bool page_exists($id)
- 'разрешение' ⇒ int auth_quickaclcheck($id)
- 'черновик' ⇒ строка $meta['type'], заданная плагином блога.
- «приоритет» ⇒ строковый приоритет задачи: «низкий», «средний», «высокий», «критический».
- 'class' ⇒ класс строки, установленный для каждой строки.
- 'файл' ⇒ строка wikiFN($id)
- 'section' ⇒ строковый идентификатор раздела, добавленный как #ancher к URL-адресу страницы.
(обязательно) finishList()закрывает список или таблицу, возвращает html

Если вы добавляете собственный столбец для своего плагина, рекомендуется добавлять через addPage()HTML для каждой ячейки столбца. В качестве альтернативы вы должны реализовать helper.phpwith th()и td().

для каждой строки столбец $ заполняется td($id, $column=null, &$class = null)(экранируйте пользовательский ввод с помощью hsc())
в заголовке заполняется столбец $ th($column=null, &$class = null)(экранирование осуществляется с помощью списка страниц).

Дополнительную документацию по аргументам см. в PHPDocs исходного кода.

Список зависимостей для каждого плагина

Некоторые примечания, использованные для очистки плагина Pagelist (сентябрь 2022 г.).

authorstats
uses:	loadHelper
	setFlags
	startList
	addPage
	finishList
cloud
	depends on tag and searchstats plugins
	⇒ unclear if it depends (indirectly) on pagelist
dir
	copied css styles, seems independent further
pageimage
	integrated with pagelist
provides:	td($id)
	th()
tagsections
	depends on tag (so on pagelist?)
task
provides:	th()
	td($id)

uses:	plugin_load('helper','pagelist')
	header array
	column array
	addCOlumn
	setFlags
	startList
	addPage
	finishList
tiledblog
	depends on blog
editor
uses:	plugin_isdisabled	use loadHelper
	plugin_load	use loadHelper
	column array
	setFlags
	startList
	addPage
	finishList
tag
provides:	td($id)
	th()

uses:	loadhelper
- topic
	setFlags
	startList
	addPage
	finishList

-searchtags	loadHelper
	setFlags
	startList
	addPage
	finishList

-action	loadHelper
	setFlags
	startList
	addPage
	finishList
tagfilter
provides:	td($id,$col)
	th($tag='')

uses:	plugin_isdisabled	use loadHelper
-syntax	plugin_load	use loadHelper
	addColumn
	setFlags
	startList
	addPage
	finishList

-action	addColumn
	setFlags
	startList
	addPage
	finishList
blog
uses:	plugin_isdisabled	use loadHelper
-archive	plugin_load	use loadHelper
	setFlags
	startList
	addPage
	finishList

-autoarchive	plugin_isdisabled	use loadHelper
	plugin_load	use loadHelper
	setFlags
	startList
	addPage
	finishList
discussion
provides:	th()
-helper	td($id, $col = null, &$class = null, $num = null) $num is used interally in discussion plugin

uses:
-threads	loadHelper
	addColumn
	setFlags
	startList
	addPage
	finishList
linkback
provides:	th()
	td($id, $number=null)
changes
	optionally: pagelist plugin used by setting a flag
uses:	plugin_load
	setFlags
	startList
	addPage
	finishList

VERY OLD - 2008:

pageseditees	–not supported anymore–
uses:	plugin_load
	page array
	_meta array	better use get_metadata directly
	_getMeta
listeabo	–not supported anymore–
uses:	plugin_load
	page array
	_meta array	better use get_metadata directly
	_getMeta
snap	–not supported anymore–
uses:	plugin_load
-syntax.php.ori	page
	_meta	better use get_metadata directly
	_getMeta

-helper	plugin_load
	page
	_meta	better use get_metadata directly
	_getMeta
favoris	–not supported anymore–
uses:	plugin_load
	page	better use get_metadata directly
	_meta
	_getMeta

COMMENTED OUT:

pageindex	–not supported–
uses:	plugin_load
	startList	not dependent
	addPage
	finishList

pagelist

anonymous@undisclosed.example.com (Anonymous) — Wed, 30 Aug 2023 08:18:13 +0000

PageList для «ДокуВики»

Перечисляет страницы в красивой таблице или неупорядоченном списке. Плагин Pagelist берет список вики-страниц и предоставляет красиво отформатированную таблицу с информацией о них. Плагин имеет ряд флагов, которые можно использовать для управления информацией и форматом списка страниц. Пользователь может предоставить список ссылок на конкретные страницы, а также некоторые популярные вспомогательные плагины, такие как плагины «Блог », «Обсуждение» , «Редактор », «Тег» , «Задача» и «Директор» .

Релиз: 2023-07-12.
Репозиторий:https://github.com/dokufreaks/plugin-pagelist
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Сообщайте об ошибках или просьбах о новых функциях в системе отслеживания ошибок

Примечание по обновлению : в августе 2023 года стиль CSS немного изменился. Конкретные стили для каждой ячейки заменяются более общими стилями. Также все стили, кроме simplelist, получили дополнительный класс plgn__pglist, позволяющий лучше настроить этот плагин с помощью вашего собственного стиля.

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Просто оберните тегом обычный неупорядоченный список внутренних ссылок <pagelist>. Вы можете предоставить конкретные внутренние ссылки на страницы или попросить плагины предоставить их, как показано в примере ниже:

<pagelist&[флаги]> 
  * [[..:blog:|Плагин блога]] 
  * [[..:discussion:|Плагин обсуждения]] 
  * [[..:editor:|Плагин редактора]] 
  * [[.. :tag:|Плагин тега]] 
  * [[..:wrap|Плагин переноса|Это показано в ячейке описания]] 
</pagelist>

[флаги]

флаги можно использовать для изменения внешнего вида списка страниц, флаги

необязательный

Флаги

Флаг по умолчанию		Альтернативный флаг		Настройка в диспетчере конфигураций
default	таблица с горизонтальными линиями	table, list или simplelist	стандартный стиль таблицы или списка «ДокуВики»	style
firsthl	покажи первый заголовок	nofirsthl	покажи название страницы	showfirsthl
date	показать дату создания или последней модификации	nodate	скрыть дату	showdate
user	создатель шоу или участники nouser скрыть пользователя	showuser
noheader	скрыть строку заголовка таблицы списка страниц	header	покажи заголовок	showheader
nodesc	скрыть описание	desc	показать описание (из метаданных)	showdesc
nocomments	скрыть количество комментариев	comments	показать количество комментариев (если установлен дискуссионный плагин )	showcomments
notags	скрыть теги tags показывать теги (если установлен плагин тегов )	showtags
nosort	нет сортировки страниц	rsort/sort	сортирует страницы (в обратном порядке) в алфавитном порядке по имени страницы	rsort/sort
nodiff	нет отображения столбца различий	showdiff	отображает столбец различий со значком различий, ссылающимся на соответствующую страницу различий для каждой строки	showdiff
noimage	показать изображение страницы	image	требуется установленный плагин Pageimage . Может быть определено на странице или будет использовано изображение с тем же именем, что и страница.	showimage

<pagelist&default&nodate&nouser&sort>
  * [[wiki:plugin:backuptool:|]]
  * [[wiki:plugin:autotooltip:|]]
  * [[wiki:plugin:codeprettify:|]]
  * [[wiki:plugin:citations:|]]
  * [[wiki:plugin:cookiebanner|]]
</pagelist>

В приведенном выше примере список страниц будет отображать информацию о предоставленных страницах в таблице со строкой заголовка и столбцом комментариев (если установлен плагин обсуждений ). Пользователь (или плагин) должен указать конкретные страницы для отображения в списке.

Конфигурация и настройки

Плагин можно настроить с помощью менеджера конфигурации DokuWiki, доступного в меню администратора. Эти настройки также применяются к плагинам, которые используют вспомогательный компонент плагина списка страниц, например, архивный компонент плагина блога .

style	Стиль списка (по умолчанию, таблица, таблица/список, простой список)
showheader	Показать заголовок таблицы
showdate	Показывает/скрывает столбец даты (скрыть, дата создания, дата изменения)
showuser	Показывает/скрывает столбец пользователя (скрыть, создатель, участники)
showdesc	Показывает/скрывает краткое описание, взятое из первого абзаца страницы (скрыть, максимум 160 символов, максимум 500 символов)
showcomments	Показывает/скрывает комментарии страницы (требуется плагин обсуждения )
showlinkbacks	Показывает/скрывает обратные ссылки на странице (требуется плагин обратных ссылок )
showtags	Показывает/скрывает теги страницы (требуется плагин тегов )
sort	Сортирует страницы в алфавитном порядке по имени страницы.
showdiff	Отображает столбец различий со значком различий, ссылающимся на соответствующую страницу различий для каждой строки.
showimage	Показывает/скрывает столбец изображения (требуется плагин Pageimage ).

Вспомогательный плагин

Вы можете легко использовать функциональность плагина Pagelist в своих собственных плагинах. Вот базовый фрагмент кода:

$pages = [
    ['id' => 'wiki:dokuwiki'],
    ['id' => 'wiki:syntax'],
];
$pagelist = $this->loadHelper('pagelist');
if (!$pagelist) return false; // failed to load plugin
$pagelist->startList();
foreach ($pages as $page){
    $pagelist->addPage($page);
}
$renderer->doc .= $pagelist->finishList();

С момента выпуска 2017-08-24 функция startList() имеет дополнительный параметр для указания класса CSS для добавления его в класс элемента таблицы:

$pagelist->startList('myclass');

Подробнее см. в разделе «Как использовать Pagelist в вашем плагине» .

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

plugin-pagelist-master.zip

Лицензия

Author: Dokufreaks (previous authors: Matthias Schulte, Michael Hamann, Esther Brunner, Gina Häußge, Michael Klier)
License: GNU GPL v2

parserarray

anonymous@undisclosed.example.com (Anonymous) — Fri, 17 Jan 2025 11:46:41 +0000

Parserarray для «ДокуВики»

Экспортирует массив инструкций парсера для текущей страницы.

Этот плагин был разработан Håkan Sandell.

Релиз: 2010-11-07.
Правка: 2011-01-04.
Репозиторий:https://github.com/HakanS/dokuwiki-plugin-parserarray/
Совместимость с «Докувики»: 2010-11-07

Этот плагин экспорта является инструментом разработки и полезен только для пониманияпарсера DokuWiki.

Совместимость

2005-09-19+

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в <dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Примеры/Использование

Этот плагин экспортирует/показывает массив инструкций парсера для текущей страницы. Полезно для тех, кто хочет понять, как работает парсер DokuWiki, и читает parser.

Используется do=export_parserarray для отображения массива парсера.

Файл для загрузки

plugin-parserarray.zip

Лицензия

Author: Håkan Sandell
License: GNU GPL v2
Donate: Click here.

downloadurl: https://github.com/HakanS/dokuwiki-plugin-parserarray/zipball/master
bugtracker : https://github.com/HakanS/dokuwiki-plugin-parserarray/issues
sourcerepo : https://github.com/HakanS/dokuwiki-plugin-parserarray/

phpwikify

anonymous@undisclosed.example.com (Anonymous) — Fri, 18 Aug 2023 21:30:53 +0000

Wikify для «ДокуВики»

Позволяет иметь возможность анализировать выходные данные PHP-скриптов.

Этот плагин позволяет вам использовать PHP-скрипты на вики-страницах так же, как с помощью тега <php>. Разница в том, что выходные данные PHP-скрипта передаются через парсер/рендерер «ДокуВики».

Релиз: 2020-06-15.
Репозиторий:https://github.com/trailjeep/dokuwiki-plugin-phpwikify
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

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

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Следующий пример:

<phpwikify>
$tt = 'help';
echo "  * first bullet\n";
echo "  * $tt me\n";
</phpwikify>

будет отображаться:

first bullet
help me

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

dokuwiki-plugin-phpwikify-master.zip

Лицензия

Author: Trailjeep
License: GNU GPL v2

plugins

anonymous@undisclosed.example.com (Anonymous) — Mon, 06 Jan 2025 21:34:14 +0000

Плагины

Плагины обеспечивают систему расширения возможностей «Докувики» без необходимости взламывать исходный код (и повторять это при каждом обновлении). Ниже приведён список готовых к использованию плагинов, созданных пользователями «Докувики».

Установка может быть выполнена автоматически путем поиска и установки плагина через менеджер extension⁹⁾. Плагин можно установить вручную, поместив его в собственную папку в разделе lib/plugins/. Смотрите подробную инструкцию по установке плагинов.

Обязательно прочитайте предупреждение о безопасности плагинов.

Если вы хотите помочь с переводом плагинов на другой язык, обратитесь к странице Localization of plugins.

Вы также можете найти рекомендуемые группы плагинов в качестве решений для общих приложений DokuWiki. Существует также список очень распространенных плагинов.

Основные плагены

Auto-Tooltip для «ДокуВики»

Вручную создавайте всплывающие подсказки или генерируйте их на основе заголовка и резюме вики-ссылки

BackupTool для «ДокуВики»

Citations для «ДокуВики»

Создает цитаты разных форматов для ваших вики-страниц. Этот плагин дает вам возможность разрешить пользователям цитировать вашу работу. Это требуется довольно часто в научных кругах и журналистике.

CodePrettifier для «ДокуВики»

Color для «ДокуВики»

Возможность писать цветной текст в «ДокуВики». Спецификация цвета переднего плана или фона может быть любой допустимой спецификацией цвета CSS

Cookiebanner для «ДокуВики»

Copy2clipboard для «ДокуВики»

Details Tag для «ДокуВики»

Diagram для «ДокуВики»

Discussion для «ДокуВики»

Добавляет раздел комментариев на вики-страницы. Плагин обсуждения добавляет раздел обсуждения после вашей вики-страницы для комментариев пользователей.

Display Wiki Page для «ДокуВики»

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

DocNavigation для «ДокуВики»

Добавьте навигационные ссылки на предыдущую и следующую страницу вверху и внизу вики-страницы.

Dokuteaser для «ДокуВики»

Дает возможность использовать блок заключенный между <dokuteaser> и </dokuteaser>, который помещает текст в заданную часть без применения таблиц и прочего.

DW2PDF для «ДокуВики»

Экспортирует страницы вики в формат PDF.

EditTable для «ДокуВики»

Предоставляет визуальный интерфейс редактирования и вставки таблиц. Этот плагин добавляет дополнительную кнопку редактирования в каждую таблицу.

Icons Plugin для «ДокуВики»

Предоставляет визуальный интерфейс для вставки иконок Font Awesome и т.п. в DokuWiki. Этот плагин добавляет дополнительную кнопку в меню редактора.

HtmlMetaTags для «ДокуВики»

Позволяет встраивать HTML и PHP в вики-страницы.

Htmlok для «ДокуВики»

Добавляет некоторые метатеги (открытый график) в заголовок html (например, ключевые слова, описание или любые другие).

link4pages для «ДокуВики»

Добавляйте пользовательские ссылки во все PageMenus.

PageList для «ДокуВики»

SMTP для «ДокуВики»

Настройте SMTP-сервер (с дополнительной аутентификацией) для отправки почты из «ДокуВики». Этот плагин заменяет способ, которым DokuWiki отправляет электронные письма.

StepByStep для «ДокуВики»

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

Tablelayout для «ДокуВики»

Установка ширины столбцов таблицы, закрепление строк заголовков, плавание таблицы, интеграция с плагином edittable

Wikify для «ДокуВики»

Wrap для «ДокуВики»

Универсальный плагин, сочетающий в себе функционал многих других плагинов. Оберните вики-текст внутри контейнеров (divs или spans) и задайте им класс (выберите из множества предустановленных классов), ширину и/или язык с соответствующим направлением текста.

Создание плагинов

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

В зависимости от того, с какими составляющими «Докувики» взаимодействуют плагины, выделяется несколько категорий плагинов. Один и тот же плагин может входить в несколько категорий. Ссылки ниже должны помочь вам:

Сборник советов для тех, кто создаёт плагины:

Plugins Programming Tips (англ.)

Плагины, описание которых переведено на русский язык

BBCode — ББ-коды
Config — Управление настройками
database2 — База данных-2
MyTemplate — «Мой шаблон»
OrphansWanted — указатель «страниц-сирот» и «требуемых страниц»
Plugin — управление плагинами
Translation — «перевод»
OpenLayersMap Plugin — карты на страницах Вашей вики
geophp Plugin — доступ к библиотеке geoPHP

Сообщения об ошибках и пожелания по функциям

Два коротких замечания:

Пожалуйста, используйте трекер проблем на странице плагина
Предоставьте достаточно информации, чтобы воспроизвести ваш случай

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

Идеи для новых плагинов

Запрос плагина

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

Чтобы попросить о создании нового плагина или обсудить идеи плагинов, пожалуйста, обратитесь к форуму Plugin Wishlist Forum или здесь.

Последние пожелания на форуме:

Произошла ошибка при получении новостной ленты: https://forum.dokuwiki.org/atom/t/plugin-wishlist/d

Больше идей...

Далее несколько закрытых запросов на функции, которые мы не будем реализовывать в ядре «Докувики», интересные идеи для плагинов: Doku Plugin idea на нашем GitHub issue tracker.

)

Произошла ошибка при получении новостной ленты: https://feeds.feedburner.com/doku-plugin-idea

Creating Plugins

If your needs aren't covered by the existing plugins above, please have a look at our pages on how to create and publish a plugin.

Reporting Bugs and Features Wishes

Two short notes:

Please use the issue tracker of the plugin
Provide enough information to reproduce your case

Please refer to How to report bugs and request new features in plugins for more info about this topic.

Ideas for New Plugins

Requesting Plugin

If you are in need of a special feature in DokuWiki but haven't the skills or resources to create your own plugin you might want to suggest the feature for consideration by the community.

To ask for the creation of a new plugin or to discuss plugin ideas, please refer to the Plugin Wishlist Forum.

Recent Wishes in the forum:

Произошла ошибка при получении новостной ленты: https://forum.dokuwiki.org/atom/t/plugin-wishlist/d

More ideas...

Further some closed features requests, which we won't implement in DokuWiki core, are interesting ideas for plugins: Doku Plugin idea's at our GitHub issue tracker.

Произошла ошибка при получении новостной ленты: https://feeds.feedburner.com/doku-plugin-idea

⁹⁾

До версии Binky это делалось с помощью менеджера plugin

rating

anonymous@undisclosed.example.com (Anonymous) — Fri, 07 Feb 2025 17:43:16 +0000

Плагин рейтинга

Совместим с «Докувики»

2024-02-06 "Kaos" да
2023-04-04 "Jack Jackrum" да
2022-07-31 "Igor" да
2020-07-29 "Hogfather" да

Позволяет оценить страницу

Последнее обновление:: 2016-01-13
Предоставляет: Syntax, Action
Репозиторий: исходный код
Требует: sqlite

Это расширение не находится в пространстве имен 'plugin' или 'template' и поэтому игнорируется.

Теги: poll, rate, rating, vote

- Andreas Gohr

statdisplay

Установка

Внешние требования: Для этого плагина требуются следующие дополнительные компоненты, которые необходимо установить отдельно:

sqlite plugin

Установите плагин с помощью Extension Manager и URL-адреса загрузки выше, который указывает на последнюю версию плагина. Обратитесь Plugins чтобы узнать, как установить плагины вручную.

Затем настройте свой шаблон и интегрируйте следующий код в то место, где вы хотите, чтобы отображались элементы управления рейтингом:

<?php
$rating = plugin_load('helper', 'rating');
if($rating) $rating->tpl();
?>

Примеры/Синтаксис

Обязательно интегрируйте плагин в свой шаблон, как описано выше. Синтаксис доступен только для вывода агрегированных данных. Ввод данных осуществляется только через интеграцию шаблона.

Вставка тега {{rating}} создаст список из десяти страниц с наилучшими оценками.

{{rating}}
{{rating|startdate=2014-07-01}}
{{rating|lang=en}}
{{rating|startdate=2014-07-01,lang=en}}

язык

Если у вас установлен плагин перевода, вы можете фильтровать страницы по языку:

{{rating|lang=$langprefix}}

Дата начала

Вы можете указать начальную дату, с которой будет вычисляться рейтинг. Формат для YYYY-MM-DD.

{{rating|startdate=$startdate}}

элементы списка

По умолчанию в списке используются маркеры, которые можно изменить на нумерованный список, добавив tag=ol опцию:

{{rating|tag=ol}}

счет

Вы можете отобразить оценку каждого элемента, добавив score=true опцию:

{{rating|score=true}}

Разработка

Журнал изменений

Merge pull request #12 from dokuwiki-translate/lang_update_327_162698… (2025/03/25 10:44)
Merge pull request #14 from dokuwiki-translate/lang_update_773_170419… (2024/01/02 17:18)
translation update (2024/01/02 14:40)
Merge pull request #13 from dokuwiki-translate/lang_update_407_164562… (2022/02/23 17:53)
translation update (2022/02/23 17:20)
translation update (2021/07/23 00:20)
Merge pull request #9 from dryoo/patch-1 (2016/06/28 00:41)
ignore actions triggered by bots (2016/01/13 13:39)

Известные ошибки и проблемы

Сообщайте об ошибках и проблемах по адресу: https://github.com/cosmocode/dokuwiki-plugin-rating/issues

Дополнения и Файлы

Плагин рейтинга

repository

anonymous@undisclosed.example.com (Anonymous) — Sun, 09 Feb 2025 12:11:13 +0000

Плагин репозитория расширений

Этот плагин является аналогом менеджера расширений. Он управляет расширениями (плагинами и шаблонами) здесь, на dokuwiki.org, и предоставляет API для менеджера расширений.

(Также доступен плагин, похожий на этот, но с большей гибкостью, предназначенный для использования за пределами dokuwiki.org. Это плагин данных.)

Запись плагинов

Каждый плагин должен иметь домашнюю страницу в plugin пространстве имен, содержащую как минимум краткое описание и блок данных, подобный следующему в начале:

---- plugin ----
description: Just an example to prove the point
author     : Joe Blow
email      : joe@example.com
type       : syntax, action, admin, helper, render
lastupdate : 2007-12-17
compatible : Anteater, 2010-02-14
depends    : plugin1
conflicts  : plugin2
similar    : plugin3
tags       : example, sample

downloadurl: https://github.com/example/dokuwiki-plugin-sample/zipball/master
bugtracker : https://github.com/example/dokuwiki-plugin-sample/issues
sourcerepo : https://github.com/example/dokuwiki-plugin-sample/
donationurl: https://www.paypal.com/...

screenshot_img : http://<someserver>/image.png
----

Информация хранится в базе данных и используется для создания динамического браузера репозитория (см. список плагинов или менеджер расширений в вашей вики)

О полях:

description – должно быть кратким описанием того, что делает плагин
author – основной автор плагина или текущий сопровождающий
email – адрес электронной почты основного автора плагина или текущего сопровождающего
type – один или несколько типов плагинов (синтаксис, действие, администрирование, помощник, рендеринг)
lastupdate – дата предоставления последней версии плагина в формате ГГГГ-ММ-ДД, используется для автоматической проверки обновлений диспетчером расширений и должна совпадать с датой в plugin.info.txt
updatemessage – показывать сообщение, информирующее пользователей об обновлении, отображается в Extension Manager
compatible – укажите версию(и) DokuWiki, с которой совместим ваш плагин . Можно указать несколько версий и использовать кодовые имена. Например: 2009-02-14, лемминг, муравьед.
- Используйте знак «плюс» + если вы считаете, что плагин будет совместим с будущими версиями DokuWiki.
- Используйте восклицательный знак ! если плагин несовместим с версией DokuWiki (например, «!Greebo»).
depends – список зависимостей плагина, разделенный запятыми, если таковые имеются
conflicts – список плагинов/шаблонов, разделенных запятыми, которые конфликтуют с вашим плагином, используйте template:xxx если конфликтуют с шаблоном xxx
similar – список плагинов, разделенных запятыми, с похожей задачей
tags – классифицируйте свой плагин здесь. Если !obsolete это единственный тег, то этот плагин будет скрыт из таблицы репозитория
screenshot_img – URL-адрес изображения для характерного снимка экрана плагина/шаблона (также используется в новом менеджере расширений, который масштабирует и обрезает его до изображения размером 120×70 пикселей)
securitywarning – используйте это поле, чтобы предупредить о внутренних проблемах безопасности плагина. Возможность выполнения произвольного скрипта может быть причиной (предопределенные значения: informationleak, allowsscript, requirespatch and partlyhidden (объяснение ))
securityissue – добавляйте это поле только в случае возникновения проблем с безопасностью плагина. Введите здесь краткое описание и сообщите автору. Плагин будет скрыт из таблицы репозитория
downloadurl – это должен быть прямой URL-адрес для загрузки, совместимый с самой последней версией
bugtracker – ссылка на багтрекер для этого плагина, оставьте пустым, если таковой отсутствует
sourcerepo – ссылка на веб-интерфейс системы управления исходным кодом, например git или darcs, оставьте пустым, если таковая отсутствует
donationurl – ссылка на PayPal, список желаний Amazon или что-то подобное, где люди могут сделать вам пожертвование; оставьте пустым, если ничего не доступно

Шаблон записи

Аналогично для шаблонов, но в template пространстве имен.

---- template ----
description   : Just an example to prove the point
author        : Joe Blow
email         : joe@example.com
lastupdate    : 2007-12-17
compatible    : Anteater, 2010-02-14
depends       : 
conflicts     : example, template:sample
similar       : 
tags          : example, sample

downloadurl   : https://github.com/example/dokuwiki-plugin-sample/zipball/master
bugtracker    : https://github.com/example/dokuwiki-plugin-sample/issues
sourcerepo    : https://github.com/example/dokuwiki-plugin-sample/
donationurl   : https://www.paypal.com/...

screenshot_img: http://<someserver>/image.png
----

Информация хранится в базе данных и используется для создания динамического браузера репозитория (см. список шаблонов или менеджер расширений в вашей вики).

About the fields:

description – должно быть кратким описанием основной функции шаблона
author – основной автор шаблона или текущий сопровождающий
email – адрес электронной почты основного автора шаблона или текущего сопровождающего
lastupdate – дата предоставления последней версии шаблона в формате ГГГГ-ММ-ДД, она используется для автоматической проверки обновлений диспетчером расширений и должна совпадать с датой в template.info.txt
updatemessage – показывать сообщение, информирующее пользователей об обновлении, отображается в Extension Manager
compatible – укажите версию(и) DokuWiki, с которой совместим ваш шаблон. Можно указать несколько версий и использовать кодовые имена. Например: 2009-02-14, лемминг, муравьед
depends – список зависимостей шаблона, разделенных запятыми, если таковые имеются
conflicts – список плагинов/шаблонов, разделенных запятыми, которые конфликтуют с вашим шаблоном, используйте, template:xxx если конфликтуют с шаблоном xxx
similar – список шаблонов с похожей задачей, разделенный запятыми
screenshot_img – URL-адрес снимка экрана вашего шаблона (также используется в новом менеджере расширений, который масштабирует и обрезает его до изображения размером 120×70 пикселей)
tags – классифицируйте свой шаблон здесь. Если !obsolete это единственный тег, то этот шаблон будет скрыт из таблицы репо
securitywarning – используйте это поле, чтобы предупредить о проблемах безопасности, присущих шаблону. Возможность выполнения произвольного скрипта может быть причиной
securityissue – добавляйте это поле только в случае возникновения проблем с безопасностью шаблона. Введите здесь краткое описание и сообщите автору. Шаблон будет скрыт из таблицы репозитория
downloadurl – это должен быть прямой URL-адрес для загрузки, совместимый с самой последней версией
bugtracker – ссылка на багтрекер для этого шаблона, оставьте пустым, если таковой отсутствует
sourcerepo – ссылка на веб-интерфейс системы управления исходным кодом, например git или darcs, оставьте пустым, если таковая отсутствует
donationurl – ссылка на PayPal, список желаний Amazon или что-то подобное, где люди могут сделать вам пожертвование; оставьте пустым, если ничего не доступно

Предупреждение о безопасности: предопределенные сочетания клавиш

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

Ярлык	Значение
informationleak	Это расширение раскрывает информацию, которая может быть ценной для хакера. Не рекомендуется для публичной установки.
allowsscript	Это расширение позволит выполнять скрипты. Его следует использовать только тогда, когда вы доверяете ВСЕМ редакторам, лучше всего подходит для личных вики.
requirespatch	Это расширение требует исправления ядра DokuWiki. Ручные исправления могут нарушить совместимость с другими расширениями и усложнить защиту вашей установки путем обновления до последней версии.
partlyhidden	Скрытие частей страницы DokuWiki не поддерживается ядром. Большинство попыток ввести контроль ACL для частей страницы приведут к утечке информации через RSS-канал, поиск или другие основные функции.

Пример частично скрытого предупреждения безопасности можно посмотреть на странице plugin:ifauth.

Руководство и API плагина репозитория

В руководстве описывается, как использовать различные компоненты плагина на dokuwiki.org.

В документации API описывается , как удаленно запросить информацию о плагине.

Совместимость с релиз-кандидатами

Когда будет доступен новый релиз-кандидат, пожалуйста, обновите домашнюю страницу плагина с соответствующей совместимостью, используйте название релиза (например, «rincewind») вместо даты RC. Таким образом, вам не придется обновлять информацию о совместимости, когда будет готов финальный релиз.

smtp

anonymous@undisclosed.example.com (Anonymous) — Thu, 10 Aug 2023 21:07:56 +0000

SMTP для «ДокуВики»

Настройте SMTP-сервер (с дополнительной аутентификацией) для отправки почты из «ДокуВики». Этот плагин заменяет способ, которым DokuWiki отправляет электронные письма. Вместо того, чтобы полагаться на встроенную функцию mail электронной почты PHP , он напрямую связывается с настроенным SMTP-сервером для отправки электронных писем. Это особенно полезно, когда настройка PHP для отправки почты сложна (Windows) или невозможна.

Этот плагин в основном заменяет старый плагин SwiftMail . Он поддерживает отправку электронных писем в формате HTML . Однако он НЕ поддерживает аутентификацию POP перед SMTP. Если вам это все еще нужно, вы должны полагаться на плагин SwiftMail. Всем остальным теперь рекомендуется этот плагин.

Релиз: 2023-04-23.
Репозиторий:https://github.com/splitbrain/dokuwiki-plugin-smtp/
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Пустое тело письма

В зависимости от вашего почтового сервера может случиться так, что отправленные электронные письма будут иметь пустое тело. (см. выпуск №17).

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Конфигурация

Все параметры конфигурации можно настроить в configuration manager в разделе «Настройки плагина SMTP»..

Кроме того, вам необходимо настроить параметр mailfrom который находится в разделе «Настройки уведомлений» диспетчера конфигурации.

Когда опция отладки включена, вся сессия SMTP будет напечатана прямо на экране, если отправка почты не удалась. Вы должны отключить это, когда ваша установка работает.

Тестирование

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

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

smtp.zip

Лицензия

Author: Andreas Gohr
License: GNU GPL v2

sqlite

anonymous@undisclosed.example.com (Anonymous) — Fri, 07 Feb 2025 18:20:00 +0000

Плагин sqlite

Совместим с «Докувики»

2024-02-06 "Kaos" да
2023-04-04 "Jack Jackrum" да
2022-07-31 "Igor" да
2020-07-29 "Hogfather" да

Вспомогательный плагин для легкого доступа к базе данных SQLite.

Последнее обновление:: 2024-06-25
Предоставляет: Helper
Репозиторий: исходный код

Это расширение не находится в пространстве имен 'plugin' или 'template' и поэтому игнорируется.

Теги: database, sqlite

Нужен для rating, repository, test

- Andreas Gohr

Этот плагин бесполезен сам по себе. Вместо этого он предоставляет механизмы для других плагинов для создания, управления и доступа к базе данных SQLite. Вам нужно установить его только в том случае, если он требуется другому плагину.

Требования

Этот плагин требует поддержки SQLite и PDO в вашей установке PHP. Убедитесь, что расширение pdo-sqlite установлено и загружено.

Например, в Debian GNU/Linux обязательно установите php-sqlite3 пакет sudo apt install php-sqlite3 который предоставит php-pdo-sqlite по мере необходимости. После этого выполните перезапуск соответствующего веб-сервера (например, если sudo systemctl restart apache2 используется Apache HTTP Server) чтобы сделать функциональные возможности доступными для движка DokuWiki.

Загрузка и установка

Найдите и установите плагин с помощью менеджера расширений. Обратитесь к plugins чтобы узнать, как установить плагины вручную.

Изменения

Version upped (2025/12/02 02:05)
updated deleted files list (2025/12/01 17:16)
Version upped (2025/08/27 02:04)
show database size in admin (2025/08/26 22:37)
Merge pull request #95 from dokuwiki-translate/lang_update_1127_17477… (2025/05/20 18:28)
translation update (2025/05/20 11:45)
Version upped (2025/05/16 02:12)
make PAGEISHIDDEN return an integer (2025/05/15 11:32)

Интерфейс администратора

Плагин поставляется с простым интерфейсом администратора, который дает вам низкоуровневый доступ к любой из доступных баз данных. Это включает:

выполнение произвольных запросов
выполнять предопределенные запросы
экспорт и импорт содержимого базы данных
сохранять и вызывать самостоятельно определенные запросы

Чтобы использовать любую из его функций, сначала выберите в содержании базу данных, с которой вы хотите работать.

Убедитесь, что вы знаете, что делаете. Этот интерфейс не обеспечивает никаких защитных сеток от удаления или повреждения содержимого вашей базы данных!

Документация разработчика

Этот плагин предоставляет вам все механизмы, необходимые для использования базы данных sqlite в вашем плагине. Вся функциональность предоставляется через \dokuwiki\plugin\sqlite\SQLiteDB класс.

Рекомендуется лениво загружать класс, если это необходимо, например, в helper component вашего плагина. Поскольку ваш помощник (обычно) является синглтоном, он гарантирует, что все части вашего кода используют одно и то же подключение к базе данных. А использование функции ленивой загрузки гарантирует, что подключение будет установлено (и инициализировано) только тогда, когда это действительно необходимо.

Ниже вы найдете пример вспомогательного компонента, который поможет вам начать работу.

<?php
 
use dokuwiki\ErrorHandler;
use dokuwiki\Extension\Plugin;
use dokuwiki\plugin\sqlite\SQLiteDB;
 
 
class helper_plugin_example extends Plugin
{
    protected $db;
 
    /**
     * Get SQLiteDB instance
     *
     * @return SQLiteDB|null
     */
    public function getDB()
    {
        if ($this->db === null) {
            try {
                $this->db = new SQLiteDB('example', DOKU_PLUGIN . 'example/db/');
            } catch (\Exception $exception) {
                if (defined('DOKU_UNITTEST')) throw new \RuntimeException('Could not load SQLite', 0, $exception);
                ErrorHandler::logException($exception);
                msg('Couldn\'t load sqlite.', -1);
                return null;
            }
        }
        return $this->db;
    }
 
    /**
     * @param string $foo
     * @return array
     */
    public function getAllBazForFoo($foo)
    {
        $db = $this->getDB();
        if (!$db) return [];
 
        $result = $db->queryAll('SELECT id, meta, baz FROM example WHERE foo = ?', [$foo]);
        return $result;
    }
 
}

Настройка и миграция базы данных

Как вы видели выше, конструктор класса constructor of the SQLiteDB требует два параметра: имя базы данных и каталог миграции.

Имя базы данных — это имя файла вашей базы данных SQLite. Если у вас нет очень веской причины, это должно быть имя вашего плагина. В приведенном выше примере имя — , в результате чего создается example файл базы данных .data/meta/example.sqlite3

Второй параметр определяет каталог, в котором будут находиться файлы миграции базы данных. Большинство плагинов используют db каталог в своей структуре плагинов. Используйте константы DOKU_PLUGIN или DIR для создания соответствующего абсолютного пути.

Итак, что такое каталог миграции? Вашему плагину нужно будет создать схему базы данных и, возможно, заполнить ее некоторыми начальными данными. Когда вы выпускаете новые версии своего плагина, вам может потребоваться обновить схему. Это делается файлами миграции в указанном каталоге. Все это обрабатывается автоматически при вызове конструктора.

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

Номер последней версии должен храниться в файле с именем latest.version. Сами файлы обновлений должны именоваться так updateXXXX.sql, где XXXX — это 4-значное число, дополненное нулями, начинающееся с 0001.

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

Плагин sqlite отслеживает текущую версию базы данных с помощью таблицы с именем opts. У вас может не быть таблицы с таким именем!

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

Публичный API

Следующие методы предоставляются классом SQLiteDB и могут быть использованы в вашем коде. Обратите внимание, что PDO::ERRMODE_EXCEPTION опция PDO включена, и все ошибки будут вызывать исключения. Обязательно обрабатывайте их в вашем коде, где это необходимо.

Список ниже должен дать вам грубый обзор доступных методов. Для получения подробной информации обратитесь к исходному коду и комментариям самого класса: SQLiteDB.php.

Всегда используйте предоставленные механизмы замены параметров при передаче пользовательских данных в запросы, чтобы избежать атак SQL-инъекций! См. метод query() method.

getPdo()

Этот метод возвращает базовый PDO object oсоединения. Вы можете использовать его для вызова всех методов, определенных интерфейсом PDO.

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

query()

Базовое выполнение запроса.

Заполнитель в запросе будет заменен данными заменами. Вы можете использовать позиционные ? или именованные : заполнители. Этот механизм тот же самый во всех других методах запроса ниже.

Этот метод возвращает объект PDOStatement Не забудьте закрыть его курсор, когда закончите. Обычно вы хотите использовать один из удобных методов ниже.

$res = $sqlite->query('SELECT foo FROM example WHERE baz = ?', [$baz]);
$row = $res->fetch();
$res->closeCursor();

exec()

Аналогично запросу, но используется для выполнения запросов на изменение данных. Возвращает последний идентификатор вставки в операторах INSERT или количество затронутых строк в противном случае.

$id = $sqlite->exec('INSERT INTO example (bar) VALUES (?)', [$bar]);
echo "new ID is $id";

queryAll()

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

$rows = $sqlite->queryAll('SELECT * FROM example WHERE bar = ?', [$bar]);
foreach($rows as $row) {
    foreach($row as $col => $val) {
        echo "$col: $val\n";
    }
    echo "------\n";
}

queryRecord()

Удобный метод выполнения запроса и возврата только одной строки.

$row = $sqlite->queryRecord('SELECT * FROM example WHERE bar = ?', [$bar]);
foreach($row as $col => $val) {
    echo "$col: $val\n";
}

saveRecord()

Удобный метод для вставки или замены одной записи в таблице. Функция ожидает ассоциативный массив для параметра $data, где ключи массива соответствуют именам столбцов.

Если предоставленные данные нарушают ограничение, они либо игнорируются, либо существующие данные заменяются.

Примечание: этот метод обеспечивает только функциональность INSERT OR IGNORE. Если вам нужна функциональность UPSERT, создайте свой запрос и используйте exec(). INSERT OR REPLACE

$data = [
    'foo' => 'Florb',
    'baz' => 12932
];
$new = $sqlite->saveRecord('example', $data);
var_dump($new);

queryValue()

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

$foo = $sqlite->queryValue('SELECT foo FROM example WHERE bar = ?', [$bar]);
echo $foo;

queryKeyValueList()

Удобный метод запроса списка ключей и значений из базы данных. Первое значение в каждой строке результата становится ключом, второе значение — значением. Вам нужно самостоятельно позаботиться об уникальности ключей, иначе более поздние значения перезапишут более ранние.

$res = $sqlite->queryKeyValueList('SELECT foo,baz FROM example WHERE bar = ?', [$bar]);
foreach($res as $key => $val) {
    echo "$key: $val\n";
}

Расширения SQL

SQLite имеет уникальную функцию, которая заключается в том, что PHP-код может быть зарегистрирован как собственные функции SQL, которые затем могут использоваться в ваших запросах. Плагин sqlite регистрирует несколько пользовательских функций, описанных ниже.

Подробную информацию смотрите в классе Functions:Functions.php.

Ваш плагин может регистрировать собственные функции с помощью getPDO()->sqliteCreateFunction() и getPDO()->sqliteCreateAggregate().

ПОЛУЧИТЬ УРОВЕНЬ ДОСТУПА

Возвращает целочисленный уровень разрешений «ДокуВики» для заданного идентификатора страницы.

Примечание: эта функция также вернет AUTH_NONE для скрытых страниц.

$sqlite->queryAll(
  'SELECT page, foo, bar FROM example WHERE GETACCESSLEVEL(page) > ?',
  [AUTH_READ]
);

СТРАНИЦА СУЩЕСТВУЕТ

Проверяет, существует ли заданное имя страницы. Возвращает 1 для существующих страниц, 0 в противном случае.

$sqlite->queryAll(
  'SELECT page, foo, bar FROM example WHERE PAGEEXISTS(page) = 1'
);

РЕГ. ВЫРАЖЕНИЕ

Сопоставляет значение с заданным регулярным выражением. Выражение используется с / разделителями и u модификатором Unicode.

$sqlite->queryAll(
  'SELECT page, foo, bar FROM example WHERE REGEXP("^wiki:.*", page)'
);

RESOLVEPAGE

Разрешает заданную относительную страницу по заданной контекстной странице.

$sqlite->queryAll(
  'SELECT RESOLVEPAGE(page, ?), foo, bar FROM example',
  [$context]
);

GROUP_CONCAT_DISTINCT

Это агрегатная функция, которая работает как встроенная функция GROUP_CONCAT Однако она гарантирует, что будут возвращены только уникальные значения.

Примечание: по возможности следует использовать собственный метод. К сожалению, собственный метод не поддерживает ключевое слово DISTINCT при использовании пользовательского разделителя. Только если другие варианты невозможны, используйте эту зарегистрированную функцию.

$sqlite->queryAll(
  'SELECT foo, GROUP_CONCAT_DISTINCT(bar,' ') FROM example GROUP BY foo',
  [$context]
);

События

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

PLUGIN_SQLITE_DATABASE_UPGRADE

Это событие запускается при применении любой новой миграции (см. выше). Это позволяет выполнять более сложные миграции, требующие больше, чем просто SQL.

Предоставленные данные выглядят следующим образом:

$data = [
    'database' => 'example', // the database name
    'from' => 5, // previous version
    'to' => 6, // version this migration migrates to
    'file' => /some/path/lib/plugin/example/db/update0006.sql, // the associated update file
    'sqlite' => [object] // deprecated instance of the old helper, do not use
    'adapter' => SQLiteDB // instance of the SQLiteDB class
];

При обработке этого события обязательно убедитесь, что вы обрабатываете только обновление своей собственной базы данных.

Вот пример для начала:

public function handle_migrations(Doku_Event $event, $param) {
    // replace example with name of your plugin
    if ($event->data['database'] !== 'example') {
        return;
    }
 
    // code to handle update to version 7
    if($data['to'] === 7) {
        $data['adapter']->exec('....');
        $event->result = true;
    }
}

Событие BEFORE выполняется до применения файла миграции. Действие по умолчанию — применить этот файл и увеличить dbversion поле в opts таблице.

Когда событие предотвращает значение по умолчанию, $event→result необходимо установить значение! Если результат истинный, dbversion увеличивается и запускаются любые дополнительные миграции. Если результат ложный, процесс миграции прерывается.

Событие BEFORE может опционально изменить file атрибут данных для загрузки другого файла.

Событие AFTER срабатывает только после применения файла миграции или после того, BEFORE как событие установило истинный результат. В то AFTER время dbversion уже был увеличен.

Код, связанный с этим событием, используемый в любых файлах плагинов и шаблонов

PLUGIN_SQLITE_QUERY_SAVE

Это событие срабатывает при сохранении запроса в интерфейсе администратора.

Вы можете предотвратить сохранение в событии BEFORE или изменить имя или запрос.

$event->data = [
    'sqlitedb' => SQLiteDB, // an instance of the SQLiteDB class for access to the ''sqlite'' database.
    'upstream' => 'example', // the name of the selected database, for which the query is stored
    'name' => &$name, // The name the user picked for this query
    'query' => &$query, // The SQL for this query
]

Код, связанный с этим событием, используемый в любых файлах плагинов и шаблонов

PLUGIN_SQLITE_QUERY_DELETE

Это событие срабатывает при удалении запроса в интерфейсе администратора.

Вы можете предотвратить удаление в событии BEFORE или изменить имя (это приведет к удалению другого запроса).

$event->data = [
    'sqlitedb' => SQLiteDB, // an instance of the SQLiteDB class for access to the ''sqlite'' database.
    'upstream' => 'example', // the name of the selected database, for which the query is stored
    'name' => &$name, // The name the user picked for this query
]

Код, связанный с этим событием, используемый в любых файлах плагинов и шаблонов

Журнал медленных запросов

Если включено ведение журнала отладки (см. параметр dontlog запросы, которые занимают больше 0,2 секунд, будут регистрироваться как медленные. Используйте это для оптимизации и отладки ваших запросов.

Изменения по сравнению с предыдущими версиями

В июле 2023 года была выпущена полностью переработанная версия, которая ввела SQLiteDB класс в пользу helper_plugin_sqlite. Последний по-прежнему предоставляется и внутренне использует SQLiteDB класс. Это означает, что новый плагин должен быть полностью обратно совместим со старыми плагинами.

Обсуждения в соответствующем Pull Request могут оказаться поучительными.

Однако некоторые мелочи могут работать немного по-другому. Самое важное, что ранее зарегистрированный метод GROUP_CONCAT был переименован в GROUP_CONCAT_DISTINCT. Пожалуйста, ознакомьтесь с егодокументацией выше и при необходимости настройте свой плагин.

Разработчикам плагинов рекомендуется обновить свои плагины, чтобы использовать новый, более чистый интерфейс SQLiteDB. Помощник теперь устарел.

Дополнения и Файлы

Плагин sqlite

statistics

anonymous@undisclosed.example.com (Anonymous) — Sun, 17 Mar 2024 16:50:23 +0000

BackupTool для «ДокуВики»

Этот плагин обеспечивает ведение журнала и статистику просмотров и посетителей вашей вики. Статистика представляет собой смесь вики-статистики (например, количества правок) и типичной веб-статистики (просмотров, посетителей). Он должен быть наиболее полезен для людей, использующих «ДокуВики» в качестве своего блога или домашней страницы, но также предоставляет полезную статистику для внутреннего использования.

Релиз: 2024-01-30.
Репозиторий:https://github.com/splitbrain/dokuwiki-plugin-statistics.
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Этому плагину нужна база данных MySQL. Вам нужен как минимум MySQL 4.1, рекомендуется MySQL 5.0 или выше.

В настоящее время регистрируются только пользователи с включенным JavaScript.
- это можно легко исправить, поместив в шаблон код <noscript>, мне просто нужно это изучить.
- после исправления можно будет добавить статистику о поисковых ботах
синтаксический анализ поискового слова немного ненадежен («не делайте» — это два слова)

Монтаж

Установите плагин через Менеджер расширений или вручную.
Создайте базу данных MySQL (см. ниже). Без этого вы не сможете сделать следующий шаг.
Создайте необходимые таблицы MySQL с помощью предоставленного db.sql файла .
Настройте доступ к базе данных через диспетчер конфигурации.

Создание БД

В оболочке выполните следующие команды:

# mysql -u root -p
MariaDB [(none)]> CREATE DATABASE stats;
MariaDB [(none)]> \q

Чтобы создать необходимые таблицы MySQL, вы можете

либо используйте phpmyadmin
- Создайте базу данных stats, которую будет использовать ваша «ДокуВики».

используйте функцию импорта phpmyadmin
- Выберите базу данных stats, которая используется вашей «ДокуВики», и выберите «Импорт» в верхнем меню, затем загрузите файл.
импортируйте вручную, используя MySQL в вашей оболочке

# mysql -u db_user -p your_dokuwiki_database < /full/path/to/db.sql

Применение

На данный момент предоставлена следующая статистика:

Панель приборов
- общая статистика, такая как отказы, вернувшиеся посетители, средняя длина сеанса
Популярные страницы
- самые просматриваемые страницы
Входящие ссылки
- лучшие рефереры
Новые входящие ссылки
- лучшие рефереры, которых не видели до выбранного периода времени
Исходящие ссылки
- самые кликабельные исходящие ссылки
Поисковые системы
- наиболее часто используемые поисковые системы для поиска вашей вики
Внешние поисковые фразы
- самые популярные поисковые фразы, которые люди используют в поисковых системах, чтобы найти вашу вики
Внешние поисковые слова
- самые популярные ключевые слова, которые люди используют в поисковых системах, чтобы найти вашу вики
Внутренние поисковые фразы
- самые популярные поисковые фразы, которые люди использовали в вашем интегрированном поиске по вики
Внутренние поисковые слова
- самые популярные ключевые слова, которые люди использовали в вашем интегрированном поиске в вики
Браузеры
- наиболее часто используемые браузеры для просмотра вашей вики
Операционные системы
- наиболее часто используемые операционные системы, используемые вашими посетителями
Страны
- откуда пришли ваши посетители за выбранный период времени
Размер экрана
- размер экрана ваших посетителей
Разрешение
- разрешение экрана, используемое вашими посетителями
Почти для всех этих статистических данных также предоставляются графические диаграммы.

Обновление

Обновления, скорее всего, потребуют обновления базы данных. Рекомендую сделать их перед обновлением плагина.

Посмотрите текущий db.sql.
Найдите в этом файле строки, начинающиеся с – UPGRADE
Найдите первую такую строку, содержащую дату, более позднюю, чем версия вашего плагина.
Скопируйте все следующие строки и примените их к существующей базе данных.

Обратите внимание, что в зависимости от объема данных в вашей базе данных эти обновления могут занять очень много времени. Я предлагаю запускать эти обновления через командную строку вместо использования веб-инструмента, такого как PHPMyAdmin.

Файл для загрузки

stepbystep

anonymous@undisclosed.example.com (Anonymous) — Mon, 28 Aug 2023 10:40:21 +0000

StepByStep для «ДокуВики»

Релиз: 2023-08-25.
Репозиторий:https://github.com/saggi-dw/dokuwiki-plugin-stepbystep/
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Параметр конфигурации: для параметра defer_js должно быть установлено значение true!

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Простое поле с заголовком создается следующим образом:

#: Название скрытого контента.
Здесь находится скрытый контент
:#

Здесь находится скрытый контент

На изображении показано следующее:

#: Шаг 1
Если вы это уже знаете, вы также можете продолжить с [[#шага 3]].

еще текст...
:#

#: Шаг 2
Еще больше текста...
:#

#: Шаг 3 ||open

Наконец, сделали :-)
:#

Если вы это уже знаете, вы также можете продолжить с шага 3.

еще текст…

Еще больше текста…

Наконец, сделали

Конфигурация и настройки

Имеется два начальных ( ''#:'', ''##:'') и два закрывающих ( '':#'', '':##'') тега. Полноценная коробочка создается по следующей схеме:

Начало: #: title[ ||options]/n
Содержание:content
Конец::# /n

Это title необязательно, но без заголовка оно не имеет смысла. Здесь разметка «ДокуВики» не анализируется. Каждый заголовок становится якорем блока в соответствии с соглашениями об именах «ДокуВики». Недопустимые символы заменяются на _. Это также относится к :. Это позволяет (например, в инструкциях) пропускать шаги, указав соответствующий целевой шаг в ссылке (например: [[#step_3|step 3]] ссылка на поле с заголовком Step 3 на той же странице).

Теги должны располагаться отдельно в одной строке.

Это content также необязательно. Но и без контента работать бессмысленно. Понимает content разметку DokuWiki.

Options возможны в начальном теге. Они отделены от заголовка двойной чертой (||). Каждая отдельная опция должна быть отделена от следующей пробелом. На данный момент поддерживаются следующие опции:

Value	Description	Example
open	развернуть поле по умолчанию	''#: Step 1\|\|open''
preview:`xxx`	расширить часть поля до указанной высоты, где `xxx` указана длина CSS	''#: Step 1\|\|preview:5em''

Возможна вложенность уровней, ~~но только если теги используются поочередно.~~.

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

#: Это история о...
...здесь можно писать много
о содержании

Lorem ipsum dolor сидеть amet...

##: Следующий раздел содержит спойлеры...
Duis autem vel eum iriure...
:##

Ut wisi enim ad minim veniam, ...
:#

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

#: Джордж Оруэлл: 1984 (подробнее) ||open

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

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

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

Lorem ipsum dolor сидеть amet…

Duis autem vel eum iriure…

Ut wisi enim ad minim veniam, …

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

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

Дополнительных настроек нет.

Используются следующие цвета, которые зависят от выбранного стиля:

Элемент	Цвет в стиле	style.ini
Фон заголовка окна	Нейтральный цвет фона	@ini_background_neu
Заголовок коробки прочитал/открылся	Общий цвет ссылки	@ini_link
Фон коробки	Основной цвет фона	@ini_background
Граница коробки	Общий цвет ссылки	@ini_link
Текст	Основной цвет текста	@ini_text

Эти цвета легко меняются. Входящий в комплект плагин стилизации, доступный через «Администратор» → «Настройка стиля шаблона», позволяет легко вносить изменения. Альтернативно можно напрямую редактировать файл style.ini

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

saggi-dw-dokuwiki-plugin-stepbystep-2c9f467.zip

Лицензия

Author: saggi
License: GNU GPL v2

tablelayout

anonymous@undisclosed.example.com (Anonymous) — Tue, 22 Aug 2023 21:26:48 +0000

Tablelayout для «ДокуВики»

Релиз: 2022-03-28.
Репозиторий:https://www.dokuwiki.org/plugin:tablelayout
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

Чтобы это работало с Internet Explorer, требуется функция polyfill для javascripts repeat() Самый простой известный мне способ — добавить в файл содержимое этой страницы в файл conf/userscript.js (создайте файл, если он не существует).

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Следующий пример синтаксиса сделает первую фиксированной и покажет около 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

Синтаксис

Основной шаблон это . Параметры указываются так же, как параметры URL : {{tablelayout?options}}.

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

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

Фиксированные строки заголовка

Вы должны указать два параметра rowsHeaderSource и rowsVisible. Первый ожидает положительное целое число, указывающее количество строк, которые фиксируются вверху. rowsVisible задает количество строк, видимых под фиксированными строками.

rowsHeaderSource можно установить на Auto.

Плавающий

Опция float принимает одно из трех возможных значений: left, right, center. left и right пусть таблица перемещается влево или вправо, centerцентрирует таблицу на странице.

Поиск

При настройке tableSearch=1 поля будут добавляться над каждым столбцом и по одному на всю таблицу.

Сортировка

При настройке tableSort=1 кнопки сортировки будут добавлены для каждого столбца.

Печать

При настройке tablePrint=1 кнопки печати добавляется под таблицу, которая открывает только таблицу в новом окне и запускает диалоговое окно печати браузера.

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

tablelayout.zip

Лицензия

Author: Michael Große
License: GNU GPL v2

test

anonymous@undisclosed.example.com (Anonymous) — Tue, 14 Jan 2025 20:18:52 +0000

data Plugin

Совместим с «Докувики»

2024-02-06 "Kaos" да
2023-04-04 "Jack Jackrum" да
2022-07-31 "Igor" неизвестно
2020-07-29 "Hogfather" да

A and query structured data in your wiki

Последнее обновление:: 2024-01-30
Предоставляет: Syntax, Helper, Action
Репозиторий: исходный код
Конфликтует с: fckg
Требует: sqlite

Это расширение не находится в пространстве имен 'plugin' или 'template' и поэтому игнорируется.

Похож на fields, pagemod, strata, struct

Теги: data, database, listing, sqlite, tables, tags

- Andreas Gohr

This plugin allows you to add structured data to any DokuWiki page. Think about this data as additional named attributes. Those attributes can then be queried and aggregated. The plugin is similar to what was done here for the repository plugin but its internals are very different to it.

You might want to consider using the spiritual successor to this plugin: struct Plugin

Download and Installation

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

Changes

Merge pull request #250 from dokuwiki-translate/lang_update_1176_1753… (2025/10/17 12:36)
translation update (2025/07/22 15:25)
Version upped (2024/02/02 01:50)
Merge pull request #240 from annda/gh-tests (2024/02/01 11:48)
Manual code style fixes (2024/01/31 11:39)
Update test workflow (2024/01/30 11:30)
Semi-automatic code style fixes (2024/01/30 11:30)
Version upped (2023/07/20 00:50)

Updating from versions prior to 2013-02-06

Be sure to update the sqlite plugin and follow its instructions on sqlite version upgrades.

Updating from versions prior to 2010-03-22

Since 2010-03-22, the data plugin uses the sqlite helper plugin. Therefore, the database file location and structure changed. If you want to keep your old database, you have to perform the following steps prior to upgrading the data plugin:

Install the sqlite plugin
Move the file data/cache/dataplugin.sqlite to data/meta/data.sqlite

Perform the following SQL statements on the database (for example using the sqlite plugin’s admin page)

CREATE TABLE opts (opt,val);
CREATE UNIQUE INDEX idx_opt ON opts(opt);
INSERT INTO opts VALUES ('dbversion', 1);

Upgrade the data plugin

If you upgraded the data plugin before these steps, a blank data.sqlite has been created and you have to copy the data/cache/dataplugin.sqlite over the existing data/meta/data.sqlite.

Plugin Syntax

This plugin depends on multiple parts, each having a similar syntax. The syntax defines a block with various key/value pairs configuring the behaviour of the plugin part. The following parts are available:

Part	Function
Data Entry	Input
Data Table	Output
Data List	Output
Related Pages	Output
Tag Cloud	Control

Data Entry (Input)

This part is used to add structured data to a page. All data entered here is tied to the page. So you can use it only once on a page¹⁰⁾. Let's start with an example:

¹⁰⁾

any additional dataentry on the same page would overwrite any preceding dataentry on this page and so - while many dataentry blocks on one page may be displayed - only the values of the last one would be stored in the SQLite database and could be retrieved as an output by e.g. a datatable

test2

anonymous@undisclosed.example.com (Anonymous) — Tue, 14 Jan 2025 19:03:04 +0000

Plugins

Plugins provide a system of extending DokuWiki's features without the need to hack the original code (and so again on each update). Below is a list of ready to use plugins created by DokuWiki users.

A Plugin is installed by putting it into its own folder beyond lib/plugins/. For many plugins this can be done automatically using the plugin manager (there are detailed plugin installation instructions). Be sure to read about Plugin Security.

You can also find recommended groups of plugins as solutions to common DokuWiki applications. There are also a list of very common plugins.

Фильтровать по типу

Syntax-плагины расширяют базовый синтаксис «Докувики».
Action-плагины заменяют или расширяют основную функциональность «Докувики».
Admin-плагины предоставляют дополнительные инструменты администрирования.
Helper-плагины обеспечивают работу других плагинов.
Render-плагины добавляют новые режимы экспорта или заменяют стандартные средства визуализации XHTML.
Remote плагины добавляют методы в RemoteAPI, доступные через веб-сервисы
Auth-плагины добавляют модули аутентификации.
CLI плагины добавляют команды для использования в интерфейсе командной строки

Фильтровать по тегу

Все доступные (16)

Автор	Последнее обновление	Популярность
Плагин диспетчера конфигураций Управляйте настройками конфигурации вашей вики (в комплекте с DokuWiki) Предоставляет: Admin Теги: !bundled, configuration, options, settings Автор: Christopher Smith	в комплекте

Совместим с «Докувики»^? **2024-02-06 "Kaos"**
Плагин CosmoCode Скачать Доступ к сервисам DokuWiki, предоставляемым CosmoCode Предоставляет: Admin Теги: Автор: Andreas Gohr	2024-11-14	0/1
Плагин DocNavigation Скачать Добавьте навигационные ссылки на предыдущую и следующую страницу вверху и внизу вики-страницы. Предоставляет: Syntax, Action Теги: browse, listing, navigation Автор: Gerrit Uitslag	2024-02-08	0/1
Include Plugin Скачать Include another wiki page into the current one Предоставляет: Syntax, Helper Теги: embed, include Автор: Dokufreaks (previous authors: Michael Hamann, Gina Häußge, Michael Klier, Esther Brunner)	2023-09-22	0/1
JSON Data Plugin Скачать Build JSON database inside DokuWiki page and use the data in the page Предоставляет: Syntax, Helper, Action, Remote Теги: data, database, json, listing, tables, template, xmlrpc Автор: Janez Paternoster	2024-03-11	0/1
Log Statistics Plugin Скачать Этот плагин предоставляет файл журнала (комбинированный с NCSA, например Apache) всех доступов к страницам DokuWiki. Предоставляет: Action Теги: logging, statistics Автор: Andreas Gohr	2016-07-06	0/1
Плагин MyIcon Скачать Встроить иконки в DokuWiki Предоставляет: Syntax, Action Теги: flag, font-awesome, font-linux, fugue, glyphicon, icons, mdi, oxygen, rpg-awesome, silk Автор: VladPolskiy	2024-10-30	0/1
Note для «ДокуВики» Скачать Этот плагин позволяет вам создавать на страницах DokuWiki такие красивые «заметки» Предоставляет: Syntax Теги: boxes, icons, toolbar Автор: Anael Mobilia	2024-04-15	0/1
Плагин рейтинга Скачать Позволяет оценить страницу Предоставляет: Syntax, Action Теги: poll, rate, rating, vote Автор: Andreas Gohr	2016-01-13	0/1
Плагин репозитория расширений Скачать управляет расширениями (плагинами и шаблонами) на dokuwiki.org, и предоставляет API для менеджера расширений Предоставляет: Syntax, Helper, Action Теги: data, database, extension, listing, repo, repository, sqlite, tables, tags Автор: Andreas Gohr/Håkan Sandell	2010-01-30	0/1
Плагин sqlite Скачать Вспомогательный плагин для легкого доступа к базе данных SQLite. Предоставляет: Helper Теги: database, sqlite Автор: Andreas Gohr	2024-06-25	0/1
data Plugin Скачать A and query structured data in your wiki Предоставляет: Syntax, Helper, Action Теги: data, database, listing, sqlite, tables, tags Автор: Andreas Gohr	2024-01-30	0/1

Совместим с «Докувики»^? **2023-04-04 "Jack Jackrum"**
Плагин linksuggest Скачать Автопредложение ссылок в текстовом редакторе Предоставляет: Action Теги: autocomplete, links Автор: lisps	2023-10-07	0/1

Совместим с «Докувики»^? **2022-07-31 "Igor"**
Statdisplay Plugin Скачать Отображает различные статистические данные и столбчатые диаграммы, рассчитанные с использованием файла журнала всех доступов к страницам DokuWiki. Предоставляет: Syntax, CLI Теги: chart, statistics Автор: Andreas Gohr	2022-12-12	0/1

Совместим с «Докувики»^? **2020-07-29 "Hogfather"**
Плагин Box Скачать Выделение секций информации с помощью блоков с настраиваемым стилем Предоставляет: Syntax Теги: boxes, style Автор: Christopher Smith	2016-02-17	0/1

Совместимость с предыдущими версиями «Докувики»
Actionlink plugin Скачать This plugin lets you use actionlinks in your wiki syntax. It's based on the DokuWiki's core function tpl_actionlink(). Предоставляет: Syntax Теги: links Автор: nowotny		0/1

Popularity values are based on data gathered through the popularity plugin - please help to increase accuracy by reporting your data with this plugin.

Creating Plugins

There are several plugin types which interchange with different parts of DokuWiki. A plugin can consist of multiple types. The links below should help you to get started writing your own DokuWiki plugin.

Syntax Plugins ( Manual )
Admin Plugins ( Manual )
Action Plugins ( Manual )
Renderer Plugins ( Manual )
Helper Plugins ( Manual )

If you created a plugin, please share it with the community. Just create a page named after your plugin in the plugin namespace. Eg. if your pluginfolder is named sample create a page plugin:sample here in the wiki. Note: uploads are not allowed here, so either paste the code or just use one of the many free file host sites on the net.

Requesting Plugin

If you are in need of a special feature in DokuWiki but haven't the skills or resources to create your own plugin you might want to suggest the feature for consideration by the community.

To ask for the creation of a new plugin or to discuss plugin ideas, please refer to the Plugin Wishlist Forum.

Recent Wishes:

title_plugen

anonymous@undisclosed.example.com (Anonymous) — Fri, 18 Aug 2023 13:26:08 +0000

BackupTool для «ДокуВики»
Резервное копирование вашего сайта и данных конфигурации в файл.

Citations для «ДокуВики»
Cоздает цитаты разных форматов для ваших вики-страниц.

Copy2clipboard для «ДокуВики»
Добавьте кнопку буфера обмена в блоки <code> и <file>, которая копирует текст в буфер обмена.

Details Tag для «ДокуВики»
Используйте теги HTML <details> и <summary> для скрытия информации на странице, которое можно сделать видимым, щелкнув текст сводки.

Diagram для «ДокуВики»
Построение схем и генеалогических деревьев, состоящих из блоков и линий соединения. Плагин расширяет синтаксис «Докувики» и позволяет строить диаграммы.

Discussion для «ДокуВики»
Плагин обсуждения добавляет раздел обсуждения после вашей вики-страницы для комментариев пользователей.

Display Wiki Page для «ДокуВики»
Плагин, который определяет дополнительную функцию шаблона, позволяющую отображать более одной вики-страницы одновременно в любом заданном документе.

[wiki:plugin:edittable

Htmlok для «ДокуВики»
Позволяет встраивать HTML и PHP в вики-страницы.

Smtp для «ДокуВики»
Настройте SMTP-сервер (с дополнительной аутентификацией) для отправки почты из «ДокуВики».

Tablelayout для «ДокуВики»
Установка ширины столбцов таблицы, закрепление строк заголовков, плавание таблицы.

Wrap для «ДокуВики»
Оберните вики-текст внутри контейнеров (divs или spans) и задайте им класс (выберите из множества предустановленных классов), ширину и/или язык с соответствующим направлением текста.

typography

anonymous@undisclosed.example.com (Anonymous) — Sat, 18 Jan 2025 23:47:50 +0000

Typography для «ДокуВики»

Обширные возможности стилизации текста с помощью таких CSS-правил, как тип шрифта, размер, толщина и цвет текста.

Релиз: 2020-07-31.
Репозиторий:https://github.com/ssahara/dw-plugin-typography
Совместимость с «Докувики»: 2024-02-06 «Kaos»

Совместимость

2024-02-06 «Kaos» да
2023-04-04 «Jack Jackrum» да
2022-07-31 «Igor» да
2020-07-29 «Hogfather» да

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Примеры/Использование

Меню плагина Возможности плагина

Синтаксис

<ff Arial>Arial</ff>\\  
<ff TimesNewRoman>Times New Roman</ff>\\  
<ff Impact>Impact</ff>\\  
<ff BrushScriptMS>Brush Script MS</ff>\\  
<ff Georgia>Georgia</ff>\\  
<ff Tangerine; fs:30px>Tangerin</ff>\\  
<ff Calligraph; fs:30px>Шрифт Calligraph</ff>\\  
<ff DS Yermak_D; fs:20px>Шрифт DS Yermak_D</ff>\\  
<ff CyrillicGoth; fs:20px>Шрифт CyrillicGoth</ff>\\  
<ff Tangerine; fs:48px>Dokuwiki's Main Configuration File Tangerine 48px</ff>\\  
\\   
<ff : Georgia; MS Serif; serif><fs:36px; lh:1.1>There is nothing either good or bad,\\  
but thinking makes it so. </fs>\\  
<fs:smaller;>//-- William Shakespeare, “Hamlet”, Act 2 scene 2//</fs></ff>

Arial
Times New Roman
Impact
Brush Script MS
Georgia
Tangerin
Шрифт Calligraph
Шрифт DS Yermak_D
Шрифт CyrillicGoth
Dokuwiki's Main Configuration File Tangerine 48px

There is nothing either good or bad,
but thinking makes it so.
– William Shakespeare, “Hamlet”, Act 2 scene 2

Функции

Плагин Typography расширяет разметку «ДокуВики» за счет возможностей набора текста. Парный тег разметки включает в себя в качестве параметров CSS-правила, такие как тип шрифта, размер, толщина и цвет текста. Аналогично CSS-синтаксису параметры состоят из пар «свойство:значение», отделяемых друг от друга точкой с запятой (;), однако последняя в списке может быть опущена. Между тегом и его параметрами ставится один пробел, после точки с запятой также можно в эстетических целях добавлять пробел. Вместо полного имени свойства можно использовать сокращённое. Значения поддерживают любые CSS-единицы, включая словарные (px, em, %, x-small и пр.)

Некоторые сокращения сами доступны как парные теги, например, <ff> (тип шрифта), <fs> (размер), <fc> (цвет), <bg> (цвет фона), <fw> (толщина). В качестве разделителя можно использовать как двоеточие, так и пробел. За счёт полного совпадения функционала и синтаксиса плагин Typography свободно, без правок статей может заменить плагины FontFamily, FontSize2 и FontColor.

Короткое имя	CSS-cвойство	Описание
`fc`	color	цвет шрифта
`bg`	background-color	цвет фона шрифта
`fs`	font-size	размер шрифта
`fw`	font-weight	толщина шрифта (толстые или тонкие символы в тексте)
`fv`	font-variant	капитель (уменьшенные прописные буквы)
`ff`	font-family	семейство шрифтов (если содержит пробелы и символы, отличные от ASCII - должно быть заключено в одинарные кавычки)
`lh`	line-height	пространство между строками (интерлиньяж)
`ls`	letter-spacing	пространство между символами (апрош или интерлеттраж)
`ws`	word-spacing	пространство между словами (спейс)
`sp`	white-space	указывает, как обрабатывается пробел (сохранить или свернуть)
`va`	vertical-align	вертикальное выравнивание
-	text-transform	режим заглавных букв в тексте (заглавные, прописные или строчные)
-	text-shadow	тень у текста
`wf`	(web-font)	класс веб-шрифта (с префиксом «wf-»)

Иногда встроенные стили необходимы, когда вы создаете страницу вручную. Однако вам следует по возможности избегать их для «семантической разметки», улучшения ремонтопригодности и возможности повторного использования. Плагин wrap предоставляет наиболее мощный и гибкий метод для определения атрибута класса.

Использование короткого синтаксиса с меню панели инструментов

Плагин Typography предоставляет синтаксис короткого имени (или отдельного свойства), который совместим с fontfamily, fontcolor и fontsize2. Если вы включили эти три плагина, короткий синтаксис обрабатывается соответствующими плагинами, а не этим плагином. Этот короткий синтаксис доступен через значки панели инструментов: . Пример одного параметра:

<typo font-size:large;>Large</typo>, 
<typo fs:x-large>Very large</typo>, 
<fs:xx-large>Huge</fs>, and 
<fs smaller>smaller</fs> size text

Пример с несколькими параметрами:

<typo fs:larger; fw:bold; ff:serif>Bold serif</typo>, 
<fs:large; fv:small-caps>Small-caps</fs> text

Синтаксис вложенности:

<ff:'Georgia', 'MS Serif', serif><fs:36px; lh:1.1>
There is nothing either good or bad, \\ but thinking makes it so.
</fs>\\
<fs:smaller;>//-- William Shakespeare, “Hamlet”, Act 2 scene 2//</fs></ff>

Использование веб-шрифта

Для начала работы с Google Fonts API, вы можете добавить ссылку на таблицу стилей для запроса желаемого веб-шрифта(ов) в файле conf/meta.html, например:

conf/meta.html

<link rel="stylesheet"
      href="https://fonts.googleapis.com/css?family=Tangerine">
<style>
.wf-tangerine { font-family: Tangerine, serif; }
</style>

Затем вы можете использовать имя шрифта (например, Tangerine) в значении font-family:

<ff Tangerine; fs:48px>Making the Web Beautiful!</ff>
<wf:tangerine; fs:48px>Making the Web Beautiful!</wf>

Tangerine 48px Making the Web Beautiful!

Поддержка рендерера

Начиная с выпуска 2014-10-13 этот плагин также поддерживает экспорт в текстовый формат открытого документа ODT. Слева вы видите снимок экрана, сделанный с тестовой страницы типографики, открытой в браузере, с правой стороны вы видите страницу, экспортированную в ODT:

Как видите, в настоящее время существуют некоторые ограничения на экспорт ODT:

~~изменение размера текста в настоящее время не поддерживается~~ Изменение размера текста поддерживается с выпуска 2015-04-02.
после закрытия тега типографики высотой строки начинается новый абзац. ODT поддерживает только установку высоты строки для каждого абзаца. Средство визуализации XHTML остается в той же строке после закрытия тега.
межсловный интервал не поддерживается форматом ODT
параметры пробела в настоящее время не поддерживаются

Примечание. Для функции экспорта ODT плагина типографики требуется PHP 5 >= 5.3.0.

Правки плагина

Добавлена регистрация обработчика события fontname

action.php

	    /* Добавлена регистрация обработчика события fontname*/
        if (plugin_isdisabled('fontname')) {
            $controller->register_hook('TOOLBAR_DEFINE', 'AFTER', $this, 'fontNameToolbar', array());
        }

Раскоментированы семейства шрифтов sans-serif и cursive и добавлены fantasy и monospace

action.php

			/*Раскоментированы семейства шрифтов sans-serif и cursive*/
            'sans-serif'  => 'sans-serif',
            'cursive'     => 'cursive',
			/*Добавлены семейства шрифтов fantasy и monospace*/
            'fantasy'     => 'fantasy',
			'monospace'   => 'monospace',

Добавлена кнопка FontName (примеры шрифтов) на панель инструментов.

action.php

    /**
     * Adds FontName toolbar button
	 * Добавляет кнопку FontName на панель инструментов.
     * @see https://www.dokuwiki.org/plugin:
     */
    public function fontNameToolbar(Doku_Event $event, $param)
    {
        $options = array(
		    'Arial'                 => 'Arial',
		    'Calligraph'            => 'Calligraph',		    
			'DS Yermak_D'           => 'DS Yermak_D',			
		    'CyrillicGoth'          => 'CyrillicGoth',			
            'Times New Roman'       => 'TimesNewRoman',
            'Impact'                => 'Impact',
            'Brush Script MS'       => 'BrushScriptMS',
            'Georgia'               => 'Georgia',
			'Tangerine'             => 'Tangerine',
			'Tangerine 48px'        => 'Tangerine; fs:48px',
            'Multiple options'      => ': Georgia; MS Serif; serif; fs:36px; lh:1.1',
			'Nesting syntax'        => ': Georgia; MS Serif; serif><fs:36px; lh:1.1>There is nothing either good or bad, but thinking makes it so. </fs><fs:smaller;>//-- William Shakespeare, “Hamlet”, Act 2 scene 2//</fs',
 
        );
        $button = array(
                'type' => 'picker',
                'title' => $this->getLang('fn_picker'),
                'icon' => DOKU_REL.'lib/plugins/typography/images/fontname/picker.png',
                'list' => array()
        );
        foreach ($options as $familyName => $familyValue) {
            $button['list'][] = array(
                'type'  => 'format',
                'title'  => $this->getLang('fn_'.$familyName),
                'sample' => $this->getLang('fn_'.$familyName.'_sample'),
                'icon'   => DOKU_REL.'lib/plugins/typography/images/fontname/'.$familyName.'.png',
                'open'   => '<ff '.$familyValue.'>',
                'close'  => '</ff>',
            );
        }
        $event->data[] = $button;
 
 
 
    }

файл fontcolor.php

Удалено условие для корректного отображения цветов текста

//if ($isSameHost && $isColorSet) {
// }

fontcolor.php

<?php
/**
 * DokuWiki Plugin Typography; Syntax typography fontcolor
 *
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     Satoshi Sahara <sahara.satoshi@gmail.com>
 *
 * provide fontcolor plugin syntax compatibility
 * @see also https://www.dokuwiki.org/plugin:fontcolor
 */
 
require_once(dirname(__FILE__).'/base.php');
 
class syntax_plugin_typography_fontcolor extends syntax_plugin_typography_base
{
    /**
     * Connect pattern to lexer
     */
    public function preConnect()
    {
        // drop 'syntax_' from class name
        $this->mode = substr(get_class($this), 7);
 
        // syntax pattern
        $this->pattern[1] = '<fc\b.*?>(?=.*?</fc>)';
        $this->pattern[4] = '</fc>';
    }
 
    public function connectTo($mode)
    {
        if (plugin_isdisabled('fontcolor')) {
            $this->Lexer->addEntryPattern($this->pattern[1], $mode, $this->mode);
        }
    }
 
    public function postConnect()
    {
        if (plugin_isdisabled('fontcolor')) {
            $this->Lexer->addExitPattern($this->pattern[4], $this->mode);
        }
    }
 
}

Заменины и добавлены новые иконки

Обновление

Для обновления удалите исходную папку lib/plugins/typography и установите новую версию, как указано выше.

Файл для загрузки

typography.zip

Лицензия

Author: Pawel Piekarski, Satoshi Sahara
Edit: VladPolskiy
License: GNU GPL v2

Ссылка на оригинальную статью

wrap

anonymous@undisclosed.example.com (Anonymous) — Sat, 01 Feb 2025 07:00:06 +0000

Wrap для «ДокуВики»

определенный класс (с множеством полезных предустановленных классов) ширина язык с соответствующим направлением текста Он потенциально заменяет множество других плагинов и, ИМХО, является лучшей альтернативой для многих.

Он полностью заменяет: class, clearfloat, div_span_shorthand, divalign2, divalign, emphasis, hide, important_paragraf, importanttext, lang, ltr, noprint, pagebreak, side_note, tip, wpre

Частично заменяет: box, button, color, columns, fontcolor, fontfamily, fontsize2, fontsize, highlight, layout, note, styler, tab, tablewidth, typography

Релиз: 2022-08-10.
Репозиторий:https://github.com/selfthinker/dokuwiki_plugin_wrap
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Совместимость

WRAP экспортируются в формат ODT, но не все работает на 100%
Скругленные углы работают только в современных браузерах (без IE8 и ниже).
Несколько столбцов работают только в современных браузерах (без IE9 и ниже).
Классы ширины являются экспериментальными и работают только в современных браузерах (без IE8 и ниже).
Обычные заголовки «ДокуВики» раньше не работали, поэтому был добавлен обходной путь. Теперь, когда заголовки работают, обходной путь больше не нужен, но сохранен для обратной совместимости. Он устарел в версии 2018-04-22 и отключен по умолчанию. Их можно включить с помощью emulatedHeadlines параметра конфигурации. . Следующий синтаксис будет создавать два разных типа эмулируемых заголовков внутри любой обертки:
- //**__Большой подчеркнутый заголовок__**// (В примечаниях по технике безопасности они будут выглядеть немного иначе.)
- //**Малый заголовок**//
не включайте ~~DISCUSSION~~ в блок WRAP noprint

Монтаж

Используйте менеджер плагинов для установки или…

скачать zip-файл
распаковать его в<dokuwiki>/lib/plugins/
войдите как администратор и измените плагин в менеджере конфигурации

Применение

Синтаксис

Основной синтаксис:

<WRAP classes #id width :language>
"big" content
</WRAP>

**or**
<block classes #id width :language>
"big" content
</block>

or
<div classes #id width :language>
"big" content
</div>

<WRAP> в верхнем регистре (или, альтернативно, <block> или <div>) создает div и должен использоваться для «больших» контейнеров, окружающих абзацы, списки, таблицы и т. д.

<wrap classes #id width :language>"small" content</wrap>

или
<inline classes #id width :language>"small" content</inline>

или
<span classes #id width :language>"small" content</span>

<wrap> в нижнем регистре (или альтернативно <inline> or <span>) создает span и должен использоваться для «маленьких» контейнеров, внутри абзацев, списков, таблиц и т. д.

Начиная с версии 2013-06-13 также используется сокращенный синтаксис (для оберток без содержимого):

<WRAP classes #id /> или <block classes #id /> или <div classes #id />

<wrap classes #id /> или <inline classes #id /> или <span classes #id />

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

Примеры

Плагин поставляется с примером страницы, которая должна многое объяснить и выглядит так в шаблоне по умолчанию (см. ниже).

колонки

колонка 2

выделить (маркер)

пометить неважным

простой центрированный блок

Классы

На данный момент доступны следующие классы:

имя класса	описание/примечания
columns – аналогично columns, side_note, styler, tip
`column`	так же, как `left` в языках LTR и так же, как `right` в языках с письмом справа налево
`left`	то же, что и `column`, позволит вам разместить контейнер слева
`right`	позволит контейнеру плавать правильно
`center`	расположит контейнер в горизонтальном центре страницы
`col2`..`col5`	будет показывать текст в нескольких столбцах в зависимости от их количества (2, 3, 4 или 5), работает только в современных браузерах (без IE9 и ниже)
`colsmall`, `colmedium`, `collarge`	также будет отображаться текст в нескольких столбцах, но в зависимости от их ширины (маленький, средний или большой), работает только в современных браузерах (без IE9 и ниже)
ширина — экспериментальная , может работать не так, как ожидалось, включает поддержку мобильных устройств
`half`	подходит для двух столбцов подряд, следует использовать парами
`third`	подходит для трех или двух столбцов подряд, следует использовать в тройках или вместе с `twothirds`
`twothirds`	подходит для двух столбцов подряд при использовании вместе с `third`, один шириной 1/3, а другой шириной 2/3
`quarter`	помещается в четыре столбца подряд, следует использовать в четырехугольниках
выравнивания — аналогично divalign , columns , styler — не работают с промежутками!
`leftalign`	выравнивает текст по левому краю
`rightalign`	выравнивает текст по правому краю
`centeralign`	центрирует текст
`justify`	оправдывает текст
коробки и заметки - аналогично коробке , заметке , подсказке
`box`	создает рамку вокруг контейнера (использует цвета из `style.ini`)
`info` (было `information` в предыдущих версиях)	создает синее поле со значком информации
`important`	создает оранжевое поле с важным значком
`alert` (было `warning` в предыдущих версиях)	создает красное поле со значком предупреждения
`tip`	создает желтую коробку со значком подсказки
`help`	создает фиолетовое поле со значком помощи
`todo`	создает голубое поле со значком todo
`download`	создает зеленое поле со значком загрузки
`round`	добавляет закругленные углы к любому контейнеру с цветом фона или рамкой (работает только в современных браузерах, т.е. без IE )
`danger`	создает красную заметку об опасности
`warning`	создает оранжевое предупреждение о безопасности
`caution`	создает предупреждение о безопасности желтого цвета
`notice`	создает синее уведомление о безопасности
`safety`	создает зеленую заметку о безопасности
метки — похожие на выделение , важный_параграф , важный текст
`hi`	помечает текст как выделенный
`lo`	помечает текст как менее значимый
`em`	помечает текст как особо выделенный
*разнообразный*
`clear`	similar to clearfloat, похоже на clearfloat , желательно использовать с div, т.е. с прописными `<WRAP>`буквами
`tabs`	если обернуть список ссылок, они будут отображаться как вкладки
`hide`	скрывает текст для CSS (текст по-прежнему будет отображаться в исходном коде, в несовременных браузерах и доступен для поиска)
`noprint`	выводит текст на экран, но не на печать, аналогично noprint
`onlyprint`	отображает текст только в печатном виде, но не на экране
`pagebreak`	принудительно открывает новую страницу в распечатках (не отображается на экране), аналогично разрыву страницы
`nopagebreak`	пытается избежать разрыва страницы в распечатках (не виден на экране)
`spoiler`	показывает белый текст на белом фоне, который раскрывается только при его выделении; похоже на скрыть
`button`	при обертывании ссылки стилизует ее как кнопку
`tablewidth`	устанавливает ширину таблиц внутри в зависимости от ширины обертки, частично заменяет ширину таблицы
`indent`	делает отступ в тексте, может использоваться вместо табуляции
`outdent`	«выступающий» текст, может быть частично использован вместо «выступающий»
`prewrap`	оборачивает текст внутри предварительно отформатированных блоков кода, аналогично wpre

Возможно, вам придется настроить несколько классов в соответствии с потребностями вашего шаблона, особенно hi, lo and em. Если у вас темная или ярко окрашенная тема, используйте darkTpl параметр конфигурации ..

Классы легко настраиваются и расширяются. Любые пожелания приветствуются.

Ширина

Вы можете установить любую допустимую ширину для любого контейнера <WRAP> в верхнем регистре %, px, em, rem, ex, ch, vw, vh, pt, pc, cm, mm, in. Просто установите ширину до или после или с классами, например

<WRAP какой-то класс 50% другой класс>...

Все, кроме процентов, будет уменьшено, чтобы иметь максимальную ширину, доступную на небольших экранах.

Вы также можете использовать ключевые слова ширины half, third, twothirds and quarter. Для правильной работы им нужна еще одна обертка вокруг них. Например

<WRAP group>
  <WRAP half column>...</WRAP>
  <WRAP half column>...</WRAP>
</WRAP>

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

Якорь

Для определения привязки применяется следующий синтаксис:

<wrap #ankername />

Якорь доступен через: #ankername

Языки и текстовые направления

Вы можете изменить язык и направление контейнера, просто добавив двоеточие, за которым следует код языка, например:

<wrap :en>Этот текст явно помечен как английский.</wrap>

Направление текста (rtl, справа налево или ltr, слева направо) вставляется автоматически и зависит исключительно от языка. Список поддерживаемых в настоящее время языков взят из: http://meta.wikimedia.org/wiki/Template:List_of_language_names_ordered_by_code

Если вы хотите пометить текст с другим направлением текста, чем направление по умолчанию, вы должны использовать div, т.е. <WRAP>символы верхнего регистра. В противном случае выравнивание текста также не изменится.

Это делает его лучшей заменой ltr (и lang).

Файл CSS - lib/plugen/wrap/all.less

Скругление углов

/*____________ rounded corners ____________*/
/* (only for modern browsers) */
 
div.wrap_round {
    border-radius: 0.2em;
}
span.wrap_round {
    border-radius: 0.2em;
}

Демо

Вы можете увидеть демонстрацию плагина на demo.selfthinker.org.

«Примеры» (демо) на русском языке (для v2011-05-15).Источник .

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

wrap.zip

Лицензия

Author: Anika Henke
License: GNU GPL v2

worldwide open-source software - wiki:plugin

accscounter

Счетчик доступа и плагин популярности для «ДокуВики»

Примечания

Краткое содержание

Монтаж

Применение

Счетчик доступа

Популярные страницы

Посмотрите, как работает плагин

Синтаксис

Менеджер данных

Конфигурация и настройки

разработка

История изменений

Известные ошибки и проблемы

Список дел и пожеланий

Свяжитесь со мной

Обновление

Дополнения и Файлы

Лицензия

actionlink

Actionlink plugin

amazon

Amazon Plugin

More by Andi

Headline

Headline2

Headline3

Headline4

Headline5

autotooltip

Auto-Tooltip для «ДокуВики»

Совместимость

Монтаж

Применение

Конфигурация и настройки

Вспомогательный плагин

Обновление

Файл для загрузки

Лицензия

backuptool

BackupTool для «ДокуВики»

Совместимость

Монтаж

Применение

Восстановление резервной копии

Файл для загрузки

blog

Blog для «ДокуВики»

Совместимость

Монтаж

Installation

Syntax

Blog

Archive

Configuration and Settings

Changes

Development

Change Log

Bugs / Feature Requests

FAQ

My dates are shown wrong. What can I do?

Is it possible to change the way the date is displayed?

How can I alter the date of a blog post?

Is it possible to show table of contents?

The header is always a link to the page even though it's disabled in the include plugin settings

Is it possible to show just the first lines of each post with a 'Read more' link to view the full post?

the excluded_pages does not work

Discussion

Обновление

Файл для загрузки

Лицензия

camelcase

CamelCase для «ДокуВики»

Совместимость

Монтаж

Примеры/Использование

Синтаксис

Подробности