JSDoc Template !CI

A decent template for JSDoc, redesigned from the default template.

Check out the demo.

Use it

$3


``bash
npm i @alexispuga/jsdoc-template
jsdoc your/files -t ./node_modules/@alexispuga/jsdoc-template
`

Previews





Customize it

Make this template yours too:
- Create a ` jsdoc.config.js ` file.
- Modify it (see all supported properties).
- Load it from jsdoc: ` jsdoc your/files -t this/template -c your/jsdoc.config.js `.

$3

#### Changing the default font (the simplest way)
`js
// jsdoc.config.js

module.exports = {
templates: {
// Options for this template.
custom: {
tags: {
head: [

]
}
}
}
}

`

#### Changing the theme for the prettified code and replacing it with my own (this time by using a JSON)

`json

{
"templates": {
"default": {
"staticFiles": {
"include": [
"./path/to/your/theme.css"
]
}
},
"custom": {
"themes": {
"prettify": "theme.css"
}
}
}
}

`

#### Changing the site name and adding a favicon

`javascript
// jsdoc.config.js

module.exports = {
templates: {
default: {
staticFiles: {
include: [
'path/to/your/favicon-32x32.png'
]
}
},
custom: {
siteName: 'My site',
tags: {
head: [

]
}
}
}
};

``

Contribute

Your contributions are welcome (and needed). Please check the CONTRIBUTING file for details.

Versioning

This project uses SemVer for versioning. See the available versions here.

License

Any modification made to the default template is licensed under the Apache License, Version 2.0 - See the LICENSE file for details.

For more information, check the main project.

Acknowledgments

Thanks to all people who contributed to this project, and people who participated in the original one.