Rest 如何使用RAML在API端点文档中显示绝对URL?
我正在使用它来记录我的RESTAPI。在RAML文档中,我在根级别指定了基本URLRest 如何使用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,但我更愿意
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
,但我更愿意显示绝对URLhttp://api.example.org/api/v1/foo/bar
相反,这可能吗 raml2html
允许对整个文档包装、每个资源和每个项目使用自定义模板
在您的情况下,您希望自定义资源模板,然后将其与
-r custom resource.handlebar
参数一起使用。是否有提供自定义模板的示例/教程?您可以使用现有模板作为示例: