Mehrsprachigkeit
================

:file:`*.svg`-Dateien können mehrsprachig sein. Dabei können auch mehrere
Übersetzungen in einer Datei vorhanden sein. Eine solche Datei hat mehrere
Vorteile:

* Die Speichergröße und die Anzahl der Dateien für mehrsprachige
  Visualisierungen verringert sich.
* Bei einer Aktualisierung erfolgt die Änderung für alle Sprachen in nur einer
  Datei.

Hierfür wird das `<switch>
<https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/switch>`_-Element
von SVG verwendet, :abbr:`z. B. (zum Beispiel)`:

.. literalinclude:: cusy.svg
   :language: xml

.. figure:: cusy.svg

SVG-Dateien verwenden `IETF
<https://www.rfc-editor.org/rfc/rfc1766>`-Sprachkennzeichnungen.

.. tip::
   Die Reihenfolge der ``<text>``-Elemente ist wichtig!

   SVG betrachtet die ``<text>``-Elemente nacheinander. Nur wenn das
   ``systemLanguage``-Attribut **nicht** übereinstimmt, wird zum nächsten
   Element gewechselt.  Das letzte ``<text>``-Element ohne
   ``systemLanguage``-Attribut wird verwendet, wenn keines der
   ``systemLanguage``-Attribute in den vorigen ``<text>``-Elementen zutreffend
   war.

.. warming::
   Verschiedene Übersetzungen haben unterschiedliche Längen, daher sollte der
   Ankerpunkt sorgfältig ausgewählt werden.

   Für Sprachen, die von rechts nach links laufen, sollte das `anchor
   <https://developer.mozilla.org/de/docs/Web/SVG/Reference/Attribute/text-anchor>`_-Attribut
   voraussichtlich auf ``end`` geetzt werden.

In der Datei `Annexation of Southern and Eastern Ukraine.svg
<https://commons.wikimedia.org/wiki/File:Annexation_of_Southern_and_Eastern_Ukraine.svg>`_
findet ihr ein komplexes Beispiel für eine mehrsprachige SVG-Karte, die auch
Schriften von rechts nach links enthält. Dabei werden  Symbole und
Sprachumschalter der Beschriftungen im  ``<defs>``-Abschnitt definiert, wobei
jedes davon in einem ``<g>``-Element gruppiert wird. Anschließend werden beide
in den Legende einer weiteren ``<switch>``-Konstruktion eingesetzt.

.. seealso::
   * `SVG Tutorial: Das switch-Element
     <https://svgtutorial.aptico.de/start3.php?knr=7&kname=Dokum.&uknr=7.6&ukname=Auswahlmoeglichkeiten%20-%20das%20switch-Element>`_