dauer commented on issue #14898: URL: https://github.com/apache/grails-core/issues/14898#issuecomment-3191054646
The issue is that the documentation is assembled from multiple documents. The root document `index.adoc` includes multiple other documents fx. `advancedGORMFeatures/eventsAutoTimestamping.adoc` When the included documents are processed individually Asciidoctor complains about the headlines starting from level 3 (which is where the root document expects them). I think a solution is to write the documents as if they where not to be inserted in the root document (treat them as individual docs), meaning headlines starts from level 1. When inserted into the root document (`index.adoc`) we then adjust the level offset: `include::advancedGORMFeatures/eventsAutoTimestamping.adoc[leveloffset=+2]` https://docs.asciidoctor.org/asciidoc/latest/directives/include-with-leveloffset/ The drawback is that it requires some editing, there are a lot of `*.adoc` files... -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: notifications-unsubscr...@grails.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
