feat: configuration file snippet shortcode

Author: ldez

docs/content/docs/configuration/file.md

@@ -18,8 +18,47 @@ Config options inside the file are identical to command-line options.
 You can configure specific linters' options only within the config file (not the command-line).
 
 There is a [`.golangci.reference.yml`](https://github.com/golangci/golangci-lint/blob/HEAD/.golangci.reference.yml) file with all supported options, their descriptions, and default values.
-This file is neither a working example nor a recommended configuration, it's just a reference to display all the configuration options.
+This file is neither a working example nor a recommended configuration,
+it's just a reference to display all the configuration options used to generate the documentation.
 
 The configuration file can be validated with the JSON Schema: [golangci.jsonschema.json](https://golangci-lint.run/jsonschema/golangci.jsonschema.json)
 
-{ .ConfigurationExample }
+{{% configuration-file-snippet section="root" %}}
+
+## `version` configuration
+
+{{% configuration-file-snippet section="version" %}}
+
+## `linters` configuration
+
+{{< cards  cols=2 >}}
+{{< card link="/docs/linters" title="Linters Overview" icon="collection" >}}
+{{< card link="/docs/linters/configuration" title="Linters  Settings" icon="adjustments" >}}
+{{< /cards >}}
+
+{{% configuration-file-snippet section="linters" %}}
+
+## `formatters` configuration
+
+{{< cards  cols=2 >}}
+{{< card link="/docs/formatters" title="Formatters Overview" icon="collection" >}}
+{{< card link="/docs/formatters/configuration" title="Formatters  Settings" icon="adjustments" >}}
+{{< /cards >}}
+
+{{% configuration-file-snippet section="formatters" %}}
+
+## `issues` configuration
+
+{{% configuration-file-snippet section="issues" %}}
+
+## `output` configuration
+
+{{% configuration-file-snippet section="output" %}}
+
+## `run` configuration
+
+{{% configuration-file-snippet section="run" %}}
+
+## `severity` configuration
+
+{{% configuration-file-snippet section="severity" %}}

docs/layouts/_shortcodes/configuration-file-snippet.html

@@ -0,0 +1,16 @@
+{{- /*
+Creates a code block with the contents of a configuration file section.
+
+@param {string} section The name of the section inside the data file.
+@returns {string}
+
+@example {{% configuration-file-snippet section="sectionName" %}}
+*/ -}}
+
+{{- $sectionName := .Get "section" -}}
+
+{{- $file := index $.Site.Data.configuration_file -}}
+
+```yaml
+{{ index $file $sectionName | safeHTML }}
+```