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

Question

我正在使用 spring rest 文档生成 asciidoc sn-ps。

我可以在我的文档页面中包含生成的 sn-ps。但是，我想在单独的 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[]

我希望它变成这样

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

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

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

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

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