@@ -467,24 +467,23 @@ The ``translation:extract`` command looks for missing translations in:
467
467
468
468
$ composer require nikic/php-parser
469
469
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:
481
474
482
475
.. code-block :: terminal
483
476
484
- # changes default prefix
485
477
$ php bin/console translation:extract --force --prefix="NEW_" fr
486
478
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
488
487
$ php bin/console translation:extract --force --no-fill fr
489
488
490
489
.. versionadded :: 7.2
@@ -493,7 +492,6 @@ no effect.
493
492
494
493
.. _translation-resource-locations :
495
494
496
-
497
495
Translation Resource/File Names and Locations
498
496
---------------------------------------------
499
497
0 commit comments