blob: accf23414facca823bcb80291d22c4176ae7572f [file] [log] [blame]
Patrick Williamsc124f4f2015-09-15 14:41:29 -05001# This is a single Makefile to handle all generated Yocto Project documents,
2# which includes the BitBake User Manual and the Toaster User Manual.
3# The Makefile needs to live in the documents directory and all figures used
4# in any manuals must be .PNG files and live in the individual book's figures
5# directory as well as in the figures directory for the mega-manual.
6#
Brad Bishopd7bf8c12018-02-25 22:55:05 -05007# Note that the figures for the Yocto Project Development Tasks Manual
Patrick Williamsc124f4f2015-09-15 14:41:29 -05008# differ depending on the BRANCH being built.
9#
10# The Makefile has these targets:
11# all: If you leave off the target then "all" is implied.
Brad Bishopc342db32019-05-15 21:57:59 -040012# You will generate HTML and a tarball of files.
Patrick Williamsc124f4f2015-09-15 14:41:29 -050013#
14# pdf: generates a PDF version of a manual. Not valid for the
15# Quick Start or the mega-manual (single, large HTML file
16# comprised of all Yocto Project manuals).
17# html: generates an HTML version of a manual.
Patrick Williamsc124f4f2015-09-15 14:41:29 -050018# tarball: creates a tarball for the doc files.
19# validate: validates
20# publish: pushes generated files to the Yocto Project website
21# clean: removes files
22#
23# The Makefile can generate an HTML and PDF version of every document except the
24# Yocto Project Quick Start and the single, HTML mega-manual, which is comprised
25# of all the individual Yocto Project manuals. You can generate these two manuals
26# in HTML form only. The variable DOC indicates the folder name for a given manual.
27# The variable VER represents the distro version of the Yocto Release for which the
28# manuals are being generated. The variable BRANCH is used to indicate the
29# branch (edison or denzil) and is used only when DOC=dev-manual or
30# DOC=mega-manual. If you do not specify a BRANCH, the default branch used
31# will be for the latest Yocto Project release. If you build for either
32# edison or denzil, you must use BRANCH. You do not need to use BRANCH for
33# any release beyond denzil.
34#
35# To build a manual, you must invoke Makefile with the DOC argument. If you
36# are going to publish the manual, then you must invoke Makefile with both the
37# DOC and the VER argument. Furthermore, if you are building or publishing
Brad Bishopd7bf8c12018-02-25 22:55:05 -050038# the edison or denzil versions of the Yocto Project Development Tasks Manual or
Patrick Williamsc124f4f2015-09-15 14:41:29 -050039# the mega-manual, you must also use the BRANCH argument.
40#
41# Examples:
42#
43# make DOC=bsp-guide
Brad Bishop316dfdd2018-06-25 12:45:53 -040044# make html DOC=brief-yoctoprojectqs
Patrick Williamsc124f4f2015-09-15 14:41:29 -050045# make pdf DOC=ref-manual
46# make DOC=dev-manual BRANCH=edison
47# make DOC=mega-manual BRANCH=denzil
48#
Brad Bishopc342db32019-05-15 21:57:59 -040049# The first example generates the HTML version of the BSP Guide.
Patrick Williamsc124f4f2015-09-15 14:41:29 -050050# The second example generates the HTML version only of the Quick Start. Note
51# that the Quick Start only has an HTML version available. So, the
Brad Bishop316dfdd2018-06-25 12:45:53 -040052# 'make DOC=brief-yoctoprojectqs' command would be equivalent. The third example
Patrick Williamsc124f4f2015-09-15 14:41:29 -050053# generates just the PDF version of the Yocto Project Reference Manual.
Brad Bishopc342db32019-05-15 21:57:59 -040054# The fourth example generates the HTML 'edison' version of the YP Development
55# Tasks Manual. The last example
Patrick Williamsc124f4f2015-09-15 14:41:29 -050056# generates the HTML version of the mega-manual and uses the 'denzil'
57# branch when choosing figures for the tarball of figures. Any example that does
58# not use the BRANCH argument builds the current version of the manual set.
59#
60# The publish target pushes the generated manuals to the Yocto Project
61# website. Unless you are a developer on the YP team, you will not succeed in
62# pushing manuals to this server. All files needed for the manual's HTML form are
Brad Bishopc342db32019-05-15 21:57:59 -040063# pushed.
Patrick Williamsc124f4f2015-09-15 14:41:29 -050064#
65# Examples:
66#
67# make publish DOC=bsp-guide VER=1.7
68# make publish DOC=adt-manual VER=1.6
69# make publish DOC=dev-manual VER=1.1.1 BRANCH=edison
70# make publish DOC=dev-manual VER=1.2 BRANCH=denzil
71#
72# The first example publishes the 1.7 version of both the PDF and HTML versions of
73# the BSP Guide. The second example publishes the 1.6 version of both the PDF and
74# HTML versions of the ADT Manual. The third example publishes the 1.1.1 version of
Brad Bishopd7bf8c12018-02-25 22:55:05 -050075# the PDF and HTML YP Development Tasks Manual for the 'edison' branch. The fourth
76# example publishes the 1.2 version of the PDF and HTML YP Development Tasks Manual
77# for the 'denzil' branch.
Patrick Williamsc124f4f2015-09-15 14:41:29 -050078#
79
Brad Bishop316dfdd2018-06-25 12:45:53 -040080ifeq ($(DOC),brief-yoctoprojectqs)
81XSLTOPTS = --stringparam html.stylesheet brief-yoctoprojectqs-style.css \
82 --stringparam chapter.autolabel 0 \
83 --stringparam section.autolabel 0 \
84 --stringparam section.label.includes.component.label 0 \
85 --xinclude
Brad Bishopc342db32019-05-15 21:57:59 -040086ALLPREQ = html tarball
Brad Bishop316dfdd2018-06-25 12:45:53 -040087TARFILES = brief-yoctoprojectqs-style.css brief-yoctoprojectqs.html figures/bypqs-title.png \
88 figures/yocto-project-transp.png
Brad Bishopc342db32019-05-15 21:57:59 -040089MANUALS = $(DOC)/$(DOC).html
Brad Bishop316dfdd2018-06-25 12:45:53 -040090FIGURES = figures
91STYLESHEET = $(DOC)/*.css
92
93endif
94
95ifeq ($(DOC),overview-manual)
96XSLTOPTS = --xinclude
Brad Bishopc342db32019-05-15 21:57:59 -040097ALLPREQ = html tarball
Brad Bishop316dfdd2018-06-25 12:45:53 -040098TARFILES = overview-manual-style.css overview-manual.html figures/overview-manual-title.png \
99 figures/git-workflow.png figures/source-repos.png figures/index-downloads.png \
100 figures/yp-download.png figures/YP-flow-diagram.png figures/key-dev-elements.png \
101 figures/poky-reference-distribution.png figures/cross-development-toolchains.png \
102 figures/user-configuration.png figures/layer-input.png figures/source-input.png \
103 figures/package-feeds.png figures/patching.png figures/source-fetching.png \
104 figures/configuration-compile-autoreconf.png figures/analysis-for-package-splitting.png \
105 figures/image-generation.png figures/sdk-generation.png figures/images.png \
Brad Bishopc342db32019-05-15 21:57:59 -0400106 figures/sdk.png
107MANUALS = $(DOC)/$(DOC).html
Brad Bishop316dfdd2018-06-25 12:45:53 -0400108FIGURES = figures
109STYLESHEET = $(DOC)/*.css
110
111endif
112
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500113ifeq ($(DOC),bsp-guide)
114XSLTOPTS = --xinclude
Brad Bishopc342db32019-05-15 21:57:59 -0400115ALLPREQ = html tarball
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500116TARFILES = bsp-style.css bsp-guide.html figures/bsp-title.png \
Brad Bishopc342db32019-05-15 21:57:59 -0400117 figures/bsp-dev-flow.png
118MANUALS = $(DOC)/$(DOC).html
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500119FIGURES = figures
120STYLESHEET = $(DOC)/*.css
121
122endif
123
124ifeq ($(DOC),dev-manual)
125XSLTOPTS = --xinclude
Brad Bishopc342db32019-05-15 21:57:59 -0400126ALLPREQ = html tarball
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500127#
128# Note that the tarfile might produce the "Cannot stat: No such file or
129# directory" error message for .PNG files that are not present when building
130# a particular branch. The list of files is all-inclusive for all branches.
131# Note, if you don't provide a BRANCH option, it defaults to the latest stuff.
132# This would be appropriate for "master" branch.
133#
134
135 ifeq ($(BRANCH),edison)
136TARFILES = dev-style.css dev-manual.html \
137 figures/app-dev-flow.png figures/bsp-dev-flow.png \
138 figures/dev-title.png figures/git-workflow.png \
139 figures/index-downloads.png figures/kernel-dev-flow.png \
140 figures/kernel-example-repos-edison.png \
141 figures/kernel-overview-1.png figures/kernel-overview-2.png \
142 figures/kernel-overview-3-edison.png \
143 figures/source-repos.png figures/yp-download.png \
144 figures/wip.png
145 else ifeq ($(BRANCH),denzil)
146TARFILES = dev-style.css dev-manual.html \
147 figures/app-dev-flow.png figures/bsp-dev-flow.png \
148 figures/dev-title.png figures/git-workflow.png \
149 figures/index-downloads.png figures/kernel-dev-flow.png \
150 figures/kernel-example-repos-denzil.png \
151 figures/kernel-overview-1.png figures/kernel-overview-2.png \
152 figures/kernel-overview-3-denzil.png \
153 figures/source-repos.png figures/yp-download.png \
154 figures/wip.png
155 else
Brad Bishop316dfdd2018-06-25 12:45:53 -0400156TARFILES = dev-style.css dev-manual.html figures/buildhistory-web.png \
157 figures/dev-title.png figures/buildhistory.png \
Brad Bishopd7bf8c12018-02-25 22:55:05 -0500158 figures/recipe-workflow.png figures/bitbake-build-flow.png \
Brad Bishopc342db32019-05-15 21:57:59 -0400159 figures/multiconfig_files.png
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500160 endif
161
Brad Bishopc342db32019-05-15 21:57:59 -0400162MANUALS = $(DOC)/$(DOC).html
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500163FIGURES = figures
164STYLESHEET = $(DOC)/*.css
165
166endif
167
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500168ifeq ($(DOC),mega-manual)
169XSLTOPTS = --stringparam html.stylesheet mega-style.css \
170 --stringparam chapter.autolabel 1 \
171 --stringparam section.autolabel 1 \
172 --stringparam section.label.includes.component.label 1 \
173 --xinclude
174ALLPREQ = html tarball
175
176 ifeq ($(BRANCH),edison)
177TARFILES = mega-manual.html mega-style.css figures/yocto-environment.png \
178 figures/building-an-image.png \
179 figures/using-a-pre-built-image.png \
180 figures/poky-title.png \
181 figures/adt-title.png figures/bsp-title.png \
182 figures/kernel-title.png figures/kernel-architecture-overview.png \
183 figures/app-dev-flow.png figures/bsp-dev-flow.png \
184 figures/dev-title.png figures/git-workflow.png \
185 figures/index-downloads.png figures/kernel-dev-flow.png \
186 figures/kernel-example-repos-edison.png \
187 figures/kernel-overview-1.png figures/kernel-overview-2.png \
188 figures/kernel-overview-3-edison.png \
189 figures/source-repos.png figures/yp-download.png \
190 figures/wip.png
191 else ifeq ($(BRANCH),denzil)
192TARFILES = mega-manual.html mega-style.css figures/yocto-environment.png \
193 figures/building-an-image.png \
194 figures/using-a-pre-built-image.png \
195 figures/poky-title.png \
196 figures/adt-title.png figures/bsp-title.png \
197 figures/kernel-title.png figures/kernel-architecture-overview.png \
198 figures/app-dev-flow.png figures/bsp-dev-flow.png \
199 figures/dev-title.png figures/git-workflow.png \
200 figures/index-downloads.png figures/kernel-dev-flow.png \
201 figures/kernel-example-repos-denzil.png \
202 figures/kernel-overview-1.png figures/kernel-overview-2.png \
203 figures/kernel-overview-3-denzil.png \
204 figures/source-repos.png figures/yp-download.png \
205 figures/wip.png
206 else
Brad Bishopd7bf8c12018-02-25 22:55:05 -0500207TARFILES = mega-manual.html mega-style.css \
Brad Bishop316dfdd2018-06-25 12:45:53 -0400208 figures/YP-flow-diagram.png \
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500209 figures/using-a-pre-built-image.png \
210 figures/poky-title.png figures/buildhistory.png \
211 figures/buildhistory-web.png \
Patrick Williamsd8c66bc2016-06-20 12:57:21 -0500212 figures/sdk-title.png figures/bsp-title.png \
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500213 figures/kernel-dev-title.png figures/kernel-architecture-overview.png \
Patrick Williamsd8c66bc2016-06-20 12:57:21 -0500214 figures/bsp-dev-flow.png \
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500215 figures/dev-title.png \
216 figures/git-workflow.png figures/index-downloads.png \
217 figures/kernel-dev-flow.png \
Brad Bishopd7bf8c12018-02-25 22:55:05 -0500218 figures/kernel-overview-2-generic.png \
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500219 figures/source-repos.png figures/yp-download.png \
220 figures/profile-title.png figures/kernelshark-all.png \
221 figures/kernelshark-choose-events.png \
222 figures/kernelshark-i915-display.png \
Brad Bishopc342db32019-05-15 21:57:59 -0400223 figures/kernelshark-output-display.png \
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500224 figures/oprofileui-busybox.png figures/oprofileui-copy-to-user.png \
225 figures/oprofileui-downloading.png figures/oprofileui-processes.png \
226 figures/perf-probe-do_fork-profile.png \
227 figures/perf-report-cycles-u.png \
228 figures/perf-systemwide.png figures/perf-systemwide-libc.png \
229 figures/perf-wget-busybox-annotate-menu.png \
230 figures/perf-wget-busybox-annotate-udhcpc.png \
231 figures/perf-wget-busybox-debuginfo.png \
232 figures/perf-wget-busybox-dso-zoom.png \
233 figures/perf-wget-busybox-dso-zoom-menu.png \
234 figures/perf-wget-busybox-expanded-stripped.png \
235 figures/perf-wget-flat-stripped.png \
236 figures/perf-wget-g-copy-from-user-expanded-stripped.png \
237 figures/perf-wget-g-copy-to-user-expanded-debuginfo.png \
238 figures/perf-wget-g-copy-to-user-expanded-stripped.png \
239 figures/perf-wget-g-copy-to-user-expanded-stripped-unresolved-hidden.png \
240 figures/pybootchartgui-linux-yocto.png \
241 figures/pychart-linux-yocto-rpm.png \
242 figures/pychart-linux-yocto-rpm-nostrip.png \
243 figures/sched-wakeup-profile.png figures/sysprof-callers.png \
244 figures/sysprof-copy-from-user.png figures/sysprof-copy-to-user.png \
245 figures/cross-development-toolchains.png \
Brad Bishop316dfdd2018-06-25 12:45:53 -0400246 figures/user-configuration.png \
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500247 figures/source-input.png figures/package-feeds.png \
248 figures/layer-input.png figures/images.png figures/sdk.png \
249 figures/source-fetching.png figures/patching.png \
250 figures/configuration-compile-autoreconf.png \
251 figures/analysis-for-package-splitting.png \
Brad Bishop316dfdd2018-06-25 12:45:53 -0400252 figures/image-generation.png figures/key-dev-elements.png\
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500253 figures/sdk-generation.png figures/recipe-workflow.png \
254 figures/build-workspace-directory.png figures/mega-title.png \
Brad Bishop1a4b7ee2018-12-16 17:11:34 -0800255 figures/toaster-title.png figures/hosted-service.png figures/multiconfig_files.png \
Brad Bishop316dfdd2018-06-25 12:45:53 -0400256 figures/simple-configuration.png figures/poky-reference-distribution.png \
Patrick Williamsd8c66bc2016-06-20 12:57:21 -0500257 figures/compatible-layers.png figures/import-layer.png figures/new-project.png \
258 figures/sdk-environment.png figures/sdk-installed-standard-sdk-directory.png \
259 figures/sdk-devtool-add-flow.png figures/sdk-installed-extensible-sdk-directory.png \
Brad Bishopc342db32019-05-15 21:57:59 -0400260 figures/sdk-devtool-modify-flow.png \
Brad Bishop316dfdd2018-06-25 12:45:53 -0400261 figures/sdk-devtool-upgrade-flow.png figures/bitbake-build-flow.png figures/bypqs-title.png \
Brad Bishop19323692019-04-05 15:28:33 -0400262 figures/overview-manual-title.png figures/sdk-autotools-flow.png figures/sdk-makefile-flow.png \
263 figures/bb_multiconfig_files.png figures/bitbake-title.png
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500264 endif
265
266MANUALS = $(DOC)/$(DOC).html
267FIGURES = figures
268STYLESHEET = $(DOC)/*.css
269
270endif
271
272ifeq ($(DOC),ref-manual)
273XSLTOPTS = --xinclude
Brad Bishopc342db32019-05-15 21:57:59 -0400274ALLPREQ = html tarball
Brad Bishop316dfdd2018-06-25 12:45:53 -0400275TARFILES = ref-manual.html ref-style.css figures/poky-title.png \
Brad Bishopc342db32019-05-15 21:57:59 -0400276 figures/build-workspace-directory.png
277MANUALS = $(DOC)/$(DOC).html
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500278FIGURES = figures
279STYLESHEET = $(DOC)/*.css
280endif
281
Patrick Williamsd8c66bc2016-06-20 12:57:21 -0500282ifeq ($(DOC),sdk-manual)
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500283XSLTOPTS = --xinclude
Brad Bishopc342db32019-05-15 21:57:59 -0400284ALLPREQ = html tarball
Patrick Williamsd8c66bc2016-06-20 12:57:21 -0500285TARFILES = sdk-manual.html sdk-style.css figures/sdk-title.png \
286 figures/sdk-environment.png figures/sdk-installed-standard-sdk-directory.png \
287 figures/sdk-installed-extensible-sdk-directory.png figures/sdk-devtool-add-flow.png \
Brad Bishopc342db32019-05-15 21:57:59 -0400288 figures/sdk-devtool-modify-flow.png \
289 figures/sdk-devtool-upgrade-flow.png figures/sdk-autotools-flow.png figures/sdk-makefile-flow.png
290MANUALS = $(DOC)/$(DOC).html
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500291FIGURES = figures
292STYLESHEET = $(DOC)/*.css
293endif
294
295ifeq ($(DOC),profile-manual)
296XSLTOPTS = --xinclude
Brad Bishopc342db32019-05-15 21:57:59 -0400297ALLPREQ = html tarball
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500298TARFILES = profile-manual.html profile-manual-style.css \
299 figures/profile-title.png figures/kernelshark-all.png \
300 figures/kernelshark-choose-events.png \
301 figures/kernelshark-i915-display.png \
Brad Bishopc342db32019-05-15 21:57:59 -0400302 figures/kernelshark-output-display.png \
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500303 figures/oprofileui-busybox.png figures/oprofileui-copy-to-user.png \
304 figures/oprofileui-downloading.png figures/oprofileui-processes.png \
305 figures/perf-probe-do_fork-profile.png \
306 figures/perf-report-cycles-u.png \
307 figures/perf-systemwide.png figures/perf-systemwide-libc.png \
308 figures/perf-wget-busybox-annotate-menu.png \
309 figures/perf-wget-busybox-annotate-udhcpc.png \
310 figures/perf-wget-busybox-debuginfo.png \
311 figures/perf-wget-busybox-dso-zoom.png \
312 figures/perf-wget-busybox-dso-zoom-menu.png \
313 figures/perf-wget-busybox-expanded-stripped.png \
314 figures/perf-wget-flat-stripped.png \
315 figures/perf-wget-g-copy-from-user-expanded-stripped.png \
316 figures/perf-wget-g-copy-to-user-expanded-debuginfo.png \
317 figures/perf-wget-g-copy-to-user-expanded-stripped.png \
318 figures/perf-wget-g-copy-to-user-expanded-stripped-unresolved-hidden.png \
319 figures/pybootchartgui-linux-yocto.png \
320 figures/pychart-linux-yocto-rpm.png \
321 figures/pychart-linux-yocto-rpm-nostrip.png \
322 figures/sched-wakeup-profile.png figures/sysprof-callers.png \
Brad Bishopc342db32019-05-15 21:57:59 -0400323 figures/sysprof-copy-from-user.png figures/sysprof-copy-to-user.png
324MANUALS = $(DOC)/$(DOC).html
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500325FIGURES = figures
326STYLESHEET = $(DOC)/*.css
327endif
328
329ifeq ($(DOC),kernel-dev)
330XSLTOPTS = --xinclude
Brad Bishopc342db32019-05-15 21:57:59 -0400331ALLPREQ = html tarball
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500332TARFILES = kernel-dev.html kernel-dev-style.css \
Brad Bishopd7bf8c12018-02-25 22:55:05 -0500333 figures/kernel-dev-title.png figures/kernel-overview-2-generic.png \
Brad Bishopc342db32019-05-15 21:57:59 -0400334 figures/kernel-architecture-overview.png figures/kernel-dev-flow.png
335MANUALS = $(DOC)/$(DOC).html
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500336FIGURES = figures
337STYLESHEET = $(DOC)/*.css
338endif
339
340ifeq ($(DOC),toaster-manual)
341XSLTOPTS = --xinclude
342ALLPREQ = html tarball
343TARFILES = toaster-manual.html toaster-manual-style.css \
344 figures/toaster-title.png figures/simple-configuration.png \
Patrick Williamsd8c66bc2016-06-20 12:57:21 -0500345 figures/hosted-service.png \
346 figures/compatible-layers.png figures/import-layer.png figures/new-project.png
Patrick Williamsf1e5d692016-03-30 15:21:19 -0500347MANUALS = $(DOC)/$(DOC).html
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500348FIGURES = figures
349STYLESHEET = $(DOC)/*.css
350endif
351
352
353##
354# These URI should be rewritten by your distribution's xml catalog to
355# match your locally installed XSL stylesheets.
356XSL_BASE_URI = http://docbook.sourceforge.net/release/xsl/1.76.1
357XSL_XHTML_URI = $(XSL_BASE_URI)/xhtml/docbook.xsl
358
359all: $(ALLPREQ)
360
361pdf:
Brad Bishop316dfdd2018-06-25 12:45:53 -0400362ifeq ($(DOC),brief-yoctoprojectqs)
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500363 @echo " "
Brad Bishop316dfdd2018-06-25 12:45:53 -0400364 @echo "ERROR: You cannot generate a PDF file for brief-yoctoprojectqs."
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500365 @echo " "
366
367else ifeq ($(DOC),mega-manual)
368 @echo " "
369 @echo "ERROR: You cannot generate a mega-manual PDF file."
370 @echo " "
371
372else
373
374 cd $(DOC); ../tools/poky-docbook-to-pdf $(DOC).xml ../template; cd ..
375endif
376
377html:
378ifeq ($(DOC),mega-manual)
379# See http://www.sagehill.net/docbookxsl/HtmlOutput.html
380 @echo " "
381 @echo "******** Building "$(DOC)
382 @echo " "
383 cd $(DOC); xsltproc $(XSLTOPTS) -o $(DOC).html $(DOC)-customization.xsl $(DOC).xml; cd ..
384 @echo " "
385 @echo "******** Using mega-manual.sed to process external links"
386 @echo " "
387 cd $(DOC); sed -f ../tools/mega-manual.sed < mega-manual.html > mega-output.html; cd ..
388 @echo " "
389 @echo "******** Cleaning up transient file mega-output.html"
390 @echo " "
391 cd $(DOC); rm mega-manual.html; mv mega-output.html mega-manual.html; cd ..
392else
393# See http://www.sagehill.net/docbookxsl/HtmlOutput.html
394 @echo " "
395 @echo "******** Building "$(DOC)
396 @echo " "
397 cd $(DOC); xsltproc $(XSLTOPTS) -o $(DOC).html $(DOC)-customization.xsl $(DOC).xml; cd ..
398endif
399
400
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500401tarball: html
402 @echo " "
403 @echo "******** Creating Tarball of document files"
404 @echo " "
405 cd $(DOC); tar -cvzf $(DOC).tgz $(TARFILES); cd ..
406
407validate:
408 cd $(DOC); xmllint --postvalid --xinclude --noout $(DOC).xml; cd ..
409
410
411publish:
412 @if test -f $(DOC)/$(DOC).html; \
413 then \
414 echo " "; \
415 echo "******** Publishing "$(DOC)".html"; \
416 echo " "; \
417 scp -r $(MANUALS) $(STYLESHEET) docs.yp:/var/www/www.yoctoproject.org-docs/$(VER)/$(DOC); \
418 cd $(DOC); scp -r $(FIGURES) docs.yp:/var/www/www.yoctoproject.org-docs/$(VER)/$(DOC); \
419 else \
420 echo " "; \
421 echo $(DOC)".html missing. Generate the file first then try again."; \
422 echo " "; \
423 fi
424
425clean:
426 rm -rf $(MANUALS); rm $(DOC)/$(DOC).tgz;