【发布时间】:2016-03-04 00:25:58
【问题描述】:
有人知道是否有从 Raml2html 到 Raml 1.0 的版本?我只找到了适用于 Raml 0.8 的工具,例如 raml2html 或 raml2md,但不适用于 Raml 1.0。
【问题讨论】:
标签: node.js api documentation raml
有人知道是否有从 Raml2html 到 Raml 1.0 的版本?我只找到了适用于 Raml 0.8 的工具,例如 raml2html 或 raml2md,但不适用于 Raml 1.0。
【问题讨论】:
标签: node.js api documentation raml
您现在可能已经知道了,但是 raml2html 和 raml2md 4.x 可以处理 RAML 1.0 文件。
【讨论】:
我猜,raml2html 1.0 仍处于实验阶段。
raml2html 有一个技巧可以通过禁用 RAML 解析器上的验证来处理 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
【讨论】:
raml2html 和 raml2md 的所有者已经离开,这两个 repos 现在不在维护中。
raml2html和raml2md依赖raml2obj,raml2obj依赖raml-parser,目前只支持0.8。新的 raml 解析器是 raml-js-parser-2,但它仍处于 beta 状态
【讨论】: