Различия

Показаны различия между двумя версиями страницы.

--- ru:devel:plugins [2009-09-25 12:27] – 93.91.4.119
+++ ru:devel:plugins [2014-05-18 15:12] (текущий) – Aleksandr
@@ Строка 1: / Строка 1: @@
 ====== Плагины ======
-У DokuWiki имеется гибкий API плазинов, который позволяет расширять их функциональность -- вводить дополнительные режимы [[ru:syntax|синтаксиса]], специальные [[action modes|режимы действий]], новые форматы [[ru:export|экспорта]] и многое другое. В зависимости от предназначения плагина, плагин может состоять из одного или более [[#типы плагинов|типов плагинов]], представленных ниже.
+В «ДокуВики» имеется гибкий API плагинов, который позволяет расширять их функциональность --- вводить дополнительные [[ru:wiki:syntax|синтаксические моды]], специальные [[action_modes|режимы действий]], новые форматы [[ru:export|экспорта]] и многое другое. В зависимости от предназначения плагина, плагин может состоять из одного или более [[#типы плагинов|типов плагинов]], представленных ниже.
 ===== Типы плагинов =====
-В настоящее время DokuWiki содержит пять разных типов плагинов.
-  * [[Syntax Plugins|Плагины синтаксиса]] расширяют базовый [[ru:syntax|синтаксис]] DokuWiki.
+В настоящее время «ДокуВики» содержит пять разных типов плагинов.
-  * [[Action Plugins|Плагины действий]] могут быть использованы для расширения или изменения многих аспектов основных операци DokuWiki: от сохранения статей до введения новых  [[action modes|режимов действия]].
-  * [[Admin Plugins|Плагины администрирования]] могут предоставить функциональность администрирования  DokuWiki - эти плагины доступны для суперпользователей и менеджеров через кнопку Admin.
+  * [[syntax_plugins|Синтаксические плагины]] расширяют базовый [[ru:wiki:syntax|синтаксис]] «ДокуВики».
-  * [[Helper Plugins|Вспомогательные плагины]] могут использоваться для обеспечения функциональности для многих других плагинов, чтобы не реализовывать в этих плагинах снова и снова одни и те же функции.
+  * [[action_plugins|Плагины действий]] могут быть использованы для расширения или изменения многих аспектов основных операци «ДокуВики»: от сохранения статей до введения новых  [[action modes|режимов действия]].
-  * [[Renderer Plugins|Плагины рендеринга]] позволяют создавать новые режимы [[ru:export|экспорта]] и заменить стандартный для DokuWiki рендерер xhtml.
+  * [[admin_plugins|Плагины администрирования]] могут предоставить функциональность администрирования  «ДокуВики» --- эти плагины доступны для суперпользователей и менеджеров через кнопку «Управление» (Admin).
+  * [[helper_plugins|Вспомогательные плагины]] могут использоваться для обеспечения функциональности для многих других плагинов, чтобы не реализовывать в этих плагинах снова и снова одни и те же функции.
+  * [[renderer_plugins|Плагины рендеринга]] позволяют создавать новые режимы [[ru:export|экспорта]] и заменить стандартный для «ДокуВики» рендер xhtml.
+===== Имя плагина =====
+Корректное имя плагина:
+  * Должно содержать только символы английского алфавита a-z и цифры 0-9.
+  * ПОДЧЕРКИВАНИЕ не разрешено так как:
+    * используется для отделения ''<имени плагина>'' от ''<имени компонента>''.
+    * Использование ПОДЧЕРКИВАНИЯ может также понизить статистику [[:popularity|популярности]] до нуля.
+  * Если одинаковое имя используется двумя разными плагинами то:
+    * они взаимно исключаются и становятся несовместимыми.
+    * кроме того, только один из них сможет иметь домашнюю страничку на dokuwiki.org.
+===== Мастер создания плагинов =====
+Мастер для создания базовой основы плагинов «Докувики» можно найти на [[http://pluginwiz.dokuwiki.org/]], его рекомендуется использовать для начала разработки.
+If you later need to extend your plugin refer to the [[plugin_file_structure|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 well((You can use the [[plugin:imageshack]] plugin to add images here)). [[devel:plugin_homepages|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 [[plugin:repository|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 [[http://github.com/|Github]] which offers also a bug tracker for your repository.
 ===== Обзор плагинов =====
-[[devel:plugin survey:|Plugin Survey 2009]]  -  обзор для разработчиков, в котором рассмотрены все [[ru:plugins|плагины]] представленные в пространстве имен plugin сайта %%www.dokuwiki.org%%. Данные были собраны 2009-08-13 автоматическим скриптом с небольшой ручной правкой и обработкой. Было проверено 562  статей сожержащий  539 плагинов. Исходные коды 456 плагинов (85%) были загружены и проанализированы.
+[[devel:plugin_survey:|Plugin Survey 2010]] --- обзор для разработчиков, в котором рассмотрены все [[ru:plugins|плагины]], представленные в пространстве имён «plugin» сайта [[doku>dokuwiki|www.dokuwiki.org]]. Данные были собраны 05.09.2010 г. автоматическим скриптом с небольшой ручной правкой и обработкой. Было проверено 697 страниц, содержащих 672-а плагина. Исходные коды 647-и плагинов (96%) были загружены и проанализированы.