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

Question

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

我可以在我的文档页面中包含生成的片段。但是，我想在单独的 adoc 文件中定义每个部分的结构一次，并在我的索引文件中为每个部分定义一行。

目前我的 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[]

我希望它变成这样

索引.adoc

= My Http Api Docs

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

我的模板文件

= {method} {desc}

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

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

任何人都知道如何做到这一点？

Answer 1

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

我的 index.adoc 文件看起来像这样，它可以工作:

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

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