-
Notifications
You must be signed in to change notification settings - Fork 3
/
index.js
42 lines (41 loc) · 1.3 KB
/
index.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
/**
* @name Installation
* @summary
*
* ```
* npm install dmd-readable
* ```
*/
/**
* @name About
* @summary
* Pass the plug-in name to [`jsdoc2md`](https://github.com/jsdoc2md/jsdoc-to-markdown) or [`dmd`](https://github.com/jsdoc2md/dmd):
*
* ```
* jsdoc2md --plugin dmd-readable
* ```
*
* This plugin (which was used to generate this readme) does a few things:
* - removes global indexes (see below)
* - places descriptions in block-quotes (Use @summary for descriptions without block quotes)
* - adds more whitespace before headings
* - changes the delimiter for multiple types in param tables to a comma
* - adds alias output
*
* The removal of global indexes is now a setting in the [template](docs.hbs). If you are using your own template and you wish to retain this feature, add the following line to your template:
*
* ```
* {{optionSet "global-index-format" "none"~}}
* ```
*
* All options for global-index-format are "none", "grouped", "table", "dl". Other options and more info can be found [here](https://github.com/jsdoc2md/jsdoc-to-markdown/blob/master/docs/API.md#jsdoctomarkdown-).
*
* This plugin also provides the following helper functions:
*
*/
module.exports = function() {
return {
partial: __dirname + "/partials/main/**/*.hbs",
helper: __dirname + "/helper.js"
};
};