Template for JSDoc 3

• Based on PixiJS Template
• JSDoc3
• JSDoc3 API Documentations

Installation

Install the template using NPM:

npm install git+https://github.com/IQGeo/utils-jsdoc-template.git#v2.6.1 --save-dev

Usage

If you already have JSDoc system, you can use this project as JSDoc template. More information about JSDoc command-line arguments can be found here.

jsdoc -c conf.json -R README.md

conf.json

You can set options for customizing your documentations. Notice the "template" field for setting the path to utils-jsdoc-template.

{
  "templates": {
      "applicationName": "Demo",
      "disqus": "",
      "googleAnalytics": "",
      "favicon": "path/to/favicon.png",
      "openGraph": {
          "title": "",
          "type": "website",
          "image": "",
          "site_name": "",
          "url": ""
      },
      "meta": {
          "title": "",
          "description": "",
          "keyword": ""
      },
      "linenums": true,
      "source": {
          "include": [
              "./src/"
          ],
          "includePattern": ".+\\.js(doc)?$",
          "excludePattern": "(^|\\/|\\\\)_"
      },
      "opts": {
          "encoding": "utf8",
          "recurse": true,
          "private": false,
          "lenient": true,
          "destination": "./docs",
          "template": "./node_modules/@pixi/jsdoc-template"
      }
  },
  "pixi": {
      "styles": ["path/to/custom/styles.css"],
      "scripts": ["path/to/custom/script.js"]
   }
}

License

This template is based on the Pixi template. Pixi is licensed under the MIT.

The default template for JSDoc 3 uses: the Salty Database library and the Underscore Template library.