aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMarcin Aman <marcin.aman@gmail.com>2021-04-19 13:00:31 +0200
committerMarcin Aman <marcin.aman@gmail.com>2021-04-19 13:00:31 +0200
commit8ef365f60511ac46e8a8bb13562fab4f1de96f6d (patch)
tree1da5d4ad5b1ef4bb1fa9b464be6c925a6dce3bc4
parent46b21186e77149f4f41d3b1e8c7d66e7e5e17108 (diff)
downloaddokka-8ef365f60511ac46e8a8bb13562fab4f1de96f6d.tar.gz
dokka-8ef365f60511ac46e8a8bb13562fab4f1de96f6d.tar.bz2
dokka-8ef365f60511ac46e8a8bb13562fab4f1de96f6d.zip
Update documentation with suppressGeneratedFiles and webserver
-rw-r--r--docs/src/doc/docs/user_guide/base-specific/frontend.md6
-rw-r--r--docs/src/doc/docs/user_guide/gradle/usage.md4
2 files changed, 10 insertions, 0 deletions
diff --git a/docs/src/doc/docs/user_guide/base-specific/frontend.md b/docs/src/doc/docs/user_guide/base-specific/frontend.md
index a9fd660f..f6155085 100644
--- a/docs/src/doc/docs/user_guide/base-specific/frontend.md
+++ b/docs/src/doc/docs/user_guide/base-specific/frontend.md
@@ -1,5 +1,11 @@
# Configuration specific to HTML format
+## Prerequisites
+
+Dokka's Html format requires a web server to view documentation correctly.
+This can be achieved by using the one that is build in Intellij or providing your own.
+If this requisite is not fulfilled Dokka with fail to load navigation pane and search bars.
+
!!! important
Concepts specified below apply only to configuration of the Base Plugin (that contains Html format)
and needs to be applied via pluginsConfiguration and not on the root one.
diff --git a/docs/src/doc/docs/user_guide/gradle/usage.md b/docs/src/doc/docs/user_guide/gradle/usage.md
index 1473d928..d7210849 100644
--- a/docs/src/doc/docs/user_guide/gradle/usage.md
+++ b/docs/src/doc/docs/user_guide/gradle/usage.md
@@ -202,6 +202,10 @@ dokkaHtml {
matchingRegex.set(""".*\.internal.*""") // will match all .internal packages and sub-packages
suppress.set(true)
}
+
+ // Include generated files in documentation
+ // By default Dokka will omit all files in folder named generated that is a child of buildDir
+ suppressGeneratedFiles.set(false)
}
// Configures a plugin separately from the global configuration
pluginConfiguration<PluginClass, ConfigurationClass>{