Contents

Getting started

Translating GRAMPS' documentation into a new language is a long, tedious, and boring process, just like with any complex text :-)

Since GRAMPS version 3.0 the documentation was moved completely to this wiki. So for translation you don't need to use or even install any fancy applications to help us. You can use your browser and start immediately. Just go to the User Manual page, click on your language. You should could keep the english manual open to check if there is a help page missing.

The general wiki help page will help you editing wiki pages. This wiki uses the MediaWiki software, which is the same that is used by Wikipedia, so it could feel familiar.

Translating

Screenshots

Figures: localized screenshots are nice in the localized manual

If you can provide figures on your own this is great. Upload them to this wiki with the following naming convention: figure_name_zz.png (zz is your language code). If the figure is language independent just call it figure_name.png.

A command to take screenshots that works for me, is by using imagemagick (should be installed with every linux distribution, if not, get it):

Links to wiki manual

To have your recently translated manual available from within GRAMPS. You need to activate the manual by editing the following file: display.py to contain your language code, you may also contact the developers of Gramps by opening a Feature request for the new language on the Bug tracker.

On line 32 of that file, you see:

MANUALS = {
'nl' : '/nl',
}

This maps a language code to the extension used on the wiki, so to add french, change this to:

MANUALS = {
'nl' : '/nl',
'fr' : '/fr',
}

Every 'manual|...' entry in the gramp.pot file refers to a section in the manual, so make sure to use good section headings so this does not change too much over time.

Note that reports/tools link to a section in the page with the same name as the report name in GRAMPS.

You should be able to edit directly on wiki or using tools like txt2po.

Also previous gettext file for the manual and Translation Memory may help you to upgrade deprecated/old gettext files.