asciidoc - asciidoc でテンプレート ファイルにパラメーターを渡す

Question

スプリング レスト ドキュメントを使用して asciidoc スニペットを生成しています。

生成されたスニペットをドキュメント ページに含めることができます。ただし、個別の adoc ファイルで各セクションの構造を 1 回定義し、インデックス ファイルにそれらのそれぞれに 1 行を追加したいと考えています。

現在、私の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[]