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

Question

私はspring rest文書を使ってasciidocスニペットを生成しています。

生成したスニペットをドキュメントページに含めることができます。しかし、私は別々のadocファイルで各セクションの構造を一度定義し、インデックスファイル内の各セクションに対して1行ずつ作成したいと考えています。

= 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にようになりたい：

現在、私のindex.adocファイルには、次のようになります。 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[]