introduce code-block for xliff

using the XmlLExer

Author: OskarStark

_build/conf.py

@@ -110,6 +110,7 @@
 lexers['varnish3'] = CLexer()
 lexers['varnish4'] = CLexer()
 lexers['terminal'] = TerminalLexer()
+lexers['xliff'] = XMLLexer()
 
 config_block = {
     'apache': 'Apache',
@@ -118,7 +119,8 @@
     'rst': 'reStructuredText',
     'terminal': 'Terminal',
     'varnish3': 'Varnish 3',
-    'varnish4': 'Varnish 4'
+    'varnish4': 'Varnish 4',
+    'xliff': 'XLIFF'
 }
 
 # use PHP as the primary domain

best_practices/i18n.rst

@@ -77,7 +77,7 @@ Example Translation File
 Applying all the previous best practices, the sample translation file for
 English in the application would be:
 
-.. code-block:: xml
+.. code-block:: xliff
 
     <!-- app/Resources/translations/messages.en.xlf -->
     <?xml version="1.0"?>

components/translation/usage.rst

@@ -109,12 +109,7 @@ recommended format. These files are parsed by one of the loader classes.
 
 .. configuration-block::
 
-    .. code-block:: yaml
-
-        Symfony is great: J'aime Symfony
-        symfony.great:    J'aime Symfony
-
-    .. code-block:: xml
+    .. code-block:: xliff
 
         <?xml version="1.0"?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
@@ -132,6 +127,11 @@ recommended format. These files are parsed by one of the loader classes.
             </file>
         </xliff>
 
+    .. code-block:: yaml
+
+        Symfony is great: J'aime Symfony
+        symfony.great:    J'aime Symfony
+
     .. code-block:: php
 
         return [
@@ -448,7 +448,7 @@ supports loading and dumping notes is XLIFF version 2.0.
 If the XLIFF 2.0 document contains ``<notes>`` nodes, they are automatically
 loaded/dumped when using this component inside a Symfony application:
 
-.. code-block:: xml
+.. code-block:: xliff
 
     <?xml version="1.0" encoding="utf-8"?>
     <xliff xmlns="urn:oasis:names:tc:xliff:document:2.0" version="2.0"

translation.rst

@@ -126,12 +126,7 @@ different formats, XLIFF being the recommended format:
 
 .. configuration-block::
 
-    .. code-block:: yaml
-
-        # messages.fr.yml
-        Symfony is great: J'aime Symfony
-
-    .. code-block:: xml
+    .. code-block:: xliff
 
         <!-- messages.fr.xlf -->
         <?xml version="1.0"?>
@@ -146,6 +141,11 @@ different formats, XLIFF being the recommended format:
             </file>
         </xliff>
 
+    .. code-block:: yaml
+
+        # messages.fr.yml
+        Symfony is great: J'aime Symfony
+
     .. code-block:: php
 
         // messages.fr.php

translation/debug.rst

@@ -49,12 +49,7 @@ you've already setup some translations for the ``fr`` locale inside an AcmeDemoB
 
 .. configuration-block::
 
-    .. code-block:: yaml
-
-        # src/Acme/AcmeDemoBundle/Resources/translations/messages.fr.yml
-        Symfony is great: J'aime Symfony
-
-    .. code-block:: xml
+    .. code-block:: xliff
 
         <!-- src/Acme/AcmeDemoBundle/Resources/translations/messages.fr.xliff -->
         <?xml version="1.0"?>
@@ -69,6 +64,11 @@ you've already setup some translations for the ``fr`` locale inside an AcmeDemoB
             </file>
         </xliff>
 
+    .. code-block:: yaml
+
+        # src/Acme/AcmeDemoBundle/Resources/translations/messages.fr.yml
+        Symfony is great: J'aime Symfony
+
     .. code-block:: php
 
         // src/Acme/AcmeDemoBundle/Resources/translations/messages.fr.php
@@ -80,12 +80,7 @@ and for the ``en`` locale:
 
 .. configuration-block::
 
-    .. code-block:: yaml
-
-        # src/Acme/AcmeDemoBundle/Resources/translations/messages.en.yml
-        Symfony is great: Symfony is great
-
-    .. code-block:: xml
+    .. code-block:: xliff
 
         <!-- src/Acme/AcmeDemoBundle/Resources/translations/messages.en.xliff -->
         <?xml version="1.0"?>
@@ -100,6 +95,11 @@ and for the ``en`` locale:
             </file>
         </xliff>
 
+    .. code-block:: yaml
+
+        # src/Acme/AcmeDemoBundle/Resources/translations/messages.en.yml
+        Symfony is great: Symfony is great
+
     .. code-block:: php
 
         // src/Acme/AcmeDemoBundle/Resources/translations/messages.en.php

validation/translations.rst

@@ -88,12 +88,7 @@ Now, create a ``validators`` catalog file in the ``app/Resources/translations``
 
 .. configuration-block::
 
-    .. code-block:: yaml
-
-        # app/Resources/translations/validators.en.yml
-        author.name.not_blank: Please enter an author name.
-
-    .. code-block:: xml
+    .. code-block:: xliff
 
         <!-- app/Resources/translations/validators.en.xlf -->
         <?xml version="1.0"?>
@@ -108,6 +103,11 @@ Now, create a ``validators`` catalog file in the ``app/Resources/translations``
             </file>
         </xliff>
 
+    .. code-block:: yaml
+
+        # app/Resources/translations/validators.en.yml
+        author.name.not_blank: Please enter an author name.
+
     .. code-block:: php
 
         // app/Resources/translations/validators.en.php