# Copyright 2020-2021 David Robillard # SPDX-License-Identifier: ISC # Project information project = "@LILV_TITLE@" copyright = "2020-2023, David Robillard" author = "David Robillard" release = "@LILV_VERSION@" version = "@LILV_VERSION@" desc = "A library for loading LV2 plugins" # General configuration exclude_patterns = ["xml"] 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", "LV2_Descriptor", "LV2_Feature", "LV2_Handle", "LV2_URID_Map", "LV2_URID_Unmap", "LilvInstanceImpl", "LilvNodeImpl", "LilvPluginClassImpl", "LilvPluginImpl", "LilvPortImpl", "LilvScalePointImpl", "LilvStateImpl", "LilvUIImpl", "LilvWorldImpl", "size_t", "uint32_t", "va_list", ] nitpick_ignore = list(map(lambda x: ("c:identifier", x), _opaque)) # HTML output html_copy_source = False html_secnumber_suffix = " " html_short_title = "@LILV_TITLE@" html_theme_options = { "description": desc, "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" html_theme_options.update( { "show_footer_version": True, "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.update( { "body_max_width": "60em", "body_min_width": "40em", } ) else: html_theme = "alabaster" if tags.has("singlehtml"): html_theme_options = { "body_max_width": "58em", "body_min_width": "40em", "sidebar_width": "16em", } else: html_theme_options = { "body_max_width": "60em", "body_min_width": "40em", "nosidebar": True, "show_relbars": True, }