phpdoc - phpDocumentor - 更改模板

Question

我正在使用来自http://phpdoc.org的 phpDocumentor 。

试图更改模板“响应式树枝”让我抓狂。我所做的任何更改

/usr/share/php/phpDocumentor/data/templates/responsive-twig/layout.html.twig

被完全忽略。但是，如果我重命名文件并运行 phpdoc，则会收到找不到该文件的错误。然后我清空了这个文件（0 字节）——phpdoc 命令运行良好，产生与原始文件完全相同的输出。

在所有尝试之间，我总是删除整个输出目录以确保不涉及缓存。

我不明白模板如何以及从何处获取信息，关于模板的文档在 phpDocumentor 的网站上不可用。在谷歌上搜索也没有帮助。

有什么提示吗？我真的很感激。谢谢。

score 3 · Accepted Answer

我有完全相同的问题。使用基于 twig 的模板时，生成的文件似乎缓存在系统的 tmp 文件夹中，因此即使您每次都删除整个输出目录，也会涉及缓存。如此处所写，您应该能够通过在每次进行更改时清除系统的 tmp 文件夹来解决此问题。

虽然，这个解决方案对我不起作用，但清除 tmp 文件夹不会导致更改。因此，我在函数 addExtensionsFromTemplateConfiguration 的 Twig.php 文件中添加了以下代码行，以阻止 twig 缓存：

$twigEnvironment->enableAutoReload();

丑陋但有效。

score 3 · Accepted Answer

您可以在文件中添加twig-debug参数template.xml：

<parameters>
  <parameter key="twig-debug">true</parameter>
</parameters>

2 回答 2