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

docs: Change i18n.txt to markdown format

Browse source
This commit is contained in:
Rafael Fontenelle 2023-12-07 14:12:16 +00:00 • committed by moson
parent 783422369e
commit 1b82887cd6
No known key found for this signature in database
GPG key ID: 4A4760AB4EE15296
2 changed files with 17 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
README.md
View file

@ -56,7 +56,7 @@ Translations
------------ ------------
Translations are welcome via our Transifex project at Translations are welcome via our Transifex project at
https://www.transifex.com/lfleischer/aurweb; see `doc/i18n.txt` for details. https://www.transifex.com/lfleischer/aurweb; see [doc/i18n.md](./doc/i18n.md) for details.
![Transifex](https://www.transifex.com/projects/p/aurweb/chart/image_png) ![Transifex](https://www.transifex.com/projects/p/aurweb/chart/image_png)

30
doc/i18n.txt → doc/i18n.md
View file

@ -3,9 +3,9 @@ aurweb Translation
This document describes how to create and maintain aurweb translations. This document describes how to create and maintain aurweb translations.
Creating an aurweb translation requires a Transifex (http://www.transifex.com/) Creating an aurweb translation requires a Transifex (https://app.transifex.com/)
account. You will need to register with a translation team on the aurweb account. You will need to register with a translation team on the aurweb
project page (http://www.transifex.com/projects/p/aurweb/). project page (https://app.transifex.com/lfleischer/aurweb/).
Creating a New Translation Creating a New Translation
@ -21,23 +21,23 @@ strings for the translation to be usable, and it may have to be disabled.
1. Check out the aurweb source using git: 1. Check out the aurweb source using git:
$ git clone https://gitlab.archlinux.org/archlinux/aurweb.git aurweb-git $ git clone https://gitlab.archlinux.org/archlinux/aurweb.git aurweb-git
2. Go into the "po/" directory in the aurweb source and run msginit(1) to 2. Go into the "po/" directory in the aurweb source and run [msginit(1)][msginit] to
create a initial translation file from our translation catalog: create a initial translation file from our translation catalog:
$ cd aurweb-git $ cd aurweb-git
$ git checkout master $ git checkout master
$ git pull $ git pull
$ cd po $ cd po
$ msginit -l <locale> -o <locale>.po -i aurweb.pot $ msginit -l <locale> -o <locale>.po -i aurweb.pot
3. Use some editor or a translation helper like poedit to add translations: 3. Use some editor or a translation helper like poedit to add translations:
$ poedit <locale>.po $ poedit <locale>.po
5. If you have a working aurweb setup, add a line for the new translation in 5. If you have a working aurweb setup, add a line for the new translation in
"web/lib/config.inc.php.proto" and test if everything looks right. "po/Makefile" and test if everything looks right.
6. Upload the newly created ".po" file to Transifex. If you don't like the web 6. Upload the newly created ".po" file to Transifex. If you don't like the web
interface, you can also use transifex-client to do that (see below). interface, you can also use transifex-client to do that (see below).
@ -49,13 +49,15 @@ Updating an Existing Translation
1. Download current translation files from Transifex. You can also do this 1. Download current translation files from Transifex. You can also do this
using transifex-client which is available through the AUR: using transifex-client which is available through the AUR:
$ tx pull -a $ tx pull -a
2. Update the existing translation file using an editor or a tool like poedit: 2. Update the existing translation file using an editor or a tool like poedit:
$ poedit po/<locale>.po $ poedit po/<locale>.po
3. Push the updated translation file back to Transifex. Using transifex-client, 3. Push the updated translation file back to Transifex. Using transifex-client,
this works as follows: this works as follows:
$ tx push -r aurweb.aurwebpot -t -l <locale> $ tx push -r aurweb.aurwebpot -t -l <locale>
[msginit]: https://man.archlinux.org/man/msginit.1