spring restdocsは条件付きでasciidocでオプションのパラメータを強調表示します

Question

私はspring restdocsを使用して自分のREST webapiでドキュメントを作成しています。私は物事を統合し、私のHTMLが生成されます（maven + asciidocプラグイン、再保証apis）。 私が持っている唯一の問題は、ifevalが広告されたように動作しないか、間違っていることです。

マイカスタム要求-fields.snippetは、次のようになります。tablecellcontentで

|=== 
|Path|Type|Description|Optional 

{{#fields}} 
|{{#tableCellContent}} 
ifeval::["{optional}"=="true"] 
    `{{path}}` 
endif::[] 
ifeval::["{optional}"="false"] 
    *`{{path}}`* 
endif::[] 
    {{/tableCellContent}} 
    |{{#tableCellContent}}`{{type}}`{{/tableCellContent}} 
    |{{#tableCellContent}}{{description}}{{/tableCellContent}} 
    |{{#tableCellContent}}{{optional}}{{/tableCellContent}} 

{{/fields}} 
|=== 

「オプション」値は（場合によっては「true」または「false」）正しくレンダリングが、ifevalされます解析されません（したがって、最終的なhtmlではエラーなしで解析されません）。

私は式の構文を変えてみましたが、どちらもうまくいかないようです。もしあれば正しい構文であるかもしれない何かに関するヒント？ カスタム属性を定義してifndefを使用して同じ結果を得ることを考えていますが、可能ならば既存のoptional（）サポートを使用することをお勧めします。

としては、私は、問題はあなたがifevalマクロで{optional}ではなく{{optional}}を使用しているカスタムテンプレートである結果.adoc

|=== 
|Path|Type|Description|Optional 

| 
ifeval::["{optional}"=="true"] 
    `name` 
endif::[] 
ifeval::["{optional}"=="false"] 
    *`name`* 
endif::[] 
|`String` 
|Name of the new Axis 
|false 

| 
ifeval::["{optional}"=="true"] 
    `description` 
endif::[] 
ifeval::["{optional}"=="false"] 
    *`description`* 
endif::[] 
|`String` 
|Description of the new Axis 
|true 

| 
ifeval::["{optional}"=="true"] 
    `tags[]` 
endif::[] 
ifeval::["{optional}"=="false"] 
    *`tags[]`* 
endif::[] 
|`TagDto[]` 
|Hierarchical view of axis' tags 
|false 

| 
ifeval::["{optional}"=="true"] 
    `tags[].id` 
endif::[] 
ifeval::["{optional}"=="false"] 
    *`tags[].id`* 
endif::[] 
|`Number` 
|Id of the tag 
|false 

| 
ifeval::["{optional}"=="true"] 
    `tags[].name` 
endif::[] 
ifeval::["{optional}"=="false"] 
    *`tags[].name`* 
endif::[] 
|`String` 
|Name of the tag 
|false 

| 
ifeval::["{optional}"=="true"] 
    `tags[].children` 
endif::[] 
ifeval::["{optional}"=="false"] 
    *`tags[].children`* 
endif::[] 
|`TagDto[]` 
|Child tags for this tag, if any 
|true 

|=== 

Answer 1

を追加してい要求しました。つまり、{optional}がフィールドのoptional属性に置き換えられていないため、Asciidoctorは"{optional}"=="true"または"{optional}"=="false"のいずれかを評価しています。

あなたは{{optional}}を使用するようにテンプレートを更新する必要があります。

|=== 
|Path|Type|Description|Optional 

{{#fields}} 
|{{#tableCellContent}} 
ifeval::["{{optional}}"=="true"] 
    `{{path}}` 
endif::[] 
ifeval::["{{optional}}"=="false"] 
    *`{{path}}`* 
endif::[] 
    {{/tableCellContent}} 
    |{{#tableCellContent}}`{{type}}`{{/tableCellContent}} 
    |{{#tableCellContent}}{{description}}{{/tableCellContent}} 
    |{{#tableCellContent}}{{optional}}{{/tableCellContent}} 

{{/fields}} 
|===