aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorfilip <filip.komar@gmail.com>2013-10-31 22:58:05 +0100
committerfilip <filip.komar@gmail.com>2013-10-31 22:59:09 +0100
commit004b991f5e03c437d5b5ab78d775604a3210c22d (patch)
tree667dcb50be0ce6e7b010d86294ccfcca28655f95 /README
parent3051d584e8b6b2b48b1f9bf7ba4fac8bef2c1ee6 (diff)
downloadtools-004b991f5e03c437d5b5ab78d775604a3210c22d.tar
tools-004b991f5e03c437d5b5ab78d775604a3210c22d.tar.gz
tools-004b991f5e03c437d5b5ab78d775604a3210c22d.tar.bz2
tools-004b991f5e03c437d5b5ab78d775604a3210c22d.tar.xz
tools-004b991f5e03c437d5b5ab78d775604a3210c22d.zip
change of check_for_translation_work.sh script and it's db for git transition NOTE: add git_directory in your existing config file
Diffstat (limited to 'README')
-rw-r--r--README56
1 files changed, 45 insertions, 11 deletions
diff --git a/README b/README
index f6bd6348..8cdd4dd7 100644
--- a/README
+++ b/README
@@ -1,26 +1,42 @@
+NEWS
+2013/10/31
+added support for git NOTE: you need to add git_directory variable in your ~/.mageia-i18n-config file
+added creation of list_of_resources_for_translation.txt with statistics
+added support for *.desktop
+added support for doc team resources
+removed support for mga2 since it's EOL is almost here
+added creation of working copy of po resource
+
FEATURES
-it's very configurable
+-support for git
-support for many types of svn checkout: anonymous (default), user or ssh key authentication
+-support for doc team resources
-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
+-it operates on list of translatable resources in git (including web pages)
+-automatic update of list of translatable resources
+-git and svn clone/checkout or pull/update as needed on every single resource
+-create and show a list of resources with untranslated and fuzzy strings with statistics (numbers of translated, fuzzy and untranslated strings)
+-checking the syntax of po file from git if required
+-checking the syntax of pot file from git if required
+-copying the *.pot file, *.po file, *.desktop file and web page files for editing in working directory if required
+-creation of working copy of po resource 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
+-searching for new *.pot files in svn (TODO also search from git)
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.
+Please put script check_for_translation_work.sh in your home directory ~/bin or create a symlink to it from git directory. 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 svn resource and git commit & push will be unavailable to you. See wiki for details how to do that.
+
+At least you need to adjust following setings in configuration file named .mageia-i18n-config that has been made in your home directory on the first run of the script.
Set this according to your language code:
language_code=sl
-Adjust svn and working translations directories
+Adjust svn, git and working translations directories
svn_directory= default is /home/user/Mageia/i18n/svn
+git_directory="/home/user/Mageia/i18n/git" # added after git transition
working_translations_directory= default is /home/user/Mageia/i18n/translations
choose anonymous svn method if you don't need commit access:
@@ -31,12 +47,30 @@ svn_method="svn+ssh://"
Other options should be obvious by its name or comment.
+USAGE
+
+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.
+
TODO
-better configurability of messages shown (only what work needs to be done and no message for up to date projects)
+add support for html files
+check the html resources on list of translatable resources
+add searching for new *.pot files and other resources in git
+better configurability of messages shown
better documentation
+# version of script
+# svn info:
+# git remote -v
+
+# searching for new resources
+# svn list -R:
+# git ls-files or git whatchanged
+
+# commit message of script
+# svn log -r:
+# git log --after=<date>
-SVN TIP
+TIPS SECTION
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