aboutsummaryrefslogtreecommitdiffstats
path: root/doc/c
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2022-12-04 13:18:16 -0500
committerDavid Robillard <d@drobilla.net>2022-12-04 13:32:46 -0500
commit77353fba14db23f3919bebc392dab7ff3ea02010 (patch)
tree870271cf1c556b5565250943ba81b753618baee6 /doc/c
parent79ba155516166b8b7be14ab30c22f6f6d93b550f (diff)
downloadserd-77353fba14db23f3919bebc392dab7ff3ea02010.tar.gz
serd-77353fba14db23f3919bebc392dab7ff3ea02010.tar.bz2
serd-77353fba14db23f3919bebc392dab7ff3ea02010.zip
Clean up documentation configuration
Diffstat (limited to 'doc/c')
-rw-r--r--doc/c/meson.build24
1 files changed, 22 insertions, 2 deletions
diff --git a/doc/c/meson.build b/doc/c/meson.build
index a2f7eaa5..8c4934de 100644
--- a/doc/c/meson.build
+++ b/doc/c/meson.build
@@ -1,6 +1,20 @@
# Copyright 2020-2022 David Robillard <d@drobilla.net>
# SPDX-License-Identifier: 0BSD OR ISC
+# Check for Sphinx LV2 theme
+
+pymod = import('python')
+sphinx_lv2_theme_python = pymod.find_installation(
+ modules: ['sphinx_lv2_theme'],
+ required: false
+)
+
+if not sphinx_lv2_theme_python.found()
+ warning('Missing sphinx_lv2_theme module, falling back to alabaster')
+endif
+
+# Generate Sphinx configuration file
+
config = configuration_data()
config.set('SERD_VERSION', meson.project_version())
config.set('SERD_SRCDIR', serd_src_root)
@@ -12,6 +26,8 @@ conf_py = configure_file(
output: 'conf.py',
)
+# Copy hand-written documentation sources
+
configure_file(
copy: true,
input: files('../summary.rst'),
@@ -27,9 +43,13 @@ foreach f : c_rst_files
configure_file(copy: true, input: f, output: '@PLAINNAME@')
endforeach
+# Generate reference documentation sources
+
subdir('xml')
subdir('api')
+# Generate documentation with sphinx
+
# TODO: Add install_tag: 'doc' after requiring meson 0.60.0
custom_target(
@@ -37,7 +57,7 @@ custom_target(
build_by_default: true,
command: [sphinx_build, '-M', 'singlehtml', '@OUTDIR@', '@OUTDIR@',
'-E', '-q', '-t', 'singlehtml'],
- input: [c_rst_files, c_serd_rst, c_index_xml],
+ input: [c_rst_files, c_serd_rst, c_index_xml, conf_py],
install: true,
install_dir: docdir / versioned_name,
output: 'singlehtml',
@@ -48,7 +68,7 @@ custom_target(
build_by_default: true,
command: [sphinx_build, '-M', 'html', '@OUTDIR@', '@OUTDIR@',
'-E', '-q', '-t', 'html'],
- input: [c_rst_files, c_serd_rst, c_index_xml],
+ input: [c_rst_files, c_serd_rst, c_index_xml, conf_py],
install: true,
install_dir: docdir / versioned_name,
output: 'html',