phpDocumentor - 更改模板答案

【问题标题】：phpDocumentor - changing a templatephpDocumentor - 更改模板
【发布时间】：2014-03-04 13:24:01
【问题描述】：

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

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

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

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

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

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

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

【问题讨论】：

我也经历过同样的事情！我快要疯了！在文档中找不到关于缓存的任何内容。现在我在 Windows 上找到了缓存位置：c:\Users\<username>\AppData\Local\Temp\phpdoc-twig-cache。不过，更好的选择是使用twig-debug 参数。

【解决方案1】：

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

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

$twigEnvironment->enableAutoReload();

丑陋但有效。

【讨论】：

【解决方案2】：

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

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

【讨论】：