RAML to HTML documentation generator
A simple RAML to HTML documentation generator, written for Node.js. Check raml2md for a RAML to Markdown generator.
raml2html 4 and higher only support RAML 1.0 files. Please stick with raml2html 3.x for RAML 0.8 support.
npm i -g raml2html
raml2html --helpraml2html example.raml > example.htmlraml2html -t examples/custom-template-test/template.nunjucks -i example.raml -o example.html
const raml2html = ;const configWithDefaultTemplates = raml2html;const configWithCustomTemplates = raml2html;// source can either be a filename, url, or parsed RAML objectraml2html;
/*** 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;
If you only want to configure the default Nunjucks environment you don't have to override the entire
function. Just get the default config (
const config = raml2html.getDefaultConfig();) and add a
to it that takes
env as its only parameter.
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.
There's a third party Grunt plugin at https://www.npmjs.org/package/grunt-raml2html.
Please see the following links for live examples: https://rawgit.com/raml2html/raml2html/master/examples/helloworld.html https://rawgit.com/raml2html/raml2html/master/examples/world-music-api.html
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.
npm run lintbefore committing.
If your pull request is merged feel free to ask for push access. We want to get more maintainers! If you do have push access, please still work on feature branches and create pull requests, which then get reviewed. You can also review other people's pull requests and be involved in that way.
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.
raml2html is available under the MIT license. See the LICENSE file for more info.