Contents of /i18n-tools/README

FEATURES
-it's very configurable
-support for many types of svn checkout: anonymous (default), user or ssh key authentication
-it logs all important actions
-it operates on list of "translation projects" in svn (including web pages)
-svn checkout or update as needed on every single project
-verbose checking for fuzzy and untranslated strings or just statistics (numbers of translated, fuzzy and untranslated strings) if required
-checking the syntax of po file from svn if required
-checking the syntax of pot file from svn if required
-copying the *.pot file, *.po file and web page files for editing in working directory if required
-testing for differences of *.po file from working copy if required
-testing for differences of *.pot file from working copy if required
-searching for new *.pot files in svn

INSTALATION AND CONFIGURATION

Please put script check_for_translation_work.sh in your home directory ~/bin. That way it will be in your PATH so you can call it from any directory. After first run please adjust file ~/.mageia-i18n-config to suit your needs. Remember to upload your public ssh key to mageia identity! Otherwise the script will prompty you for password everytime for every resource. See wiki for details how to do that.

Set this according to your language code:
language_code=sl

Adjust svn and working translations directories
svn_directory= default is /home/user/Mageia/i18n/svn
working_translations_directory= default is /home/user/Mageia/i18n/translations

choose anonymous svn method if you don't need commit access:
svn_method="svn://"

otherwise choose public ssh key svn access:
svn_method="svn+ssh://"

Other options should be obvious by its name or comment.

TODO
better configurability of messages shown (only what work needs to be done and no message for up to date projects)
better documentation


SVN TIP
How to svn co single file (file.pot):
svn checkout $url_of_big_dir $target_dir --depth=empty
svn up $target_dir/$file_you_want
1	FEATURES
2	-it's very configurable
3	-support for many types of svn checkout: anonymous (default), user or ssh key authentication
4	-it logs all important actions
5	-it operates on list of "translation projects" in svn (including web pages)
6	-svn checkout or update as needed on every single project
7	-verbose checking for fuzzy and untranslated strings or just statistics (numbers of translated, fuzzy and untranslated strings) if required
8	-checking the syntax of po file from svn if required
9	-checking the syntax of pot file from svn if required
10	-copying the .pot file, .po file and web page files for editing in working directory if required
11	-testing for differences of *.po file from working copy if required
12	-testing for differences of *.pot file from working copy if required
13	-searching for new *.pot files in svn
14
15	INSTALATION AND CONFIGURATION
16
17	Please put script check_for_translation_work.sh in your home directory ~/bin. That way it will be in your PATH so you can call it from any directory. After first run please adjust file ~/.mageia-i18n-config to suit your needs. Remember to upload your public ssh key to mageia identity! Otherwise the script will prompty you for password everytime for every resource. See wiki for details how to do that.
18
19	Set this according to your language code:
20	language_code=sl
21
22	Adjust svn and working translations directories
23	svn_directory= default is /home/user/Mageia/i18n/svn
24	working_translations_directory= default is /home/user/Mageia/i18n/translations
25
26	choose anonymous svn method if you don't need commit access:
27	svn_method="svn://"
28
29	otherwise choose public ssh key svn access:
30	svn_method="svn+ssh://"
31
32	Other options should be obvious by its name or comment.
33
34	TODO
35	better configurability of messages shown (only what work needs to be done and no message for up to date projects)
36	better documentation
37
38
39	SVN TIP
40	How to svn co single file (file.pot):
41	svn checkout $url_of_big_dir $target_dir --depth=empty
42	svn up $target_dir/$file_you_want