jsdoc-oblivion

JSDoc Oblivion Template

A gray and blue JSDoc template theme (based off docstrap).

Demo

https://lab.miguelmota.com/jsdoc-oblivion

Install

Available via npm

npm install jsdoc-oblivion

Usage

JSDoc config file jsdoc.json:

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

Using CLI:

jsdoc src/ -r -c jsdoc.json -d docs/ -t node_modules/jsdoc-oblivion/template

Using Grunt:

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: './jsdocjson',
          template: './node_modules/jsdoc-oblivion/template'
        }
      }
    }
  });
  grunt.registerTask('default', ['grunt-jsdoc']);
  grunt.loadNpmTasks('grunt-jsdoc');
};

Generate:

grunt jsdoc

Source

https://github.com/miguelmota/jsdoc-oblivion

License

Released under the MIT License.