libei/doc/protocol/meson.build

if 'protocol' not in get_option('documentation')
    subdir_done()
endif

hugo = find_program('hugo', required: false)
if not hugo.found()
    error('Program "hugo" not found or not executable. Try building with -Ddocumentation=false')
endif

src_script = files('generate-protocol-docs.sh')

hugo_script = find_program(src_script)

src_hugo = files(
    'hugo.toml',
    'interface.md.tmpl',
) + src_script

custom_target('hugo',
              input: src_hugo + [protocol_xml],
              output: ['doc'],
              command: [hugo_script, '--git-repo', meson.project_source_root(), '--output-dir', meson.current_build_dir()],
              install: false,
              build_by_default: true,
)
doc: split protocol and api builds into separate meson options 2023-03-07 13:44:33 +10:00			`if 'protocol' not in get_option('documentation')`
meson: hook up the protocol documentation via meson Since we want the generated documentation to be useful on-disk, drop the baseURL and switch to relativeURLs = true for hugo. This is arguably a bit nasty in that it git clones the theme into the build directory. But oh well... 2023-03-07 13:38:11 +10:00			`subdir_done()`
			`endif`

meson.build: apply consistent indentation Mostly whitespace changes, the non-whitespace ones are adding trailing commas on last arguments and moving the closing ) into a separate line for multiline function calls. Part-of: <https://gitlab.freedesktop.org/libinput/libei/-/merge_requests/364> 2025-11-06 09:09:17 +10:00			`hugo = find_program('hugo', required: false)`
meson: hook up the protocol documentation via meson Since we want the generated documentation to be useful on-disk, drop the baseURL and switch to relativeURLs = true for hugo. This is arguably a bit nasty in that it git clones the theme into the build directory. But oh well... 2023-03-07 13:38:11 +10:00			`if not hugo.found()`
meson.build: apply consistent indentation Mostly whitespace changes, the non-whitespace ones are adding trailing commas on last arguments and moving the closing ) into a separate line for multiline function calls. Part-of: <https://gitlab.freedesktop.org/libinput/libei/-/merge_requests/364> 2025-11-06 09:09:17 +10:00			`error('Program "hugo" not found or not executable. Try building with -Ddocumentation=false')`
meson: hook up the protocol documentation via meson Since we want the generated documentation to be useful on-disk, drop the baseURL and switch to relativeURLs = true for hugo. This is arguably a bit nasty in that it git clones the theme into the build directory. But oh well... 2023-03-07 13:38:11 +10:00			`endif`

doc/proto: add the generator script to the input files So meson tracks the dependency better 2023-03-07 19:07:46 +10:00			`src_script = files('generate-protocol-docs.sh')`

			`hugo_script = find_program(src_script)`
meson: hook up the protocol documentation via meson Since we want the generated documentation to be useful on-disk, drop the baseURL and switch to relativeURLs = true for hugo. This is arguably a bit nasty in that it git clones the theme into the build directory. But oh well... 2023-03-07 13:38:11 +10:00
			`src_hugo = files(`
doc: drop the special sha for the hugo theme, update hugo instead The special sha is no longer needed, let's bump to a recent version of hugo instead and that should make it all work nicely (for a while). Updating hugo requires changing to hugo.toml and forcing mermaid to be enabled, without those changes the build failed with `failed to extract shortcode: template for shortcode "mermaid" not found` This reverts commit 5909717700aead940f3b328451c2c85755d3a518 Part-of: <https://gitlab.freedesktop.org/libinput/libei/-/merge_requests/358> 2023-12-13 17:41:16 +10:00			`'hugo.toml',`
meson: hook up the protocol documentation via meson Since we want the generated documentation to be useful on-disk, drop the baseURL and switch to relativeURLs = true for hugo. This is arguably a bit nasty in that it git clones the theme into the build directory. But oh well... 2023-03-07 13:38:11 +10:00			`'interface.md.tmpl',`
doc/proto: add the generator script to the input files So meson tracks the dependency better 2023-03-07 19:07:46 +10:00			`) + src_script`
meson: hook up the protocol documentation via meson Since we want the generated documentation to be useful on-disk, drop the baseURL and switch to relativeURLs = true for hugo. This is arguably a bit nasty in that it git clones the theme into the build directory. But oh well... 2023-03-07 13:38:11 +10:00
			`custom_target('hugo',`
meson.build: apply consistent indentation Mostly whitespace changes, the non-whitespace ones are adding trailing commas on last arguments and moving the closing ) into a separate line for multiline function calls. Part-of: <https://gitlab.freedesktop.org/libinput/libei/-/merge_requests/364> 2025-11-06 09:09:17 +10:00			`input: src_hugo + [protocol_xml],`
			`output: ['doc'],`
			`command: [hugo_script, '--git-repo', meson.project_source_root(), '--output-dir', meson.current_build_dir()],`
			`install: false,`
			`build_by_default: true,`
meson: hook up the protocol documentation via meson Since we want the generated documentation to be useful on-disk, drop the baseURL and switch to relativeURLs = true for hugo. This is arguably a bit nasty in that it git clones the theme into the build directory. But oh well... 2023-03-07 13:38:11 +10:00			`)`