Use extlinks extension

Provides an easy way to link to Github issues, Forum topics, Qubes website
and Wikipedia articles.
This commit is contained in:
parulin 2025-07-27 12:47:41 -04:00
parent ba609d123e
commit e17e04a1bb
No known key found for this signature in database
GPG key ID: BC3830B42F4BF1F5
90 changed files with 330 additions and 318 deletions

12
conf.py
View file

@ -33,6 +33,7 @@ release = '4.3'
html_static_path = ['attachment/doc']
extensions = [
'sphinx.ext.autosectionlabel',
'sphinx.ext.extlinks',
'sphinxnotes.strike',
'sphinx_reredirects'
]
@ -46,6 +47,17 @@ redirects = {
"developer/general/how-to-edit-the-documentation":"https://www.qubes-os.org/doc/how-to-edit-the-documentation/"
}
extlinks = {'issue': ('https://github.com/QubesOS/qubes-issues/issues/%s',
'issue #%s'),
'topic': ('https://forum.qubes-os.org/t/%s',
'forum topic #%s'),
'website': ('https://www.qubes-os.org/%s',
None),
'wikipedia': ('https://en.wikipedia.org/wiki/%s',
'%s'),
}
extlinks_detect_hardcoded_links = True
autosectionlabel_prefix_document = True
source_suffix = {