diff options
author | David Robillard <d@drobilla.net> | 2021-02-25 10:27:59 -0500 |
---|---|---|
committer | David Robillard <d@drobilla.net> | 2021-03-08 23:23:05 -0500 |
commit | c4821c8e6bf1f81c6ea31e11ebc0fc1666e9337b (patch) | |
tree | a62995534f5f606ac2f8bae22d525532b824cb5e /subprojects/exess/doc/conf.py.in | |
parent | 6bcd18ae60482790b645a345f718e7099250f261 (diff) | |
download | serd-c4821c8e6bf1f81c6ea31e11ebc0fc1666e9337b.tar.gz serd-c4821c8e6bf1f81c6ea31e11ebc0fc1666e9337b.tar.bz2 serd-c4821c8e6bf1f81c6ea31e11ebc0fc1666e9337b.zip |
Add exess from git@gitlab.com:drobilla/exess.git 4638b1f
Diffstat (limited to 'subprojects/exess/doc/conf.py.in')
-rw-r--r-- | subprojects/exess/doc/conf.py.in | 112 |
1 files changed, 112 insertions, 0 deletions
diff --git a/subprojects/exess/doc/conf.py.in b/subprojects/exess/doc/conf.py.in new file mode 100644 index 00000000..3eba5bc1 --- /dev/null +++ b/subprojects/exess/doc/conf.py.in @@ -0,0 +1,112 @@ +# Project information + +project = "Exess" +copyright = "2021, David Robillard" +author = "David Robillard" +release = "@EXESS_VERSION@" + +# General configuration + +exclude_patterns = ["xml"] +language = "en" +nitpicky = True +pygments_style = "friendly" + +# Ignore everything opaque or external for nitpicky mode +_opaque = [ + "int16_t", + "int32_t", + "int64_t", + "int8_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 = "Exess" +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": "A library for reading and writing XSD datatypes", + "show_footer_version": True, + "show_logo_version": False, + "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 library for reading and writing XSD datatypes", + "show_footer_version": True, + "show_logo_version": False, + "logo_name": True, + "logo_width": "8em", + "nosidebar": True, + "page_width": "60em", + "sidebar_width": "14em", + "globaltoc_maxdepth": 1, + "globaltoc_collapse": True, + } + +# Man page output + +groups = { + "status": "Status", + # "numbers": "", + "decimal": "Decimal Strings", + "double": "Double Strings", + "float": "Float Strings", + "boolean": "Boolean Strings", + "long": "Long Strings", + "int": "Int Strings", + "short": "Short Strings", + "byte": "Byte Strings", + "ulong": "Unsigned Long Strings", + "uint": "Unsigned Int Strings", + "ushort": "Unsigned Short Strings", + "ubyte": "Unsigned Byte Strings", + # 'time_and_date': "", + "duration": "Duration Strings", + "datetime": "Datetime Strings", + "timezone": "Time zone strings", + "date": "Date strings", + "time": "Time strings", + "binary": "", + "hex": "Hex Binary Strings", + "base64": "Base64 Binary Strings", + "datatypes": "Datatypes", + "variant": "Value Variant", + # 'generics': "", + "coercion": "Value Type Coercion", +} + +author = "David Robillard <d@drobilla.net>" +man_pages = [] +for group, title in groups.items(): + name = "exess_" + group + man_pages += [("api/" + name, name, title, author, 3)] |