phpDocumentor - 更改模板

Question

我使用的是http://phpdoc.org的phpDocumentor。

試圖改變模板「響應枝」驅使我堅果。 我作出的任何更改

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

被完全忽略。 但是，如果我重命名文件並運行phpdoc，則會出現無法找到此文件的錯誤。 然後我清空這個文件（0字節） - 並且phpdoc命令運行良好，產生與原始文件完全相同的輸出。

在所有嘗試之間，我總是刪除整個輸出目錄以確保不涉及緩存。

我不明白，模板如何以及從何處獲取信息以及有關模板的文檔在phpDocumentor的網站上不可用。搜索谷歌並沒有幫助。

任何提示？我真的很感激它。 謝謝。

Answer 1

我有完全相同的問題。當使用基於樹枝的模板時，生成的文件似乎被緩存在系統的tmp文件夾中，因此即使每次刪除整個輸出目錄，都會涉及到緩存。正如here所寫，您應該能夠通過每次更改時清除系統的tmp文件夾來解決此問題。

雖然此解決方案對我無效，但清除tmp文件夾不會導致更改。所以我添加下面的代碼行到Twig.php文件中的函數addExtensionsFromTemplateConfiguration從高速緩存停止樹枝：

$twigEnvironment->enableAutoReload(); 

醜陋但有效。這裏

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

查看詳情：

Answer 2

您可以twig-debug參數添加到您的template.xml文件https://github.com/phpDocumentor/phpDocumentor2/issues/1114