dok

create docs

dok

JavaScript documentation generator based on JSDoc.

npm install doc -g

Usage: dok [options] [command]
 
Commands:
 
  create                 create docs/ folder with .md partials and index.html
  publish                push docs to gh-pages
  readme [options]       include .md partials in your README.md
 
Options:
 
  -h, --help     output usage information
  -V, --version  output the version number

dok has created docs for itself. Check them out.

dok uses JSDoc to parse comments. It comes with a patched version of the haruki theme that includes line numbers. Those are required for deep linking to source code on GitHub.

dok create parses JSDoc comments from your index.js. It creates a new directory docs/includes/ with markdown files for all functions. It also create an index.html file with some CSS and JS which is the root for gh-pages.

dok publish pushes all content from the docs/ directory to gh-pages.

dok readme adds all markdown partials to your README.md. By default all content is placed below '## Methods'.

JSDoc uses <caption></caption> tags for @example captions.

/**
 * @example <caption>config.js (all other DBs)</caption>
 * exports.db = {
 *   url: 'postgres://127.0.0.1:5432/',
 *   name: 'users',
 *   collection: 'my_user_table'
 * }
 */

That's pretty hard to read and to write. dok uses plain markdown.

/**
 * @example
 * `config.js (all other DBs)`
 *
 * exports.db = {
 *   url: 'postgres://127.0.0.1:5432/',
 *   name: 'users',
 *   collection: 'my_user_table'
 * }
 */

not yet

npm test

MIT