dmd-readme
A plugin for clean readme docs
Installation
$ npm i dmd-readme --save# or $ yarn add dmd-readme
Usage
Description:
Pass the plug-in name to jsdoc2md
or dmd
:
jsdoc2md --plugin dmd-readme
This plugin is initially a fork from dmd-readable, which:
- removes global indexes
- places descriptions in block-quotes
- adds more whitespace before headings
- changes the delimiter for multiple types in param tables to a comma
- adds alias output
*
config(path) ⇒ Param | Type | Description |
---|---|---|
path | string |
The config path |
Description:
Grabs configuration options
features()
Description:
Loads AVA test files located config.features
*
pkg(key) ⇒ See: docs.hbs for an example of how to use this function
Param | Type | Description |
---|---|---|
key | string |
The package property you want returned |
Description:
Reads info from the package.json file.
string
prefixLines(string, replacer) ⇒ Param | Type | Description |
---|---|---|
string | string |
The string to modify |
replacer | string |
The string to prefix to each line |
Description:
Prefixes a string to the beginning of each line in the first string
String
stripJsdocComment(jsDocCommentBlock, replaceValue) ⇒ Param | Type | Description |
---|---|---|
jsDocCommentBlock | String |
|
replaceValue | String |
Value with to replace comment blocks |
Returns: String
- The comment without the asterisks
Description:
Removes all asterisks and additional white spaces from JSDoc comments
Example
const jsDocSyntax = `/** * A JSDoc description * * Hello **\/` // => Outputs: // A JSDoc description // // Hello
string
jsCodeToMd(jsCode) ⇒ Param | Type |
---|---|
jsCode | String |
Description:
Converts given jsCode
into markdown by stripping jsDoc comments
License
© 2020-present Martin Rafael Gonzalez tin@devtin.io