Skip to content

Commit 20c05bd

Browse files
committed
phrase translation provider
- added some documentation about the phrase translation provider
1 parent 1637b92 commit 20c05bd

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
@@ -603,6 +603,7 @@ Provider Install with
603603
Crowdin ``composer require symfony/crowdin-translation-provider``
604604
Loco (localise.biz) ``composer require symfony/loco-translation-provider``
605605
Lokalise ``composer require symfony/lokalise-translation-provider``
606+
Phrase ``composer require symfony/phrase-translation-provider``
606607
==================== ===========================================================
607608

608609
Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
@@ -692,6 +693,11 @@ configure the ``providers`` option:
692693
],
693694
]);
694695
696+
.. important::
697+
698+
If you use Phrase as a provider you must configure a user agent in your dsn. See
699+
`Identification via User-Agent`_ for reasoning and some examples.
700+
695701
.. tip::
696702

697703
If you use Lokalise as a provider and a locale format following the `ISO
@@ -701,6 +707,12 @@ configure the ``providers`` option:
701707
capital letters that specifies the national variety (e.g. "GB" or "US"
702708
according to `ISO 3166-1 alpha-2`_)).
703709

710+
.. tip::
711+
712+
The Phrase provider uses Phrase's tag feature to map translations to Symfony's translation
713+
domains. If you need some assistance with organising your tags in Phrase, you might want
714+
to consider the `Phrase Tag Bundle`_ which provides some commands helping you with that.
715+
704716
Pushing and Pulling Translations
705717
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
706718

@@ -1364,3 +1376,5 @@ Learn more
13641376
.. _`Machine object format`: https://www.gnu.org/software/gettext/manual/html_node/MO-Files.html
13651377
.. _`QT Translations TS XML`: https://doc.qt.io/qt-5/linguist-ts-file-format.html
13661378
.. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
1379+
.. _`Identification via User-Agent`: https://developers.phrase.com/api/#overview--identification-via-user-agent
1380+
.. _`Phrase Tag Bundle`: https://github.com/wickedOne/phrase-tag-bundle

0 commit comments

Comments
 (0)