Auffinden von Template-Dateien mit Debugging

Um herauszufinden, welches Template das Markup für ein bestimmtes Element erzeugt, können Sie die eingebaute Twig-Option debug verwenden. Diese Option zeigt HTML-Kommentare zusammen mit der ausgegebenen Ausgabe an, die die verwendeten Theme-Hooks, vorgeschlagene Template-Dateinamen sowie die genaue Twig-Datei, die zur Darstellung eines bestimmten Abschnitts Ihres Markups verwendet wird, enthält.

Aktivieren Sie das Twig-Debugging in der Datei sites/default/services.yml, indem Sie debug:true im Abschnitt twig.config setzen (deaktivieren Sie es in der Produktionsumgebung). Wenn Sie Drupal 8 für Multisites verwenden, sollten Sie die services.yml-Datei im Verzeichnis sites/aktuellerSite für die jeweilige Seite bearbeiten, die Sie erstellen. Falls services.yml noch nicht existiert, kopieren Sie die Datei default.services.yml aus dem Verzeichnis sites/default und benennen sie in services.yml um. Ausführliche Anweisungen zum Twig-Debugging finden Sie im Abschnitt „Debugging kompilierten Twig-Templates“.

Nach Cache-Leerung prüfen Sie den Seitenquelltext; Sie sehen einen Code ähnlich dem folgenden:

<!-- THEME DEBUG -->
<!-- THEME HOOK: 'node' -->
<!-- FILE NAME SUGGESTIONS:
   * node--view--frontpage--page-1.html.twig
   * node--view--frontpage.html.twig
   * node--1--teaser.html.twig
   * node--1.html.twig
   * node--article--teaser.html.twig
   * node--article.html.twig
   * node--teaser.html.twig
   x node.html.twig
-->
<!-- BEGIN OUTPUT from 'core/themes/classy/templates/content/node.html.twig' -->

<article data-history-node-id="1" data-quickedit-entity-id="node/1" role="article" class="contextual-region node node--type-article node--promoted node--view-mode-teaser" about="/node/1" typeof="schema:Article" data-quickedit-entity-instance-id="0">
....
</article>

<!-- END OUTPUT from 'core/themes/classy/templates/content/node.html.twig' -->

Einige Punkte, auf die Sie bei dieser Debug-Ausgabe achten sollten:

• Die Vorschläge für Dateinamen sind von der spezifischsten bis zur allgemeinsten sortiert.
• Der aktuell verwendete Dateiname ist mit einem „x“ gekennzeichnet.
• Zusätzlich zu BEGIN OUTPUT und END OUTPUT finden Sie den vollständigen Pfad zur verwendeten Template-Datei.