aidantwoods/markdownphpdocs

Markdown Documentation Generator for PHP

v0.2.1 2017-06-23 16:24 UTC

Requires

• aidantwoods/betteroptions: ^0.0
• phpdocumentor/phpdocumentor: ^2.9
• symfony/yaml: ^3.2

MIT

README

Very hastily thrown together package to generate *.md files from a slightly customised version of phpdoc.

How to use

Installation:

git clone https://github.com/aidantwoods/MarkdownPhpDocs
cd MarkdownPhpDocs
composer update

You can then either directly run the file markdown-phpdoc located in the bin directory, or add this bin directory to your ~/.bash_profile to run from anywhere. e.g. by adding the lines:

PATH="[local-file-path-goes-here]/MarkdownPhpDocs/bin:${PATH}"
export PATH

Note that you'll need composer to pull down the the customised version of phpdoc as a dependency (available here), which serves to disable markdown processing in phpdoc (this to avoid markdown ending up within HTML, and thus not being ignored by most markdown parsers).

Usage

markdown-phpdoc -f [input file] -t [target directory]