Download the PHP package onspli/phpdoc-markdown without Composer
On this page you can find all versions of the php package onspli/phpdoc-markdown. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download onspli/phpdoc-markdown
More information about onspli/phpdoc-markdown
Files in onspli/phpdoc-markdown
Package phpdoc-markdown
Short Description Generate documentation in Markdown format so it can be published in GitHub.
License MIT
Informations about the package phpdoc-markdown
phpdoc markdown templates
phpDocumentor template that generates Markdown documentation of the public API only to a single README.md file. It will skip all abstract classes and non-public methods. Fork of template cvuorinen/phpdoc-markdown-public by Carl Vuorinen.
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/onspli/chess/tree/master/docs
Installation
Install with Composer:
Usage
First, you need to install phpDocumentor. There are multiple options how to install it, one of them is using the PHAR:
Read more about installation of phpDocumentor. Note that phpDocumentor is also available via Composer, however its documentation states
Ah, you discovered our secret. There is a phpDocumentor composer package that you could use to install phpDocumentor.
However: phpDocumentor is a complex application, and its libraries are used in countless other libraries and applications (2 of our libraries have more than 150 million downloads each); and this means that the chances for a conflict between one of our dependencies and yours is high. And when I say high, it is really high.
So, because of the above: we do not endorse nor actively support installing phpDocumentor using Composer.
Next, run phpDocumentor and set template as vendor/onspli/phpdoc-markdown/templates/public-onefile
.
The documentation will be generated to docs/README.md
file.
More information about configuring phpDocumentor.