Download the PHP package heimrichhannot/phpdoc-github-template without Composer
On this page you can find all versions of the php package heimrichhannot/phpdoc-github-template. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download heimrichhannot/phpdoc-github-template
More information about heimrichhannot/phpdoc-github-template
Files in heimrichhannot/phpdoc-github-template
Package phpdoc-github-template
Short Description phpDocumentor template that generates Markdown documentation of the public API
License MIT
Homepage https://github.com/cvuorinen/phpdoc-markdown-public
Informations about the package phpdoc-github-template
phpDocumentor markdown-public template
phpDocumentor template that generates Markdown documentation of only the public API. It will skip all abstract classes and non-public methods.
The main use-case for this template is to generate simple and nice looking usage documentation, that can then be published on GitHub.
For example, a small library can document it's public API in DocBlock comments, use this template to generate the Markdown documentation and then commit it to GitHub with the library to easily create a nice looking documentation for other developers to see.
Example of documentation generated with this template: https://github.com/cvuorinen/raspicam-php/tree/master/docs
Installation
Install with composer:
Usage
Run phpDocumentor and set template as vendor/cvuorinen/phpdoc-markdown-public/data/templates/markdown-public
.
Example using command-line arguments:
More information about the available arguments can be found at running phpDocumentor.
Example using configuration file:
Add a file called phpdoc.xml
with the following content to the root of your project and invoke the phpdoc
command without arguments. Modify the configuration to suit your project.
More information about configuring phpDocumentor.