跳转到主要内容
东方龙马 提交于 15 April 2024
Drupal 8+: 开启/禁用主题调试模式

Theme debugging,中文即主题调试。主题调试对于开发Drupal 8 站点是非常有帮助的。它会对DOM结构调整对应的TWIG模板文件给出建议。这个信息被添加到了Drupal输出的一条HTML指令中。我们可以在检查HTML或开发者窗口时访问这些信息。 当启用调试时,每个Twig模板的标记由HTML注释包围,其中包含主题信息,如模板文件名称建议。

为了利用这个选项,我们需要在“service.yml”文件中启用主题调试模式为TRUE。 以下是启用/禁用主题调试的步骤。

1. service.yml 文件:

检查你的Drupal文件系统是否在SITE_ROOT/sites/default中有service.yml。 如果不存在,则复制并将“default.services.yml”重命名为“services.yml”。

2. 开启/禁用主题调试

编辑service.yml,找到下面的“twig.config”,其中有“debug”键。 我们需要将其设置为“true”才能启用。 默认情况下,它是“false”。

参数:

---- ----

twig.config:

     # Not recommended in production environments # @default false

     debug: true

     # Twig auto-reload:

---- ----

3. 清缓存

完成后需要通过清除站点性能缓存来重置缓存。启用主题建议后会看到类似这样的截图:

这样,我们就可以很清晰的看到DOM的输出是来自哪个Twig模板了。