How to translate/fr

Merci de vous joindre aux traducteurs !

Cette page explique le processus de traduction au sein du wiki. Si vous souhaitez contribuer à la traduction du wiki, vous êtes au bon endroit ! Ici se trouvent les informations sur la traduction et sur les bonnes pratiques en cours dans.



Les bases de la traduction
Une fois une page complète, elle est marquée pour traduction. Pour la traduire, il suffit de cliquer sur le bouton "Translate this page" (Traduire cette page) en haut de la page, de sélectionner une langue, et voilà ! Il ne reste plus qu’à traduire la page.

Les pages traduisibles sont divisées en unités de traduction, aussi appelés "messages". Chaque unité est indépendante des autres. Cela permet de traduire le texte étape par étape, et facilite également le suivi de la traduction.

Une fois que la langue de traduction est validée, une nouvelle page est créée, ayant pour lien Nom_de_la_page/code_langue. Par exemple, Mane Page est la page originale en anglais ; "fr" est le code de langue pour le français et le lien pour la traduction française de cette page est Mane Page/fr ; pour l'allemand, le code de langue est "de" et Mane Page/de pour la page ; etc.

Sur la page source (en anglais), une nouvelle langue apparaîtra dans le bandeau des langues, correspondant à cette page nouvellement créée.

Vous pouvez revenir à la traduction à n'importe quel moment. Le pourcentage d’unités traduites est affiché en haut de la page traduite, et par des carrés colorés sur le bandeau des langues. Notez toutefois que les traductions ont parfois besoin de quelques minutes pour être prises en compte, donc ne vous inquiétez pas si vous ne voyez pas immédiatement votre traduction, revenez simplement plus tard.

Vous pouvez ajouter de la documentation aux messages.

Il se peut que la page source ait été modifiée depuis votre premier passage. Dans ce cas, le texte modifié sera surligné en rouge sur la page traduite, et les unités de traductions désuètes seront signalées par une icône d’horloge à côté, et disponibles dans l’onglet "Désuet" dans le menu de la traduction.

Si une page complète n'est pas encore disponible à la traduction, c’est probablement parce qu’elle n’a pas encore été validée par les administrateurs de traduction (voir la section pour les administrateurs ci-dessous). Si la page a tout juste été parquée pour traduction, cela peut prendre un peu de temps avant qu'elle ne soit disponible pour la traduction.

Dans ce lien, il y a un exemple pour les traducteurs sur le MediaWiki.



Bonnes pratiques
Dans cette section sont détaillées les bonnes pratiques de traduction sur ce wiki. Si vous avez le moindre doute, n’hésitez pas à contacter un administrateur de traduction sur le Discord TMQ.

Catégories
Toutes les pages de catégorie -- y compris leur titre -- sont traduisibles.

Les catégories utilisées pour décrire une page sont de la forme, où category_name (nom_catégorie) est le nom de la catégorie. Elles ne sont normalement pas incluses dans les unités de traduction. Ce code permet de générer un lien qui redirige automatiquement vers une page traduite de la catégorie selon la langue. La catégorie sera alors affichée sous la forme Category_name/language_code (Nom_catégorie/code_langue) -- les noms des catégories ne sont pas traduisibles pour l'instant -- dans la bannière des catégories de la page. Notez que si ce lien apparaît en rouge dans les pages traduites, cela signifie que la catégorie n'a pas encore été traduite dans cette langue. Dans ce cas, traduisez directement la page de la catégorie à partir de l'anglais, plutôt que de créer une nouvelle page depuis ce lien.

Lorsqu'une catégorie est appelée dans une page, son nom affiché peut être traduit à l'aide de, où category_name (nom_catégorie) est le nom de la catégorie et translated_category_name (nom_traduit_catégorie) est le nom traduit de la catégorie.



Liens internes
Les liens internes sont de la forme, où page_name (nom_page) est le nom de la page appelée et displayed_text (texte_affiché) le texte affiché pour ce lien. Seul le texte dans displayed_text est traduisible. Cette forme code permet de rediriger vers une version traduite dans la langue de l'interface utilisateur de la page appelée -- si la traduction existe, sinon vers la page source en anglais.

Il est aussi possible d'utiliser le |modèle PageRedirect plutôt que la balise Special:MyLanguage (voir la section administrateur).



Liens externes
Les liens externes, c'est-à-dire qui redirige à l'extérieur du wiki, sont de la forme, où link (lien) est le lien externe, et displayed_text (texte_affiché) le texte affiché pour ce lien. S'il existe une traduction de la page appelée sur le site web, on peut modifier le lien pour rediriger vers la bonne langue, ou bien on peut ajouter la langue du site web après le lien. Par exemple, si la page source en anglais contient le lien, vous pouvez le traduire en français soit par  , soit par.

Si vous connaissez des sites web pertinents dans votre langue qui ne sont pas dans la page source en anglais, vous pouvez l'ajouter dans la page source avec la langue du site web entre parenthèses.



Fichiers & Images
Les fichiers et images peuvent contenir du texte qui peut être traduit. Le code correspondant est  où image_name (nom_image) est le nom de l'image avec son extension dans le wiki, caption (légende) le texte décrivant cette image. Durant la traduction, vous pouvez soit changer le fichier et le remplacer par une version traduite (pour cela, changer la partie  par le nom du nouveau fichier, voir comment importer des fichiers dans Guides du contributeur), ou bien laisser le même fichier et préciser la langue du fichier dans la légende si cela est pertinent.

La capture d'écran du menu principal dans le tableau d'aperçu ne doit pas être traduit, car c'est la disposition qui importe. Toutefois, si la disposition change entre les régions, la capture peut être changée, mais cela reste exceptionnel.

Attention ! Importer un fichier traduit comme si c'était un nouveau fichier, et ne modifiez par le fichier original ! Dans la légende du fichier traduit, précisez que c'est la traduction de tel fichier, avec un lien vers l'original. Exemple : Organigramme en français des jeux de chevaux.



Termes fixes
Parfois, un mot ou un nombre est précédé d’un dollar (par exemple  ou  ) et semble de ne pas avoir de lien avec le texte : ce sont des termes qui bloquent le texte correspondant dans la page source pour éviter qu'il ne soit traduit. Par exemple, cela peut contenir un lien ou un nombre qui reste identique entre les langues. Ces termes sont indiqués par la balise  dans le code de la page source.

Autres
Les éléments entre les flèches  et   sont nommés balises, et font parti du code wiki. Ils doivent être écrits tels quels dans la traduction pour garder le même format que la page source. La même chose s'applique pour les crochets  et double crochets.



Suivi des traductions
Toutes les pages modifiables sont traduisibles, que ce soient des pages classiques, des pages de catégories ou des modèles.

Toutes les pages marquées pour traduction sont indiquées ici.

L'état de traduction des messages est indiqué sur la page spéciale des statistiques de langue, en sélectionnant le code langue correspondant.

Cette page spéciale montre les langues actuellement actives sur le wiki, et les principaux contributeurs pour chacune d'elle.



Administrateurs de traduction
Les administrateurs de traduction vérifient et marquent les pages pour traduction une fois qu'elles sont complètes. Ils ajoutent les balises permettant la traduction au code de la page source autour des éléments à traduire (avec les balises ). Les balises de traduction peuvent être utilisées en plusieurs endroits, afin de permettre la traduction des éléments pertinentes (par exemple dans la légende d’une image ou dans les cellules d’un tableau au lieu de laisser les traducteurs reproduire tout le wikicode).

Ils ajoutent également le bandeau de langue (avec la balise ), et vérifient que le code est correct pour permettre une traduction optimale. Par exemple, ils vérifient entre autres que les titres sont bien séparés du reste du texte, que les paragraphes sont bien séparés, que les catégories et les liens internes sont correctement écrits, etc.

Après avoir été marquée pour traduction, une page est immédiatement disponible pour la traduction, mais cela peut prendre quelques minutes pour prendre en compte toutes les modifications (passage du bot de traduction FuzzyBot), en particulier si la page a déjà été traduite et qu'elle est à nouveau marquée pour traduction.



Unités de traduction ou messages
Chaque unité de traduction, appelée message, est indiquée par une balise  (où x est un nombre). Cette balise est ajoutée automatiquement par un bot, ne l'ajoutez pas vous-même. Toutefois, la balise peut être déplacée ou supprimée.

Attention ! Si une balise de traduction  est supprimée, le message correspondant sera également supprimée, même s'il y avait déjà des traductions pour ce message !

Catégories
Les pages de catégories sont traduisibles.

Les catégories sont écrites à l'aide du code  où category_name (nom_catégorie) est le nom de la catégorie. Elles ne sont pas normalement pas incluses dans les unités de traduction. Ce code génère automatiquement un lien vers une page traduite de cette catégorie, dans laquelle la page traduite est catégorisée. Ainsi, les pages sources étiquetées dans une catégorie voient leurs versions traduites étiquetées uniquement dans la page traduite correspondante de la catégorie. Par exemple, la page source How to translate est étiquetée dans la catégorie Wiki User Guide, tandis que sa version française est dans la Category:Wiki User Guide/fr qui est la version traduite de la catégorie.

Si un lien vers une catégorie est en rouge dans une page traduite, cela signifie que la page de la catégorie correspondante n'a pas encore été traduite. Dans ce cas, traduire plutôt la page de la catégorie depuis l'anglais plutôt que de créer un nouveau lien depuis la page traduite catégorisée.



Liens internes
Les liens internes au wiki doivent être écrits de la forme suivante, où page_name (nom_page) est le nom de la page appelée et displayed_text le texte affiché pour ce lien. La balise Special:MyLanguage redirige automatiquement vers la page page_name dans la langue de l'interface utilisateur, si la la version traduite existe, sinon vers la page source en anglais. Par exemple, ce lien redirige vers cette page dans la langue de votre interface utilisateur, plutôt que vers la page source en anglais ou vers la page traduite en français.

Les liens internes à une page sont de la forme  où key (clé) indique vers où le lien doit rediriger dans la page et displayed_text le texte affiché pour ce lien. La clé key est créée en utilisant les balises  à l'endroit de la page où le lien doit rediriger. Le lien créé redirige automatiquement vers la même page dans la même langue. Par exemple, ce lien redirige vers la section "Administrateurs de traduction" de cette page.

Il est possible d'utiliser le |modèle PageRedirect plutôt que la balise Special:MyLanguage. Au lieu de rediriger vers la langue de l'interface utilisateur, cela redirigera vers la langue de la page en cours (si cette page cible dans cette langue, sinon en anglais). A utiliser avec le code suivant : |displayed_text où  est le nom de la page cible du lien et   le texte affiché pour le lien. Pour les pages de catégories, veuillez mettre les deux-points juste avant le modèle ou le lien ne marchera pas.

Par exemple, |Page principale donen un lien vers la page principale, tandis que |Catégorie : Genre redirige vers la catégorie "Genre". Les codes correspondant sont : |Page principale |Catégorie : Genre



Fichiers & Images
Les fichiers et les images peuvent contenir du texte traduisible. Si cela vous semble pertinent, vous pouvez soit:
 * permettre la modification du nom du fichier pour appeler un autre fichier qui est la forme traduite du fichier original;
 * soit bloquer la traduction du fichier et permettre uniquement la traduction de la légende en utilisant les balises  autour du nom du fichier   (voir cette section), ou garder le nom du fichier en-dehors des balises.





Termes fixes
Il est possible d'empêcher la traduction de certains éléments en particulier. Pour cela utiliser simplement les balises  où zzzz est le contenu et xxx la clé. Le contenu sera affiché de manière identique sur toutes les pages (source et traduites), tandis que seulement $xxx sera affiché pour les traducteurs. Cela peut être utilisé pour bloquer des nombres, des liens externes, des noms de lien ou des noms de catégories par exemple.

Modèles
Les modèles peuvent être traduits comme des pages normales. Pour cela, utiliser des balises de traduction dans la page du modèle.

Attention. Les modèles déjà marqués pour traduction doivent être A NOUVEAU marqués pour traduction pour que les modifications soient prises en compte dans toutes les pages, même celles qui en sont pas traduites.

Dans les autres pages, la version traduite du modèle correspondant à la langue de la page traduite sera automatiquement affichée - si elle existe, sinon ce sera la version originale du modèle en anglais. Pour cela, il suffit de laisser simplement le code du modèle, où template_name (nom_modèle) est le nom du modèle, en-dehors des balises de traduction. Toutefois, si du texte mis dans les paramètres du modèle doit être traduit, il est possible de mettre les balises de traduction autour du texte à traduire dans les paramètres du modèle. Par exemple, le code suivant donne :

Pour générer le bon lien en fonction de langue dans les modèles de navigation, veuillez utiliser le modèle de redirection de page.



Mots magiques
Les mots magiques retournent une valeur spécifique :
 * donne le nom du site - ici 
 * donne soit le code langue source pour les unités non-traduites, soit le code langue cible pour les unités traduites - ici fr
 * donne soit la langue source pour les unités non-traduites, soit la langue cible pour les unités traduites - ici 

Plus d'informations sur les mots magiques pour la traduction sur MediaWiki.

Spoiler tag
The translate tags should be outside the spoiler tag. Indeed, if translate tags are inside spoiler tag and if there is also a table in the original page, the translated page will not be generated, even if the translation can be done.

Aide
Si vous souhaitez en apprendre plus sur la gestion de la traduction, veuillez lire l'aide MediaWiki consacrée :
 * Tutoriel de traduction
 * Tutoriel pour les administrateurs de traduction
 * Bonnes pratiques de traduction
 * Guide complet pour les administrateurs de traduction
 * ou demandez simplement de l'aide sur le Discord TMQ.

Des questions ?
Si vous avez des questions sur le sens d'une phrase, n'hésitez pas à créer une discussion pour la page. Plus généralement, si vous avez des questions sur le processus de traduction ou le sens des phrases, vous pouvez contacter les membres sur Discord TMQ.

Vous pouvez aussi utilisez la page de test comme un bac à sable pour tester le fonctionnement du wiki et de la traduction.