Skip to content

Commit 65a14d0

Browse files
committed
Minor tweaks
1 parent 4e83e9a commit 65a14d0

File tree

1 file changed

+12
-14
lines changed

1 file changed

+12
-14
lines changed

translation.rst

+12-14
Original file line numberDiff line numberDiff line change
@@ -467,24 +467,23 @@ The ``translation:extract`` command looks for missing translations in:
467467
468468
$ composer require nikic/php-parser
469469
470-
By default, the ``translation:extract`` command extracts new messages in
471-
*message/translation* pairs, with the translation populated with the same
472-
text as the message, prefixed by ``__``. You can customize this prefix using
473-
the ``--prefix`` option.
474-
475-
If you want to leave new translations empty, use the ``--no-fill`` option.
476-
When enabled, only messages are created, and the translation strings are left
477-
empty. This is particularly useful when using external translation tools, as
478-
it ensures untranslated strings are easily identifiable without any pre-filled
479-
content. Note that when ``--no-fill`` is used, the ``--prefix`` option has
480-
no effect.
470+
By default, when the ``translation:extract`` command creates new entries in the
471+
trnaslation file, it uses the same content as both the source and the pending
472+
translation. The only difference is that the pending translation is prefixed by
473+
``__``. You can customize this prefix using the ``--prefix`` option:
481474

482475
.. code-block:: terminal
483476
484-
# changes default prefix
485477
$ php bin/console translation:extract --force --prefix="NEW_" fr
486478
487-
# leaves new translations empty
479+
Alternatively, you can use the ``--no-fill`` option to leave the pending translation
480+
completely empty when creating new entries in the translation catalog. This is
481+
particularly useful when using external translation tools, as it makes it easier
482+
to spot untranslated strings:
483+
484+
.. code-block:: terminal
485+
486+
# when using the --no-fill option, the --prefix option is ignored
488487
$ php bin/console translation:extract --force --no-fill fr
489488
490489
.. versionadded:: 7.2
@@ -493,7 +492,6 @@ no effect.
493492

494493
.. _translation-resource-locations:
495494

496-
497495
Translation Resource/File Names and Locations
498496
---------------------------------------------
499497

0 commit comments

Comments
 (0)