jsdoc-docio

JSDoc Docio Template

A blue JSDoc template theme (based off docstrap,jsdoc-oblivion).

Install

Available via npm

npm install jsdoc-docio

Available via bower

bower install jsdoc-docio

Usage

Grunt dependencies:

npm install jsdoc --save-dev
npm install grunt-jsdoc --save-dev

gruntfile.js:

module.exports = function (grunt) {
  grunt.initConfig({
    pkg: grunt.file.readJSON('package.json'),
    jsdoc : {
      dist : {
        src: [
          './**/*.js',
          'README.md'
        ],
        jsdoc: './node_modules/.bin/jsdoc',
        options: {
          destination: 'docs',
          configure: './config/conf.json',
          template: './node_modules/jsdoc-docio/template'
        }
      }
    }
  });
  grunt.registerTask('default', ['jsdoc']);
  grunt.loadNpmTasks('grunt-jsdoc');
};

config/conf.json:

{
  "tags": {
    "allowUnknownTags": true
  },
  "source": {
    "includePattern": ".+\\.js(doc)?$",
    "excludePattern": "(^|\\/|\\\\)_"
  },
  "plugins": [],
  "templates": {
    "cleverLinks": false,
    "monospaceLinks": false,
    "default": {
      "outputSourceFiles": true
    },
    "systemName"      : "Docio",
    "footer"          : "",
    "copyright"       : "Copyright © 2017",
    "navType"         : "vertical",
    "theme"           : "docio",
    "linenums"        : true,
    "collapseSymbols" : false,
    "inverseNav"      : true
  }
}

Generate:

grunt jsdoc