DokuWiki

It's better when it's simple

Инструменты пользователя

Инструменты сайта


ru:devel:plugins

Плагины

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

Типы плагинов

В настоящее время «ДокуВики» содержит пять разных типов плагинов.

Имя плагина

Корректное имя плагина:

  • Должно содержать только символы английского алфавита a-z и цифры 0-9.
  • ПОДЧЕРКИВАНИЕ не разрешено так как:
    • используется для отделения <имени плагина> от <имени компонента>.
    • Использование ПОДЧЕРКИВАНИЯ может также понизить статистику популярности до нуля.
  • Если одинаковое имя используется двумя разными плагинами то:
    • они взаимно исключаются и становятся несовместимыми.
    • кроме того, только один из них сможет иметь домашнюю страничку на dokuwiki.org.

Мастер создания плагинов

Мастер для создания базовой основы плагинов «Докувики» можно найти на http://pluginwiz.dokuwiki.org/, его рекомендуется использовать для начала разработки.

If you later need to extend your plugin refer to the plugin file structure on how files are arranged in a plugin.

Размещение плагина на dokuwiki.org

Если вы создали плагин, пожалуйста, поделитесь им с сообществом. Just create a page named after your plugin in the plugin namespace. E.g. if your pluginfolder is named sample create a page plugin:sample here in the wiki.

The page should contain all needed documentation on how to install and use the plugin and give users a pretty good idea what it does before installing the plugin. Adding screenshots might be a good idea as well1). Plugin homepage template contains more tips on how to make an user friendly page.

At the top of the plugin page a few metadata fields have to be filled. A description of each field can be found here.

Uploads are not allowed on dokuwiki.org, so you need to host your plugin files somewhere else. We recommend to manage your source with a Revision Control System like git. If you do, it's easiest to use a public repository host like Github which offers also a bug tracker for your repository.

Обзор плагинов

Plugin Survey 2010 — обзор для разработчиков, в котором рассмотрены все плагины, представленные в пространстве имён «plugin» сайта www.dokuwiki.org. Данные были собраны 05.09.2010 г. автоматическим скриптом с небольшой ручной правкой и обработкой. Было проверено 697 страниц, содержащих 672-а плагина. Исходные коды 647-и плагинов (96%) были загружены и проанализированы.

1)
You can use the imageshack plugin to add images here
ru/devel/plugins.txt · Последнее изменение: 2014-05-18 15:12 — Aleksandr

Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki