[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: adding infos to pseudo-urls.wml



Hi,

Le 17/09/2012 17:20, Stéphane Blondon a écrit :
> 2012/9/17 Justin B Rye <jbr@edlug.org.uk>:

>> [...]
>>> <li><tt>di-manuel://lang/path-in-sourcepackage/file.xml</tt> (for installation manual)</li>
>>                                                                    ^the
>> Is it really "di-manuel" rather than "di-manual"?
> 
> 
> I added the word 'the'.
> I searched in the archive and there are lot of mails with "d-i-manuel"
> and none with "di-manual". So I just added the missing minus between
> 'd' and 'i'.

There is little value documenting some specifics only used in the French
mailing list that doesn't follow the usual guidelines. The
installation-guide is available in a Debian package, and its translation
is available with po4a. If some translators still prefer editing
directly the XML files, the following syntax could be advised:

	xml://installation-guide/lang/path-in-sourcepackage/file.xml

(but I'm not sure this specific documentation should encourage
translation directly in XML files, so maybe this line should be dropped
anyway).

The following patch only wrap long lines in the beginning (as
recommended by our guidelines [0]). Changing the <ul> <li> stuff in <dd>
<dt> makes it harder to read the initial diff, but since the page is
only translated in French for the moment, that's not a big deal.

	0: http://www.debian.org/devel/website/htmlediting#general

I also changed [itt] to [ITT] in the ITT paragraph: even if the spider
doesn't care about case, documenting everything uppercase makes it
easier to follow IMHO.

I used <code> instead of <tt> for the last examples for consistency,
used xml instead of d-i-manuel as explained above, dropped the man
example (po4a is now the preferred way to indicate them) and edited the
ddp one: s/chapter/document/ since there are many different documents in
the DDP.

Furthermore, all DDP document are also available in packages (except
obsolete ones), so I'm not sure it should be documented either (I
intentionally dropped it from the first draft of this page), and for the
above reason, I'm not even sure it's worth documenting here.

Likewise, I guess all d-i stuff are packaged, so they can be tracked as
any other package with the po-debconf or even po type. Christian may
enlighten us if the d-i type is of any use for some status pages (I
doubt it, while po, po4a and po-debconf are).

Regards

David

diff --git a/english/international/l10n/pseudo-urls.wml b/english/international/l10n/pseudo-urls.wml
index ee68841..77bc475 100644
--- a/english/international/l10n/pseudo-urls.wml
+++ b/english/international/l10n/pseudo-urls.wml
@@ -19,19 +19,29 @@ TAF, MAJ, ITT, RFR, LCFC, BTS#&lt;bug number&gt;, DONE, or HOLD.
   <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>
+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
+  <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 indicate that you plan to work on the translation; used to
+  <dd>
+Sent to indicate that you plan to work on the translation; used to
 	    avoid double work.<br />
-	If you send an <tt>[itt]</tt> message and somebody else send another [itt] for the same file, please send a new message immediately on the mailing list to remind him you have the priority. The goal is to avoid useless work.</dd>
+	If you send an <tt>[ITT]</tt> message and somebody else send
+another [ITT] for the same file, please send a new message immediately
+on the mailing list to remind him you have the priority. The goal is to
+avoid useless work.
+  </dd>
   <dt>
     <tt>RFR</tt> (Request For Review)
   </dt>
@@ -85,7 +95,8 @@ TAF, MAJ, ITT, RFR, LCFC, BTS#&lt;bug number&gt;, DONE, or HOLD.
   </dt>
   <dd>
 	Used to put a translation on hold, for example when more changes
-	    are due (if there is errors about translation in the package or the translation is available somewhere else).<br />
+	    are due (if there is errors about translation in the package or
+the translation is available somewhere else).<br />
 	The goal of this status is to avoid unuseful work.
   </dd>
 </dl>
@@ -118,9 +129,8 @@ it's strongly recommended to follow the scheme given below.
 
 <ul>
 <li><code>debian-installer://package-name/path-in-sourcepackage/lc.po</code> (for the installer)</li>
-<li><tt>ddp://chapter/filename.po</tt> (for Debian documentation)</li>
-<li><tt>d-i-manuel://lang/path-in-sourcepackage/file.xml</tt> (for the installation manual)</li>
-<li><tt>man://package-name/path-in-sourcepackage/file.po</tt> (for manpages)</li>
+<li><code>ddp://document/filename.po</tt> (for Debian documentation)</li>
+<li><code>xml://installation-guide/lang/path-in-sourcepackage/file.xml</tt> (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>

Attachment: signature.asc
Description: OpenPGP digital signature


Reply to: