raml2html

RAML to HTML documentation generator

RAML to HTML

A simple RAML to HTML documentation generator, written for Node.js. Check raml2md for a RAML to Markdown generator.

npm i -g raml2html
raml2html --help
raml2html example.raml > example.html
raml2html -t custom-template.nunjucks -p ./templates/ -i example.raml -o example.html
var raml2html = require('raml2html');
var configWithDefaultTemplates = raml2html.getDefaultConfig();
var configWithCustomTemplates = raml2html.getDefaultConfig('mytemplate.html', './templates');
 
// source can either be a filename, url, file contents (string) or parsed RAML object
raml2html.render(source, configWithDefaultTemplates).then(function(result) {
  // Save the result to a file or do something else with the result
}, function(error) {
  // Output error
});
/**
 * config should be an object with at least an `processRamlObj` property which is a function that receives the raw RAML 
 * object and must return a promise with the result. You can do whatever you want in this function.
 *
 * You can also supply a postProcessHtml function that can for example minify the generated HTML.
 */
raml2html.render(source, config).then(function(result) {
  // Save the result to a file or do something else with the result
}, function(error) {
  // Output error
});

See also example/script.js for an example of using raml2html as a library.

Please note that if you want to use a different template language, you're probably better off directly using raml2obj.

You can use the latest raml2html directly from Gulp, or use the third party gulp-raml2html plugin (which uses an outdated version of raml2html).

There's a third party Grunt plugin at https://www.npmjs.org/package/grunt-raml2html.

If you get parsing errors, please do not report them to raml2html: it doesn't do the actual RAML parsing. Review the error and fix your RAML file, or open a new issue at raml-js-parser.

raml2html is an open source project and your contribution is very much appreciated.

  1. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
  2. Fork the repository on Github and make your changes on the develop branch (or branch off of it).
    Please retain the code style that is used in the project and npm run lint before committing.
  3. Add an example of the new feature to example.raml (if applicable)
  4. Send a pull request (with the develop branch as the target).

A big thank you goes out to everyone who helped with the project, the contributors and everyone who took the time to report issues and give feedback.

See changelog.md

raml2html is available under the MIT license. See the LICENSE file for more info.