From ab10760878c7a26916bf4b7c2a32230234c2483a Mon Sep 17 00:00:00 2001 From: filip Date: Sat, 7 Dec 2013 18:43:07 +0100 Subject: expanded usage --- README | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) (limited to 'README') diff --git a/README b/README index 01a01a47..2856f356 100644 --- a/README +++ b/README @@ -56,11 +56,26 @@ svn_method="svn+ssh://" Other options should be obvious by its name or comment. -USAGE +USAGE OF THE SCRIPT First time after your configuration the script will need some time to clone all the needed git repos. Just wait a bit. It will be much faster next time as it will only need to pull the changes from git since your last run. The script can show the differences from the last run by default but you can switch that off in your config. Script will show the list of resources for translation (with fuzzy and untranslated strings) on the end. +In working directory script will create/update subdirectories with the following files: +1. Translation catalog xxx.pot file, which can be used for Localize or msgmerge ("msgmerge xxx.pot_lang.po xxx.pot > new_lang.po"). +2. Translation file lang.po is there as it's safer for script not to overwrite your translation file if you run it before you pushed that translation. +It's also useful for comparison. +3. Working copy of translation file xxx.pot_lang.po is the one to work on. Downside of additional file is that you have to rename it before commit/push. +4. If there is new_pot_lang.po file present in your current subdirectory you should replace existing file xxx.pot_lang.po with it before translation. If you're not sure how old that file is use msgmerge. + + + +TRANSLATION AND COMMIT +A. It's safer and conveniant to translate file xxx_lang.po in working directory, +B. merge ("msgmerge xxx.pot_lang.po xxx.pot > new_lang.po") and check your translation ("msgfmt -o /dev/null --statistics --check xxx_lang.po"), +C. copy the file xxx_lang.po to git directory with the name lang.po and +D. commit it. + TODO add searching for new *.pot files and other resources in git -- cgit v1.2.1