Rework title anchors for maven docs

Closes gh-26617
This commit is contained in:
Phillip Webb
2021-05-19 21:16:06 -07:00
parent 1702c9fc3d
commit f0896c2de6
13 changed files with 158 additions and 111 deletions

View File

@@ -94,7 +94,7 @@ public class DocumentPluginGoals extends DefaultTask {
writer.println();
writer.println();
writer.printf("[[%s]]%n", sectionId);
writer.printf("== `%s:%s`%n", plugin.getGoalPrefix(), mojo.getGoal());
writer.printf("= `%s:%s`%n", plugin.getGoalPrefix(), mojo.getGoal());
writer.printf("`%s:%s:%s`%n", plugin.getGroupId(), plugin.getArtifactId(), plugin.getVersion());
writer.println();
writer.println(mojo.getDescription());
@@ -108,7 +108,7 @@ public class DocumentPluginGoals extends DefaultTask {
writer.println();
writer.println();
writer.printf("[[%s-required]]%n", parametersSectionId);
writer.println("=== Required parameters");
writer.println("== Required parameters");
writeParametersTable(writer, detailsSectionId, requiredParameters);
}
List<Parameter> optionalParameters = parameters.stream().filter((parameter) -> !parameter.isRequired())
@@ -117,13 +117,13 @@ public class DocumentPluginGoals extends DefaultTask {
writer.println();
writer.println();
writer.printf("[[%s-optional]]%n", parametersSectionId);
writer.println("=== Optional parameters");
writer.println("== Optional parameters");
writeParametersTable(writer, detailsSectionId, optionalParameters);
}
writer.println();
writer.println();
writer.printf("[[%s]]%n", detailsSectionId);
writer.println("=== Parameter details");
writer.println("== Parameter details");
writeParameterDetails(writer, parameters, detailsSectionId);
}
}
@@ -155,7 +155,7 @@ public class DocumentPluginGoals extends DefaultTask {
writer.println();
writer.println();
writer.printf("[[%s-%s]]%n", sectionId, name);
writer.printf("==== `%s`%n", name);
writer.printf("=== `%s`%n", name);
writer.println(parameter.getDescription());
writer.println();
writer.println("[cols=\"10h,90\"]");