mirror of https://github.com/Icinga/L10n.git
doc: Mention translate.icinga.com
This commit is contained in:
Johannes Meyer
parent
84dc513a95
commit
8e65a5e10e
|
|
@ -1 +0,0 @@
|
|||
{"pt_BR": "10%", "it_IT": "54%", "de_DE": "77%", "ru_RU": "45%", "fr_FR": "2%", "fi_FI": "4%", "ar_SA": "25%", "ja_JP": "56%", "uk_UA": "80%", "es_AR": "36%"}
|
||||
|
|
@ -1,73 +1,6 @@
|
|||
# Contributing to Icinga L10n
|
||||
|
||||
If you are already familiar with [gettext](https://www.gnu.org/software/gettext/manual/gettext.html#Why),
|
||||
contributing here is rather straightforward.
|
||||
|
||||
Assuming you already [forked](https://help.github.com/en/github/getting-started-with-github/fork-a-repo)
|
||||
the repository you will find all important files in here:
|
||||
|
||||
* locale (Compiled catalogs and their source files)
|
||||
* src (The template and intermediate catalogs)
|
||||
|
||||
The `locale` directory stores all current compiled translations. It also contains the
|
||||
*.po* files used to compile them. These files must pass the validation checks and hence
|
||||
must be error-free and must not contain fuzzy messages.
|
||||
|
||||
The `src` directory is where you will work on the translations. It contains the current
|
||||
template and intermediate catalogs, which are automatically kept up to date on a daily
|
||||
basis. To fetch the latest update just pull the `master` branch.
|
||||
|
||||
## Working on Translations
|
||||
|
||||
To start working on a translation, please use your favorite editor. Though, we highly
|
||||
recommend [Poedit](https://poedit.net/) as we already prepared the intermediate catalogs
|
||||
for it. It is easy to use as well.
|
||||
|
||||
When adding/updating translations for an existing language, please open the respective
|
||||
*.po* file in e.g. `src/de_DE/LC_MESSAGES/icinga.po`. To start from scratch with a new
|
||||
language, copy the template `src/icinga.pot` and use it to create a new catalog in e.g.
|
||||
`src/zh_CN/LC_MESSAGES/icinga.po`.
|
||||
|
||||
When you are done please make sure your changes do not contain any errors or fuzzy
|
||||
messages. You can then copy the file to the respective locale in `locale` together with
|
||||
its compiled *.mo* file. (No *.mo* file? *Poedit* can automatically create them upon
|
||||
saving, check its configuration.)
|
||||
|
||||
To send us your work please open a new [pull request](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request)
|
||||
and include the following files in it:
|
||||
|
||||
* `src/ll_CC/LC_MESSAGES/icinga.po`
|
||||
* `locale/ll_CC/LC_MESSAGES/icinga.po`
|
||||
* `locale/ll_CC/LC_MESSAGES/icinga.mo`
|
||||
|
||||
## Keeping Pull Requests up-to-date
|
||||
|
||||
As mentioned above, the master branch gets updated frequently. Once new messages get
|
||||
introduced in a linked repository (such as Icinga Web 2) the template and source catalogs
|
||||
will be updated. To get these new messages into your fork, just update it with our current
|
||||
master. Github also lets you update your pull request right from the UI.
|
||||
|
||||
Though, sooner or later you will get conflicts, and a simple update of your pull request
|
||||
is not possible anymore. You need to resolve the conflicts first then, in order to update.
|
||||
|
||||
Our source catalogs however are huge. A few conflicts may be fixable by hand, but many of
|
||||
them can be a pain. We don't recommend fixing conflicts by hand, but provide a bot which
|
||||
will take care of them automatically.
|
||||
|
||||
> **Note:**
|
||||
>
|
||||
> To utilize the bot, it is required to enable maintainer edits.
|
||||
|
||||
If you want the bot to resolve source catalog conflicts and update your pull request,
|
||||
add a comment with `/resolve` in the first line.
|
||||
|
||||
|
||||
|
||||
The bot will then immediately attempt to fix your source catalog conflicts. Once the bot
|
||||
finished its work, it will leave a comment. Pull its changes then and continue with the
|
||||
translation.
|
||||
|
||||
Pulling the bot's changes is important. Once you trigger the bot, it's not only you
|
||||
anymore who's working on the pull request. It's then also the bot which is adding
|
||||
commits. To avoid conflicts in your working tree, it is recommended to pull the remote
|
||||
branch first before continuing with the translation.
|
||||
We manage translations now on [translate.icinga.com](https://translate.icinga.com). We don't accept
|
||||
pull requests on Github anymore. To report bugs in either source or translation strings, please also
|
||||
head over there and [lookup](https://translate.icinga.com/projects/icinga/#search) the offending
|
||||
string and add a comment to it in the respective scope.
|
||||
|
|
|
|||
17
README.md
17
README.md
|
|
@ -1,16 +1,5 @@
|
|||
# Icinga - L10n
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
L10n (short for *Localization*) is the central location for all translations available
|
||||
for Icinga.
|
||||
|
||||
|
|
@ -29,5 +18,7 @@ or the Icinga CLI: `ICINGAWEB_LOCALEDIR=/var/www/icinga/L10n/locale`
|
|||
|
||||
## Contributing
|
||||
|
||||
Want to contribute a new language or help complete an existing one? Head over to the
|
||||
[CONTRIBUTING.md](CONTRIBUTING.md) to help get you started!
|
||||
We manage translations now on [translate.icinga.com](https://translate.icinga.com). We don't accept
|
||||
pull requests on Github anymore. To report bugs in either source or translation strings, please also
|
||||
head over there and [lookup](https://translate.icinga.com/projects/icinga/#search) the offending
|
||||
string and add a comment to it in the respective scope.
|
||||
|
|
|
|||
Binary file not shown.
|
Before Width: | Height: | Size: 12 KiB |
Loading…
Reference in New Issue