From 77353fba14db23f3919bebc392dab7ff3ea02010 Mon Sep 17 00:00:00 2001 From: David Robillard Date: Sun, 4 Dec 2022 13:18:16 -0500 Subject: Clean up documentation configuration --- doc/c/meson.build | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) (limited to 'doc/c/meson.build') 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 # 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', -- cgit v1.2.1