Hi all;
I've just set up a new project to fill in some missing translations in the docbook stylesheets. These stylesheets are a set of XML templates used to produce documentation, and are especially important for Fedora docs because our documentation tool (Publican) relies on them. For example, the names of elements like "Chapter", "Appendix", "Example", and "Table" in Publican documents come from docbook.
The project is located here: https://translate.fedoraproject.org/projects/docbook-locales/master/
In some ways, translating these stylesheets should be pretty easy — each po file contains only around 200 words, most of them very common.
However, almost each of these words is in a separate string by itself without any context. In most cases, the lack of context shouldn't be a problem; for example, words like "Book", "Author", or "January" are self-explanatory. Where it looks like context might be a problem, I've included comments in the PO file that should be visible in whatever software you use to do your translations. If anything is still unclear, or you think that I could have explained something better, please ask! I'd be very grateful for your feedback and suggestions.
One further point to be aware of is that the docbook stylesheets often include different versions of a word with different capitalisation. For example, there are separate entries for "warning", "Warning", and "WARNING". If your language distinguishes between upper- and lower-case letters, please pay careful attention to the English capitalisation and follow it as appropriate for your language. Of course, if your language doesn't have different cases for characters, then you can just use the same translation to represent all the differently-capitalised English words.
Thanks in advance for anyone who can help out with this! (And thanks to Piotr who took Polish from around 60% to 100% before I even sent out this email!)
Cheers Ruediger
Ruediger Landmann wrote:
Hi all;
I've just set up a new project to fill in some missing translations in the docbook stylesheets. These stylesheets are a set of XML templates used to produce documentation, and are especially important for Fedora docs because our documentation tool (Publican) relies on them. For example, the names of elements like "Chapter", "Appendix", "Example", and "Table" in Publican documents come from docbook.
The project is located here: https://translate.fedoraproject.org/projects/docbook-locales/master/
Thank you so much Rudi for: - providing contextual information in the translation files - getting xml2po conversion done and providing translator friendly PO format - spending time working with upstream DocBook project to convince them accept translations from fedorahosted translations
I think this is one of the few projects I have worked with, where author is taking proactive approach for getting things done and making localizers' job easier and smooth. Thanks again Rudi. :)
* Now, there is one process we might want to understand. basically, the process going to be followed from the point *translator submits translations in PO format to fedorahosted: http://git.fedorahosted.org/git/?p=docbook-locales.git;a=tree;f=po* to *translations reach upstream in xml format: http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/gentext/locale/ * The reason behind understanding this process is, we would like to know "how much time it could take to get your translations upstream from the time you submit it through transifex?". That's the basic question we may face from translators often.
* and another doubt I had, how are we going to work with upstream (DocBook, not Fedora - downstream) translators? Actually, this question should have come in the very beginning, somehow it just got missed. :(