phpDocumentor - 更改模板

Question

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

尝试更改模板“responsive-twig”让我抓狂。 我对

所做的任何更改

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

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

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

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

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

Answer 1

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

不过，这个解决方案对我不起作用，清除 tmp 文件夹并没有导致更改。因此，我将以下代码行添加到函数 addExtensionsFromTemplateConfiguration 中的 Twig.php 文件中，以阻止 twig 进行缓存:

$twigEnvironment->enableAutoReload();

丑陋但有效。