dmd-readable v1.2.4

Dmd Readable

A plugin for dmd and jsdoc-to-markdown to provide more readable docs

Installation

npm install dmd-readable

About

Pass the plug-in name to jsdoc2md or 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. 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.

This plugin also provides the following helper functions:

package(key) ⇒ *

Reads info from the package.json file.

See: docs.hbs for an example of how to use this function

changeCase(to, string) ⇒ string

Implements the library change-case.

See: docs.hbs for an example of how to use this function

prefixLines(string, replacer) ⇒ string

Prefixes a string to the beginning of each line in the first string

findBy(array, key, value) ⇒ array

Finds an object in an array with a matching key: value

replace(string, pattern, newString) ⇒ string

Calls string.replace

isNew(string) ⇒ boolean

Determines if the provided string is truthy and is different than the string provided the previous time this function was called