arsenetar
/
dupeguru
mirror of https://github.com/arsenetar/dupeguru.git
1
0
Fork 0
Code Releases Wiki Activity

Updated Translator Guide (markdown)

Virgil Dupras 2015-05-09 14:11:33 -04:00
parent 7f28f4c681
commit 92d5c28cf0
1 changed files with 27 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
Translator-Guide.md

@ -76,6 +76,33 @@ All these rules in the previous section are rather complex, but the fact of the
If your text editor lets you choose an encoding to save your file to, make sure that you use UTF-8. It will make my life much easier.
## See the results live
To see the results of you translation, you have to be able to [build dupeGuru from source](https://github.com/hsoft/dupeguru#how-to-build-dupeguru-from-source). Then, the steps to follow depend on the situation.
### Transifex
If you've done the translation on Transifex, you'll have to pull those translations into dupeGuru using the [transifex client](http://docs.transifex.com/client/). You can install it with those steps:
1. Make sure that dupeGuru's virtualenv is active: `. env/bin/activate`.
2. `pip install transifex-client`
Then, you can pull translations update with `tx pull -a`
### Existing language
If the language you're working on is already present in dupeGuru, things are simple. You simply have to build dupeGuru with `python build.py` followed by `python run.py` and you'll be able to see your changes live.
### New language
If the language you're working on is new, things are a bit more complicated. You'll have to add that language in the code. You'll have to add references to your new language in these files:
* hscommon/trans.py
* qtlib/preferences.py
* qt/base/preferences_dialog.py
To help you, you can look at [this commit](https://github.com/hsoft/dupeguru/commit/0068e7b85a93d7032e7a381f54178f7708a7ab24) where the Korean language was added.
# Help File translation
Help file translation is much simpler to do than application translation, but it's much longer and more boring. I'd understand if you don't want to do it, or do it partially (I personally hate to do it). dupeGuru help is built using [Sphinx](http://sphinx.pocoo.org/), so it's better if you're familiar with its syntax.