Help:Extension:Translate/Insertables/fr

Les chaînes traductibles contiennent souvent des marques qui doivent être laissées telles quelles dans la traduction. Entrer ces marques peut être lent et difficile car il n'est pas rare d'y trouver des caractères spéciaux. Un objet Insertable (« insérable ») est un élément de marquage présenté au traducteur comme un bouton ou un autre élément d'interface. En cliquant sur le bouton, on insère l'élément de marquage dans le texte traduit à la position courante du curseur.

Chaque groupe de messages peut avoir un. Cette classe est responsable de la génération d'une liste d’. Chaque  a trois parties :


 * 1) ce qu'il faut afficher à l'utilisateur
 * 2) ce qui est inséré avant la  position du curseur dans la traduction
 * 3) ce qui est inséré après la position du curseur dans la traduction

L'extension Translate est livrée comportant. Des logiciels proposant des suggestions pour d'autres types de contenu peuvent être trouvés sur le dépôt Git de translatewiki.net.

Configuration
Voici un exemple de modification de la configuration dans un fichier YAML,

Elements insérables pré-fournis ou embarqués
Voici une liste d'éléments insérables embarqués.

HtmlTagInsertablesSuggester
This insertable will display suggestion for any HTML tags found inside the source string.

Par exemple :


 * Message : This linklink takes you to the home page.
 * Suggester displayed:

MediaWikiInsertablesSuggester
This insertable will display various suggestion for MediaWiki related wikitext messages. These include suggestion for,


 * Parameters like  which are present in API Help messages.
 * Suggestions for HTML tags.
 * Suggestions for HTML tags.

NumericalParameterInsertablesSuggester
This insertable will display suggestions for numerical parameters such as,  , or

RegexInsertablesSuggester
This insertable is a general purpose insertable that can be used to display suggestions based on a custom regular expression.

Example:

Parameter description,


 * regex - The regex to use for identifying insertables. Mandatory.
 * display - What to show to the user. Not mandatory, defaults to matched value.
 * pre - What to insert before selection. Not mandatory, defaults to matched value.
 * post - What to insert after selection. Not mandatory, defaults to matched value.

TranslatablePageInsertablesSuggester
Used primarily on translatable pages to provide suggester for variables like.

Adding a custom insertable
In case existing insertables are not sufficient to meet your requirements, it is possible to add custom insertables.

Voici un exemple sur la manière d'ajouter la prise en charge des Insertable concernant des groupes de messages basés sur des fichiers existants : FreeCol. Le fichier YAML a été élagué pour le raccourcir. Les lignes récemment ajoutées sont mises en valeur.

FreeCol.yaml:

Suggester.php:

Les paramètres de Insertable sont :