bookshelf-jsdoc-theme
v1.0.1
Published
JSDoc theme used by bookshelfjs.org, the homepage of the Bookshelf.js ORM http://bookshelfjs.org
Downloads
284
Readme
Bookshelf theme
JSDoc theme for bookshelfjs.org.
Forked from Minami.
Uses
Install
$ npm install --save-dev bookshelf-jsdoc-theme
Usage
Clone repository to your designated jsdoc
template directory, then:
$ jsdoc entry-file.js -t path/to/bookshelf-jsdoc-theme
Styles
Stlyes must be compiled if edited:
$ npm run styles
Node.js Dependency
In your projects package.json
file add a generate script:
"script": {
"generate-docs": "jsdoc --configure .jsdoc.json --verbose"
}
In your .jsdoc.json
file, add a template option.
"opts": {
"template": "./node_modules/bookshelf-jsdoc-theme"
}
Example JSDoc Config
{
"tags": {
"allowUnknownTags": true,
"dictionaries": ["jsdoc"]
},
"source": {
"include": ["lib", "package.json", "README.md"],
"includePattern": ".js$",
"excludePattern": "(node_modules/|docs)"
},
"plugins": [
"plugins/markdown"
],
"templates": {
"cleverLinks": false,
"monospaceLinks": true
},
"opts": {
"destination": "./docs/",
"encoding": "utf8",
"private": true,
"recurse": true,
"template": "./node_modules/bookshelf-jsdoc-theme"
"whitelist": ['Optional', 'List', 'Of', 'Top', 'Level', 'Classes']
"changelog": './path-to/CHANGELOG.md',
"title": "Bookshelf.js"
}
}
License
Licensed under the Apache2 license.