Update template to render directly to docs includes directory

Signed-off-by: Christian Richter <crichter@owncloud.com>

docs/extensions/_includes/.gitignore

@@ -1 +1,2 @@
 *_configvars.md
+*-example.yaml

docs/extensions/accounts/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/accounts-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/accounts_configvars.md" >}}

docs/extensions/glauth/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/glauth-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/glauth_configvars.md" >}}

docs/extensions/graph-explorer/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/graph-explorer-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/graph-explorer_configvars.md" >}}

docs/extensions/graph/configuration.md

@@ -7,6 +7,8 @@ geekdocEditPath: edit/master/docs/extensions/graph
 geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
+## Example YAML Config
 
+{{< include file="extensions/_includes/graph-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/graph_configvars.md" >}}

docs/extensions/idm/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/idm-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/idm_configvars.md" >}}

docs/extensions/idp/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/idp-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/idp_configvars.md" >}}

docs/extensions/nats/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/nats-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/nats_configvars.md" >}}

docs/extensions/notifications/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/notifications-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/notifications_configvars.md" >}}

docs/extensions/ocs/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/ocs-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/ocs_configvars.md" >}}

docs/extensions/proxy/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/proxy-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/proxy_configvars.md" >}}

docs/extensions/settings/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/settings-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/settings_configvars.md" >}}

docs/extensions/store/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/store-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/store_configvars.md" >}}

docs/extensions/thumbnails/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/thumbnails-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/thumbnails_configvars.md" >}}

docs/extensions/web/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/web-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/web_configvars.md" >}}

docs/extensions/webdav/configuration.md

@@ -8,5 +8,8 @@ geekdocFilePath: configuration.md
 geekdocCollapseSection: true
 ---
 
+## Example YAML Config
+
+{{< include file="extensions/_includes/webdav-config-example.yaml"  language="yaml" >}}
 
 {{< include file="extensions/_includes/webdav_configvars.md" >}}

docs/helpers/example-config-generator.go.tmpl

@@ -34,14 +34,20 @@ func main() {
 		{{- end}}
 	}
 	for pkg, yml := range cfg {
-		targetFolder := filepath.Join("../../", pkg, "/config")
-		os.MkdirAll(targetFolder, 0700)
-		targetYamlFile, err := os.Create(filepath.Join(targetFolder, replacer.Replace(pkg) + "-config-example.yaml"))
-		if err != nil {
-			log.Fatalf("Failed to create target file for : %s", err)
+		targetFolders := []string{
+			// TODO: comment in when it is clear how to commit this to the structure of the master|main branch
+			// filepath.Join("../../", pkg, "/config"),
+			"../../docs/extensions/_includes/",
+		}
+		for _, targetFolder := range targetFolders {
+			os.MkdirAll(targetFolder, 0700)
+			targetYamlFile, err := os.Create(filepath.Join(targetFolder, replacer.Replace(pkg) + "-config-example.yaml"))
+			if err != nil {
+				log.Fatalf("Failed to create target file for : %s", err)
+			}
+			defer targetYamlFile.Close()
+			targetYamlFile.WriteString(yml)
 		}
-		defer targetYamlFile.Close()
-		targetYamlFile.WriteString(yml)
 	}
 }