PhpDocumentor : How to choose templates?

2
votes

Recently I have met with PhpDocumentor. It looks like a good documentation tool. I want to use the 'responsive-twig' as template which comes with phpDocumentor. I tried;

  • --template="responsive-twig" in command line with phpdoc, It says 'ERROR: Unknown command-line option "--template" encountered, use phpdoc -h for help'

  • Changed the 'name' attribute of the 'template' tag to 'responsive-twig' in /usr/share/php/phpDocumentor/data/phpdoc.tpl.xml, default was 'clean'

  • Changed the 'name' attribute of the 'template' tag to 'responsive-twig' in /usr/share/php/phpDocumentor/phpdoc.dist.xml

However I cannot change the default template.

I have installed phpDocumentor via PEAR. I have three phpDocumentor directories. One in /var/www and two other('phpDocumentor' and 'PhpDocumentor') in /usr/share/php.

There is a 'responsive-twig' folder under /usr/share/php/phpDocumentor/data/templates.

Please help!

1
phptemplatesphpdocphpdocumentor2
Did you install phpDocumentor from the phpdoc channel or the default channel? What do you get if you type phpdoc --version at the command line? - toxalot
I have installed phpDocumentor following the steps given in this post: link. phpdoc --version gives that error: ERROR: Unknown command-line option "--version" encountered, use phpdoc -h for help - zarax
What happens if you type pear info phpdoc/phpDocumentor? What version number is reported? If you type phpdoc -h, is --template or --version listed as an option? - toxalot
It gives the details about phpdoc. For example, release date: 2014-02-26 21:00:50, Release version 2.3.1(stable). --template and --version are not listed - zarax
Very, very strange. I'm wondering if you have two different versions installed and they are interfering with each other. What happens if you type pear info PhpDocumentor, note the missing phpdoc/? If that returns anything, I'd try uninstalling both versions and then re-installing version 2. - toxalot

1 Answers

2
votes

FYI, Succeed by follows:

yum install graphviz
pear install Image_GraphViz
rm -rf /tmp/phpdoc-twig-cache
phpdoc -d ./joomla-cms/libraries -t ./joomla-doc --template=responsive-twig

With latest phpDocumentor version 2.8.1
May help!