Различия

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

--- wiki:plugin:repository [2025/02/07 10:40] – создано vladpolskiy
+++ wiki:plugin:repository [2025/02/09 15:11] (текущий) – [Руководство и API плагина репозитория] vladpolskiy
@@ Строка 1: / Строка 1: @@
-====== Extension Repository Plugin ======
+====== Плагин репозитория расширений ======
-This plugin is the counterpart of the [[extension|extension manager]]. It manages [[:extensions]] ([[:plugins]] and [[:templates]]) here at dokuwiki.org and provides the API for the extension manager.
+Этот плагин является аналогом [[wiki:plugin:extension|менеджера расширений]]. Он управляет [[wiki:extensions|расширениями]] ([[wiki:plugins|плагинами]] и [[wiki:templates|шаблонами]]) здесь, на dokuwiki.org, и предоставляет API для менеджера расширений.
-(A plugin similar to this one but with more flexibility, aimed at usage outside dokuwiki.org, is also available. It's the [[:plugin:data|data plugin]].)
+(Также доступен плагин, похожий на этот, но с большей гибкостью, предназначенный для использования за пределами dokuwiki.org. Это [[wiki:plugin:data|плагин данных]].)
-===== Plugins Entry =====
+===== Запись плагинов =====
-Each plugin should have a homepage in the ''plugin'' namespace, containing at least a short description and a data block like this at the start:
+Каждый плагин должен иметь домашнюю страницу в ''plugin'' пространстве имен, содержащую как минимум краткое описание и блок данных, подобный следующему в начале:
 <code>
@@ Строка 31: / Строка 31: @@
 </code>
-The info is stored in a database and used to build a dynamic repository browser (see the [[:plugins]] listing or the [[plugin:Extension|Extension Manager]] in your wiki).
+Информация хранится в базе данных и используется для создания динамического браузера репозитория (см. список [[wiki:plugins|плагинов]] или [[wiki:plugin:Extension|менеджер расширений]] в вашей вики)
-About the fields:
+О полях:
-  * **description** -- should be a short description of what the plugin does
+  * **description** -- должно быть кратким описанием того, что делает плагин
-  * **author** -- the plugin's main author or current maintainer
+  * **author** -- основной автор плагина или текущий сопровождающий
-  * **email** -- email address of the plugin's main author or current maintainer
+  * **email** -- адрес электронной почты основного автора плагина или текущего сопровождающего
-  * **type** -- one or more of the plugin types (syntax, action, admin, helper, render)
+  * **type** -- один или несколько типов плагинов (синтаксис, действие, администрирование, помощник, рендеринг)
-  * **lastupdate** -- date when newest version of the plugin was provided, in YYYY-MM-DD format, it is used for automated update checking by the [[plugin:extension|Extension Manager]] and should equal the date in [[devel:plugin_info|plugin.info.txt]]
+  * **lastupdate** -- дата предоставления последней версии плагина в формате ГГГГ-ММ-ДД, используется для автоматической проверки обновлений диспетчером [[wiki:plugin:Extension|расширений]] и должна совпадать с датой в [[wiki:devel:plugin_info|plugin.info.txt]]
-  * **updatemessage** -- show message to inform users about update, visible in Extension Manager
+  * **updatemessage** -- показывать сообщение, информирующее пользователей об обновлении, отображается в Extension Manager
-  * **compatible** -- give the DokuWiki version(s) your plugin is [[:extension_compatibility|compatible]] to. Multiple versions can be given and code names can be used. Eg: 2009-02-14, lemming, anteater.
+  * **compatible** -- укажите версию(и) DokuWiki, с которой [[wiki:extension_compatibility|совместим]] ваш плагин . Можно указать несколько версий и использовать кодовые имена. Например: 2009-02-14, лемминг, муравьед.
-    * Use a plus sign ''**+**'' if you think it's safe to assume that the plugin will be compatible with future releases of DokuWiki.
+    * Используйте знак «плюс» ''**+**'' если вы считаете, что плагин будет совместим с будущими версиями DokuWiki.
-    * Use an exclamation mark ''**!**'' if the plugin is not compatible to a DokuWiki release (e.g. "!Greebo").
+    * Используйте восклицательный знак ''**!**'' если плагин несовместим с версией DokuWiki (например, «!Greebo»).
-  * **depends** -- comma separated list of plugin dependencies if any
+  * **depends** -- список зависимостей плагина, разделенный запятыми, если таковые имеются
-  * **conflicts** -- comma separated list of plugins/templates which conflict your plugin, use ''template:xxx'' if conflicting with the template ''xxx''
+  * **conflicts** -- список плагинов/шаблонов, разделенных запятыми, которые конфликтуют с вашим плагином, используйте ''template:xxx'' если конфликтуют с шаблоном ''xxx''
-  * **similar** -- comma separated list of plugins with a similar task
+  * **similar** -- список плагинов, разделенных запятыми, с похожей задачей
-  * **tags** -- categorize your plugin here. If ''!obsolete'' is the only tag, then this plugin will be hidden from repo table
+  * **tags** -- классифицируйте свой плагин здесь. Если ''!obsolete'' это единственный тег, то этот плагин будет скрыт из таблицы репозитория
-  * **screenshot_img** -- image url to characteristic screenshot of plugin/template (also used in new Extension Manager, which scales and cut it to a 120x70 px image)
+  * **screenshot_img** -- URL-адрес изображения для характерного снимка экрана плагина/шаблона (также используется в новом менеджере расширений, который масштабирует и обрезает его до изображения размером 120×70 пикселей)
-  * **securitywarning** -- use this field to warn about inherent security problems with the plugin. Ability to execute arbitrary script could be a reason (pre-defined values: ''informationleak'', ''allowsscript'', ''requirespatch'' and ''partlyhidden'' ([[plugin:repository:manual#entry_component|explanation]]))
+  * **securitywarning** -- используйте это поле, чтобы предупредить о внутренних проблемах безопасности плагина. Возможность выполнения произвольного скрипта может быть причиной (предопределенные значения: ''informationleak'', ''allowsscript'', ''requirespatch'' and ''partlyhidden'' ([[wiki:plugin:repository:manual#entry_component|объяснение ]]))
-  * **securityissue** -- only add this field when there is a [[devel:security]] problem with the plugin. Enter a short description here and inform the author. Plugin will be hidden from repo table
+  * **securityissue** -- добавляйте это поле только в случае возникновения проблем с [[wiki:devel:security|безопасностью]] плагина. Введите здесь краткое описание и сообщите автору. Плагин будет скрыт из таблицы репозитория
-  * **downloadurl** -- this should be the direct URL to the download compatible with the most current release
+  * **downloadurl** -- это должен быть прямой URL-адрес для загрузки, совместимый с самой последней версией
-  * **bugtracker** -- a link to the bug tracker for this plugin, leave empty if none available
+  * **bugtracker** -- ссылка на багтрекер для этого плагина, оставьте пустым, если таковой отсутствует
-  * **sourcerepo** -- a link to the webinterface of a source code management system like [[devel:git]] or [[devel:darcs]], leave empty if none available
+  * **sourcerepo** -- ссылка на веб-интерфейс системы управления исходным кодом, например [[wiki:devel:git]] или [[wiki:devel:darcs]], оставьте пустым, если таковая отсутствует
-  * **donationurl** -- a link to paypal, an Amazon wishlist or similar thing where people can donate to you, leave empty if none available
+  * **donationurl** -- ссылка на PayPal, список желаний Amazon или что-то подобное, где люди могут сделать вам пожертвование; оставьте пустым, если ничего не доступно
-===== Template Entry =====
+===== Шаблон записи =====
-Similar for templates, but in the ''template'' namespace.
+Аналогично для шаблонов, но в ''template'' пространстве имен.
 <code>
@@ Строка 81: / Строка 81: @@
 </code>
-The info is stored in a database and used to build a dynamic repository browser (see the [[:template]] listing or the [[plugin:Extension|Extension Manager]] in your wiki).
+Информация хранится в базе данных и используется для создания динамического браузера репозитория (см. список [[wiki:template|шаблонов]] или [[wiki:plugin:Extension|менеджер расширений]] в вашей вики).
 About the fields:
-  * **description** -- should be a short description of the templates main feature
+  * **description** -- должно быть кратким описанием основной функции шаблона
-  * **author** -- the template's main author or current maintainer
+  * **author** -- основной автор шаблона или текущий сопровождающий
-  * **email** -- email address of the template's main author or current maintainer
+  * **email** -- адрес электронной почты основного автора шаблона или текущего сопровождающего
-  * **lastupdate** -- date when newest version of the template was provided, in YYYY-MM-DD format, it is used for automated update checking by the [[plugin:extension|Extension Manager]]  and should equal the date in [[devel:template_info|template.info.txt]]
+  * **lastupdate** -- дата предоставления последней версии шаблона в формате ГГГГ-ММ-ДД, она используется для автоматической проверки обновлений диспетчером [[wiki:plugin:Extension|расширений]]  и должна совпадать с датой в [[wiki:devel:template_info|template.info.txt]]
-  * **updatemessage** -- show message to inform users about update, visible in Extension Manager
+  * **updatemessage** -- показывать сообщение, информирующее пользователей об обновлении, отображается в Extension Manager
-  * **compatible** -- give the DokuWiki version(s) your template is compatible to. Multiple versions can be given and code names can be used. Eg: 2009-02-14, lemming, anteater
+  * **compatible** -- укажите версию(и) DokuWiki, с которой совместим ваш шаблон. Можно указать несколько версий и использовать кодовые имена. Например: 2009-02-14, лемминг, муравьед
-  * **depends** -- comma separated list of template dependencies if any
+  * **depends** -- список зависимостей шаблона, разделенных запятыми, если таковые имеются
-  * **conflicts** -- comma separated list of plugins/templates which conflict your template, use ''template:xxx'' if conflicting with the template ''xxx''
+  * **conflicts** -- список плагинов/шаблонов, разделенных запятыми, которые конфликтуют с вашим шаблоном, используйте, ''template:xxx'' если конфликтуют с шаблоном ''xxx''
-  * **similar** -- comma separated list of template with a similar task
+  * **similar** -- список шаблонов с похожей задачей, разделенный запятыми
-  * **screenshot_img** -- URL to screenshot of your template (also used in new Extension Manager, which scales and cut it to a 120x70 px image)
+  * **screenshot_img** -- URL-адрес снимка экрана вашего шаблона (также используется в новом менеджере расширений, который масштабирует и обрезает его до изображения размером 120×70 пикселей)
-  * **tags** -- categorize your template here. If ''!obsolete'' is the only tag, then this template will be hidden from repo table
+  * **tags** -- классифицируйте свой шаблон здесь. Если ''!obsolete'' это единственный тег, то этот шаблон будет скрыт из таблицы репо
-  * **securitywarning** -- use this field to warn about inherent security problems with the template. Ability to execute arbitrary script could be a reason
+  * **securitywarning** -- используйте это поле, чтобы предупредить о проблемах безопасности, присущих шаблону. Возможность выполнения произвольного скрипта может быть причиной
-  * **securityissue** -- only add this field when there is a [[devel:security]] problem with the template. Enter a short description here and inform the author. Template will be hidden from repo table
+  * **securityissue** -- добавляйте это поле только в случае возникновения проблем с [[wiki:devel:security|безопасностью]] шаблона. Введите здесь краткое описание и сообщите автору. Шаблон будет скрыт из таблицы репозитория
-  * **downloadurl** -- this should be the direct URL to the download compatible with the most current release
+  * **downloadurl** -- это должен быть прямой URL-адрес для загрузки, совместимый с самой последней версией
-  * **bugtracker** -- a link to the bug tracker for this template, leave empty if none available
+  * **bugtracker** -- ссылка на багтрекер для этого шаблона, оставьте пустым, если таковой отсутствует
-  * **sourcerepo** -- a link to the webinterface of a source code management system like [[devel:git]] or [[devel:darcs]], leave empty if none available
+  * **sourcerepo** -- ссылка на веб-интерфейс системы управления исходным кодом, например [[wiki:devel:git]] или [[wiki:devel:darcs]], оставьте пустым, если таковая отсутствует
-  * **donationurl** -- a link to paypal, an Amazon wishlist or similar thing where people can donate to you, leave empty if none available
+  * **donationurl** -- ссылка на PayPal, список желаний Amazon или что-то подобное, где люди могут сделать вам пожертвование; оставьте пустым, если ничего не доступно
-===== Security warning: predefined shortcuts =====
+===== Предупреждение о безопасности: предопределенные сочетания клавиш =====
-The security warning field allows usage of some predefined shortcuts. The following table shows the actually defined shortcuts and their meaning:
+Поле предупреждения безопасности позволяет использовать некоторые предопределенные сочетания клавиш. В следующей таблице показаны фактически определенные сочетания клавиш и их значение:
-^  Shortcut             ^  Meaning  ^
+^  Ярлык             ^  Значение  ^
-|  **informationleak**  | This extension exposes information that might be valuable to a hacker. It is not recommended in a public installation.  |
+|  **informationleak**  | Это расширение раскрывает информацию, которая может быть ценной для хакера. Не рекомендуется для публичной установки.  |
-|  **allowsscript**     | This extension will allow execution of scripts. It should only be used when you trust ALL editors, best suited in private personal wikis.  |
+|  **allowsscript**     | Это расширение позволит выполнять скрипты. Его следует использовать только тогда, когда вы доверяете ВСЕМ редакторам, лучше всего подходит для личных вики.  |
-|  **requirespatch**    | This extension requires patching the DokuWiki core. Manual patches may break compatibility with other extensions and make it harder to secure your installation by upgrading to the latest version.  |
+|  **requirespatch**    | Это расширение требует исправления ядра DokuWiki. Ручные исправления могут нарушить совместимость с другими расширениями и усложнить защиту вашей установки путем обновления до последней версии.  |
-|  **partlyhidden**     | Hiding parts of a DokuWiki page is not supported by the core. Most attempts to introduce ACL control for parts of a page will leak information through RSS feed, search or other core functionality.  |
+|  **partlyhidden**     | Скрытие частей страницы DokuWiki не поддерживается ядром. Большинство попыток ввести контроль ACL для частей страницы приведут к утечке информации через RSS-канал, поиск или другие основные функции.  |
-An example for the **partlyhidden** security warning can be viewed at the [[plugin:ifauth|plugin:ifauth]] page.
+Пример **частично скрытого** предупреждения безопасности можно посмотреть на странице [[wiki:plugin:ifauth|plugin:ifauth]].
-===== Repository Plugin Manual and API =====
+===== Руководство и API плагина репозитория =====
-The [[:plugin:repository:manual]] describes how to use the different components of the plugin on dokuwiki.org.
+В [[wiki:plugin:repository:manual|руководстве]] описывается, как использовать различные компоненты плагина на dokuwiki.org.
-The [[:plugin:repository:api|API doc]] describes how to query the plugin info from remote.
+В [[wiki:plugin:repository:api| документации API]] описывается , как удаленно запросить информацию о плагине.
-===== Compatibility with release candidates =====
+===== Совместимость с релиз-кандидатами =====
-When a new release candidate is available please update the plugin homepage with appropriate compatibility, use the release name (i.e. "rincewind") rather than the RC date. That way you won't have to update the compatibility information as the final release is done.
+Когда будет доступен новый релиз-кандидат, пожалуйста, обновите домашнюю страницу плагина с соответствующей совместимостью, используйте название релиза (например, «rincewind») вместо даты RC. Таким образом, вам не придется обновлять информацию о совместимости, когда будет готов финальный релиз.