VCL Documentation Generator

A documentation generator for the VCL based on a set of modules or an entry point package.json and its recursive dependencies. In most cases you want the doc-gen to use a single package.json listing all dependencies from your project. The output will look like the VCL's module browser.

Under the Hood

The main purpose of this module is to generate a JSON data structure in which all information is held. Modules considered need to have a vcl property in the package.json file according to the structure explained here.

Each module's documentation file (default is README.md) is picked and copied into the JSON structure as well as the meta data from package.json.

The JSON data is rendered into a browsable documentation based on HTML by the vcl-doc-client module.

Usage

CLI

npm -g i @vcl/doc-gen
cd someProject
vcl-doc-gen --entry ./package.json --output doc.html

Arguments

All arguments are optional.

Option | Default | Description --- | --- | --- --name | VCL Documentation | Browser Title & Main heading --output | vcl-documentation.html| Output HTML file --entry | ./package.json | Entry file. --basePath| current working dir |

See Options for a more detailed description.

Local CLI

npm install --save-dev @vcl/doc-gen
./node_modules/.bin/vcl-doc-gen

Generate HTML

var docGenerator = require('@vcl/doc-gen');

docGenerator.generateHtml({
  name: 'VCL Documentation',
  entryPackage: './package.json',
  output: './documentation.html'
});

Generate JSON

var docGenerator = require('@vcl/doc-gen');

docGenerator.generate({
  name: 'VCL Documentation',
  entryPackage: './package.json',
  output: './doc.json'
});

Options

name

The name of the documentation. When using vcl-doc-client this will be displayed in the header and set as the page title.

Default: name: 'VCL Documentation'

entryPackage

The package that the doc-gen should parse to find all VCL dependencies and generate the documentation from.

Example: entryPackage: './package.json'

packages

You can put a list of paths to additional packages here or use this as an alternative to the entryPackage option and set your packages manually.

Example: packages: ['../vcl-test', './some/package']

output

The file to output the finished JSON doc.

Default: output: './doc.json'

removeTopHeading

With this option, all level 1 headings from the package readme files are removed. Defaults to true, because most packages have the package name as the first heading and the vcl-doc-client does already display the package name above the readme.

Default: removeTopHeading: true

basePath

The base path.

Example: basePath: './my-project'