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

Re: some issues in docs.fedoraproject.org

(Repeating some comments because I just realised that this morning I replied only to the docs-list, not to trans-list as well... and merging some of your comments from two separate emails)

On 10/06/2009 06:15 AM, Domingo Becker wrote:
The new docs.fp.o interface seems to be faster than the later one to
reach an online book.

Thanks! :) Congratulations go to Ryan Lerch for the fantastic redesign :)

But some translations seems to have got lost in the process of the
move from the old interface.

No books were actually changed; only the main index page. Therefore, any errors in any books were already there. In the case of the Installation Guide, since 19 June [1]; and in the case of the Installation Quick Start Guide, since 6 August [2].

The books are:

1. Installation Guide for F11

2. Installation quick start guide for F11

The strings with no translations are some of the index

Entries in the indexes of Publican books come directly from the titles of chapters and sections; entries appear in English in the index of the Spanish books because, unfortunately, they also appear in English in the chapters and sections themselves: for example, look at the headings on these pages:




These missing strings are sadly the result of the complicated process that we must follow at the moment to merge all of Publican's many small PO files together into one big PO file for Transifex, then splitting the big PO file back into many small PO files to build in Publican. Let's look at the first example: "7.11. Language Selection"

Here is the XML file that holds the English title: http://git.fedorahosted.org/git/docs/install-guide.git?p=docs/install-guide.git;a=blob;f=en-US/Language_Selection_common-title.xml;h=5e94d8ec79f5f3b39000f3dfe81f4da53ace95d2;hb=485b0213fdb3ce7433852ff64870fc0a8072d729

Publican transforms this whole XML file into a POT file ("make update-pot"): http://git.fedorahosted.org/git/docs/install-guide.git?p=docs/install-guide.git;a=blob;f=pot/Language_Selection_common-title.pot;h=22a75944da222d27af9782cd50f201fcb3ac51dc;hb=485b0213fdb3ce7433852ff64870fc0a8072d729

And then into a PO file for Spanish ("make update-po-es-ES"): http://git.fedorahosted.org/git/docs/install-guide.git?p=docs/install-guide.git;a=blob;f=es-ES/Language_Selection_common-title.po;h=ee5def09d6442d5eeb4f79f372d0dffaad092114;hb=485b0213fdb3ce7433852ff64870fc0a8072d729 -- note that Publican has matched this string as a fuzzy with an (incorrect) other string that it found elsewhere.

The Installation Guide contains several hundred separate PO files. To make the book available in Transifex, we have to merge them together into one big PO file. In the Docs project, we have been using (for example) "msgcat -u -o es.po *.po" within Publican's es-ES directory to prepare these big PO files.

However, for some reason, some strings get lost sometimes. If you look at the es.po file generated with this method, you will see that this string is missing: http://git.fedorahosted.org/git/docs/install-guide.git?p=docs/install-guide.git;a=blob;f=po/es.po;h=6f9c7c2c16711d9f4fc476e058d448721f47f052;hb=485b0213fdb3ce7433852ff64870fc0a8072d729 -- I would expect to find it around line 16096, but it isn't there... :(

Please file a bug against the Fedora 11 Installation Guide so that we have a record that this happened.

If anyone knows of a more reliable method or tool to merge the many small PO files into a single, big PO file, please say so!

I also seem to recall seeing problems in the other direction; some strings that were translated in the big PO files were sometimes lost while splitting them into many small PO files -- I can't think of an example right now, but someone else might remember?

and the common content.

As far as I can tell. the only part of the Common Content that ever appeared in English was the Legal Notice, which always appears in English, for legal reasons. Was there something else wrong?

On 10/06/2009 06:56 AM, Domingo Becker wrote:
The new option "autostep --autoscreenshot" in the kickstart file would
probably make it ease to get the localized screenshots included in the
Install Guide.

Don't hesitate to ask translators to get those screenshots.

Thanks! I'll probably need some of that help when the F12 Beta becomes available.

For Fedora 11 Install Guide they are all in English. We can improve that. :-)

Actually, no, the F11 Installation Guide screenshots were all localised (to the extent that anaconda itself was). I remember taking something like 60 screenshots per language in around 40 languages... Take a browse through the test builds here: http://rlandmann.fedorapeople.org/Installation%20Guide/

Of course, the degree of localisation depends on the degree of localisation in anaconda. For example, the text of this screen appears in English:


But if you notice the "AtrĂ¡s" and "Siguiente" buttons, you will see that this is actually a Spanish installation of Fedora. Hopefully, this is fixed in Fedora 12.... :)

Of course, with so many screenshots and so many languages, it's quite possible I made some mistakes here and there. For example, I just realised that I used the wrong screenshot for the "Keyboard selection" screen in Spanish, and have fixed this -- the changes should appear on the website the next time that the server synchronises with the docs repo. If you notice any other wrong images, please let me know on f-t-l, f-d-l, in email, or in a bug -- there are lots of ways to reach me ;)

Kind regards, and thank you, as always for the amazing work that you guys do. Sorry that our tools are still letting you down sometimes.



[1] http://cvs.fedora.redhat.com/viewvc/web/html/docs/install-guide/f11/es-ES/html-single/index.html?root=fedora&view=log

[2] http://cvs.fedora.redhat.com/viewvc/web/html/docs/installation-quick-start-guide/index.php?root=fedora&view=log

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