API:Localisation/ru

Это документирует данные, специфические для локализации сетевого API движка MediaWiki (api.php). См. Localisation для общих комментариев на тему локализации MediaWiki.

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

Именование
Сообщения справки по модулям API размещены в пространстве имён с использованием «пути модуля» — строки, используемой для параметра «modules» action=help. Для модулей, добавленных в, это будет тот же ключ, как и использованный в этом массиве, когда для модулей, добавленных в , или  это будет тот же ключ с префиксом «query+».


 * The description message, formerly returned by the [//doc.wikimedia.org/mediawiki-core/master/php/html/classApiBase.html#a49b8857e40e254e0af27fd281f3a2230 getDescription] method, is . This may be overridden by implementing the [//doc.wikimedia.org/mediawiki-core/master/php/html/classApiBase.html#aa0c499873fba5c934b98aae65e61a33d getDescriptionMessage] method, but cases where that is needed are rare.
 * The parameter description messages, formerly returned by the [//doc.wikimedia.org/mediawiki-core/master/php/html/classApiBase.html#a1d9406dc4a7b6e5b69554c492ee464f6 getParamDescription] method, are  (where   is the key from [//doc.wikimedia.org/mediawiki-core/master/php/html/classApiBase.html#a6806d2768e2bf6ea57e6b081bf4a9f9f getAllowedParams]). This may be overridden by setting a value for [//doc.wikimedia.org/mediawiki-core/master/php/html/classApiBase.html#ab3a6e8b6e7cfbaf4f8bf4339a13d76c5  ] in the data structure returned from [//doc.wikimedia.org/mediawiki-core/master/php/html/classApiBase.html#a6806d2768e2bf6ea57e6b081bf4a9f9f getAllowedParams].
 * Parameters with a description similar to "When more results are available, use this to continue" should use api-help-param-continue instead of redefining a duplicate message.
 * Sorting parameters taking values "newer" and "older" (with related "start" and "end" parameters) should use api-help-param-direction instead of redefining a duplicate message.
 * Modules using CSRF tokens by implementing [//doc.wikimedia.org/mediawiki-core/master/php/html/classApiBase.html#a9bd9dd747c20665d94b5939373b3f40c ] do not need to document the token parameter; this is automatically handled by ApiBase.
 * Several additional constants are available for use in [//doc.wikimedia.org/mediawiki-core/master/php/html/classApiBase.html#a6806d2768e2bf6ea57e6b081bf4a9f9f getAllowedParams]; see ApiBase for details.
 * Parameters with an array for [//doc.wikimedia.org/mediawiki-core/master/php/html/classApiBase.html#a345d7963199abd8893bd88015f7d4ed6 ] may use [//doc.wikimedia.org/mediawiki-core/master/php/html/classApiBase.html#a5a023b82d4aa17a44e33c1e8e2abdd6b  ] to specify that each value is individually documented. These messages are by default  . If the messages are named according to the default, there is no need to map messages to values in the [//doc.wikimedia.org/mediawiki-core/master/php/html/classApiBase.html#a5a023b82d4aa17a44e33c1e8e2abdd6b  ] array.
 * All examples must have a descriptive text. Message names should be along the lines of.

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

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

Используйте семантическую викитекстовую разметку в сообщениях:
 * for mention of parameter keys, and also references to variables like $wgMiserMode.
 * for the possible values of parameters, mention of parameters with values, and the mention of the input values in example docs.
 * for mention of keys or values in the API output.
 * for anything else that's computer code, e.g. "the  header" or "the page  ".
 * You don't need additional quotation marks when using semantic markup.

If you need to reference other API modules, pipe a link to Special:ApiHelp and the help formatter will do the right thing. For example, " " is used in the documentation for various token parameters. The Special:ApiHelp link properly renders as an in-page anchored link if it's on the same help page (example). Similarly, reference to MediaWiki configuration variables such as $wgMiserMode should link to the documentation on mediawiki.org.

Pages referenced in examples should generally not be linked, as these links are unlikely to exist on many wikis.

Ошибки и предупреждения
The code for this has yet to be written.

Текст в ответах API
ApiBase, and thus all API modules, are also context sources. Messages should generally be accessed using, and the API module itself should generally be passed when an IContextSource is needed.

Messages should not be arbitrarily included in the output because a client might find it useful.

Улучшение локализации на сайте translatewiki
You can add and improve API help message translations on translatewiki.net, in the same manner as other core MediaWiki messages. The relevant message groups include


 * MediaWiki web API
 * API feature usage
 * ApiSandbox extension

См. также

 * API/Architecture_work/i18n – Draft document with information for converting old API modules to the new system.
 * translatewiki:Template:doc-apihelp-param