jbroadway / visor

API documentation generator for the Elefant CMS

Home Page:http://www.elefantcms.com/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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

About

API documentation generator for the Elefant CMS

http://www.elefantcms.com/


Languages

Language:PHP 84.2%Language:CSS 10.7%Language:HTML 2.8%Language:JavaScript 2.3%