trans-default-domain

Was bedeutet {% trans-default-domain %} in Twig?

{% trans-default-domain %} wird verwendet, um die Standard-Domäne für Übersetzungen festzulegen – trans steht für translation. Wenn wir in einem Template Übersetzungen machen, müssen wir die Domäne nicht immer explizit angeben. Die Übersetzungen werden in der dafür definierten Standard-Domäne (konkret: im Übersetzungsbereich bzw. in der Übersetzungsdatei) gesucht.

{% trans_default_domain 'contao-exception' %}

Die Übersetzungen für die error.html.twig kommen aus der Domäne contao-exception.

/vendor/contao/core-bundle/contao/languages/de/exception.xlf
/vendor/contao/news-bundle/...
/vendor/contao/calendar-bundle/...

Beispiel Wartungsmodus

Seit Contao 5.3 wird der Wartungsmodus in Browsersprache ausgegeben, trotzdem möchten wir vielleicht die Texte anpassen:

wartungsscreen

Die entsprechenden Sprachdateien finden wir hier, und das wissen wir, weil das oben in der {% trans-default-domain %} angegeben wurde:

<?xml version="1.0" ?><xliff version="1.1">
  <file datatype="php" original="contao/languages/en/explain.php" source-language="en" target-language="de">
    <body>

      <!-- XPT unavailable -->
      <trans-unit id="XPT.unavailable">
        <source>Service unavailable</source>
        <target>Dienst nicht verfügbar</target>
      </trans-unit>

      <!-- XPT matter -->
      <trans-unit id="XPT.matter">
        <source>What's the matter?</source>
        <target>Was ist das Problem?</target>
      </trans-unit>

      <!-- XPT maintenance -->
      <trans-unit id="XPT.maintenance">
        <source>The website is currently not available. Please come back later.</source>
        <target>Die Webseite ist momentan nicht verfügbar. Bitte versuchen Sie es später noch einmal.</target>
      </trans-unit>

      <!-- XPT hint -->
      <trans-unit id="XPT.hint">
        <source>To customize this notice, create a custom Twig template overriding &lt;em&gt;%s&lt;/em&gt;.</source>
        <target>Legen Sie ein eigenes Twig-Template an, das das Template &lt;em&gt;%s&lt;/em&gt; überschreibt, um diese Meldung anzupassen.</target>
      </trans-unit>
    </body>
  </file>
</xliff>

Um die Meldungen anzupassen, legen wir eine Datei exception.php oder exception.xlf unter /contao/languages/de an (siehe auch Sprachdateien anpassen):

<?xml version="1.0" ?><xliff version="1.1">
  <file datatype="php" original="contao/languages/en/explain.php" source-language="en" target-language="de">
    <body>

      <!-- XPT unavailable -->
      <trans-unit id="XPT.unavailable">
        <source>Service unavailable</source>
        <target>Niemand zuhause</target>
      </trans-unit>

      <!-- XPT matter -->
      <trans-unit id="XPT.matter">
        <source>What's the matter?</source>
        <target>Was ist das Problem?</target>
      </trans-unit>

      <!-- XPT maintenance -->
      <trans-unit id="XPT.maintenance">
        <source>The website is currently not available. Please come back later.</source>
        <target>Die Webseite wird gerade überarbeitet. Bitte versuchen Sie es später noch einmal.</target>
      </trans-unit>

      <!-- XPT hint -->
      <trans-unit id="XPT.hint">
        <source>To customize this notice, create a custom Twig template overriding &lt;em&gt;%s&lt;/em&gt;.</source>
        <target>Legen Sie ein eigenes Twig-Template an, das das Template &lt;em&gt;%s&lt;/em&gt; überschreibt, um diese Meldung anzupassen.</target>
      </trans-unit>
    </body>
  </file>
</xliff>