grunt task using docco to generate HTML documents out of you source
I got the idea for this plugin from David Souther but his version did
not work for me and
Some people experienced issues with an unmet docco dependency. I tried to fix this by pointing to a specific commit of docco but I am not sure if this is working with all NPM versions supporting github URL's.
I have test it on following setup:
This plugin requires Grunt
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-docco2
In your project's Gruntfile, add a section named
docco to the data object passed into
gruntinitConfigdocco:options:dst: 'docs'layout: 'parallel'docs:files:expand: truecwd: 'public/js'
This example uses this pattern
public/js/**/*.js to get your code files.
In this case
public/js/libs should be excluded from docco.
If you are not sure about the pattern and how you should define the
src array, read more about the
Files Array Format.
// Project configuration.gruntinitConfigdocco:options:dst: './docs/annotated-source'layout: 'parallel'docs:files:expand: truecwd: './public/js'src:'**/*.js''!libs/**/*';// Load tasksgruntloadNpmTasks'grunt-docco2';// Default task(s)gruntregisterTask'default' 'docco';;