1.0.1-beta • Published 5 years ago
dmd-readme v1.0.1-beta
Installation
$ npm i dmd-readme --save
# or
$ yarn add dmd-readmeUsage
Description:
Pass the plug-in name to jsdoc2md or dmd:
jsdoc2md --plugin dmd-readmeThis 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.
prefixLines(string, replacer) ⇒ string
| 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
stripJsdocComment(jsDocCommentBlock, replaceValue) ⇒ String
| 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
//
// HellojsCodeToMd(jsCode) ⇒ string
| Param | Type |
|---|---|
| jsCode | String |
Description:
Converts given jsCode into markdown by stripping jsDoc comments
License
© 2020-present Martin Rafael Gonzalez tin@devtin.io
1.0.1-beta
5 years ago
1.0.0
5 years ago