From 60d63cc6b71fd470dca444169e05c9d0f5e5013c Mon Sep 17 00:00:00 2001 From: Loui Chang Date: Mon, 19 Jan 2009 16:38:29 -0500 Subject: Add TRANSLATING guide. Adapted from http://wiki.archlinux.org/index.php/AUR_Translation Signed-off-by: Loui Chang --- TRANSLATING | 79 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 TRANSLATING diff --git a/TRANSLATING b/TRANSLATING new file mode 100644 index 00000000..4137413f --- /dev/null +++ b/TRANSLATING @@ -0,0 +1,79 @@ +AUR Translation +================ + +This document describes how to create and maintain AUR translations. +It was derived from http://wiki.archlinux.org/index.php/AUR_Translation + +Creating an AUR translation requires python and git to be installed. + +Translation files should be gzipped to protect from possible encoding +errors when submitting. + +Patches should be sent to the aur-dev mailing list at: +aur-dev@archlinux.org + + +Creating a New Translation +--------------------------- + +Before beginning, please make sure that git and python are installed. +Also, please do not translate if you are unwilling to maintain or find +someone to maintain the translation. This is due to the fact that the +AUR is a rapidly evolving project and there are constantly new strings +to be translated. If the translations get too out of sync with the +released versions, there will be too many untranslated strings for the +translation to be usable, and it may have to be disabled. + +1. Check out the AUR source using git. + +$ git clone git://projects.archlinux.org/aur.git aur-git + +2. Go into the AUR source and run translation_tool. + translation_tool will interactively guide you through the translation + process, simply answer its questions and prompts. If you wish to stop + at some point during the translation, you may kill translation_tool + using Ctrl+C. If you later wish to continue the translation, simply + run translation_tool again, and it will continue from where you left off. + +$ cd aur-git +$ git checkout -b testing origin/testing +$ cd web/lang +$ ./translation_tool + +3. To commit your patch to your branch: + +$ git add +$ git commit -s + +4. Create a git formatted patch. + +$ git format-patch origin/master + +5. Send the gzipped patch to the aur-dev mailing list. + + +Updating an Existing Translation +--------------------------------- + +1. Update your copy of the AUR code. + +$ cd aur-git +$ git pull + +2. Run translation_tool, which will only prompts for strings that have + changed or been added since the last translation. + +$ cd web/lang +$ ./translation_tool + +3. To commit your patch to your branch: + +$ git add +$ git commit -s + +4. Create a git formatted patch. + +$ git format-patch origin/master + +5. Send the gzipped patch to the aur-dev mailing list. + -- cgit v1.2.3-24-g4f1b