[docs] Custom template clarifications and other minor enhancements (#4167)

* [docs] Updating docsite outputs to be browsable on Github as well

* Fix links to other files
   Suffix `.md` was needed to make links works

* [docs] Add clarification to differences between customization and templating docs

* [docs] Collapsible side bar, scroll to top, minor enhancements
This commit is contained in:
Jim Schubert
2019-10-16 18:04:44 -04:00
committed by GitHub
parent 60d601ee26
commit 0e1ce6bb63
131 changed files with 1705 additions and 1133 deletions

View File

@@ -148,16 +148,13 @@ public class ConfigHelp implements Runnable {
}
private void generateMarkdownHelp(StringBuilder sb, CodegenConfig config) {
sb.append(newline);
if (Boolean.TRUE.equals(markdownHeader)) {
sb.append("---").append(newline);
sb.append("id: generator-opts-").append(config.getTag().toValue()).append("-")
.append(config.getName()).append(newline);
sb.append("title: Config Options for ").append(generatorName).append(newline);
sb.append("sidebar_label: ").append(generatorName).append(newline);
sb.append("---").append(newline);
} else {
sb.append(newline);
sb.append("## CONFIG OPTIONS");
if (Boolean.TRUE.equals(namedHeader)) {

View File

@@ -96,7 +96,7 @@ public class ListGenerators implements Runnable {
GeneratorMetadata meta = generator.getGeneratorMetadata();
if (docusaurus) {
sb.append("* ");
String id = "generators/" + generator.getName();
String id = "generators/" + generator.getName() + ".md";
sb.append("[").append(generator.getName());
if (meta != null && meta.getStability() != null && meta.getStability() != Stability.STABLE) {