@@ -33,8 +33,8 @@ The translation process has several steps:
33
33
#. :ref: `Enable and configure <translation-configuration >` Symfony's
34
34
translation service;
35
35
36
- #. Abstract strings (i.e. "messages") by wrapping them in calls to the
37
- `` Translator `` (" :ref: ` translation-basic `") ;
36
+ #. Abstract strings (i.e. "messages") by :ref: ` wrapping them in calls
37
+ <translation-basic>` to the `` Translator ``;
38
38
39
39
#. :ref: `Create translation resources/files <translation-resources >`
40
40
for each supported locale that translate each message in the application;
@@ -169,8 +169,8 @@ different formats:
169
169
'Symfony is great' => "J'aime Symfony",
170
170
];
171
171
172
- For information on where these files should be located, see
173
- :ref: `translation-resource-locations `.
172
+ You can find more information on where these files
173
+ :ref: `should be located < translation-resource-locations > `.
174
174
175
175
Now, if the language of the user's locale is French (e.g. ``fr_FR `` or ``fr_BE ``),
176
176
the message will be translated into ``J'aime Symfony ``. You can also translate
@@ -256,8 +256,8 @@ To actually translate the message, Symfony uses the following process when
256
256
using the ``trans() `` method:
257
257
258
258
#. The ``locale `` of the current user, which is stored on the request is
259
- determined; this is typically set via a ``_locale `` attribute on your routes
260
- (see :ref: ` translation-locale-url `) ;
259
+ determined; this is typically set via a ``_locale `` :ref: ` attribute on
260
+ your routes < translation-locale-url>` ;
261
261
262
262
#. A catalog of translated messages is loaded from translation resources
263
263
defined for the ``locale `` (e.g. ``fr_FR ``). Messages from the
@@ -450,10 +450,10 @@ The ``translation:extract`` command looks for missing translations in:
450
450
defined in the :ref: `twig.default_path <config-twig-default-path >` and
451
451
:ref: `twig.paths <config-twig-paths >` config options);
452
452
* Any PHP file/class that injects or :doc: `autowires </service_container/autowiring >`
453
- the ``translator `` service and makes calls to the ``trans() `` method.
453
+ the ``translator `` service and makes calls to the ``trans() `` method;
454
454
* Any PHP file/class stored in the ``src/ `` directory that creates
455
- :ref: `translatable-objects ` using the constructor or the `` t() `` method or calls
456
- the ``trans() `` method.
455
+ :ref: `translatable objects < translatable -objects> ` using the constructor or
456
+ the ``t() `` method or calls the `` trans() `` method;
457
457
* Any PHP file/class stored in the ``src/ `` directory that uses
458
458
:ref: `Constraints Attributes <validation-constraints >` with ``*message `` named argument(s).
459
459
@@ -1168,10 +1168,10 @@ unused translation messages templates:
1168
1168
.. caution ::
1169
1169
1170
1170
The extractors can't find messages translated outside templates (like form
1171
- labels or controllers) unless using :ref: `translatable-objects ` or calling
1172
- the ``trans() `` method on a translator. Dynamic
1173
- translations using variables or expressions in templates are not
1174
- detected either:
1171
+ labels or controllers) unless using :ref: `translatable objects
1172
+ <translatable-objects>` or calling the ``trans() `` method on a translator
1173
+ (since Symfony 5.3). Dynamic translations using variables or expressions in
1174
+ templates are not detected either:
1175
1175
1176
1176
.. code-block :: twig
1177
1177
@@ -1180,9 +1180,10 @@ unused translation messages templates:
1180
1180
{{ message|trans }}
1181
1181
1182
1182
Suppose your application's default_locale is ``fr `` and you have configured
1183
- ``en `` as the fallback locale (see :ref: `translation-configuration ` and
1184
- :ref: `translation-fallback ` for how to configure these). And suppose
1185
- you've already setup some translations for the ``fr `` locale:
1183
+ ``en `` as the fallback locale (see :ref: `configuration
1184
+ <translation-configuration>` and :ref: `fallback <translation-fallback >` for
1185
+ how to configure these). And suppose you've already set up some translations
1186
+ for the ``fr `` locale:
1186
1187
1187
1188
.. configuration-block ::
1188
1189
0 commit comments