これは StackOverflow に関する私の最初の質問です。
Java 11、Spring Boot 2.4.0、JUnit 5、Auto Rest Docs 2.0.9 を使用しています。
ドキュメントの生成中に次の警告が表示されます。
asciidoctor: WARNING: C:/{path-to-project}/build/generated-snippets/register_success/auto-section.adoc: line 2: section title out of sequence: expected level 2, got level 3
2 行目は次のようになります。==== Register
ドキュメントの構造は次のようになります。
= API Methods
== Account Registration Operations
include::{snippets}/register_success/auto-section.adoc[]
== Other level 1 section
=== Level 2 section
include::{snippets}/{other-method-name}/auto-section.adoc[]
内に直接含まれるすべてのスニペットに対して警告がありますLevel 1 section。
内部のスニペットについては、Level 2 sectionすべて問題ありません。
警告が表示される理由は理解できますが、自動生成されたスニペット内でタイトル レベルを構成するにはどうすればよいですか?
セクション タイトルがレベル 2 になるように設定する方法があれば、Level 2 section(のようなexpected level 3, got level 2) 内のスニペットに対して警告が表示される可能性があります。
自動生成されたスニペット内のセクション タイトルのレベルを自動的に設定する方法はありますか? (含まれる親セクション レベルに基づく)
または、各単体テスト内で意図するレベルを指定する方法さえあります。
ドキュメントを確認しましたが、何も見つかりませんでした。どんな助けでも大歓迎です。ありがとうございました！