1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68
|
if get_option('documentation')
subdir('tools')
expand_content_md_files = [
'adaptive-layouts.md',
'boxed-lists.md',
'build-howto.md',
'css-variables.md',
'initialization.md',
'migrating-libhandy-1-4-to-libadwaita.md',
'migrating-to-adaptive-dialogs.md',
'migrating-to-breakpoints.md',
'styles-and-appearance.md',
'style-classes.md',
'widget-gallery.md',
]
toml_data = configuration_data()
toml_data.set('VERSION', meson.project_version())
libadwaita_toml = configure_file(
input: 'libadwaita.toml.in',
output: 'libadwaita.toml',
configuration: toml_data
)
dependency('gi-docgen', version: '>= 2021.1',
fallback: ['gi-docgen', 'dummy_dep'],
native: true,
required: get_option('documentation'))
gidocgen = find_program('gi-docgen')
docs_dir = datadir / 'doc'
custom_target('libadwaita-doc',
input: [ libadwaita_toml, libadwaita_gir[0] ],
output: 'libadwaita-@0@'.format(apiversion),
command: [
gidocgen,
'generate',
'--quiet',
'--config=@INPUT0@',
'--output-dir=@OUTPUT@',
'--no-namespace-dir',
'--content-dir=@0@'.format(meson.current_source_dir()),
'@INPUT1@',
],
depend_files: [ expand_content_md_files ],
build_by_default: true,
install: true,
install_dir: docs_dir,
)
test('Validate docs',
gidocgen,
args: [
'check',
'--config', libadwaita_toml,
'--add-include-path=@0@'.format(meson.current_build_dir() / '../src'),
libadwaita_gir[0],
],
depends: libadwaita_gir[0],
suite: ['doc'],
)
endif
|