Skip to content

Commit 52d9ba5

Browse files
mhalbritterwilkinsona
authored andcommitted
Move appendix subsections under appendix section
This involved a small code change to the generated configuration properties snippets. The section id has to start with 'appendix.', otherwise the section-id asciidoctor extension complains. To ensure that the anchors that are derived from the section IDs remain backwards compatible, the anchor-rewrite properties have been updated. See gh-29667
1 parent 48fe151 commit 52d9ba5

38 files changed

+237
-166
lines changed

buildSrc/src/main/java/org/springframework/boot/build/context/properties/Snippets.java

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,9 @@ private Set<String> writeSnippet(Path outputDirectory, Snippet snippet, Set<Stri
9090

9191
private Asciidoc getAsciidoc(Snippet snippet, Table table) {
9292
Asciidoc asciidoc = new Asciidoc();
93-
asciidoc.appendln("[[" + snippet.getAnchor() + "]]");
93+
// We have to prepend 'appendix.' as a section id here, otherwise the
94+
// spring-asciidoctor-extensions:section-id asciidoctor extension complains
95+
asciidoc.appendln("[[appendix." + snippet.getAnchor() + "]]");
9496
asciidoc.appendln("== ", snippet.getTitle());
9597
table.write(asciidoc);
9698
return asciidoc;

spring-boot-project/spring-boot-docs/src/docs/asciidoc/anchor-rewrite.properties

Lines changed: 144 additions & 75 deletions
Large diffs are not rendered by default.

spring-boot-project/spring-boot-docs/src/docs/asciidoc/application-properties.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[appendix]
2-
[[application-properties]]
2+
[[appendix.application-properties]]
33
= Common Application Properties
44
include::attributes.adoc[]
55

spring-boot-project/spring-boot-docs/src/docs/asciidoc/auto-configuration-classes.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[appendix]
2-
[[auto-configuration-classes]]
2+
[[appendix.auto-configuration-classes]]
33
= Auto-configuration Classes
44
include::attributes.adoc[]
55

spring-boot-project/spring-boot-docs/src/docs/asciidoc/auto-configuration-classes/actuator.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
[[auto-configuration-classes.actuator]]
1+
[[appendix.auto-configuration-classes.actuator]]
22
== spring-boot-actuator-autoconfigure
33
The following auto-configuration classes are from the `spring-boot-actuator-autoconfigure` module:
44

spring-boot-project/spring-boot-docs/src/docs/asciidoc/auto-configuration-classes/core.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
[[auto-configuration-classes.core]]
1+
[[appendix.auto-configuration-classes.core]]
22
== spring-boot-autoconfigure
33
The following auto-configuration classes are from the `spring-boot-autoconfigure` module:
44

spring-boot-project/spring-boot-docs/src/docs/asciidoc/build-tool-plugins/other-build-systems.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
[[build-tool-plugins.other-build-systems]]
22
== Supporting Other Build Systems
33
If you want to use a build tool other than Maven, Gradle, or Ant, you likely need to develop your own plugin.
4-
Executable jars need to follow a specific format and certain entries need to be written in an uncompressed form (see the "`<<executable-jar#executable-jar, executable jar format>>`" section in the appendix for details).
4+
Executable jars need to follow a specific format and certain entries need to be written in an uncompressed form (see the "`<<executable-jar#appendix.executable-jar, executable jar format>>`" section in the appendix for details).
55

66
The Spring Boot Maven and Gradle plugins both make use of `spring-boot-loader-tools` to actually generate jars.
77
If you need to, you may use this library directly.
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[[build-tool-plugins.whats-next]]
22
== What to Read Next
33
If you are interested in how the build tool plugins work, you can look at the {spring-boot-code}/spring-boot-project/spring-boot-tools[`spring-boot-tools`] module on GitHub.
4-
More technical details of the executable jar format are covered in <<executable-jar#executable-jar,the appendix>>.
4+
More technical details of the executable jar format are covered in <<executable-jar#appendix.executable-jar,the appendix>>.
55

66
If you have specific build-related questions, you can check out the "`<<howto#howto, how-to>>`" guides.

spring-boot-project/spring-boot-docs/src/docs/asciidoc/cli/using-the-cli.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -146,7 +146,7 @@ Doing so consults Spring Boot's default dependency metadata to deduce the artifa
146146

147147
NOTE: The default metadata is tied to the version of the CLI that you use.
148148
It changes only when you move to a new version of the CLI, putting you in control of when the versions of your dependencies may change.
149-
A table showing the dependencies and their versions that are included in the default metadata can be found in the <<dependency-versions#dependency-versions,appendix>>.
149+
A table showing the dependencies and their versions that are included in the default metadata can be found in the <<dependency-versions#appendix.dependency-versions,appendix>>.
150150

151151

152152

spring-boot-project/spring-boot-docs/src/docs/asciidoc/configuration-metadata.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[appendix]
2-
[[configuration-metadata]]
2+
[[appendix.configuration-metadata]]
33
= Configuration Metadata
44
include::attributes.adoc[]
55

@@ -9,7 +9,7 @@ Spring Boot jars include metadata files that provide details of all supported co
99
The files are designed to let IDE developers offer contextual help and "`code completion`" as users are working with `application.properties` or `application.yml` files.
1010

1111
The majority of the metadata file is generated automatically at compile time by processing all items annotated with `@ConfigurationProperties`.
12-
However, it is possible to <<configuration-metadata#configuration-metadata.annotation-processor.adding-additional-metadata,write part of the metadata manually>> for corner cases or more advanced use cases.
12+
However, it is possible to <<configuration-metadata#appendix.configuration-metadata.annotation-processor.adding-additional-metadata,write part of the metadata manually>> for corner cases or more advanced use cases.
1313

1414

1515

0 commit comments

Comments
 (0)