Visor
API documentation generator for the Elefant CMS
Install / Use
/learn @jbroadway/VisorREADME
This is a very simple documentation generator for the Elefant CMS. It uses PHP's Reflection classes to produce JavaDoc-style output from Elefant's core classes.
This is not meant as a full replacement for phpDoc or ApiGen, but rather a simple solution that we can more easily integrate into our website.
I wrote this for a few reasons:
- I don't like the "interactive" elements in the output of the new phpDoc
- I kept running into issues with ApiGen's code generation, and their Texy markup is inferior to Markdown
- I want a more human-friendly comment format than they both allow
- Documentation generation is pretty easy and even fun with PHP's Reflection capabilities
For a live example of this app in use, visit:
http://api.elefantcms.com/
To make the routes work well, add these to the [Alias] section in conf/routes.php:
/api = /visor
/helpers = /visor/helpers
/helper = /visor/helper
