46 lines
1.3 KiB
Markdown
46 lines
1.3 KiB
Markdown
# Translating X-Decor-libre
|
||
|
||
This mod wants to be translated in many languages.
|
||
|
||
The recommended way to translate this mod is online on Codeberg Translate:
|
||
|
||
<https://translate.codeberg.org/projects/xdecor/>
|
||
|
||
This is the easiest way to help this mod get translated.
|
||
|
||
## Manual translation
|
||
|
||
The rest of this document describes how translation works under the hood.
|
||
You don’t need to understand this.
|
||
|
||
The translations are provided in the gettext PO format (supported since
|
||
Luanti 5.10.0); they can be edited with programs like Poedit.
|
||
|
||
Many strings are commented, so read the comments to understand the context
|
||
of each string.
|
||
|
||
There are two files to translate:
|
||
|
||
* `xdecor.pot`: Main translation file
|
||
* `_xdecor_cut_nodes.pot`: Descriptions of nodes that were cut by the workbench
|
||
|
||
To create a complete translation, you need to have:
|
||
|
||
* `xdecor.<CODE>.po`
|
||
* `_xdecor_cut_nodes.<CODE>.po`
|
||
|
||
where `<CODE>` is the language code like `de` for German.
|
||
|
||
## Special symbols
|
||
|
||
The strings may contain some symbols with special meaning:
|
||
|
||
`@1`, `@2`, `@3`, etc. are placeholders, they will be replaced with some other
|
||
text. The translation *MUST* include all placeholders of the original string,
|
||
but you can change the order as you wish.
|
||
|
||
`@n` represents a new line.
|
||
|
||
Refer to `lua_api.md` of the Luanti documentation for more information about
|
||
the translation system.
|