aboutsummaryrefslogtreecommitdiffstats
path: root/doc/conf.py.in
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2023-05-11 22:43:02 -0400
committerDavid Robillard <d@drobilla.net>2023-05-11 23:12:04 -0400
commit60cbe5b9b6d42bd850c5ea39c06b6e182f9c2645 (patch)
treed10b1910875079f5724ff92b68d711a7e9a6804b /doc/conf.py.in
parent86894351ffb6cc7f9fd9a4d63ba0a6eecc64d29d (diff)
downloadserd-60cbe5b9b6d42bd850c5ea39c06b6e182f9c2645.tar.gz
serd-60cbe5b9b6d42bd850c5ea39c06b6e182f9c2645.tar.bz2
serd-60cbe5b9b6d42bd850c5ea39c06b6e182f9c2645.zip
Clean up documentation and remove junk files from install
Diffstat (limited to 'doc/conf.py.in')
-rw-r--r--doc/conf.py.in102
1 files changed, 49 insertions, 53 deletions
diff --git a/doc/conf.py.in b/doc/conf.py.in
index 51b37217..5037d217 100644
--- a/doc/conf.py.in
+++ b/doc/conf.py.in
@@ -4,7 +4,7 @@
# Project information
project = "@SERD_TITLE@"
-copyright = "2022, David Robillard"
+copyright = "2022-2023, David Robillard"
author = "David Robillard"
release = "@SERD_VERSION@"
version = "@SERD_VERSION@"
@@ -46,69 +46,68 @@ html_secnumber_suffix = " "
html_short_title = "@SERD_TITLE@"
html_static_path = ["@SERD_SRCDIR@/doc/_static"]
+html_theme_options = {
+ "description": desc,
+ "logo": "serd.svg",
+ "logo_name": True,
+ "logo_width": "8em",
+}
+
+if tags.has("singlehtml"):
+ html_sidebars = {"**": ["globaltoc.html"]}
+ html_theme_options.update(
+ {
+ "globaltoc_collapse": False,
+ "globaltoc_maxdepth": 3,
+ "nosidebar": False,
+ "page_width": "80em",
+ }
+ )
+else:
+ html_theme_options.update(
+ {
+ "globaltoc_collapse": True,
+ "globaltoc_maxdepth": 1,
+ "nosidebar": True,
+ "page_width": "60em",
+ }
+ )
+
if have_lv2_theme:
html_theme = "sphinx_lv2_theme"
- if tags.has("singlehtml"):
- html_sidebars = {
- "**": [
- "globaltoc.html",
- ]
- }
-
- html_theme_options = {
- "body_max_width": "48em",
- "body_min_width": "48em",
- "description": desc,
+ html_theme_options.update(
+ {
"show_footer_version": True,
- "show_logo_version": False,
- "logo": "serd.svg",
- "logo_name": True,
- "logo_width": "8em",
- "nosidebar": False,
- "page_width": "80em",
- "sidebar_width": "12em",
- "globaltoc_maxdepth": 3,
- "globaltoc_collapse": False,
+ "show_logo_version": True,
}
+ )
+
+ if tags.has("singlehtml"):
+ html_theme_options.update(
+ {
+ "body_max_width": "64em",
+ "body_min_width": "64em",
+ "nosidebar": False,
+ "sidebar_width": "12em",
+ }
+ )
else:
- html_theme_options = {
- "body_max_width": "60em",
- "body_min_width": "40em",
- "description": desc,
- "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,
- }
+ html_theme_options.update(
+ {
+ "body_max_width": "60em",
+ "body_min_width": "40em",
+ }
+ )
else:
-
html_theme = "alabaster"
if tags.has("singlehtml"):
- html_sidebars = {
- "**": [
- "globaltoc.html",
- ]
- }
-
html_theme_options = {
- "body_max_width": "40em",
+ "body_max_width": "58em",
"body_min_width": "40em",
- "description": desc,
- "globaltoc_collapse": False,
- "globaltoc_maxdepth": 3,
- "logo": "serd.svg",
- "nosidebar": False,
- "page_width": "56em",
"sidebar_width": "16em",
}
@@ -116,9 +115,6 @@ else:
html_theme_options = {
"body_max_width": "60em",
"body_min_width": "40em",
- "description": desc,
- "logo": "serd.svg",
"nosidebar": True,
- "page_width": "60em",
"show_relbars": True,
}