gianiaz / phpdoc-md
PHP documentation generator, with markdown output
Requires
- php: >=7.0.0
- twig/twig: ~1.2|2.0
Requires (Dev)
- phpdocumentor/phpdocumentor: ~2.8.0
- sabre/cs: ~0.0.5
README
This is a script that can generate markdown (.md) files for your API documentation.
It is tailored for projects using PSR-0, PSR-1, PSR-2, PSR-4 and namespaces. The project was primarily developed for sabre/dav, but it should work for other codebases as well.
It only documents classes and interfaces.
The code is ugly, it was intended as a one-off, and I was in a hurry.. so the codebase may not be up to your standards. (it certainly isn't up to mine).
Installation
This project assumes you have composer installed. Simply add:
"require-dev" : {
"gianiaz/phpdoc-md" : "~0.3.0"
}
To your composer.json, and then you can simply install with:
composer install
Usage
First ensure that phpdocumentor 2 is installed somewhere, after, you must
generate a file called structure.xml
.
The easiest is to create a temporary directory, for example named docs/
.
# phpdoc command
phpdoc -d [project path] -t docs/ --template="xml"
# Next, run phpdocmd:
phpdocmd docs/structure.xml [outputdir]
Options
--lt [template]
This specifies the 'template' for links we're generating. By default
this is "%c.md".
--index [filename]
This specifies the 'filename' for API Index markdown file we're generating.
By default this is "ApiIndex.md".
This should generate all the .md files. I'm excited to hear your feedback.