not done yet. trying to substitute reference.conf

Author: SiyaoIsHiding

build-doc.sh

@@ -12,5 +12,17 @@ mvn clean install -DskipTests # or guava-shaded can not be found
 # mvn javadoc:javadoc -pl core,query-builder,mapper-runtime
 mvn javadoc:aggregate
 
+# Substitute the reference.yaml. I didn't find a better alternative.
+sed -i '' "/<SUBSTITUE_ME>/{
+    r core/src/main/resources/reference.conf
+    d
+}" manual/core/configuration/reference/README.md
+
 # Build manual with API references
-mkdocs build # or `mkdocs serve` to preview
+mkdocs build # or `mkdocs serve` to preview
+
+# revert the substitution
+sed -i '' "/{
+    r core/src/main/resources/reference.conf
+    d
+}/<SUBSTITUE_ME>" manual/core/configuration/reference/README.md

manual/core/configuration/README.md

@@ -552,6 +552,6 @@ config.getDefaultProfile().getInt(MyCustomOption.AWESOMENESS_FACTOR);
 
 [Typesafe Config]: https://github.com/typesafehub/config
 [config standard behavior]: https://github.com/typesafehub/config#standard-behavior
-[reference.conf]: reference/
+[reference.conf]: ./reference.conf
 [HOCON]: https://github.com/typesafehub/config/blob/master/HOCON.md
 [API conventions]: ../../api_conventions