Development/Easy Hacks/Translation Of Comments
From The Document Foundation Wiki
Easy Hack - Translate Comments from German to English
You find the description of this Easy Hack in the corresponding report.
Because we want to avoid double work, you should write on this site, in which directories of /core you are translating comments.
Note the special instructions in the Patch Handling Guidelines regarding translation patches.
| Directory in libs-core | Who is working on it? | Status |
|---|---|---|
| avmedia | - | no comments found |
| basic | Andreas Mantke | work in progress |
| comphelper | Tom Thorogood | done |
| connectivity | Tom Thorogood | done |
| cppuhelper | Tom Thorogood | done |
| configmgr | - | no comments found |
| cui | Tom Thorogood | in progress |
| desktop | Albert Thuswaldner | done, see [[1]] |
| editeng | Albert Thuswaldner | done, see [[2]] |
| eventattacher | Rob Snelders | done |
| formula | Adrián Cereto |
done |
| fpicker | Michael Münch | done |
| idl | Michael Münch | done |
| linguistic | Rob Snelders | done |
| sfx2 | Albert Thuswaldner | done, see [[3]] |
| svx/inc | Wolfgang Silbermayr | work in progress, see [[4]] |
| ucb | Rob Snelders | done |
| uui | Albert Thuswaldner | done, see [[5]] |
| vbahelper | Rob Snelders | done |
| Directories other than libs-core | Who is working on it? | Status |
|---|---|---|
| writer/sw/inc | Christoph Herzog | work in progress |
| writer/sw/source/ui | Martin Kepplinger | work in progress |
| impress/sd/source/core | Samuel Mehrbrodt | work in progress |
| sw/source/core/doc | Philipp Weissenbacher | DONE! |
| vcl | Michael Bohlender | work in progress |
Getting started
There is a script in core/bin/ called find-german-comments, that helps you find German comments. Be sure to download the directory text_cat as well.
Here is an example on how to use it:
~/git/libreoffice/rawbuild/starmath$ ~/git/libreoffice/bin/find-german-comments -v > german-comments.txt processing file 'inc/action.hxx'... processing file 'inc/applicat.hxx'... processing file 'inc/config.hxx'... (...)
The file german-comments.txt will contain the file names and line numbers where German comments were found. You can run the script in any directory and it'll check the hxx/cxx files under that directory recursively (this can be handy in large modules, as guessing the language of a comment takes some time). If you want only the file names, use the -f option instead of -v.
Note that it only checks comments that are 4 characters or longer, which might miss some. Also, logging messages are not detected yet. You can translate them as well.
If you have problems with the script, poke vmiklos.
If you want to save some time, there is now a text document listing all of the directories containing German comments so that you don't have to parse through the entire core. Because this may be out of date, double check the above table before assigning yourself to a directory to make sure nobody else is working on it or has already completed it. It's a good place to start if you're not sure where to go hunting down the comments.