Localización de archivos de plantilla con depuración
Para saber qué plantilla genera el marcado para un elemento específico, puedes usar la opción integrada debug de Twig. Esta opción mostrará comentarios HTML junto con la salida renderizada, incluyendo los hooks de tema usados, los nombres sugeridos de archivos de plantilla, y señalará el archivo Twig exacto utilizado para renderizar una sección determinada de tu marcado.
Activa la depuración de Twig en sites/default/services.yml
, estableciendo debug: true
en la sección twig.config
(desactívalo en producción). Si usas Drupal 8 para multisitios, deberías editar el archivo services.yml
en el directorio sites/currentsite
para el sitio específico que estás creando. Si services.yml
aún no existe, copia el archivo default.services.yml
desde sites/default
y renómbralo a services.yml
. Instrucciones detalladas para la depuración de Twig están en la sección «Depuración de plantillas Twig compiladas».
Después de limpiar la caché, revisa el código fuente de la página; verás un código similar al siguiente:
<!-- 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' -->
Algunos puntos a destacar en esta salida de depuración:
- Las sugerencias de nombres de archivo están listadas de la más específica a la menos específica.
- El archivo actualmente en uso tiene un símbolo «x» al lado.
- Junto con BEGIN OUTPUT y END OUTPUT encontrarás la ruta completa a la plantilla renderizada.
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.