Skip to content

Commit c275989

Browse files
committed
Do not generate reference docs for include-files
Prior to this commit, the Asciidoctor Gradle tasks generated top-level HTML and PDF documents for AsciiDoc files that are included in other top-level documents. This causes slower builds and results in each include-file being published twice: 1) inline in the including document (as intended) 2) as a top-level document but missing surrounding context (unintended) The reason these include-files are generated as top-level documents is that the asciidoctor and asciidoctorPdf Gradle tasks are configured to use '*.adoc' as the input source files. This commit addresses this issue by moving the following include-files to new subdirectories. Locating the include-files in the subdirectories causes them to be ignored in the '*.adoc' pattern used to identify input source files. - data-access-appendix.adoc -> data-access/data-access-appendix.adoc - integration-appendix.adoc -> integration/integration-appendix.adoc - testing-webtestclient.adoc -> testing/testing-webtestclient.adoc Closes gh-25783
1 parent 9486ece commit c275989

File tree

6 files changed

+3
-3
lines changed

6 files changed

+3
-3
lines changed

src/docs/asciidoc/data-access.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7037,4 +7037,4 @@ within Web services.
70377037

70387038

70397039

7040-
include::data-access-appendix.adoc[leveloffset=+1]
7040+
include::data-access/data-access-appendix.adoc[leveloffset=+1]
File renamed without changes.

src/docs/asciidoc/integration.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8289,4 +8289,4 @@ directly through the backing cache (when configuring it) or through its native A
82898289

82908290

82918291

8292-
include::integration-appendix.adoc[leveloffset=+1]
8292+
include::integration/integration-appendix.adoc[leveloffset=+1]
File renamed without changes.

src/docs/asciidoc/testing.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6186,7 +6186,7 @@ Spring MVC Test's own tests include
61866186
https://github.com/spring-projects/spring-framework/tree/master/spring-test/src/test/java/org/springframework/test/web/client/samples[example
61876187
tests] of client-side REST tests.
61886188

6189-
include::testing-webtestclient.adoc[leveloffset=+2]
6189+
include::testing/testing-webtestclient.adoc[leveloffset=+2]
61906190

61916191

61926192

File renamed without changes.

0 commit comments

Comments
 (0)