external/aurweb
0
0
Fork 0
mirror of https://gitlab.archlinux.org/archlinux/aurweb.git synced 2025-02-03 10:43:03 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update "TRANSLATING" with gettext and Transifex instructions.

Browse source 
Signed-off-by: Lukas Fleischer <archlinux@cryptocrack.de>
This commit is contained in:
Lukas Fleischer 2011-04-10 14:40:37 +02:00
parent 3a5693166c
commit 8bca269b81
1 changed files with 33 additions and 58 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

91
TRANSLATING
View file

@ -1,89 +1,64 @@
AUR Translation AUR Translation
================ ================
This document describes how to create and maintain AUR translations. This document describes how to create and maintain AUR translations. It was
It was derived from http://wiki.archlinux.org/index.php/AUR_Translation originally derived from http://wiki.archlinux.org/index.php/AUR_Translation
Creating an AUR translation requires python and git to be installed. Creating an AUR translation requires a Transifex (http://www.transifex.net/)
account. You will need to register with a translation team on the AUR project
Translation files should be gzipped to protect from possible encoding page (http://www.transifex.net/projects/p/aur/).
errors when submitting. Tarring is not necessary.
You will need to register on the mailing list before submitting:
http://mailman.archlinux.org/mailman/listinfo/aur-dev
Patches should be sent to the aur-dev mailing list at:
aur-dev@archlinux.org
Creating a New Translation Creating a New Translation
--------------------------- ---------------------------
Before beginning, please make sure that git and python are installed. Before beginning, please sign up for an Transifex account and request the
Also, please do not translate if you are unwilling to maintain or find addition of a new translation team for the AUR project. Also, please do not
someone to maintain the translation. This is due to the fact that the translate if you are unwilling to maintain or find someone to maintain the
AUR is a rapidly evolving project and there are constantly new strings translation. This is due to the fact that the AUR is a rapidly evolving project
to be translated. If the translations get too out of sync with the and there are constantly new strings to be translated. If the translations get
released versions, there will be too many untranslated strings for the too out of sync with the released versions, there will be too many untranslated
translation to be usable, and it may have to be disabled. strings for the translation to be usable, and it may have to be disabled.
1. Check out the AUR source using git. 1. Check out the AUR source using git:
$ git clone git://projects.archlinux.org/aur.git aur-git $ git clone git://projects.archlinux.org/aur.git aur-git
2. Go into the AUR source and run translation_tool. 2. Go into the "po/" directory in the AUR source and run msginit(1) to create a
translation_tool will interactively guide you through the translation initial translation file from our translation catalog:
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 $ cd aur-git
$ git checkout master $ git checkout master
$ git pull $ git pull
$ cd web/lang $ cd po
$ ./translation_tool $ msginit -l <locale> -o <locale>.po -i aur.pot
3. Add a line for the new translation in web/lib/config.inc.proto 3. Use some editor or a translation helper like poedit to add translations:
4. Add an entry in the AUTHORS file.
5. To commit your patch to your branch: $ poedit <locale>.po
$ git add <all edited files> 5. If you have a working AUR setup, add a line for the new translation in
$ git commit -s "web/lib/config.inc.proto" and test if everything looks right.
Write your commit message above the sign off and separate them by a 6. Upload the newly created ".po" file to Transifex. If you don't like the web
blank line. interface, you can also use transifex-client to do that (see below).
6. Create a git formatted patch.
$ git format-patch origin/master
7. Send the gzipped patch to the aur-dev mailing list.
Updating an Existing Translation Updating an Existing Translation
--------------------------------- ---------------------------------
1. Update your copy of the AUR code. 1. Download current translation files from Transifex. You can also do this
using transifex-client which is available through the AUR:
$ cd aur-git $ tx init --host=http://www.transifex.net
$ git pull $ tx set --auto-remote http://www.transifex.net/projects/p/aur
$ tx pull -r aur.aurpot -a
2. Run translation_tool, which will only prompts for strings that have 2. Update the existing translation file using an editor or a tool like poedit:
changed or been added since the last translation.
$ cd web/lang $ poedit <locale>.po
$ ./translation_tool
3. To commit your patch to your branch: 3. Push the updated translation file back to Transifex. Using transifex-client,
this works as follows:
$ 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.
$ tx push -r aur.aurpot -t -l <locale>