Le 3 septembre 2012 00:05, David Prévot <da...@tilapin.org> a écrit : > Le 02/09/2012 17:44, Stéphane Blondon a écrit : >> Proposition de réalisation : >> - la première page garderait l'explication sur la façon d'utiliser >> son client mail, les sections « Exemples » et « Autres », et >> pointerait vers la seconde. >> - la seconde récupérerait les infos disponibles en plus dans la >> première concernant les détails à propos des états ainsi que les >> projets concernés. > > Ça semble pas mal dit comme ça, merci.
Après modification puis corrections de la version anglaise sur la liste d-l10n-en, voici les fichiers pour relecture : - les fichiers diff comparent la version francophone actuellement en cours et les modifications que je propose ; - pseudo-urls.fr.wml et format.wml sont les versions complètes incluant mes modifs ; - pseudo-urls.en.wml est la version englophone avec mes modifications et les (nombreuses) corrections sur la liste d-l10n-en. Bon week-end, -- Imprimez ce message en A2 et en couleur au moins 500 fois! Brûlez des arbres!! -- envoyé depuis ma centrale à charbon Stéphane
format.wml.stephane.diff
Description: Binary data
pseudo-urls.fr.wml.stephane.diff
Description: Binary data
#use wml::debian::template title="Coordination of l10n teams" <h1>Pseudo-URLs</h1> <p> The program that listens to debian-l10n-* lists understands pseudo-URLs in the subject header. The pseudo-URLs need to have the following form. </p> <div class="center"><code>[<state>] <type>://<package>/<file></code></div> <p> The <i>state</i> must be one of the following: TAF, MAJ, ITT, RFR, LCFC, BTS#<bug number>, DONE, or HOLD. </p> <dl> <dt> <tt>TAF</tt> (<i>Travail À Faire</i>) </dt> <dd> Sent by a <strong>coordinator</strong> (not by a random list member) to indicate that there is a document that needs to be worked on. </dd> <dt> <tt>MAJ</tt> (<i>Mise À Jour</i>) </dt> <dd> Sent by a <strong>coordinator</strong> (not by a random list member) to indicate that there is a document that needs to be updated and that the work is reserved for the previous translator. </dd> <dt> <tt>ITT</tt> (Intent To Translate) </dt> <dd> Sent to register a claim on a translation; used to avoid double work.<br /> </dd> <dt> <tt>RFR</tt> (Request For Review) </dt> <dd> An initial draft translation is attached. Others on the list are requested to check it for errors and send a reply (possibly off-list if they found no flaws).<br /> Further RFRs may follow if substantial changes have been made. </dd> <dt> <tt>ITR</tt> (Intent To Review) </dt> <dd> Used to avoid LCFCs being sent when there are reviews pending.<br /> Mainly used when you expect your review not to be ready for several days (because the translation is big, or you don't have any time before the weekend, etc.)<br /> The mail body should contain an indication of when to expect the review.<br /> Note that ITR pseudo-URLs are ignored by the spider.<br /> </dd> <dt> <tt>LCFC</tt> (Last Chance For Comment) </dt> <dd> Indicates that translation is finished, with changes from the review process incorporated, and that it will be sent to the appropriate place.<br /> Can be sent when there are no ITRs, and discussion following the last RFR has ended for a few days.<br /> Should not be sent before there has been at least one review. </dd> <dt> <tt>BTS#<bug number></tt> (Bug Tracking System) </dt> <dd> Used to register a bug number once you have submitted the translation to the BTS.<br /> The spider will regularly check if an open bug report has been fixed or closed. </dd> <dt> <tt>DONE</tt> </dt> <dd> Used to close a thread once the translation has been dealt with; useful if it has not been sent to the BTS. </dd> <dt> <tt>HOLD</tt> </dt> <dd> Used to put a translation on hold when there's a danger that any work done now may be wasted, for example when problems have been found that require changes in the original text. </dd> </dl> <p> The <i>type</i> can be anything indicating the type of the document, such as po-debconf, debian-installer, po, po4a, or wml. </p> <p> <i>package</i> is the name of the package that the document comes from. Please use <i>www.debian.org</i> or nothing for the WML files of the Debian web site. </p> <p> <i>file</i> is the filename of the document; it can contain other information to uniquely identify the document, such as the path to the file. It's usually a name like <i>lc</i>.po where <i>lc</i> is the language code (e.g.: <i>de</i> for German, or <i>pt_BR</i> for Brazilian Portuguese). </p> <p> The structure of <i>file</i> depends on the chosen type, and of course the language. In principle it's just an identifier, but since it's used on these web pages to track the status of translations, it's strongly recommended to follow the scheme given below. </p> <ul> <li><code>debian-installer://package-name/path-in-sourcepackage/lc.po</code> (for the installer)</li> <li><code>ddp://document/filename.po</code> (for Debian documentation)</li> <li><code>xml://installation-guide/lang/path-in-sourcepackage/file.xml</code> (for the installation guide)</li> <li><code>po://package-name/path-in-sourcepackage/lc.po</code> (for classical po file)</li> <li><code>po-debconf://package-name/lc.po</code> (for installer configuration interface)</li> <li><code>po4a://package-name/path-in-sourcepackage/lc.po</code> (for documentation converted to po format)</li> <li><code>wml://path_under_language_name_in_CVS</code> (for web site pages)</li> </ul> <p> The BTS state is somewhat special; it registers a bug number so the l10n-bot can track the status of the translation once submitted to the BTS by checking whether any of the open bug reports have been closed. Thus for instance the debian-l10n-spanish list might use: </p> <div class="center"><code>[BTS#123456] po-debconf://cups/es.po</code></div> <p> If you intend to translate a lot of packages, you can ITT them all at once. An example (for the debian-l10n-danish list): </p> <div class="center"><code>[ITT] po-debconf://{cups,courier,apache2}/da.po</code></div> <p> So put the packages between braces and separate them with commas. No extra spaces! </p>
#use wml::debian::template title="Le format des messages" <p>Le nombre de messages sur la liste étant assez important et les sous-projets variés, nous donnons des titres spéciaux à nos messages pour pouvoir sélectionner facilement ceux qui nous intéressent. Les principes généraux sont expliqués ici, veuillez vous reporter à chaque <a href="index#sous-projets">sous-projet</a> pour les nuances pouvant apparaître.</p> <h3>Format classique du sujet des messages</h3> <p>Avec le temps, nous sommes arrivés à un formalisme que tout le monde semble trouver suffisant et utile. Ces titres sont analysés par un robot, les résultats sont disponibles pour la traduction française sur la <a href="http://l10n.debian.org/coordination/french/fr.by_translator.html">page de coordination</a>. Essayez donc de ne pas vous tromper lorsque vous utilisez ce format. Si cela arrivait, ce n'est évidemment pas la fin du monde. Il suffit d'envoyer immédiatement un <tt>[done]</tt> contenant l'erreur, suivi du message corrigé.</p> <p>Le titre d'un message doit contenir quatre informations :</p> <h4><a name="etat"></a>L'état du document</h4> <p>Certains de ces états ne sont applicables que pour une partie des sous-projets (par exemple, la marque [bts] ne concerne pas le site web). Lisez bien les instructions spécifiques à chacun de ces sous-projets pour comprendre les différences.</p> <p>Les différents états sont détaillés sur une <a href="http://www.debian.org/international/french/format">page spécifique</a>. <br /> Les marques d'état peuvent être indifféremment en minuscules ou en majuscules.</p> <p>Ces différents états sont chronologiques et certains clients de messagerie gèrent parfaitement les fils de discussion. Il faut donc toujours essayer de répondre à l'ancien message en y changeant le sujet. Pour plus de précision, voici un exemple de ce qu'il ne faut pas faire et de ce qu'il faut faire.</p> <p>Ce qu'il ne faut pas faire : Envoyer un nouveau message à chaque nouvel état. Les (bons) clients de messagerie afficheront alors :</p> <ul> <li>...</li> <li>[taf] wml://www.debian.org/index.wml</li> <li>...</li> <li>[itt] wml://www.debian.org/index.wml</li> <li>...</li> <li>[rfr] wml://www.debian.org/index.wml <ul><li>Re: [rfr] wml://www.debian.org/index.wml</li></ul> <ul><li>Re: [rfr] wml://www.debian.org/index.wml</li></ul> </li> <li>...</li> <li>[lcfc] wml://www.debian.org/index.wml <ul><li>Re: [lcfc] wml://www.debian.org/index.wml</li></ul></li> <li>...</li> <li>[done] wml://www.debian.org/index.wml</li> <li>...</li> </ul> <p>Chaque nouvel envoi pourra être entrecoupé par d'autres messages au sujet complètement différent, ce qui complique la gestion du même fichier.</p> <p>Ce qu'il faut faire : Toujours répondre à un ancien message, en changeant le sujet si nécessaire (ceci n'est valable que pour la gestion d'un même fichier, pour un nouveau fichier, il conviendra d'envoyer un nouveau message).</p> <ul> <li>...</li> <li>[taf] wml://www.debian.org/index.wml <ul><li>[itt] wml://www.debian.org/index.wml <ul><li>[rfr] wml://www.debian.org/index.wml <ul><li>Re: [rfr] wml://www.debian.org/index.wml <ul><li>[lcfc] wml://www.debian.org/index.wml <ul><li>Re: [lcfc] wml://www.debian.org/index.wml <ul><li>[done] wml://www.debian.org/index.wml</li></ul> </li></ul> </li></ul> </li></ul> <ul><li>Re: [rfr] wml://www.debian.org/index.wml</ul></li></ul> </li></ul> </li> <li>...</li> </ul> <h4>Le sous-projet concerné</h4> <p>Chaque sous-projet est désigné dans le titre par un pseudo-protocole (par exemple <tt>ddp://</tt>). La liste est détaillée sur la <a href="http://www.debian.org/international/french/format">page des états</a>.</p> <p>Les équipes de traduction sont libres d'ajouter des sous-projets su cela leur semble nécessaire. Cependant ils ne seront pas pris en compte par le robot. En plus des sous-projets commun, l'équipe francophone utilise : <ul> <li><tt>di-manuel://</tt> désigne le manuel d'installation ;</li> <li><tt>man://</tt> désigne les pages de manuel ;</li> </ul> </p> <h4>Le paquet concerné</h4> <p>Dans le cas de la documentation, il s'agit de <tt>manuals.sgml</tt> et dans le cas du site web, de <tt>www.debian.org</tt>. Pour les autres sous-projets, il s'agit du paquet auquel le fichier traduit est rattaché.</p> <h4>Le document</h4> <p>La pseudo-URL est complétée par le chemin complet (répertoire et nom du fichier) où trouver le document original.</p> <h3>Exemples</h3> <ul> <li>Pour traduire la page web <tt>http://www.debian.org/devel/index</tt>, envoyez un message dont le sujet sera : <tt>[itt] wml://www.debian.org/devel/index.wml</tt> ;</li> <li>Pour demander une relecture du fichier po du paquet dpkg, envoyez un message dont le sujet sera : <tt>[rfr] po://dpkg/po/fr.po</tt> ;</li> <li>Pour signaler que la traduction du fichier po du questionnaire Debconf du paquet apt-build se trouve dans le système de suivi des bogues et que le numéro du bogue est le 290244, envoyez un message dont le sujet sera : <tt>[bts] po-debconf://apt-build/fr.po #290244</tt>.</li> </ul> <h3>Autres</h3> Quelques autres marques sont également utilisées à certains moments. Elles ne sont pas lues par les robots, donc le format est nettement moins strict. Cependant, en les utilisant, vous permettez à tout le monde de savoir précisément de quoi parle votre message. En voici quelques-unes : <dl> <dt>[dico] <var>un_mot</var></dt> <dd> Le mot <var>un_mot</var> pose problème. Vous demandez des avis éclairés aux personnes de la liste. </dd> <dt>[vac] <var>JJ</var>/<var>MM</var>/<var>AAAA</var> - \ <var>JJ</var>/<var>MM</var>/<var>AAAA</var></dt> <dd>Vous serez indisponible entre les deux dates indiquées dans le sujet. Il est très important de le signaler lorsque vous êtes responsables de documents importants, pour que quelqu'un d'autre puisse faire sans hésiter les mises à jour nécessaires.</dd> <dt>[hs] <var>titre quelconque</var> </dt> <dd>Votre message n'a pas grand chose à voir avec la localisation de Debian en français, mais vous estimez qu'il peut intéresser suffisamment de personnes sur la liste pour y être envoyé. Vous signalez donc que votre message est hors sujet. </dd> </dl>
#use wml::debian::template title="Coordination des équipes de localisation" #use wml::debian::translation-check translation="1.1" maintainer="David Prévot" <h1>Format des messages</h1> <p> Le programme qui suit les listes de coordination comme debian-l10n-french est capable de comprendre des pseudo-URL du sujet. Les sujets doivent être de la forme suivante : </p> <div class="center"><code>[<état>] <type>://<paquet>/<fichier></code></div> <p> L'<i>état</i> peut prendre une des valeurs suivantes : TAF, MAJ, ITT, RFR, LCFC, BTS#<numéro de bogue>, DONE ou HOLD. </p> <dl> <dt> <tt>TAF</tt> (<i>Travail À Faire</i>) </dt> <dd> Envoyé par un <strong>coordinateur</strong> de la liste (et non un simple participant) pour indiquer qu'un document est à traduire. </dd> <dt> <tt>MAJ</tt> (<i>Mise À Jour</i>) </dt> <dd> Envoyé par un <strong>coordinateur</strong> de la liste (et non un simple participant) pour indiquer qu'un document est à mettre à jour par le précédent traducteur. </dd> <dt> <tt>ITT</tt> (<q>Intent To Translate</q>, intention de traduire) </dt> <dd> Envoyé pour indiquer que vous avez l'intention de traduire le document, pour éviter que quelqu'un d'autre ne travaille dessus en même temps. </dd> <dt> <tt>RFR</tt> (<q>Request For Review</q>, demande de relecture) </dt> <dd> Une première version de la traduction est ajoutée en pièce jointe du message. Les autres membres de la liste sont invités à la vérifier pour signaler les erreurs. <br /> D'autres RFR peuvent suivre pour partager le fichier à jour des dernières modifications. <br /> Remarque : envoyez une réponse, éventuellement hors liste, si vous avez vérifié le fichier et n'avez pas trouvé de défauts. </dd> <dt> <tt>ITR</tt> (<q>Intent To Review</q>, intention de relire) </dt> <dd> Pour éviter qu'un LCFC soit envoyé pendant une relecture est en cours. <br /> Surtout utilisé si vous avez l'intention d'envoyer une relecture mais qu'elle ne sera pas prête avant quelques jours (parce que la traduction est grosse ou que vous n'avez pas le temps avant quelques jours par exemple). <br /> Le corps du message devrait indiquer une date approximative de relecture. <br /> Remarquez que cet état n'est pas considéré par le robot. </dd> <dt> <tt>LCFC</tt> (<q>Last Chance For Comment</q>, dernier appel à commentaires) </dt> <dd> Indique que la traduction est terminée, que les modifications du processus de relecture ont été intégrées et que la traduction va être envoyée à l'endroit approprié. <br /> Peut être envoyé s'il n'y a pas d'ITR et que la discussion suivant le RFR est terminée depuis quelques jours. <br /> Ne devrait pas être envoyé avant d'avoir reçu au moins une relecture. </dd> <dt> <tt>BTS#<numéro de bogue></tt> (<q>Bug Tracking System</q>, système de gestion des bogues) </dt> <dd> Utilisé pour enregistrer un numéro de bogue une fois la traduction au BTS envoyée. <br /> Le robot vérifiera régulièrement l'état du rapport de bogue. </dd> <dt> <tt>DONE</tt> (terminé) </dt> <dd> Utilisé pour fermer un fil quand la traduction a été prise en compte, utile si elle n'a pas été envoyée au BTS. </dd> <dt> <tt>HOLD</tt> (mise en attente) </dt> <dd> Utilisé pour mettre une traduction en attente, par exemple si d'autres modifications sont attendues. Il n'est donc pas nécessaire de mettre à jour la traduction tout de suite, car elle serait probablement inutile. </dd> </dl> <p> Le <i>type</i> permet d'indiquer le type de document, comme po-debconf, debian-installer, po, po4a ou wml. </p> <p> <i>paquet</i> est le nom du paquet d'où vient le document. Veuillez utiliser <i>www.debian.org</i> ou rien du tout pour les fichiers WML du site web. </p> <p> <i>fichier</i> est le nom de fichier du document, qui peut contenir d'autres renseignements pour l'identifier de façon unique, comme le chemin complet vers le fichier. C'est en général fr.po pour le français. </p> <p> La structure de <i>fichier</i> dépend du type choisi, et bien sûr de la langue. En principe, c'est juste un identifiant, mais puisqu'il est utilisé pour mettre à jour les pages d'état de cette section, il est fortement recommandé de suivre les schémas suivantes. </p> <ul> <li><code>debian-installer://nom_de_paquet/arborescence_dans_le_code_source/fr.po</code></li> <li><code>ddp://document/fichier.po</code> (pour la documentation Debian)</li> <li><code>xml://installation-guide/lang/chemin-dans-le-paquet-source/fichier.xml</code> (pour le guide d'installation)</li> <li><code>po://nom_de_paquet/arborescence_dans_le_code_source/fr.po</code> (pour les fichiers po classiques)</li> <li><code>po-debconf://nom_de_paquet/fr.po</code></li> <li><code>po4a://nom_de_paquet/arborescence_dans_le_code_source/fr.po</code> (pour la documentation convertie au format po)</li> <li><code>wml://chemin_dans_le_répertoire_french_du_dépôt_CVS</code> (pour les pages du site web)</li> </ul> <p> L'état BTS est un peu particulier, il est utilisé pour enregistrer un numéro de bogue, ce qui permet au robot de suivre l'état de la traduction envoyée au BTS : il vérifiera si les rapports de bogue ont été fermés. Par exemple : </p> <div class="center"><code>[BTS#123456] po-debconf://cups/fr.po</code></div> <p> Si vous avez l'intention de traduire plusieurs paquets, vous pouvez envoyer un seul ITT pour tous, par exemple : </p> <div class="center"><code>[ITT] po-debconf://{cups,courier,apache2}/fr.po</code></div> <p> Le développement des accolades fonctionne comme dans bash(1), mais est limité à une paire. </p>