docs: mention additional python modules needed for building

Also check that they are available in meson.build.

Closes #11772
pull/11777/head
Eli Schwartz 12 months ago
parent 53f43605ce
commit 10d6d2860c
No known key found for this signature in database
GPG Key ID: CEB167EFB5722BD6
  1. 4
      docs/README.md
  2. 10
      docs/meson.build

@ -8,6 +8,10 @@ Minimum required version of hotdoc is *0.8.9*.
Instructions on how to install hotdoc are [here](https://hotdoc.github.io/installing.html).
Our custom hotdoc extensions require:
- [chevron](https://pypi.org/project/chevron)
- [strictyaml](https://pypi.org/project/strictyaml)
## Building the documentation
From the Meson repository root dir:

@ -1,5 +1,11 @@
project('Meson documentation', version: '1.0')
yaml_modname = get_option('unsafe_yaml') ? 'yaml' : 'strictyaml'
py = import('python').find_installation('python3', modules: [yaml_modname], required: false)
if not py.found()
error(f'Cannot build documentation without yaml support')
endif
cur_bdir = meson.current_build_dir()
sitemap = files('sitemap.txt')
@ -105,6 +111,10 @@ genrelnotes = custom_target(
sitemap = genrelnotes[0]
hotdoc_prog = find_program('hotdoc', version: '>=0.13.7')
py = import('python').find_installation('python3', modules: ['chevron'], required: false)
if not py.found()
error('Building the HTML docs requires the chevron module to render generated markdown pages')
endif
hotdoc = import('hotdoc')
documentation = hotdoc.generate_doc(meson.project_name(),

Loading…
Cancel
Save