phpDocumentor - изменение шаблона

Question

Я использую phpDocumentor с http://phpdoc.org/.

Попытка изменить шаблон "отзывчивый прут" сводит меня с ума. Любые изменения, которые я делаю в

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

полностью игнорируются. Однако, если я переименую файл и запущу phpdoc, я получаю сообщение об ошибке, что этот файл не может быть найден. Затем я очистил этот файл (0 байт) - и команда phpdoc работает нормально, производя точно такой же вывод, как и в исходном файле.

Между всеми попытками я всегда удалял весь выходной каталог, чтобы убедиться, что кеширование не задействовано.

Я не понимаю, как и откуда шаблоны получают информацию, а документация по шаблонам не доступна на сайте phpDocumentor. Поиск по всему гуглу тоже не помог.

Есть намеки? Я действительно ценю это. Благодарю.

Answer 1

У меня была точно такая же проблема. При использовании шаблона, основанного на ветке, сгенерированные файлы, похоже, кэшируются в папке tmp вашей системы, поэтому кеширование происходит, даже если вы каждый раз удаляете весь выходной каталог. Как написано здесь, вы сможете решить эту проблему, очищая папку tmp вашей системы каждый раз, когда вы вносите изменения.

Хотя это решение не сработало, очистка папки tmp не вызвала изменений. Поэтому я добавил следующую строку кода в файл Twig.php в функции addExtensionsFromTemplateConfiguration, чтобы остановить кеширование ветки:

$twigEnvironment->enableAutoReload();

Уродливый, но эффективный.

Answer 2

Можете добавить twig-debug параметр вашего template.xml файл:

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

Подробности смотрите здесь: https://github.com/phpDocumentor/phpDocumentor2/issues/1114