Debian
Debian-France
Debian-Facile
Debian-fr.org
Forum-Debian.fr
Debian ?
Communautés
Vous n'êtes pas identifié(e).
L'icône rouge permet de télécharger chaque page du wiki visitée au format
PDF et la grise au format ODT →
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
doc:mentors:mentors [24/11/2019 06:06] Texou |
doc:mentors:mentors [06/12/2023 14:43] (Version actuelle) vv222 [Aider les utilisateurs] Suppression d’une mention de Freenode |
||
|---|---|---|---|
| Ligne 16: | Ligne 16: | ||
| ===== Rapporter des bugs (débutant) ===== | ===== Rapporter des bugs (débutant) ===== | ||
| + | * Voir le tuto [[https://debian-facile.org/doc:systeme:reportbug|Reportbug]] | ||
| * Voir: https://www.debian.org/Bugs/Reporting | * Voir: https://www.debian.org/Bugs/Reporting | ||
| * Pour les non-anglophones qui voudraient reporter un bug, vous pouvez passer sur le forum et demander de l'aide à la traduction :-) | * Pour les non-anglophones qui voudraient reporter un bug, vous pouvez passer sur le forum et demander de l'aide à la traduction :-) | ||
| Ligne 22: | Ligne 23: | ||
| * Pour les anglophones pas trop sûr d'eux qui voudraient traduire une page du wiki, proposez ça sur le forum, on le fera à plusieurs :-) | * Pour les anglophones pas trop sûr d'eux qui voudraient traduire une page du wiki, proposez ça sur le forum, on le fera à plusieurs :-) | ||
| + | |||
| + | * Les discussions se passent sur la liste de diffusion https://lists.debian.org/debian-l10n-french/ | ||
| + | |||
| + | * Vous pouvez aussi rejoindre l'équipe via IRC sur #debian-l10n-french sur le serveur OFTC. | ||
| + | |||
| + | * Veuillez noter que Debian fonctionne par compromis, consensus et respect mutuel. Si toute suggestion est bienvenue, il faut respecter le traducteur, car nombreux sont ceux qui y travaillent d'arrache pied depuis près de dix ans. Leur engagement mérite le respect et, avant d'opérer des changements, de comprendre le pourquoi de quelque chose. Certains changements, quoique de bonnes idées, sont à mesurer car ils impliquent une mise en cohérence d'une masse énorme de choses. Il faut donc bien en discuter. | ||
| + | |||
| + | * La bonne pratique est donc de se conformer aux pratiques, de ne pas refaire du travail mais de traduire les choses non faites, et de ne pas imposer ses idées. Chez Debian, ça marche au consensus, toujours. | ||
| + | |||
| ====== En quoi ça consiste ? ====== | ====== En quoi ça consiste ? ====== | ||
| Ligne 35: | Ligne 45: | ||
| Cette section est une suite de recommandations faite par un développeur Debian qui a cherché son chemin durant quinze ans dans la traduction du projet, avant de trouver la voie menant à une contribution épanouissante et effective. Elle vous recommande des étapes dans l'ordre pour ne pas perdre en motivation, chose facile vu la masse du travail et le peu de monde qui le fait. | Cette section est une suite de recommandations faite par un développeur Debian qui a cherché son chemin durant quinze ans dans la traduction du projet, avant de trouver la voie menant à une contribution épanouissante et effective. Elle vous recommande des étapes dans l'ordre pour ne pas perdre en motivation, chose facile vu la masse du travail et le peu de monde qui le fait. | ||
| - | * Commencer par traduire la description des paquets : ça se passe ici: https://ddtp2.debian.net/ddtss/index.cgi/fr | + | * Commencer par traduire la description des paquets : ça se passe ici: https://www.debian.org/international/l10n/ddtp.fr.html |
| - | L'équipe doit traduire près de 60 000 descriptions, or on en est à 20 000 environ. L'avanage est qu'une contribution peut durer entre 1 minute et 1 journée, selon vos envies, votre temps. Vous n'êtes pas frustré en "laissant du travail en plan", car toute traduction (même courte) est une contribution. | + | |
| - | Pour aider, créez-vous un compte, relisez les paquets en souffrance, et traduisez. Commencez par traduire ceux auxquels vous pensez (généralement, ceux installé sor son PC et qui sont en anglais et pour lesquels on se dit "hmmm ça serait bien de le traduire". Quand vous êtes à cours d'idée, demandez qu'un paquet vous soit attribué automatiquement, l'outil vous les envoie par ordre de priorité. | + | L'équipe doit traduire près de 60 000 descriptions, or on en est à 20 000 environ. L’avantage est qu'une contribution peut durer entre 1 minute et 1 journée, selon vos envies, votre temps. Vous n'êtes pas frustré en "laissant du travail en plan", car toute traduction (même courte) est une contribution. |
| + | |||
| + | Pour aider, créez-vous un compte, relisez les paquets en souffrance, et traduisez. Commencez par traduire ceux auxquels vous pensez (généralement, ceux installé sur son PC et qui sont en anglais et pour lesquels on se dit "hmmm ça serait bien de le traduire". Quand vous êtes à cours d'idée, demandez qu'un paquet vous soit attribué automatiquement, l'outil vous les envoie par ordre de priorité. | ||
| Une fois traduit, vous n'avez plus qu'à attendre qu'il soit relu. Au bout d'une relecture, puis une deuxième (qui peut être la vôtre), la traduction est publiée. | Une fois traduit, vous n'avez plus qu'à attendre qu'il soit relu. Au bout d'une relecture, puis une deuxième (qui peut être la vôtre), la traduction est publiée. | ||
| Ligne 50: | Ligne 61: | ||
| Il vous reste à traiter la pièce jointe. Il s'agit d'un fichier qu'on ouvre avec un éditeur de PO, format utilisé pour faciliter la traduction. Avec un éditeur de fichiers PO, vous identifiez facilement les chaînes non traduites, celles à revoir suite à une mise à jour (fuzzy), celles traduites. | Il vous reste à traiter la pièce jointe. Il s'agit d'un fichier qu'on ouvre avec un éditeur de PO, format utilisé pour faciliter la traduction. Avec un éditeur de fichiers PO, vous identifiez facilement les chaînes non traduites, celles à revoir suite à une mise à jour (fuzzy), celles traduites. | ||
| - | Une fois la traduction terminée, répondez à votre mail en changeant l'objet par RFR. Un échange de suggestions commence avec les autres membres de l'équipe. Envoyez-leur le fichier, la différence (générée par la commande patch) avec l'original, pour les aider à relire. Ils vous renverront des fichiers .diff vec leurs propositions, que vous pouvez appliquer à votre traduction automatiquement. Une fois le retour traité, relancez une phase de relecture avec l'objet RFR2. Quand vous estimez que c'est prêt, lanez une dernière passe avec l'objet LCFC. Laissez, selon la longueur du fichier à traduire, au moins une semaine avant de franchir une étape RFR - LCFC. | + | Une fois la traduction terminée, répondez à votre mail en changeant l'objet par RFR. Un échange de suggestions commence avec les autres membres de l'équipe. Envoyez-leur le fichier, la différence (générée par la commande diff) avec l'original, pour les aider à relire. Ils vous renverront des fichiers .diff vec leurs propositions, que vous pouvez appliquer à votre traduction automatiquement. Une fois le retour traité, relancez une phase de relecture avec l'objet RFR2. Quand vous estimez que c'est prêt, lanez une dernière passe avec l'objet LCFC. Laissez, selon la longueur du fichier à traduire, au moins une semaine avant de franchir une étape RFR - LCFC. |
| Quand le travail est terminé, vous pouvez utiliser un script d'envoi automatique de rapport de bug au responsable du paquet, incluant votre patch, lequel met à jour la traduction. | Quand le travail est terminé, vous pouvez utiliser un script d'envoi automatique de rapport de bug au responsable du paquet, incluant votre patch, lequel met à jour la traduction. | ||
| Ligne 56: | Ligne 67: | ||
| Notez que si vous avez déjà traduit, vous recevrez, par le coordinateur, un mail dont l'objet est MAJ et qui vous invite à mettre à jour votre traduction. | Notez que si vous avez déjà traduit, vous recevrez, par le coordinateur, un mail dont l'objet est MAJ et qui vous invite à mettre à jour votre traduction. | ||
| - | * Une fois à l'aise, localisez les paquets Debian : un foux similaire s'applique pour traduire les fichiers PO de paquets spécifiques à Debian. L'objet des mails commence cette fois par po://. Ne changez jamais l'objet du mail, en-deors de la partie entre crochets. | + | * Une fois à l'aise, localisez les paquets Debian : un flux similaire s'applique pour traduire les fichiers PO de paquets spécifiques à Debian. L'objet des mails commence cette fois par po://. Ne changez jamais l'objet du mail, en-dehors de la partie entre crochets. |
| + | |||
| + | * Sortons un peu des sentiers battus : les pages de man | ||
| + | |||
| + | Les pages de manuel sont les écrans que vous obtenez en tapant "man commande". C'est là que vous trouvez la description de la commande et sa syntaxe, ses options et autres éléments utiles. Ce projet s'appelle aussi parfois po4a. | ||
| + | |||
| + | Pour des raisons historiques, la traduction de cette ressource a depuis longtemps été récupérée par Debian qui, pour ce sujet, travaille aussi bien pour elle que pour toutes les distributions. Contribuer à ce projet, c'est donc contribuer à plus que Debian. | ||
| + | |||
| + | Pour voir l'état d'avancement du projet, commencez ici: https://manpages-l10n-team.pages.debian.net/manpages-l10n/debian-unstable-fr.html | ||
| + | |||
| + | Quand vous avez choisi une page de man, vérifiez qu'elle n'est pas déjà entre les mains d'un traducteur ici: | ||
| + | https://l10n.debian.org/coordination/french/fr.by_translator.html | ||
| + | |||
| + | Récupérez les "sources" du paquet ici: | ||
| + | https://salsa.debian.org/manpages-l10n-team/manpages-l10n | ||
| + | |||
| + | Nous vous recommandons de cloner le dépôt pour faciliter votre synchronisation. | ||
| + | |||
| + | Envoyez pour cela à la liste debian-l10n-french un message ITT en spécifiant l'URL: po4a://manpages-fr/nom_du_paquet/po/fr.po et les stats affichées par votre éditeur de PO. Par exemple: [ITT] po4a://manpages-fr/cat/po/fr.po 1f | ||
| + | |||
| + | La suite ressemble à la traduction des paquets ou écrans de configuration. De manière générale, il est sécurisé d'envoyer, pour RFR et LCFC, une archive tar contenant le diff, la VO et votre fichier modifié. | ||
| + | |||
| + | Quand vous considérez que le processus de relecture est terminé, répondez à votre LCFC pour solliciter la liste afin qu'un membre publie le résultat. Il répondra avec un message commençant par [DONE]. | ||
| + | |||
| + | Quand vous aurez de l'expérience, vous pourrez demander à être ajouté sur le groupe manpages-l10n (après avoir créé un compte salsa). Vous aussi pourrez alors modifier le paquet directement, sans déroger au process ci-dessus pour garantir la qualité et l'homogénéité des traductions. | ||
| * Vous êtes expérimenté, lancez-vous dans la documentation : même processus | * Vous êtes expérimenté, lancez-vous dans la documentation : même processus | ||
| Ligne 68: | Ligne 103: | ||
| ===== Aider les utilisateurs ===== | ===== Aider les utilisateurs ===== | ||
| - | * Pour l'entre-aide, vous avez le choix. Ici bien ûr, sur le forum. Ou sur la liste de diffusion dédiée: https://lists.debian.org/debian-user-french/ | + | * Pour l'entre-aide, vous avez le choix. Ici bien sûr, sur le forum. Ou sur la liste de diffusion dédiée: https://lists.debian.org/debian-user-french/ |
| - | * Enfin, IRC est un centre d'aide important. #debian-facile, #debian-fr sur le serveur freenode, ou #debian-fr sur oftc. | + | * Enfin, IRC est un centre d'aide important. #debian-facile ou #debian-fr sur oftc. |
| ===== Aider à la maintenance du site web ===== | ===== Aider à la maintenance du site web ===== | ||
