RAML文档生成器raml2html详解

本文主要是介绍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

这篇关于RAML文档生成器raml2html详解的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！

---