是否有一个Raml 1.0（不是0.8）HTML生成器？

Question

有人知道是否有raml2html到Raml 1.0的版本？我发现只有Raml 0.8的工具，如 raml2html 或 raml2md ，但不适用于Raml 1.0。

Answer 1

raml2html和raml2md的所有者已经离开了，而且这两个repos现在还没有维护。

raml2html和raml2md取决于raml2obj，raml2obj取决于raml-parser，它现在只支持0.8。新的raml解析器是raml-js-parser-2，但它仍处于beta状态

Answer 2

您现在可能已经知道了，但是raml2html和raml2md 4.x可以使用RAML 1.0文件。

Answer 3

我猜，raml2html 1.0仍处于试验阶段 通过禁用RAML解析器上的验证，raml2html可以使用RAML 1.0文件。

我们需要将raml2obj中的raml.loadFile(source)电话更改为raml.loadFile(source, {validate: false}) 参考：https://github.com/raml2html/raml2html/issues/156

此链接可以为您提供更多帮助：http://forums.raml.org/t/recommended-tool-for-raml-1-0-to-html/1251/8

这里可能是raml2html工具的替代品： https://github.com/PGSSoft/ramlo 它正在生成用RAML编写的RESTful API文档，并支持1.0