Add intersphinx documentation and clean syntax

* I replaced the `:external:` syntax by a cleaner one, as suggested by
  @maiska.
* An implicit external reference is now impossible.
* Fix duplicate labels warnings
* Minor typos, including the word "orthographicallly" :)
This commit is contained in:
parulin 2025-09-13 17:13:33 -04:00
parent b052a98721
commit 1a47fc973b
No known key found for this signature in database
GPG key ID: 65099A5B0E31336C
7 changed files with 54 additions and 73 deletions

View file

@ -102,11 +102,13 @@ linkcheck_ignore = [r'^https?://[^/\s]+\.onion']
autosectionlabel_prefix_document = True
# Allows references to the docs in dev.qubes-os.org
# i.e.: :doc:`core-admin:libvirt`
intersphinx_mapping = {
'core-admin': ('https://dev.qubes-os.org/projects/core-admin/en/latest/', None),
'core-admin-client': ('https://dev.qubes-os.org/projects/core-admin-client/en/latest/', None),
'core-qrexec': ('https://dev.qubes-os.org/projects/qubes-core-qrexec/en/stable/', None),
}
intersphinx_disabled_reftypes = ["*"]
# Open Graph image for social media sharing
ogp_image = "https://www.qubes-os.org/attachment/icons/qubes-logo-icon-name-slogan-fb.png"