html 文档生成器,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 example.raml > example.html

raml2html --theme raml2html-markdown-theme example.raml > example.html

raml2html --template my-custom-template.nunjucks -i example.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