melawy-plasma-plasmoid-OnzeMenuKDE-kde5/com.github.adhec.OnzeMenuKDE/translate/ReadMe.md

> Zren based translation template, i18n scripts. [link](https://github.com/Zren/plasma-applet-tiledmenu)


## Install Translations

Go to `~/.local/share/plasma/plasmoids/OnzeMenu/translate/` and run `sh ./build --restartplasma`.

## New Translations

1. Fill out [`template.pot`](template.pot) with your translations then open a [new issue](https://github.com/adhec/dittoMenuKDE/issues), name the file `spanish.txt`, attach the txt file to the issue (drag and drop).

Or if you know how to make a pull request

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 |      40 |       |
| de       |   32/40 |   80% |
| fr       |   32/40 |   80% |
| ko       |   32/40 |   80% |
| nl       |   33/40 |   82% |
| pt-br    |   32/40 |   80% |
| ru       |   32/40 |   80% |
| tr       |   28/40 |   70% |
| uk       |   33/40 |   82% |
| zh_CN    |   30/40 |   75% |