Mirror of Monero
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Alexander Blair 51873fec04
Merge pull request #6145
5 days ago
.github add 'sponsor' button on GitHub 7 months ago
cmake CMake build out of source 2 months ago
contrib Merge pull request #6143 5 days ago
external Merge pull request #6037 1 month ago
include Update 2019 copyright 10 months ago
src Merge pull request #6144 5 days ago
tests Merge pull request #6115 5 days ago
translations Translations from weblate + resync 2 months ago
utils Merge pull request #6144 5 days ago
.gitattributes cmake: support git info in released tarballs 5 years ago
.gitignore Add __pycache__ directory to .gitignore 2 months ago
.gitmodules RandomX integration 3 months ago
.travis.yml build: fix depends Travis ncurses build, don't wipe CONFIG_SHELL 5 months ago
ANONYMITY_NETWORKS.md ANONYMITY_NETWORKS.md : fix unintentional wrapping 2 months ago
CMakeLists.txt Windows: enable high-entropy ASLR where available 2 months ago
CMakeLists_IOS.txt Update 2019 copyright 10 months ago
CONTRIBUTING.md SHALL -> MUST 10 months ago
Dockerfile Docker updated dependencies cmake boost sodium cppzmq udev protobuf zmq 5 months ago
Doxyfile Changed URLs to HTTPS 1 year ago
LEVIN_PROTOCOL.md Added support for "noise" over I1P/Tor to mask Tx transmission. 6 months ago
LICENSE Make difficulty 128 bit instead of 64 bit 10 months ago
Makefile Makefile: add a top level debug target for ASAN 4 months ago
README.i18n.md Made code block usage consistent across all .md files 8 months ago
README.md Merge pull request #6079 2 months ago
snap Add snap symlink 2 years ago

README.i18n.md

Monero daemon internationalization

The Monero command line tools can be translated in various languages. If you wish to contribute and need help/support, contact the Monero Localization Workgroup on Taiga or come chat on #monero-translations (Freenode/IRC, riot/matrix, MatterMost)

In order to use the same translation workflow as the Monero Core GUI, they use Qt Linguist translation files. However, to avoid the dependencies on Qt this normally implies, they use a custom loader to read those files at runtime.

Tools for translators

In order to create, update or build translations files, you need to have Qt tools installed. For translating, you need either the Qt Linguist GUI (part of Qt Creator or a 3rd-party standalone version), or another tool that supports Qt ts files, such as Transifex. The files are XML, so they can be edited in any plain text editor if needed.

Creating / modifying translations

You do not need anything from Qt in order to use the final translations.

To update ts files after changing source code:

./utils/translations/update-translations.sh

To add a new language, eg Spanish (ISO code es):

cp translations/monero.ts translations/monero_es.ts

To edit translations for Spanish:

linguist translations/monero_es.ts

To build translations after modifying them:

./utils/translations/build-translations.sh

To test a translation:

LANG=es ./build/release/bin/monero-wallet-cli

To add new translatable strings in the source code:

Use the tr(string) function if possible. If the code is in a class, and this class doesn’t already have a tr() static function, add one, which uses a context named after what lupdate uses for the context, usually the fully qualified class name (eg, cryptonote::simple_wallet). If you need to use tr() in code that’s not in a class, you can use the fully qualified version (eg, simple_wallet::tr) of the one matching the context you want. Use QT_TRANSLATE_NOOP(string) if you want to specify a context manually.

If you’re getting messages of the form:

Class 'cryptonote::simple_wallet' lacks Q_OBJECT macro

all is fine, we don’t actually need that here.