gaschz/trilium
1
0
Fork 0
mirror of https://github.com/zadam/trilium.git synced 2025-12-07 16:04:23 +01:00
Code Issues Actions 6 Packages Projects Releases Wiki Activity
trilium/docs/Developer Guide/Developer Guide/Concepts/Internationalisation Translations/Adding a new locale.md
Elian Doran 5281e8e5b4
docs(dev): document adding a new locale
2025-11-16 21:24:34 +02:00

1.0 KiB
Vendored
Raw Blame History

Adding a new locale

Once the Weblate translations for a single language have reached ~50% in coverage, it's time to add it to the application.

To do so:

  1. In packages/commons look for i18n.ts and add a new entry to UNSORTED_LOCALES for the language.
  2. In apps/server look for services/i18n.ts and add a mapping for the new language in DAYJS_LOADER. Sort the entire list.
  3. In apps/client, look for collections/calendar/index.tsx and modify LOCALE_MAPPINGS to add support to the new language.
  4. In apps/client, look for widgets/type_widgets/canvas/i18n.ts and modify LANGUAGE_MAPPINGS. A unit test ensures that the language is actually loadable.
  5. In apps/client, look for widgets/type_widgets/MindMap.tsx and modify LOCALE_MAPPINGS. The type definitions should already validate if the new value is supported by Mind Elixir.
  6. In packages/ckeditor5, look for i18n.ts and modify LOCALE_MAPPINGS. The import validation should already check if the new value is supported by CKEditor, and there's also a test to ensure it.