Skip to content

Commit a5a4960

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 2342f5f commit a5a4960

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
@@ -8378,4 +8378,4 @@ within Web services.
83788378

83798379

83808380

8381-
include::data-access-appendix.adoc[leveloffset=+1]
8381+
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
@@ -7873,4 +7873,4 @@ directly through the backing cache (when configuring it) or through its native A
78737873

78747874

78757875

7876-
include::integration-appendix.adoc[leveloffset=+1]
7876+
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
@@ -8494,7 +8494,7 @@ Spring MVC Test's own tests include
84948494
https://github.com/spring-projects/spring-framework/tree/master/spring-test/src/test/java/org/springframework/test/web/client/samples[example
84958495
tests] of client-side REST tests.
84968496

8497-
include::testing-webtestclient.adoc[leveloffset=+2]
8497+
include::testing/testing-webtestclient.adoc[leveloffset=+2]
84988498

84998499

85008500

File renamed without changes.

0 commit comments

Comments
 (0)