[TASK] Revise "Localized labels" chapter (#102)

- Update image
- Adjust wording

Releases: main, 12.4

Co-authored-by: Chris Müller <2566282+brotkrueml@users.noreply.github.com>

Author: github-actions[bot]

Documentation/Images/ManualScreenshots/Frontend/IndexedSearchGerman.png

@@ -1,42 +1,42 @@
-.. include:: /Includes.rst.txt
+..  include:: /Includes.rst.txt
 
+..  _localized-labels:
 
-.. _localized-labels:
-
+================
 Localized labels
-^^^^^^^^^^^^^^^^
+================
 
 
-.. _localized-labels-typoscript:
+..  _localized-labels-typoscript:
 
 Using XLF labels in TypoScript structures
-"""""""""""""""""""""""""""""""""""""""""
+=========================================
 
-XLIFF (XLF) files are XML files containing labels that the system can fetch
-in a localized version if the relevant translations are installed.
-It is possible to retrieve values from XLF files using TypoScript:
+:ref:`XLIFF (XLF) <t3coreapi:xliff>` files are XML files containing labels that
+the system can retrieve in a localized version if the appropriate translations
+are installed. It is possible to retrieve values from XLF files using TypoScript:
 
-.. code-block:: typoscript
-   :caption: EXT:site_package/Configuration/TypoScript/setup.typoscript
+..  code-block:: typoscript
+    :caption: EXT:site_package/Configuration/TypoScript/setup.typoscript
 
-   page.20 = TEXT
-   page.20.data = LLL:EXT:indexed_search/Resources/Private/Language/locallang.xlf:form.submit
+    page.20 = TEXT
+    page.20.data = LLL:EXT:indexed_search/Resources/Private/Language/locallang.xlf:form.submit
 
 This looks for the label :code:`form.submit` in the file
-:file:`Resources/Private/Language/locallang.xlf` from extension
+:file:`Resources/Private/Language/locallang.xlf` from the extension
 "indexed\_search".
 
-If the frontend is now accessed in the language "de", the german language
-is configured in the site configuration and the german translations
-are installed in :ref:`t3coreapi:Environment-labels-path`/:file:`de/`, the output should be "Suche"
-(instead "Search" which is what you will get if the label is retrieved
-for the default language).
+If the frontend is now accessed in the language "de", the German language
+is configured in the :ref:`site configuration <languages>` and the German
+translations are installed in :ref:`t3coreapi:Environment-labels-path`/:file:`de/`,
+the output should be "Suche" (instead "Search" which is what you will get if the
+label is retrieved for the default language).
 
 
-.. _localized-labels-plugins:
+..  _localized-labels-plugins:
 
 Using XLF labels in frontend plugins
-""""""""""""""""""""""""""""""""""""
+====================================
 
 Making your code ready for internationalization is covered in
 :ref:`t3coreapi:internationalization` and
@@ -48,17 +48,18 @@ output when a specific language is requested.
 For instance, if the page is accessed in the language "de" and
 the German translations are installed, you will see this page for "indexed search":
 
-.. figure:: /Images/ManualScreenshots/Frontend/IndexedSearchGerman.png
-   :alt: Indexed search in German
+..  figure:: /Images/ManualScreenshots/Frontend/IndexedSearchGerman.png
+    :alt: Output from the Indexed Search plugin in German
+    :class: with-shadow
 
-   Output from the indexed search plugin in German
+    Output from the Indexed Search plugin in German
 
 Overriding an existing translation is possible using custom XLIFF files.
-This process is described in :ref:`Core APIs <t3coreapi:xliff-translating-custom>`.
+This process is described in :ref:`t3coreapi:xliff-translating-custom`.
 
 It is also possible to override a label using TypoScript. See the
 :ref:`TypoScript Reference for more information <t3tsref:setup-plugin-local-lang-lang-key-label-key>`.
 
-It is also possible to create XLIFF files for a language into which
-TYPO3 CMS is not translated yet. This process is also described in
-:ref:`Core APIs <t3coreapi:xliff-translating-languages>`.
+You can also create XLIFF files for a language into which
+TYPO3 is not translated yet. This process is described in
+:ref:`t3coreapi:xliff-translating-languages`.