Конфигурация DocBlox: данный шаблон по умолчанию не найден или недоступен для чтения
Я установил последнюю версию 0.18.1 DocBlox на Ubuntu 11.10, используя PEAR. Кажется, все работает нормально, если я укажу все в командной строке. Однако, используя только docblox, вы не найдете docblox.xml в текущем каталоге. Указание doxblox -c (или --config) ./docblox.xml также не работает. Я проверил разрешения и что файл существует.
У меня есть каталог Testing с некоторыми простыми файлами для тестирования.
/home/Testing$ docblox --config ./docblox.xml
DocBlox version 0.18.1
ERROR: The given template default could not be found or is not readable
/home/Testing$ ls -l
total 20
-rw-rw-rw- 1 dev dev 992 2012-01-17 12:03 docblox.xml
-rw-rw-rw- 1 dev dev 107 2012-01-17 11:59 index.php
-rw-rw-rw- 1 dev dev 769 2012-01-17 12:01 SOME_CLASS.class
-rw-rw-rw- 1 dev dev 1335 2012-01-17 12:02 SOME_CLASS.class.test
3 ответа
default
до версии 0.18.0 шаблон являлся де-факто шаблоном и был переименован в new_black
в версии 0.18. Возможно, вы прямо упоминаете default
шаблон в собственной конфигурации?
попробуйте установить new_black
шаблон и либо пропустите имя шаблона в вашей конфигурации, либо определите new_black
,
После удаления раздела шаблона это исправило мои проблемы, и я могу сгенерировать отчеты и график занятий. Новый docblox.xml ниже для тех, кто в этом нуждается.
<?xml version="1.0" encoding="UTF-8" ?>
<docblox>
<title>My project</title>
<parser>
<target>output</target>
<markers>
<item>TODO</item>
<item>FIXME</item>
</markers>
<extensions>
<extension>class</extension>
<extension>fn</extension>
<extension>php</extension>
</extensions>
<visibility></visibility>
</parser>
<transformer>
<target>output</target>
</transformer>
<logging>
<level>warn</level>
<paths>
<default>{APP_ROOT}/data/log/{DATE}.log</default>
<errors>{APP_ROOT}/data/log/{DATE}.errors.log</errors>
</paths>
</logging>
<files>
<file>*</file>
<file>bin/*</file>
<directory>src</directory>
<directory>tes??</directory>
<ignore>test/*</ignore>
</files>
</docblox>
Вы, вероятно, должны установить тему. Я должен был сделать это сам в первом выпуске после того, как сопровождающий отделил темы от ядра
$ pear list-all -c docblox
All packages [Channel docblox]:
===============================
Package Latest Local
docblox/DocBlox 0.18.1 0.18.1 PHP 5.3 compatible API Documentation generator aimed at projects of all sizes and Continuous Integration
docblox/DocBlox_Template_abstract 1.0.1 The abstract template for DocBlox
docblox/DocBlox_Template_checkstyle 1.0.0 1.0.0 The checkstyle template for DocBlox
docblox/DocBlox_Template_new_black 1.0.1 1.0.1 The new_black template for DocBlox
docblox/DocBlox_Template_old_ocean 1.0.0 The old_ocean template for DocBlox
docblox/DocBlox_Template_pdf_old_ocean 1.0.0 The pdf_old_ocean template for DocBlox
docblox/DocBlox_Template_zend 1.0.0 The zend template for DocBlox
docblox/DocBlox_Theme_default 1.0.0 The default theme for DocBlox
$ pear install docblox/DocBlox_Theme_default