aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--NEWS3
-rw-r--r--doc/conf.py.in76
2 files changed, 52 insertions, 27 deletions
diff --git a/NEWS b/NEWS
index af8db216..8447b375 100644
--- a/NEWS
+++ b/NEWS
@@ -1,8 +1,9 @@
serd (0.30.9) unstable;
+ * Add fallback configuration if documentation theme is unavailable
* Fix SERD_DISABLE_DEPRECATED
- -- David Robillard <d@drobilla.net> Sat, 09 Jan 2021 17:08:32 +0000
+ -- David Robillard <d@drobilla.net> Sat, 16 Jan 2021 12:46:46 +0000
serd (0.30.8) stable;
diff --git a/doc/conf.py.in b/doc/conf.py.in
index 170ae1b1..9375f0dc 100644
--- a/doc/conf.py.in
+++ b/doc/conf.py.in
@@ -12,6 +12,12 @@ language = "en"
nitpicky = True
pygments_style = "friendly"
+try:
+ import sphinx_lv2_theme
+ have_lv2_theme = True
+except ModuleNotFoundError:
+ have_lv2_theme = False
+
# Ignore everything opaque or external for nitpicky mode
_opaque = [
"FILE",
@@ -42,44 +48,62 @@ nitpick_ignore = list(map(lambda x: ("c:identifier", x), _opaque))
# HTML output
html_static_path = ["_static"]
-html_theme = "sphinx_lv2_theme"
html_copy_source = False
html_short_title = "Serd"
-if tags.has('singlehtml'):
- html_sidebars = {
- "**": [
- "globaltoc.html",
- ]
- }
+if have_lv2_theme:
+ html_theme = "sphinx_lv2_theme"
- html_theme_options = {
- "body_max_width": "48em",
- "body_min_width": "48em",
- "description": "A lightweight library for working with RDF",
- "show_footer_version": True,
- "show_logo_version": False,
- "logo": "serd.svg",
- "logo_name": True,
- "logo_width": "8em",
- "nosidebar": False,
- "page_width": "80em",
- "sidebar_width": "18em",
- "globaltoc_maxdepth": 3,
- "globaltoc_collapse": False,
- }
+ if tags.has('singlehtml'):
+ html_sidebars = {
+ "**": [
+ "globaltoc.html",
+ ]
+ }
+
+ html_theme_options = {
+ "body_max_width": "48em",
+ "body_min_width": "48em",
+ "description": "A lightweight library for working with RDF",
+ "show_footer_version": True,
+ "show_logo_version": False,
+ "logo": "serd.svg",
+ "logo_name": True,
+ "logo_width": "8em",
+ "nosidebar": False,
+ "page_width": "80em",
+ "sidebar_width": "18em",
+ "globaltoc_maxdepth": 3,
+ "globaltoc_collapse": False,
+ }
+
+ else:
+ html_theme_options = {
+ "body_max_width": "60em",
+ "body_min_width": "40em",
+ "description": "A lightweight library for working with RDF",
+ "show_footer_version": True,
+ "show_logo_version": False,
+ "logo": "serd.svg",
+ "logo_name": True,
+ "logo_width": "8em",
+ "nosidebar": True,
+ "page_width": "60em",
+ "sidebar_width": "14em",
+ "globaltoc_maxdepth": 1,
+ "globaltoc_collapse": True,
+ }
else:
+
+ html_theme = "alabaster"
+
html_theme_options = {
"body_max_width": "60em",
"body_min_width": "40em",
"description": "A lightweight library for working with RDF",
- "show_footer_version": True,
- "show_logo_version": False,
"logo": "serd.svg",
"logo_name": True,
- "logo_width": "8em",
- "nosidebar": True,
"page_width": "60em",
"sidebar_width": "14em",
"globaltoc_maxdepth": 1,