dapepe/documentor

Super intuitive documentation generator, from markdown files to a single html file (style, scripts, images, search engine embedded). —

A super intuitive doc generator from Markdown files

Installation

npm -g i documentor

or for yarn users: yarn global add documentor

Quick Usage

documentor init  # initialisation of the documentation

documentor ./myName -o output.html  # render the documentation to output.html

Documentation

Please check the documentation for more details.

Command Line Usage

• -i, --input: Input folder (optional flag)
• -o, --output: Write in file
• -c, --config: Configuration file
• -w, --watch: Watch docs files with partial generation
• -v, --verbose: Configuration file
• --var, --variable: Set or override config variable(s)
• -h, --help: Show help

Examples

Generate project.html from ./docs folder

documentor ./docs -o out.html

Output html to STDOUT from ./docs folder and read the configuration file conf.yml

documentor docs -c conf.yml

Generate "out.html" with a custom name and footer

documentor ./docs -o out.html --var.name "My Project" --var.footer "(c) Project 1.0"

Watch the "docs" folder and regenerate "out.html" on change

documentor docs -o out.html -w

Dev

yarn install

Test

yarn test

Screenshot

TODO

• Embed images from markdown