1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99
|
Description: Get rid of sphinx extensions not available in debian
Forwarded: not-needed
Last-Update: 2025-12-06
Author: Jérémy Lal <kapouer@melix.org>
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -16,10 +16,6 @@
import os
import sys
-import cloud_sptheme as csp # type: ignore[import-untyped]
-
-from passlib import __version__ as release
-
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
@@ -54,24 +50,6 @@
"sphinx.ext.autodoc",
"sphinx.ext.todo",
"sphinx.ext.intersphinx",
- # 'sphinx.ext.viewcode',
- # 3rd part extensions
- "sphinxcontrib.fulltoc",
- # adds extra ids & classes to genindex html, for additional styling
- "cloud_sptheme.ext.index_styling",
- # inserts toc into right hand nav bar (ala old style python docs)
- "cloud_sptheme.ext.relbar_links",
- # add "issue" role
- "cloud_sptheme.ext.issue_tracker",
- # allow table column alignment styling
- "cloud_sptheme.ext.table_styling",
- # monkeypatch sphinx to support a few extra things we can't do with extensions.
- "cloud_sptheme.ext.autodoc_sections",
- "cloud_sptheme.ext.autoattribute_search_bases",
- "cloud_sptheme.ext.docfield_markup",
- "cloud_sptheme.ext.escaped_samp_literals",
- # silence "footnote not referenced" warning -- should maybe redo these in docs :)
- "cloud_sptheme.ext.allow_unreferenced_footnotes",
]
# Add any paths that contain templates here, relative to this directory.
@@ -103,10 +81,12 @@
# |version| and |release|, also used in various other places throughout the
# built documents.
+release = 'latest'
+version = 'latest'
+
# release: The full version, including alpha/beta/rc tags.
# version: The short X.Y version.
-version = csp.get_version(release)
if ".dev" in release:
tags.add("devcopy") # type: ignore[name-defined] # noqa: F821
@@ -170,33 +150,6 @@
# further. For a list of options available for each theme, see the
# documentation.
html_theme_options: dict[str, object] = {}
-if csp.is_cloud_theme(html_theme):
- html_theme_options.update(
- roottarget=index_doc,
- issueicon=None,
- # lighter_decor=True,
- borderless_decor=True,
- sidebarbgcolor="transparent",
- small_sidebar_bg_color="#EBEBEB",
- bodytrimcolor="transparent",
- max_width="12.5in",
- sidebarwidth="3in",
- large_sidebar_width="3.5in",
- hyphenation_language="en",
- # headfont='"Bitstream Vera Sans", sans-serif',
- colored_object_prefixes="all",
- # bodyfont='arial, helvetica, sans-serif',
- relbarbgcolor="#C74A29",
- footerbgcolor="#733610",
- sectionbgcolor="#FB8A45",
- rubricbgcolor="#FFB657",
- sidebarlinkcolor="#6A3051",
- link_hover_text_color="#ff0000",
- link_hover_trim_color="#ddb1b8",
- toc_local_bg_color="#FFE8C4",
- toc_local_trim_color="#FFC68A",
- )
-
# Add any paths that contain custom themes here, relative to this directory.
# html_theme_path = []
@@ -205,7 +158,7 @@
html_title = f"{project} v{release} Documentation"
# A shorter title for the navigation bar. Default is the same as html_title.
-html_short_title = f"{project} {version} Documentation"
+html_short_title = f"{project} {release} Documentation"
# The name of an image file (relative to this directory) to place at the top
# of the sidebar.
|