2018-12-08 21:31:25 +00:00
|
|
|
project('GStreamer manuals and tutorials', 'c',
|
2019-04-24 14:05:52 +00:00
|
|
|
version: '1.17.0.1',
|
2018-12-08 21:31:25 +00:00
|
|
|
meson_version: '>=0.48.0')
|
2018-11-13 14:29:37 +00:00
|
|
|
|
|
|
|
|
hotdoc = import('hotdoc')
|
2019-04-26 01:05:06 +00:00
|
|
|
hotdoc_subprojects = []
|
2018-11-13 14:29:37 +00:00
|
|
|
|
|
|
|
|
apiversion = '1.0'
|
2019-04-26 01:05:06 +00:00
|
|
|
if host_machine.system() == 'windows'
|
|
|
|
|
pathsep = ';'
|
|
|
|
|
else
|
|
|
|
|
pathsep = ':'
|
|
|
|
|
endif
|
|
|
|
|
|
|
|
|
|
libs = ''
|
|
|
|
|
plugins_doc = ''
|
|
|
|
|
deps = []
|
|
|
|
|
plugins_sitemap = ''
|
|
|
|
|
if get_option('built_subprojects') != ''
|
|
|
|
|
foreach project_name: get_option('built_subprojects').split(',')
|
|
|
|
|
sub = subproject(project_name)
|
|
|
|
|
if sub.get_variable('build_hotdoc')
|
|
|
|
|
message('Building @0@ documentation'.format(project_name))
|
|
|
|
|
|
|
|
|
|
foreach lib: sub.get_variable('libs_doc')
|
|
|
|
|
hotdoc_subprojects += [lib]
|
|
|
|
|
libs += lib.full_path() + pathsep
|
|
|
|
|
deps += [lib]
|
|
|
|
|
endforeach
|
|
|
|
|
|
|
|
|
|
foreach plugin_doc: sub.get_variable('plugins_doc')
|
|
|
|
|
plugins_doc += plugin_doc.full_path() + pathsep
|
|
|
|
|
hotdoc_subprojects += [plugin_doc]
|
|
|
|
|
deps += [plugin_doc]
|
|
|
|
|
endforeach
|
|
|
|
|
else
|
|
|
|
|
message('@0@ did not build hotdoc documentation, can\'t build API doc'.format(project_name))
|
|
|
|
|
endif
|
|
|
|
|
endforeach
|
|
|
|
|
endif
|
|
|
|
|
|
|
|
|
|
if get_option('use_portal_index')
|
|
|
|
|
index = 'markdown/index.md'
|
|
|
|
|
else
|
|
|
|
|
index = 'markdown/simple-index.md'
|
|
|
|
|
endif
|
|
|
|
|
sitemap_gen = find_program('scripts/generate_sitemap.py')
|
|
|
|
|
sitemap = configure_file(command: [sitemap_gen, '@INPUT@', '@OUTPUT@',
|
|
|
|
|
index.split('/')[1], libs, plugins_doc],
|
|
|
|
|
input: 'sitemap.txt',
|
|
|
|
|
output: 'sitemap.txt')
|
2018-11-13 14:29:37 +00:00
|
|
|
|
|
|
|
|
html_theme = 'https://github.com/hotdoc/hotdoc_lumen_theme/releases/download/0.9/hotdoc_lumen_theme-0.9.tar.xz?sha256=ec3807f13eda2d4914fcf251b7e9607e90f33430725a2b1d433a90c9210a52fc'
|
|
|
|
|
|
|
|
|
|
gstreamer_doc = hotdoc.generate_doc('GStreamer',
|
|
|
|
|
project_version: apiversion,
|
2019-04-26 01:05:06 +00:00
|
|
|
sitemap: sitemap,
|
|
|
|
|
index: index,
|
2018-11-13 14:29:37 +00:00
|
|
|
install: true,
|
|
|
|
|
extra_assets: [join_paths(meson.current_source_dir(), 'images')],
|
|
|
|
|
syntax_highlighting_activate: true,
|
|
|
|
|
html_theme: html_theme,
|
|
|
|
|
include_paths: join_paths(meson.current_source_dir(), 'examples'),
|
|
|
|
|
html_extra_theme: join_paths(meson.current_source_dir(), 'theme/extra'),
|
2019-04-26 01:05:06 +00:00
|
|
|
dependencies: deps,
|
|
|
|
|
subprojects: hotdoc_subprojects,
|
2018-11-13 14:29:37 +00:00
|
|
|
disable_incremental_build: true,
|
2019-04-26 01:05:06 +00:00
|
|
|
gst_list_plugins_page: 'plugins_doc.md',
|
2018-11-13 14:29:37 +00:00
|
|
|
devhelp_activate: true,
|
2019-04-26 01:05:06 +00:00
|
|
|
build_always_stale: true,
|
|
|
|
|
edit_on_github_repository: 'https://gitlab.freedesktop.org/gstreamer/gst-docs/',
|
2018-12-08 23:28:57 +00:00
|
|
|
)
|
