phpDocumentor语言 - 更改模板



我正在使用 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

相关内容

  • 没有找到相关文章

最新更新