From 5fde618fa71dd2fc94634cb03aae46a2a9758156 Mon Sep 17 00:00:00 2001 From: Garvin Hicking Date: Wed, 4 Feb 2026 21:18:13 +0100 Subject: [PATCH 1/4] Update CGL: XLIFF translation domain syntax --- Documentation/Appendix/Cgl.rst | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/Documentation/Appendix/Cgl.rst b/Documentation/Appendix/Cgl.rst index f6ca8a9..9c691cd 100644 --- a/Documentation/Appendix/Cgl.rst +++ b/Documentation/Appendix/Cgl.rst @@ -103,3 +103,32 @@ label reference can be separated by dots, for example: Existing labels should not be mass-changed to snake case, as each changed label must be retranslated into all languages. + +.. _appendix-cgl-xliff-domain-syntax: + +Utilizing "translation domain syntax" +------------------------------------- + +With `Feature: #93334 - Translation Domain Mapping `_ +and `Feature: #107759 - TranslateViewHelper supports translation domain syntax `_ +the label localization within fluid template files and PHP code can be +shortened: + +.. code-block:: fluid + + + + +.. code-block:: php + + $languageService->sL('backend.toolbar:save'); + +This syntax is preferred and should be utilized for any new code committed +to TYPO3 v14+ because of these reasons: + +* It is shorter, easier to read, has no odd "LLL:EXT:" magic notation +* Applies conventions of Symfony translation usage in other frameworks +* Allows better automatic extraction and analysis (CLI commands) +* Allows for better deprecations and usage analysis + +Detailed reasons are found in the mentioned changelogs. From 481ab22bc0898d333b4b55789d859a9677213c84 Mon Sep 17 00:00:00 2001 From: Lina Wolf <48202465+linawolf@users.noreply.github.com> Date: Thu, 5 Feb 2026 08:54:32 +0100 Subject: [PATCH 2/4] Change code block to html fluid is not allowed yet --- Documentation/Appendix/Cgl.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/Appendix/Cgl.rst b/Documentation/Appendix/Cgl.rst index 9c691cd..604b1b7 100644 --- a/Documentation/Appendix/Cgl.rst +++ b/Documentation/Appendix/Cgl.rst @@ -114,7 +114,7 @@ and `Feature: #107759 - TranslateViewHelper supports translation domain syntax < the label localization within fluid template files and PHP code can be shortened: -.. code-block:: fluid +.. code-block:: html From 20ab56defb014096632363d2d00d97b5b9f71a45 Mon Sep 17 00:00:00 2001 From: Lina Wolf <48202465+linawolf@users.noreply.github.com> Date: Thu, 5 Feb 2026 08:55:18 +0100 Subject: [PATCH 3/4] Apply suggestion from @linawolf --- Documentation/Appendix/Cgl.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/Appendix/Cgl.rst b/Documentation/Appendix/Cgl.rst index 604b1b7..b65e281 100644 --- a/Documentation/Appendix/Cgl.rst +++ b/Documentation/Appendix/Cgl.rst @@ -126,7 +126,7 @@ shortened: This syntax is preferred and should be utilized for any new code committed to TYPO3 v14+ because of these reasons: -* It is shorter, easier to read, has no odd "LLL:EXT:" magic notation +* It is shorter, easier to read, has no odd `LLL:EXT:` magic notation * Applies conventions of Symfony translation usage in other frameworks * Allows better automatic extraction and analysis (CLI commands) * Allows for better deprecations and usage analysis From 00382ee3f2afa5cb77f5b4eaf8dcf3f9f23854a2 Mon Sep 17 00:00:00 2001 From: Lina Wolf <48202465+linawolf@users.noreply.github.com> Date: Thu, 5 Feb 2026 08:55:45 +0100 Subject: [PATCH 4/4] Apply suggestion from @linawolf --- Documentation/Appendix/Cgl.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/Appendix/Cgl.rst b/Documentation/Appendix/Cgl.rst index b65e281..9394c1f 100644 --- a/Documentation/Appendix/Cgl.rst +++ b/Documentation/Appendix/Cgl.rst @@ -111,7 +111,7 @@ Utilizing "translation domain syntax" With `Feature: #93334 - Translation Domain Mapping `_ and `Feature: #107759 - TranslateViewHelper supports translation domain syntax `_ -the label localization within fluid template files and PHP code can be +the label localization within Fluid template files and PHP code can be shortened: .. code-block:: html