docs: improve generation of default config files

- config files are placed into `docs/generated/conf/`, using the
  expected name, and without any indentation
- `literalinclude::` is used instead of `include::`
- uses `:download:` instead of `:file:` to allow for downloading the
  generated files easily
This commit is contained in:
Daniel Hahler
2018-06-16 18:35:58 +02:00
parent 49b065cbe7
commit 8a0cd73821
3 changed files with 12 additions and 15 deletions

View File

@@ -152,6 +152,7 @@ Command Line Interface
Sample diff.conf
-----------------
Below is a sample :file:`diff.conf` with all default settings.
Below is a sample :download:`diff.conf </generated/conf/diff.conf>` with all default settings.
.. include:: /generated/conf-kitten-diff-literal.rst
.. literalinclude:: /generated/conf/diff.conf
:language: conf