aboutsummaryrefslogtreecommitdiffstats
path: root/doc/conf.py.in
diff options
context:
space:
mode:
Diffstat (limited to 'doc/conf.py.in')
-rw-r--r--doc/conf.py.in86
1 files changed, 86 insertions, 0 deletions
diff --git a/doc/conf.py.in b/doc/conf.py.in
new file mode 100644
index 00000000..224b6e77
--- /dev/null
+++ b/doc/conf.py.in
@@ -0,0 +1,86 @@
+# Project information
+
+project = "Serd"
+copyright = "2020, David Robillard"
+author = "David Robillard"
+release = "@SERD_VERSION@"
+
+# General configuration
+
+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
+_opaque = [
+ "FILE",
+ "SerdByteSinkImpl",
+ "SerdByteSourceImpl",
+ "SerdCursorImpl",
+ "SerdEnvImpl",
+ "SerdIterImpl",
+ "SerdModelImpl",
+ "SerdNodeImpl",
+ "SerdNodesImpl",
+ "SerdRangeImpl",
+ "SerdReaderImpl",
+ "SerdSinkImpl",
+ "SerdStatementImpl",
+ "SerdWorldImpl",
+ "SerdWriterImpl",
+ "int64_t",
+ "size_t",
+ "uint32_t",
+ "uint8_t",
+ "uintptr_t",
+ "va_list",
+]
+
+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 = "alabaster"
+# html_theme = "sphinx_rtd_theme"
+
+if html_theme == "alabaster":
+
+ html_theme_options = {
+ "description": "A lightweight library for RDF storage and serialisation",
+ "donate_url": "http://drobilla.net/pages/donate.html",
+ # "github_repo": "serd",
+ # "github_user": "lv2",
+ "logo": "serd.svg",
+ "logo_name": True,
+ "logo_text_align": "center",
+ "page_width": "80em - 20em",
+ "sidebar_width": "24em",
+ }
+
+ html_sidebars = {
+ "**": [
+ "about.html",
+ "localtoc.html",
+ "donate.html",
+ ]
+ }
+
+elif html_theme == "sphinx_rtd_theme":
+
+ html_theme_options = {
+ "sticky_navigation": False,
+ "collapse_navigation": False,
+ "navigation_depth": 4,
+ "display_version": True,
+ }