Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
Yii-Docs-Generator: Generates nice HTML documentation from your Yii app source code, just a quick hack of the doc builder from Yii's build process. Also includes some properly commented templates for Gii. Read the wiki at http://www.yiiframework.com/wiki/186/how-to-generate-yii-like-documentation/ Installation: Extract the contents of the commands folder to protected/commands If you want to use the included commented Gii templates, extract them somewhere like ext.giitemplates, then include them in your gii module config e.g. 'gii'=>array( ... 'generatorPaths' => array( 'ext.giitemplates', ), ), Usage: ./yiic docs check - Checks the source code to see if there's any classes that are lacking documentation, good for quality checking ./yiic docs ../docs - Generates the site documentation in the specified folder (which must exist) Documenting Views: If you want to annotate the parameters passed to views by controllers, use the following syntax in your view right at the top of your view file /** * Some text describing what the view does goes here * @uses CActiveDataProvider $dataProvider The data provider for this model * @uses User $model The user model */ Notes: If you're getting errors with certain classes you might need to exclude them from the documentation process, to do this add them to the list of excluded files in $this->$appOptions in DocsCommand.php