JDOC

Translating Links/fr: Difference between revisions

From Joomla! Documentation

MATsxm (talk | contribs)
Created page with "Liens de page ordinaires <pre> Component doit être traduit par <{cette partie est la traduction}> ou Component doit être traduit par Sp..."
MATsxm (talk | contribs)
No edit summary
Line 32: Line 32:
=== Traducteurs ===
=== Traducteurs ===


A setting in documentation has made it easier with an short alias to "Special:" in links. You may use "S:" instead of "Special:" in a link, <code>[[S:MyLanguage/...</code>.
Un paramétrage dans la documentation permet de remplacer le "Special:" dans les liens pour un alias plus court. Ainsi, il est possible d'utiliser dans un lien "S:" à la place de "Special:" <code>[[S:MyLanguage/...]]</code>.


Liens de page ordinaires
Liens de page ordinaires

Revision as of 21:58, 4 March 2014

Lier les pages traduites est essentiel pour offrir une bonne navigation entre les pages à nos utilisateurs. C'est le moyen le plus efficace pour inviter l'utilisateur à visiter une autre page pour obtenir plus d'informations sur un sujet. La traduction de ces liens doit être réalisée d'une manière spécifique afin qu'un utilisateur puisse naviguer dans la langue de son choix. Si une personne consulte notre documentation dans une langue en particulier, ils souhaitent pouvoir naviguer dans la même langue. Proposer un lien vers une page en anglais est bien entendu envisageable cependant, l'utilisateur doit pouvoir consulter un lien dans sa propre langue.

Introduction

La traduction des liens doit suivre un certain processus afin de permettre au visiteur de naviguer d'une page à l'autre dans la même langue. Les rédacteurs en langue anglaise peuvent également suivre le même format. Il sera plus facile pour les traducteurs de travailler sur des liens correctement crées.

Avec un lien normal de type [[Component]], un utilisateur qui cliquera sur le lien sera dirigé vers la page Component. Si il existe une version traduite de la page, par exemple en français, la page française sera alors : [[Component/fr]].

Que ce passe-t-il si la page Component/fr n'a pas encore été créée ? L'utilisateur verra alors un 'lien en rouge' (cette page n'existe pas) contrairement au 'lien bleu' (page existante). Peut être que la page Composant sera traduite mais ce n'est pas le cas pour le moment (si le lien est rouge). C'est la raison pour laquelle le préfixe Special:MyLanguage/ doit TOUJOURS être utilisé pour la page à lier.

[[Component]] doit être écrit de la façon suivante : [[S:MyLanguage/Component|Composant]]
 ou
[[Component]] doit être écrit de la façon suivante : [[Special:MyLanguage/Component|Composant]]

Comment "Special:MyLanguage" fonctionne avec les Liens

Qu'est-ce que Special:MyLanguage/ signifie ? Cette commande permet le traitement d'un lien dès l'instant où il est cliqué et avant que la page soit renvoyée à l'utilisateur. En prenant la page Component pour exemple :

  • L'utilisateur a demandé le lien Special:MyLanguage/Component
  • Je récupère la langue de l'utilisateur (ou celle de la page actuellement consultée).
  • Je l'ai ! L'utilisateur consulte la page en français donc fr est le code de langue.
  • Voyons si le lien cliqué pour 'Component' existe en français. J'y ajoute donc /fr.
    • Oui, la page Component/fr existe ! J'envoie donc l'utilisateur vers la page de la version française.
    • Non, la page Component/fr n'existe pas ! J'envoie donc l'utilisateur vers la page par défaut utilisant la langue source.
  • J'affiche la bonne page à l'utilisateur.

Application pratique

Traducteurs

Un paramétrage dans la documentation permet de remplacer le "Special:" dans les liens pour un alias plus court. Ainsi, il est possible d'utiliser dans un lien "S:" à la place de "Special:" S:MyLanguage/....

Liens de page ordinaires

[[Component]] doit être traduit par [[S:MyLanguage/Component|<{cette partie est la traduction}>]]
 ou
[[Component]] doit être traduit par [[Special:MyLanguage/Component|<{cette partie est la traduction}>]]

Namespaced page links

[[JDOC:Translating Links]] should be written as [[S:MyLanguage/JDOC:Translating Links|<{translate this only}>]]
 or
[[JDOC:Translating Links]] should be written as [[Special:MyLanguage/JDOC:Translating Links|<{translate this only}>]]

Category page links:

[[:Category:Glossary_definitions]] should be written as [[S:MyLanguage/:Category:Glossary_definitions|<{translate this only}>]]
 or
[[:Category:Glossary_definitions]] should be written as [[Special:MyLanguage/:Category:Glossary_definitions|<{translate this only}>]]

English Page Writers and Editors

All the above in the Translators section applies to English version page writers and copy editors. You can help with translations by creating page links in English version pages using Special:MyLanguage/ or S:MyLanguage/ too! A page doesn't need to be marked for translation or even in the process of being translated. As pages are added to the translation queue, translators will have an easier time translating the links on a page.