Skip to content

Commit 5dedf97

Browse files
committed
minor #15386 [Translation] Improve Translation Providers docs (welcoMattic)
This PR was squashed before being merged into the 5.3 branch. Discussion ---------- [Translation] Improve Translation Providers docs This PR add more precise documentation for Lokalise and PoEditor providers. Indeed, some settings in those SaaS must be correctly configured in order to make the providers work Commits ------- a2635f3 [Translation] Improve Translation Providers docs
2 parents dbfc512 + a2635f3 commit 5dedf97

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

translation.rst

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -713,6 +713,18 @@ configure the ``providers`` option:
713713
],
714714
]);
715715
716+
.. tip::
717+
718+
If you use Lokalise as provider and a locale format following the `ISO 639-1`_ (e.g., "en" or "fr"),
719+
you have to set the `Custom Language Name setting`_ in Lokalise for each of your locales,
720+
in order to override the default value (which follow the `ISO 639-1`_ succeeded by a sub-code
721+
in capital letters that specifies the national variety (e.g., "GB" or "US" according to `ISO 3166-1 alpha-2`_)).
722+
723+
.. tip::
724+
725+
If you use PoEditor as provider, you have to define a `Default Reference Language`_ in your project,
726+
otherwise your translations could not be correctly exported.
727+
716728
Pushing and Pulling Translations
717729
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
718730

@@ -879,3 +891,5 @@ Learn more
879891
.. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
880892
.. _`Translatable Extension`: https://github.com/doctrine-extensions/DoctrineExtensions/blob/main/doc/translatable.md
881893
.. _`Translatable Behavior`: https://github.com/KnpLabs/DoctrineBehaviors
894+
.. _`Default Reference Language`: https://poeditor.com/kb/setting-a-default-reference-language
895+
.. _`Custom Language Name setting`: https://docs.lokalise.com/en/articles/1400492-uploading-files#custom-language-codes

0 commit comments

Comments
 (0)