Angular-JSDoc

JSDoc 3 Template for AngularJS.
A JSDoc plugin and template for AngularJS, nothing else!

Blog: Sign, AngularJS Documentation

Features

• Right side TOC, table of contents, for navigation by Directives, Services, Controllers, etc
• Read and process @ngdoc tag

How Does It Look Like

• angularjs-google-maps Documentation

Install

$ npm install jsdoc angular-jsdoc --save-dev

Run In Command Line

Run jsdoc command to generate your documentation. All command line options are the options of jsdoc

$ path/to/jsdoc -c path to conf> -t <template> <your source code>

In example,

`$ node_modules/jsdoc/jsdoc.js -c node_modules/angular-jsdoc/conf.json -t node_modules/angular-jsdoc/template -r myDir`

Run with gulp

1. install gulp-shell
   $ npm install gulp-shell --save-dev

2. add the following to the gulpfile.json

   var shell = require('gulp-shell'); 
   gulp.task('docs', shell.task([ 
     'node_modules/jsdoc/jsdoc.js '+ 
       '-c node_modules/angular-jsdoc/conf.json '+   // config file
       '-t node_modules/angular-jsdoc/template '+    // template file
       '-d build/docs '+                             // output directory
       './README.md ' +                              // to include README.md as index contents
       '-r app/scripts'                              // source code directory
   ])); 
   

3. run gulp task
   $ gulp docs

Run with grunt

copy/pasted from hashbang blog

grunt.initConfig({
  jsdoc : {
    dist: {
      src: [
        'src/scripts/app/**/*.js',
        'FRONTEND-GUIDE.md'
      ], 
      options: {
        destination: '../docs/client-jsdocs',
        configure: 'node_modules/angular-jsdoc/conf.json',
        template: 'node_modules/angular-jsdoc/template'
      }
    }
  }
});

Example of Directive Documentation

Example of Service Documentation