diff options
author | David Robillard <d@drobilla.net> | 2022-12-04 10:16:38 -0500 |
---|---|---|
committer | David Robillard <d@drobilla.net> | 2022-12-04 10:16:38 -0500 |
commit | acd3234a19720c4ad26de92e37430cada30ce6f6 (patch) | |
tree | fa217de9d0bde24ac169b201bc9d057027c145b4 /doc/conf.py.in | |
parent | c41ebbc08687b5c072108885b7fab66512917d9b (diff) | |
download | zix-acd3234a19720c4ad26de92e37430cada30ce6f6.tar.gz zix-acd3234a19720c4ad26de92e37430cada30ce6f6.tar.bz2 zix-acd3234a19720c4ad26de92e37430cada30ce6f6.zip |
Fix version in documentation
Diffstat (limited to 'doc/conf.py.in')
-rw-r--r-- | doc/conf.py.in | 96 |
1 files changed, 96 insertions, 0 deletions
diff --git a/doc/conf.py.in b/doc/conf.py.in new file mode 100644 index 0000000..d6994ec --- /dev/null +++ b/doc/conf.py.in @@ -0,0 +1,96 @@ +# Copyright 2021-2022 David Robillard <d@drobilla.net> +# SPDX-License-Identifier: 0BSD OR ISC + +# Project information + +project = "Zix" +copyright = "2011-2022, David Robillard" +author = "David Robillard" +release = "@ZIX_VERSION@" +version = "@ZIX_VERSION@" +desc = "A lightweight C library of portability wrappers and data structures" + +# General configuration + +exclude_patterns = ["xml"] +language = "en" +nitpicky = True +pygments_style = "friendly" + +# Ignore everything opaque or external for nitpicky mode +_opaque = [ + "FILE", + "ZixAllocator", + "ZixAllocatorImpl", + "ZixBTree", + "ZixBTreeImpl", + "ZixBTreeNode", + "ZixBTreeNodeImpl", + "ZixHash", + "ZixHashImpl", + "ZixRing", + "ZixRingImpl", + "ZixSem", + "ZixSemImpl", + "ZixTree", + "ZixTreeImpl", + "ZixTreeIter", + "ZixTreeNode", + "ZixTreeNodeImpl", + "int64_t", + "pthread_t", + "ptrdiff_t", + "size_t", + "uint16_t", + "uint32_t", + "uint64_t", + "uint8_t", +] + +_c_nitpick_ignore = map(lambda x: ("c:identifier", x), _opaque) +_cpp_nitpick_ignore = map(lambda x: ("cpp:identifier", x), _opaque) +nitpick_ignore = list(_c_nitpick_ignore) + list(_cpp_nitpick_ignore) + +# HTML output + +html_copy_source = False +html_short_title = "@ZIX_TITLE@" +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, + "show_footer_version": True, + "show_logo_version": True, + "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": desc, + "show_footer_version": True, + "show_logo_version": True, + "logo_name": True, + "logo_width": "8em", + "nosidebar": True, + "page_width": "60em", + "sidebar_width": "14em", + "globaltoc_maxdepth": 1, + "globaltoc_collapse": True, + } |