jjsm01/kimai2
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity
Files
7880f980a8978dfff65cd12a38d93d7ece9e69bb
kimai2/var/docs/translations.md
Matheus 54d06462fc added portuguese translations (#446)
2018-11-28 18:22:05 +01:00

2.3 KiB
Raw Blame History

Translations

We try to keep the number of language files small, in order to make it easier to identify the location of application messages and to unify the codebase.

  • If you add a new key, you have to add it in every language file
  • Its very likely that you want to edit the file messages as it holds 90% of our application translations

The files in translations/ as a quick overview:

  • exceptions only holds translations of error pages and exception handlers
  • flashmessages hold all success and error messages, that will be shown as results from action calls after page reload
  • messages holds most of the visible application translations (like all the static UI elements and form translations)
  • pagerfanta includes the translations for the pagination component
  • sidebar holds all the translations of the right sidebar
  • validators only holds translations related to violations/validation of submitted form data (or API calls)
  • invoice-calculator holds translations of calculator types (see Adding invoice calculator in developers-section)
  • invoice-numbergenerator holds translations of the invoice calculator (see Adding invoice-number generator in developers-section)
  • invoice-renderer holds translations of all invoice templates (read more)

Adding a new language

As example I choose a new hypothetical language with the locale xx.

Copy each translation file from translations/*.en.xliff and rename them to translations/*.xx.xliff.

Adjust the target-language in the file header, as example for the new file exceptions.xx.xliff:

<file date="2018-08-01T20:00:00Z" source-language="en" target-language="xx" datatype="plaintext" original="exceptions.en.xliff">`

Adjust the file config/packages/kimai.yaml and add the language settings below the key kimai.languages:

kimai:
    languages:
        xx:
            date_short: 'd.m.Y'

Append the new locale in the file config/services.yaml at parameters.app_locales divided by a pipe:

parameters:
    locale: en
    app_locales: en|de|ru|it|xx

Check for missing translations

When you search for missing keys, please use this command:

bin/console debug:translation --only-missing de

and replace de with your locale.