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., _(*1)

The main use-case for this template is to generate simple and nice looking usage documentation, that can then be published on GitHub., _(*2)

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., _(*3)

Example of documentation generated with this template: https://github.com/cvuorinen/raspicam-php/tree/master/docs, _(*4)

Installation

Install with composer:, _(*5)

composer require cvuorinen/phpdoc-markdown-public

Usage

Run phpDocumentor and set template as vendor/cvuorinen/phpdoc-markdown-public/data/templates/markdown-public., _(*6)

Example using command-line arguments:, _(*7)

./vendor/bin/phpdoc --directory=src/ --target=docs/ --template="vendor/cvuorinen/phpdoc-markdown-public/data/templates/markdown-public" --title="My Project Documentation"

More information about the available arguments can be found at running phpDocumentor., _(*8)

Example using configuration file:, _(*9)

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., _(*10)

<?xml version="1.0" encoding="UTF-8" ?>
<phpdoc>
    <title>My Project Documentation</title>
    <parser>
        <target>build</target>
    </parser>
    <transformer>
        <target>docs</target>
    </transformer>
    <transformations>
        <template name="vendor/cvuorinen/phpdoc-markdown-public/data/templates/markdown-public" />
    </transformations>
    <files>
        <directory>src</directory>
        <ignore>test/*</ignore>
    </files>
</phpdoc>

More information about configuring phpDocumentor., _(*11)