diff options
| author | David Robillard <d@drobilla.net> | 2022-12-04 13:18:16 -0500 |
|---|---|---|
| committer | David Robillard <d@drobilla.net> | 2022-12-04 13:32:46 -0500 |
| commit | 77353fba14db23f3919bebc392dab7ff3ea02010 (patch) | |
| tree | 870271cf1c556b5565250943ba81b753618baee6 /doc/c | |
| parent | 79ba155516166b8b7be14ab30c22f6f6d93b550f (diff) | |
| download | serd-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.build | 24 |
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', |