Reworked inter documentation links.

Related to: debops/docs#153

.gitignore

@@ -0,0 +1,6 @@
+## For quick testing.
+## Generated by https://github.com/ypid/ypid-ansible-common/blob/master/bin/sphinx-debops-role-build
+docs/Makefile
+docs/_build/
+docs/conf.py
+docs/defaults.rst

defaults/main.yml

@@ -145,7 +145,7 @@ unattended_upgrades__dependent_origins: []
 #   Unattended upgrade blacklists
 # ---------------------------------
 
-# See :ref:`unattended_upgrades__blacklist` for more details about how
+# See :ref:`unattended_upgrades__ref_blacklist` for more details about how
 # blacklist entries can be defined.
 
 # .. envvar:: unattended_upgrades__default_blacklist
@@ -237,7 +237,7 @@ unattended_upgrades__mail_only_on_error: False
 # .. envvar:: unattended_upgrades__remove_unused
 #
 # Enable or disable automatic removal of the unused package dependencies after
-# unattended upgrade (``apt-get autoremove``).
+# unattended upgrade (:program:`apt-get autoremove`).
 unattended_upgrades__remove_unused: False
 
 

docs/defaults-configuration.rst

@@ -10,12 +10,12 @@ examples for them.
    :depth: 1
 
 
-.. _unattended_upgrades__blacklist:
+.. _unattended_upgrades__ref_blacklist:
 
 unattended_upgrades__blacklist
 ------------------------------
 
-The ``unattended_upgrades__blacklist`` and similar lists allow you to specify
+The :envvar:`unattended_upgrades__blacklist` and similar lists allow you to specify
 packages which shouldn't be upgraded automatically. You can specify them
 as simple package names or dictionaries with specific keys: