Add TRANSLATING guide.

Adapted from http://wiki.archlinux.org/index.php/AUR_Translation

Signed-off-by: Loui Chang <louipc.ist@gmail.com>

1 files changed, 79 insertions, 0 deletions

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 <all edited files>
+$ 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 <all edited files>
+$ 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.
+