【问题标题】:Is there a Raml 1.0 (not 0.8) HTML generator? [closed]是否有 Raml 1.0(不是 0.8)HTML 生成器? [关闭]
【发布时间】:2016-03-04 00:25:58
【问题描述】:

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

【问题讨论】:

    标签: node.js api documentation raml


    【解决方案1】:

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

    【讨论】:

      【解决方案2】:

      我猜,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

      【讨论】:

        【解决方案3】:

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

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

        【讨论】:

        • 好吧,所有者(我)一直在寻找新的维护者,但从未离开。尽管我仍在寻找新的维护者和贡献者,但 repos 仍在维护中!
        猜你喜欢
        • 1970-01-01
        • 2011-05-16
        • 1970-01-01
        • 2015-03-01
        • 1970-01-01
        • 2011-02-24
        • 2014-09-28
        • 2017-03-18
        • 1970-01-01
        相关资源
        最近更新 更多