Maintenir les traductions à jour

Comme les pages web ne sont pas statiques, c'est une bonne idée de garder une trace de la version de l'original auquel une certaine traduction se réfère, et d'utiliser cette information pour trouver quelles pages ont été modifiées depuis la dernière traduction. Cette information devrait être visible au début du document (mais après toutes les autres commandes « #use ») sous cette forme :

#use wml::debian::translation-check translation="git_commit_hash"

git_commit_hash est l’empreinte numérique du commit de Git qui référence le fichier original (anglais) à traduire. Les détails de ce commit particulier peuvent être obtenus en utilisant l’outil git show : git show <git_commit_hash>. Si vous utilisez le script copypage.pl dans le répertoire webwml, la ligne translation-check est ajoutée automatiquement à la première version de votre traduction de page, pointant vers la version du fichier original existant à ce moment.

Quelques traductions peuvent ne pas être mises à jour depuis un certain temps, même si la version originale (anglaise) a été modifiée. À cause de la négociation de contenu, le lecteur des pages traduites peut ne pas être au courant de ce point, et passer à côté d’informations importantes, ajoutées dans de nouvelles versions du document original. Le module translation-check contient des instructions pour regarder si la traduction est obsolète, et produit un message d’avertissement approprié l’utilisateur.

D'autres paramètres peuvent aussi être utilisés sur la ligne translation-check :

original="langue"
langue est le nom de la langue du document original, si ce n'est pas l'anglais. Le nom doit correspondre au répertoire sous la racine utilisé dans le VCS et au nom déclaré dans le fichier languages.wml.
mindelta="nombre"
qui définit la différence maximale entre les numéros de révisions de Git avant que la traduction ne soit considérée comme plus jour. La valeur par défaut est 1. Pour les pages moins importantes, vous pouvez le mettre à 2, il faut alors deux changements dans l'original avant que la traduction ne soit marquée comme n'étant plus à jour.
maxdelta="nombre"
qui définit la différence maximale entre les numéros de révisions de Git avant que la traduction ne soit considérée comme dépassée. La valeur par défaut est 5. Pour les pages très importantes, il faut le diminuer. Une valeur de 1 implique que chaque changement marque la traduction comme obsolète.

Le suivi de l’âge des traductions nous permet d’avoir des statistiques de traduction, un rapport de toutes les pages dont la traduction n'est plus à jour (avec des liens montrant les différences entre les révisions des fichiers), ainsi que celles qui n'ont jamais été traduites. Le but est d'aider les traducteurs et d'attirer de nouvelles recrues.

Pour éviter de présenter des informations trop dépassées à nos utilisateurs, les traductions qui n'ont pas été mises à jour dans les six mois après la modification de la page d'origine sont automatiquement supprimées. Veuillez consulter la liste des pages périmées pour trouver quelles pages sont sur le point d'être supprimées.

De plus, le script check_trans.pl est disponible dans le répertoire webwml, qui affichera les pages devant être mises à jour :

check_trans.pl langue

langue est le nom du répertoire qui contient la traduction, par exemple « french ».

Les pages qui ne sont pas traduites seront marquées comme « Missing nom_fichier », et les pages qui ne sont pas à jour comme « NeedToUpdate nom_fichier to version XXXXXXX ».

Si vous voulez voir les changements exacts, vous pouvez récupérer les différences en ajoutant l'option -d à la commande ci-dessus.

Si vous voulez ignorer les avertissements sur des pages manquantes (par exemple les pages d'anciennes nouvelles), vous pouvez créer un fichier appelé .transignore dans le répertoire où vous voulez supprimer ces avertissements, qui liste les fichiers que vous n'allez pas traduire, avec un nom par ligne.

Un script similaire pour suivre les modifications des traductions des descriptions des listes de diffusion est également disponible. Veuillez lire les commentaires dans le script check_desc_trans.pl pour la documentation.