Skip to content

Latest commit

 

History

History
66 lines (50 loc) · 2.49 KB

translation.md

File metadata and controls

66 lines (50 loc) · 2.49 KB
Raw

Translation

The package offers translations for the quill toolbar and editor, it will follow the locale that is defined in your WidgetsApp for example MaterialApp which usually follows the system locally unless you set your own locale with:

QuillToolbar.simple(
  configurations: QuillSimpleToolbarConfigurations(
    controller: _controller,
    sharedConfigurations: const QuillSharedConfigurations(
      locale: Locale('de'),
    ),
  ),
),
Expanded(
  child: QuillEditor.basic(
    configurations: QuillEditorConfigurations(
      controller: _controller,
      sharedConfigurations: const QuillSharedConfigurations(
        locale: Locale('de'),
      ),
    ),
  ),
)

Currently, translations are available for these 37 locales:

  • Locale('en'), Locale('ar'), Locale('bn'), Locale('bs')
  • Locale('cs'), Locale('de'), Locale('da'), Locale('fr')
  • Locale('he'), Locale('zh', 'CN'), Locale('zh', 'HK')
  • Locale('ko'), Locale('ku'), Locale('ku', 'CKB')
  • Locale('ro', 'RO'), Locale('ru'), Locale('es'), Locale('tk'), Locale('tr')
  • Locale('uk'), Locale('ur'), Locale('pt'), Locale('pl')
  • Locale('vi'), Locale('id'), Locale('it'), Locale('ms')
  • Locale('nl'), Locale('no'), Locale('ne', 'NP'), Locale('fa'), Locale('hi')
  • Locale('sk'), Locale('sr'), Locale('sv'), Locale('sw'), Locale('ja')

Contributing to translations

The translation files are located in the l10n folder. Feel free to contribute your own translations, just copy the English translations map and replace the values with your translations.

Add a new file in the l10n folder with the following name quill_${localName}.arb for example quill_de.arb

paste the English version and replace the values

Also, you can take a look at the untranslated.json JSON file, which is a generated file that tells you which keys with which locales haven't translated so you can find the missings easily

After you are done and want to test the changes, run the following in the root folder (preferred):

./scripts/regenerate_translations.sh

or (if you can't run the script for some reasons):

flutter gen-l10n
dart fix --apply ./lib/src/l10n/generated
dart format ./lib/src/l10n/generated

This will generate the new dart files from the arb files in order to take effect, otherwise, you won't notice a difference

Then open a pull request so everyone can benefit from your translations!