将参数传递给asciidoc中的模板文件

Question

我正在使用spring rest docs生成asciidoc片段.

我可以在我的文档页面中包含生成的代码段.但是,我想在一个单独的adoc文件中定义每个secion的结构,并为我的索引文件中的每个文件都有一行.

目前我的index.adoc文件如下所示:

= My Http Api Docs

= GET /units/:id

== Path Parameters
include::{snippets}/units/get/path-parameters.adoc[]

== Response Fields
include::{snippets}/units/get/response-fields.adoc[]

我希望它是这样的

index.adoc

= My Http Api Docs

usemytemplates::mytemplate.adoc[method='get', url='units', desc='/units/:id']

mytemplate.adoc

= {method} {desc}

== Path Parameters
include::{snippets}/{url}/{method}/path-parameters.adoc[]

== Response Fields
include::{snippets}/{url}/{method}/response-fields.adoc[]

谁知道这样的事情怎么办？

Answer 1

我能够通过在每个include语句之前使用替换语法来解决这个问题.

我的index.adoc文件看起来像这样,它的工作原理如下:

:method: get
:url: units
:desc: /utils/:id
include::mytemplate.adoc[]

:method: get
:url: members
:desc: /members/:id
include::mytemplate.adoc[]