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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
project('GStreamer manuals and tutorials', 'c',
version: '1.17.1',
meson_version: '>=0.48.0')
hotdoc = import('hotdoc')
hotdoc_subprojects = []
apiversion = '1.0'
if host_machine.system() == 'windows'
pathsep = ';'
else
pathsep = ':'
endif
python3 = import('python').find_installation()
built_subprojects = get_option('built_subprojects')
if built_subprojects != ''
message('Have subprojects list from options')
else
read_file_contents = '''
import os
import sys
assert len(sys.argv) >= 2
fname = sys.argv[1]
with open(fname, 'r') as f:
for l in f:
print(l)
'''
# gst-build will generate this file for us to consume so that subproject
# changes can still work
fname = join_paths(meson.build_root(), 'GstDocumentedSubprojects')
cmdres = run_command(
python3,
'-c', read_file_contents,
fname,
)
if cmdres.returncode() == 0
built_subprojects = cmdres.stdout().strip()
message('Have subprojects from file: @0@'.format(fname))
endif
endif
libs = ''
plugins_doc = ''
deps = []
plugins_sitemap = ''
if built_subprojects != ''
foreach project_name: 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
deps += [dependency('gstreamer-' + apiversion, fallback: ['gstreamer', 'gst_dep'])]
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@',
'gi-index', libs, plugins_doc],
input: 'sitemap.txt',
output: 'sitemap.txt')
html_theme = 'https://github.com/hotdoc/hotdoc_lumen_theme/releases/download/0.999/hotdoc_lumen_theme-0.999.tar.xz?sha256=61088e983e7a5d171f2afc4e270c82f1ca251e38e375658ef230666691418629'
gstreamer_doc = hotdoc.generate_doc('GStreamer',
project_version: apiversion,
sitemap: sitemap,
index: index,
gi_index: index,
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'),
dependencies: deps,
subprojects: hotdoc_subprojects,
disable_incremental_build: true,
gst_list_plugins_page: 'gst-index',
gst_index: join_paths(meson.current_source_dir(), 'markdown/plugins_doc.md'),
devhelp_activate: true,
devhelp_online: 'https://gstreamer.freedesktop.org/documentation/',
build_always_stale: true,
edit_on_github_repository: 'https://gitlab.freedesktop.org/gstreamer/gst-docs/',
)
cdata = configuration_data()
cdata.set('GST_API_VERSION', apiversion)
readme = configure_file(input: 'scripts/RELEASE_README.md',
output: 'README.md',
configuration : cdata)
run_target('release',
command: [find_program('scripts/release.py'),
gstreamer_doc.full_path(),
'gstreamer-docs-@0@'.format(meson.project_version()),
join_paths(meson.current_build_dir(), 'README.md')],
depends: [gstreamer_doc]
)
|
