The Wayback Machine - https://web.archive.org/all/20050310052825/http://i18n.kde.org:80/translation-howto/index.html
 
KDE -         The K Desktop Environment

The KDE Translation HOWTO

The KDE Translation HOWTO

Thomas Diehl

Rewrite of the doc-translation part: Frank Schütte
Update of the GUI-translation part: Arash Zeini
Revision 1.6 (2001-7-5)

Please note: Only the part on doc translation has been updated lately, thanks to the work of Frank Schütte and due to the massive changes in this area which made the former doc section totally obsolete. An update of the GUI part was postponed. So there are some substantial new developments missing, esp. the new plural handling in GUI files. For information on the latter you still have to refer to the respective threads in the translators mailing list, mainly plural handling and plural handling again.

This HOWTO is meant for translation team coordinators, new translators, and everybody else interested in the subject. It gives a first overview of how new languages are introduced to KDE, and how the translations of the graphic user interface, the on-line help, and other KDE-related things are actually done. It also takes a closer look at resources available to assist translators in the process. Other important areas (e.g. how to compile KDE sources or how to find one's way around CVS) are referenced throughout. A current HTML version of this document can be found at i18n.kde.org/translation-howto. You can dowload the file in various formats. Have a look at http://i18n.kde.org/sitedoc.html. To contribute, comment, or correct, please send email to thd@kde.org, for the doc translation part to F.Schuette@t-online.de.


Table of Contents

1. Introduction
2. Bringing a New Language to KDE
First Things First...
Taking a Look at Available Resources and CVS
Starting the Actual Translation
Localization Issues
Where to Go From Here: Some Practical Hints
Getting Credit for Your Work
3. GUI Translation
POT and PO Files
To-do Lists for GUI Translation
Step by Step: The Translation of POTs and POs
Peculiarities and Difficulties
Using Specialized Programs for GUI Translation
KTranslator
KBabel
(X)Emacs in PO Mode
Checking and Committing Your Work
Syntax Check: msgfmt --statistics
Checking for Missing Variables and Other Problems
Compilation, Context and Accelerator Checks
Committing Your Work to CVS
4. Doc Translation
Conversion from SGML to XML/PO Format
General Requirements for Doc Translation
POT and PO Files Used for Documentation
To-do Lists for Doc Translation
Step by Step: The Translation of Documentation Files
Peculiarities and Difficulties
Checking and Committing Your Work
Checking the Markup and the Spelling
What to Do with Translated and Corrected Documentation?
5. Bug Reports and User Feedback: Handling and Translating
Handling Translation Bugs
Submitting Bug Reports
Closing Bug Reports
Followup Messages
Handling Non-English User Feedback
6. Web Site Translation and Design
Web Sites for Internal Use
Web Sites for KDE Users
7. Appendix: Tools and Resources for KDE Translators
The i18n Server
CVS, CVSUP, WebCVS...
Mailing Lists, IRC, and On-line Fora
Web and FTP Sites
Files
Statistics
HOWTOs and Info Sites
Specialized Programs and Modules
...for GUI Translation
...for Doc Translation
Dictionaries and Tools for Consistency Checking
8. Acknowledgements