FaqGuide and pot

[matthew.east.ubuntu at breathe.com]

Claude Paroz writes: 

> Hi, 
> 
> I realize there is still much to do with translation of Docbook
> documents (eg FaqGuide), at least with the xml2po utility. 
> 
> Two things I just came upon : 
> 
> 1. xreflabels aren't included in the pot file. That leads to something
> like (in French) : "Voir Where can I download Ubuntu? pour les sites de
> téléchargement."

You're right, this is indeed a fault with xml2po afaics. 

> 2. Some entity are expanded when creating the pot file. By example,
> &ubuntu; is expanded to <phrase>Ubuntu</phrase>. Then, when the
> translated po is merged back, xml2po cannot match the original text with
> the msgid, resulting in a non translated string. Or maybe I did
> something false ?

This is intentional: you need to pass -e with xml2po when making the 
translated xml file. We will be downloading the translations from Rosetta 
and generating these xml files on our repository after the release, so you 
can get them from there. 

> Hopefully these issues will be resolved in a future version of
> gnome-doc-utils. Until then, I fear we'll still need to manually tweak
> the resulting files. 
> 
> Meanwhile I'll try to produce a corrected HTML French version to put it
> on the Loco website. What is the best way to produce an HTML output from
> XML ?

Not sure. You might get some help from the Makefile at gnome/ in our 
repository.