12

有人知道是否有 raml2html 到 Raml 1.0 的版本?我只找到了适用于 Raml 0.8 的工具,例如raml2htmlraml2md,但不适用于 Raml 1.0。

4

3 回答 3

3

raml2html 和 raml2md 的所有者已经离开,这两个 repos 现在不在维护中。

raml2htmlraml2md依赖于raml2obj,而raml2obj依赖于raml-parser,目前仅支持 0.8。新的 raml 解析器是raml-js-parser-2,但它仍处于 beta 状态

于 2015-12-01T08:04:52.153 回答
2

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

于 2017-02-11T01:08:08.923 回答
0

我猜,raml2html 1.0 仍处于实验阶段。
raml2html 有一个技巧可以通过禁用 RAML 解析器上的验证来处理 RAML 1.0 文件。

我们需要将raml.loadFile(source)raml2obj 中的调用更改为raml.loadFile(source, {validate: false}) ref: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

于 2016-09-16T22:22:08.783 回答