如何使用RAML在API端点文档中显示绝对URL？

Question

我正在使用RAML来记录我的REST API。在RAML文档中，我在根级别指定基本URL

baseUri: http://api.example.org/api/{version}
version: v1

然后，在doc的API端点部分，我指定了相对于此基础的URL，例如

/foo/bar:
    get:
      description: blah blah blah

当我运行raml2html从RAML文档生成HTML页面时，相对URL /foo/bar显示在API端点的文档中，但我更希望显示绝对URL {{相反，这可能吗？

Answer 1

raml2html允许为整个文档包装器，每个资源和每个项目使用自定义模板。

在您的情况下，您希望自定义资源模板，然后将其与-r custom-resource.handlebars参数一起使用。