我正在使用 http://phpdoc.org 的phpDocumentor。
试图更改模板"响应式树枝"让我发疯。我所做的任何更改
/usr/share/php/phpDocumentor/data/templates/responsive-twig/layout.html.twig
被完全忽略。但是,如果我重命名文件并运行 phpdoc,则会出现找不到此文件的错误。然后我清空了这个文件(0 字节) - phpdoc 命令运行良好,产生与原始文件完全相同的输出。
在所有尝试之间,我总是删除整个输出目录,以确保不涉及缓存。
我不明白,模板如何以及从哪里获取信息,并且有关模板的文档在phpDocumentor的网站上不可用。在谷歌上搜索也没有帮助。
有什么提示吗?我真的很感激。谢谢。
我遇到了完全相同的问题。使用基于 twig 的模板时,生成的文件似乎缓存在系统的 tmp 文件夹中,因此即使您每次都删除整个输出目录,也会涉及缓存。如此处所写,您应该能够通过每次进行更改时清除系统的tmp文件夹来解决此问题。
虽然,这个解决方案对我不起作用,但清除tmp文件夹并没有引起更改。因此,我将以下代码行添加到函数 addExtensionsFromTemplateConfiguration 中的 Twig.php 文件中,以阻止 twig 缓存:
$twigEnvironment->enableAutoReload();
丑陋但有效。
您可以将twig-debug
参数添加到template.xml
文件中:
<parameters>
<parameter key="twig-debug">true</parameter>
</parameters>
在此处查看详细信息:https://github.com/phpDocumentor/phpDocumentor2/issues/1114