API:Localisation/fr

Ce document contient les informations spécifiques à la localisation de l'API action de MediaWiki. Voir Localisation pour les commentaires généraux sur la localisation de MediaWiki.



Fichiers de messages
Les messages de localisation du coeur de MediaWiki se trouvent sous.

Pour les extensions, les messages qui ne servent que dans documentation de l'API et qui ne sont pas vus de la ajorité des utilisateurs finaux doivent être mis dans un fichier séparé en utilisant les mécanismes standards pour avoir des fichiers multiples. Voir la documentation d'internationalisation sur l'ajout de nouveaux messages.



Nommage
Les messages d'aide pour les modules de l'API utilisent l'espace de noms formé par le « chemin du module », qui est la chaîne utilisée pour le paramètre des « modules » de action=help. Pour les modules ajoutés à, ce sera la même chose que la clé utilisée dans ce tableau, tandis que pour les modules ajoutés à , , ou , ce sera cette clé préfixée par « query+ ».


 * Le message de description, renvoyé initialement par la méthode [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a49b8857e40e254e0af27fd281f3a2230 getDescription], a été coupé en deux messages : un message  avec un résumé sur une ligne du module et une   contenant toute documentation supplémentaire de niveau module. Ceux-ci peuvent être réécrasés avec les méthodes correspondantes, mais ces cas sont rares. These may be overridden with corresponding methods, but cases where that is needed are rare.
 * Avant la version 1.30, on utilisait un message  . Ceci pouvait être réécrasé en implémentant la méthode $1, mais les cas où cela était nécessaire étaient rares. This was be overridden by implementing the [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#aa0c499873fba5c934b98aae65e61a33d getDescriptionMessage] method, but cases where that was needed were rare.
 * Les messages de description des paramètres, initialement retournés par la méthode [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a1d9406dc4a7b6e5b69554c492ee464f6 getParamDescription], sont  (où   est la clé de [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a6806d2768e2bf6ea57e6b081bf4a9f9f getAllowedParams]). Ceci peut être réécrasé en définissant une valeur pour   dans la structure de données renvoyée par [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a6806d2768e2bf6ea57e6b081bf4a9f9f getAllowedParams].
 * Les paramètres avec une description similaire à "Lorsque davantage de résultats sont disponibles, utilisez ceci pour continuer" doivent utiliser api-help-param-continue au lieu de redéfinir un message dupliqué.
 * Trier les paramètres qui prennent des valeurs telles que « plus récent » ou « plus ancien » (avec leurs paramètres « début » et « fin » associés ) doivent utiliser api-help-param-direction au lieu de redéfinir un message dupliqué.
 * Les modules qui utilisent les jetons CSRF en implémentant  n'ont pas besoin de renseigner le paramètre token ; ceci est géré automatiquement par ApiBase.
 * Plusieur constantes supplémentaires sont disponibles pour être utilisées dans [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a6806d2768e2bf6ea57e6b081bf4a9f9f getAllowedParams]; voir ApiBase pour les détails.
 * Les paramètres tableaux pour  peuvent utiliser   pour spécifier que chaque valeur est individuellement documentée. Ces messages sont par défaut  . Si les messages sont nommés par défaut, il n'y a pas besoin de faire de correspondance entre les messages et les valeurs dans le tableau    (il doit encore exister mais peut rester vide). 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).
 * Tous les exemples doivent avoir un texte de description. Les noms de message doivent être avec les lignes de . Message names should be along the lines of.



Documentation des messages
Quand vous documentez les messages dans, utilisez les modèles usivants :


 * doc-apihelp-summary
 * doc-apihelp-description
 * doc-apihelp-extended-description
 * doc-apihelp-param
 * doc-apihelp-paramvalue
 * doc-apihelp-paraminfo
 * doc-apihelp-example



Format des messages
Tous les messages doivent se terminer par un point, et être composés de phrases grammaticales. Pour les paramètres passés aux messages par défaut, voir les modèles liés de #Message documentation.

Utiliser le marquage sémantique de texte wiki dans les messages:


 * pour mentionner des clés de paramètres, ainsi que les références à des variables telles que $wgMiserMode.
 * pour les valeurs possibles des paramètres, pour mentionner des paramètres avec valeurs (y compris les références aux autres modules), et mentionner les valeurs d'entrée dans les documentations d'exemples.
 * pour mentionner des clés ou des valeurs dans les sorties de l'API.
 * pour tout autre chose qui serait du code informatique, par exemple « l'entête   » ou « la page  ».
 * Vous n'avez pas besoin d'ajouter d'apostrophes supplémentaires lorsque vous utilisez la marquage sémantique.

Si vous devez référencer d'autres modules API, ajoutez un lien à Special:ApiHelp avec une barre verticale (pipe) et l'aide au formatage fera le reste. Par exemple, «  » est utilisé dans la documentation pour différents paramètres token. Le lien Special:ApiHelp est rendu correctement comme un lien vers une ancre définie dans la page s'il se trouve sur la même page d'aide (exemple). De la même façon, la référence aux variables de configuration de MediaWiki telles que $wgMiserMode doit pointer vers la documentation sur mediawiki.org.

Les pages référencées dans les exemples ne doivent généralement pas être liées, parce que ces liens peuvent ne pas exister sur les différents wikis.



Erreurs et avertissements
Les erreurs sont déclenchées en appelant  et le message est localisé de manière habituelle. C'est la même chose pour les avrtissements avec. Voir pour les détails.

Les messages d'erreur personnalisés de l'API ont des clés de messages commençant par  et les avertissements commencent eux, par. Vous pouvez utiliser doc-apierror dans la documentation du message.



Texte dans les réponses de l'API
ApiBase, ainsi tous les modules d'API, sont aussi des sources de contexte. Les messages doivent généralement être accédés en utilisant, et le module de l'API lui-même doit généralement être passé quand un IContextSource est nécessaire.

Les messages ne doivent pas être inclus arbitrairement dans la sortie parce qu'un client trouverait cela utile.



Améliorer les localisations sur translatewiki
Vous pouvez ajouter et améliorer les traductions des messages d'aide de l'API sur translatewiki.net, de la même manière que pour d'autres messages du coeur de MediaWiki. Les groupes de messages significatifs incluent


 * API d'action de MediaWiki
 * Utiliser les fonctions de l'API



Voir aussi

 * – Projet de document de 2014 contenant des informations pour la conversion des anciens modules API au système actuel.