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

Rest 如何使用RAML在API端点文档中显示绝对URL?,rest,documentation,raml,Rest,Documentation,Raml,我正在使用它来记录我的RESTAPI。在RAML文档中,我在根级别指定了基本URL baseUri: http://api.example.org/api/{version} version: v1 然后在文档的API端点部分,我指定了它们相对于这个基的URL,例如 /foo/bar: get: description: blah blah blah 当我运行raml2html从RAML文档生成HTML页面时,API端点的文档中会显示相对URL/foo/bar,但我更愿意

我正在使用它来记录我的RESTAPI。在RAML文档中,我在根级别指定了基本URL

baseUri: http://api.example.org/api/{version}
version: v1
然后在文档的API端点部分,我指定了它们相对于这个基的URL,例如

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

当我运行
raml2html
从RAML文档生成HTML页面时,API端点的文档中会显示相对URL
/foo/bar
,但我更愿意显示绝对URL
http://api.example.org/api/v1/foo/bar
相反,这可能吗

raml2html
允许对整个文档包装、每个资源和每个项目使用自定义模板


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

是否有提供自定义模板的示例/教程?您可以使用现有模板作为示例: