38 lines
1.5 KiB
Markdown
38 lines
1.5 KiB
Markdown
With KDE Frameworks v5.37 and above, translations are bundled with the `*.plasmoid` file downloaded from the store.
|
|
|
|
## Install Translations
|
|
|
|
Run `sh ./build --restartplasma`.
|
|
|
|
## New Translations
|
|
|
|
1. Copy the `template.pot` file and name it your locale's code (Eg: `en`/`de`/`fr`) with the extension `.po`. Then fill out all the `msgstr ""`.
|
|
|
|
## Scripts
|
|
|
|
* `sh ./merge` will parse the `i18n()` calls in the `*.qml` files and write it to the `template.pot` file. Then it will merge any changes into the `*.po` language files.
|
|
* `sh ./build` will convert the `*.po` files to it's binary `*.mo` version and move it to `contents/locale/...` which will bundle the translations in the `*.plasmoid` without needing the user to manually install them.
|
|
* `sh ./plasmoidlocaletest` will run `./build` then `plasmoidviewer` (part of `plasma-sdk`).
|
|
|
|
## Links
|
|
|
|
* https://zren.github.io/kde/docs/widget/#translations-i18n
|
|
* https://techbase.kde.org/Development/Tutorials/Localization/i18n_Build_Systems
|
|
* https://api.kde.org/frameworks/ki18n/html/prg_guide.html
|
|
|
|
## Examples
|
|
|
|
* https://l10n.kde.org/stats/gui/trunk-kf5/team/fr/plasma-desktop/
|
|
* https://github.com/psifidotos/nowdock-plasmoid/tree/master/po
|
|
* https://github.com/kotelnik/plasma-applet-redshift-control/tree/master/translations
|
|
|
|
## Status
|
|
| Locale | Lines | % Done|
|
|
|----------|---------|-------|
|
|
| Template | 65 | |
|
|
| de | 30/65 | 46% |
|
|
| fr | 30/65 | 46% |
|
|
| id | 30/65 | 46% |
|
|
| nl | 30/65 | 46% |
|
|
| ru | 63/65 | 96% |
|