diff options
author | David Robillard <d@drobilla.net> | 2021-01-07 00:10:27 +0100 |
---|---|---|
committer | David Robillard <d@drobilla.net> | 2021-01-07 00:11:55 +0100 |
commit | 07ed82cc08d6d85e04a6e3bea4762436f35ca18a (patch) | |
tree | b36450b366c7ca86c50e9e8a19c1150c64067012 /doc/conf.py.in | |
parent | 397ddf11571a33a7da33ecd0839d10911c5890be (diff) | |
download | sratom-07ed82cc08d6d85e04a6e3bea4762436f35ca18a.tar.gz sratom-07ed82cc08d6d85e04a6e3bea4762436f35ca18a.tar.bz2 sratom-07ed82cc08d6d85e04a6e3bea4762436f35ca18a.zip |
Switch to LV2 documentation theme
Diffstat (limited to 'doc/conf.py.in')
-rw-r--r-- | doc/conf.py.in | 71 |
1 files changed, 34 insertions, 37 deletions
diff --git a/doc/conf.py.in b/doc/conf.py.in index 2b1c485..13119ab 100644 --- a/doc/conf.py.in +++ b/doc/conf.py.in @@ -7,15 +7,12 @@ release = "@SRATOM_VERSION@" # General configuration +exclude_patterns = ["xml"] language = "en" - -extensions = [ - # 'sphinx_rtd_theme', -] - -# Enable nitpicky mode to get warnings about broken links -# Unfortunately this means we need to explicitly ignore everything external nitpicky = True +pygments_style = "friendly" + +# Ignore everything opaque or external for nitpicky mode _opaque = [ "LV2_Atom", "LV2_Atom_Forge", @@ -36,45 +33,45 @@ _opaque = [ nitpick_ignore = list(map(lambda x: ("c:identifier", x), _opaque)) -templates_path = ["_templates"] - -pygments_style = "friendly" - # HTML output -exclude_patterns = ["xml"] html_static_path = ["_static"] +html_theme = "sphinx_lv2_theme" +html_copy_source = False +html_short_title = "Sratom" -html_theme = "alabaster" -# html_theme = "sphinx_rtd_theme" - -if html_theme == "alabaster": - - html_theme_options = { - "description": "A small library for serialising LV2 atoms to and from RDF", - "donate_url": "http://drobilla.net/pages/donate.html", - # "github_repo": "sratom", - # "github_user": "lv2", - # "logo": "sratom.svg", - "logo_name": True, - "logo_text_align": "center", - "page_width": "80em - 20em", - "sidebar_width": "20em", - } - +if tags.has("singlehtml"): html_sidebars = { "**": [ - "about.html", - "localtoc.html", - "donate.html", + "globaltoc.html", ] } -elif html_theme == "sphinx_rtd_theme": + html_theme_options = { + "body_max_width": "48em", + "body_min_width": "48em", + "description": "A small library for serialising LV2 atoms to and from RDF", + "globaltoc_collapse": False, + "globaltoc_maxdepth": 3, + "logo_name": True, + "nosidebar": False, + "page_width": "80em", + "show_footer_version": True, + "show_logo_version": False, + "sidebar_width": "18em", + } +else: html_theme_options = { - "sticky_navigation": False, - "collapse_navigation": False, - "navigation_depth": 4, - "display_version": True, + "body_max_width": "60em", + "body_min_width": "40em", + "description": "A small library for serialising LV2 atoms to and from RDF", + "globaltoc_collapse": True, + "globaltoc_maxdepth": 1, + "logo_name": True, + "nosidebar": True, + "page_width": "60em", + "show_footer_version": True, + "show_logo_version": False, + "sidebar_width": "14em", } |