RAML文档生成器raml2html详解

raml2html是一款从RAML到HTML的文档生成器，JavaScript语言编写。
raml2html默认支持Node.js，支持默认或定制theme。

1. 版本
raml2html 3.x支持RAML 0.8

raml2html 4支持RAML 1.0

2. 安装

npm i -g raml2html

安装Markdown主题

npm i -g raml2html-markdown-theme

3. 作为命令行工具使用

raml2html --help
raml2html examples\helloworld.raml > helloworld.html
raml2html --theme raml2html-markdown-theme examples\helloworld.raml > example.html
raml2html --template my-custom-template.nunjucks -i examples\helloworld.raml -o example.html

生成的页面如下：

4. 作为JS类库使用

const raml2html = require('raml2html');
const configWithDefaultTheme = raml2html.getConfigForTheme();
const configForDifferentTheme = raml2html.getConfigForTheme('raml2html-markdown-theme');
const configWithCustomTemplate = raml2html.getConfigForTemplate('~/path/to/my-custom-template.nunjucks');
raml2html.render(source, configForDifferentTheme).then(function(result) {
    // Save the result to a file or do something else with the result
    }, function(error) {
        // Output error
    });

参考链接：

https://github.com/raml2html/raml2html