API:Localisation/de

Diese Seite dokumentiert Dinge, die bei der Lokalisation der MediaWiki Action API spezifiziert werden müssen. Siehe Lokalisation für allgemeine Informationen zur Lokalisation von MediaWiki.

Nachrichtendateien
Lokalisierungsnachrichten für den MediaWiki-Kern befinden sich unter.

Für Erweiterungen sollten sich die Nachrichten, die nur von der API-Dokumentation genutzt werden und von den meisten Benutzern nicht gesehen werden, in einer separaten Datei befinden und den normalen Mechanismus für mehrere Dateien nutzen. Siehe die Lokalisierungs-Dokumentation zum Hinzufügen neuer Nachrichten.

Benennung
Die Hilfenachrichten für API-Module nutzen als Namenspfad den "Modul-Pfad", wobei es sich um die Zeichenkette handelt, die für den Parameter action=help des "Moduls" genutzt wird. Für zu hinzugefügte Module ist dies der gleiche Schlüssel, der in dem Array genutzt wird, während für zu,  oder  hinzugefügte Module der Schlüssel das Präfix "query+" erhält.


 * Die Beschreibungsnachricht, früher über die Methode [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a49b8857e40e254e0af27fd281f3a2230 getDescription] ausgegeben, wurde auf zwei aufgeteilt: eine Nachricht  mit einer einzeiligen Beschreibung des Moduls und eine , die zusätzliche Modul-Level-Dokumentation enthält. Diese kann über entsprechende Methoden überschrieben werden, was jedoch nur in seltenen Fällen erforderlich ist.
 * Vor 1.30 wurde eine Beschreibung  genutzt. Dies wurde durch Implementation der Methode [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#aa0c499873fba5c934b98aae65e61a33d getDescriptionMessage] überschrieben, wobei dies nur in seltenen Fällen benötigt wurde.
 * Die Parameterbeschreibungsnachrichten, früher über die Methode [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a1d9406dc4a7b6e5b69554c492ee464f6 getParamDescription] ausgegeben, sind  (wobei   der Schlüssel aus [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a6806d2768e2bf6ea57e6b081bf4a9f9f getAllowedParams] ist). Dies kann durch Setzen eines Wertes für   in der aus [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a6806d2768e2bf6ea57e6b081bf4a9f9f getAllowedParams] ausgegebenen Datenstruktur überschrieben werden.
 * Parameter mit einer Beschreibung, die "Wenn weitere Ergebnisse verfügbar sind, nutze dies, um fortzufahren" ähnelt, sollten api-help-param-continue nutzen, statt eine doppelte Nachricht neu zu definieren.
 * Sortierungparameter, die Werte "neuer" und "älter" übernehmen (mit entsprechenden Parametern "Start" und "Ende"), sollten api-help-param-direction nutzen, statt eine doppelte Nachricht neu zu definieren.
 * Module, die CSRF-Token durch Implementation von  nutzen, müssen den Parameter token nicht dokumentieren; dies erfolgt automatisch über ApiBase.
 * Several additional constants are available for use in [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a6806d2768e2bf6ea57e6b081bf4a9f9f getAllowedParams]; see ApiBase for details.
 * Parameters with an array for  may use   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  array (it still has to exist but can be left empty).
 * All examples must have a descriptive text. Message names should be along the lines of.

Nachrichtendokumentation
When documenting the messages in, use the following templates:



Nachrichtenformatierung
Alle Nachrichten sollten mit einem Punkt enden und vollständige Sätze sein. For parameters passed to the messages by default, see the templates linked from #Message documentation.

Verwenden Sie semantisches Wikitext-Markup in Nachrichten:


 * for mention of parameter keys, and also references to variables like $wgMiserMode.
 * for the possible values of parameters, mention of parameters with values (including references to other modules), 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.

Fehler und Warnungen
Errors are raised by calling  and the message can be localized in the usual way. Likewise for warnings with. Siehe für Details.

Customarily API error messages have message keys starting with  and warnings with.

Text in API-Antworten
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.

Verbesserung der Lokalisierung in 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-Aktions-API
 * Verwendung von API-Funktionen

Siehe auch

 * – Draft document with information for converting old API modules to the new system.