]>
Commit | Line | Data |
---|---|---|
1 | DGDIR=. | |
2 | ||
3 | include ./pve-doc-generator.mk | |
4 | ||
5 | GEN_PACKAGE=pve-doc-generator | |
6 | DOC_PACKAGE=pve-docs | |
7 | ||
8 | # also update debian/changelog | |
9 | GEN_PKGREL=1 | |
10 | # also update doc-debian/changelog | |
11 | DOC_PKGREL=2 | |
12 | ||
13 | GITVERSION:=$(shell cat .git/refs/heads/master) | |
14 | ||
15 | GEN_DEB=${GEN_PACKAGE}_${DOCRELEASE}-${GEN_PKGREL}_amd64.deb | |
16 | DOC_DEB=${DOC_PACKAGE}_${DOCRELEASE}-${DOC_PKGREL}_all.deb | |
17 | ||
18 | CHAPTER_LIST= \ | |
19 | sysadmin \ | |
20 | pvecm \ | |
21 | pmxcfs \ | |
22 | pvesm \ | |
23 | qm \ | |
24 | pve-firewall \ | |
25 | pveum \ | |
26 | pct \ | |
27 | ha-manager \ | |
28 | vzdump \ | |
29 | pve-faq \ | |
30 | pve-bibliography | |
31 | ||
32 | ||
33 | COMMAND_LIST= \ | |
34 | pvesubscription \ | |
35 | pvecm \ | |
36 | qm \ | |
37 | qmrestore \ | |
38 | pveceph \ | |
39 | pct \ | |
40 | pveam \ | |
41 | pvesm \ | |
42 | pveum \ | |
43 | vzdump \ | |
44 | ha-manager | |
45 | ||
46 | SERVICE_LIST= \ | |
47 | pve-firewall \ | |
48 | pve-ha-crm \ | |
49 | pve-ha-lrm \ | |
50 | pvestatd \ | |
51 | pmxcfs \ | |
52 | pveproxy \ | |
53 | spiceproxy \ | |
54 | pvedaemon | |
55 | ||
56 | CONFIG_LIST=datacenter.cfg qm.conf pct.conf | |
57 | ||
58 | GEN_DEB_SOURCES= \ | |
59 | pve-doc-generator.mk \ | |
60 | attributes.txt \ | |
61 | $(addsuffix .adoc, ${COMMAND_LIST}) \ | |
62 | $(addsuffix .adoc, ${SERVICE_LIST}) \ | |
63 | $(addsuffix .adoc, ${CONFIG_LIST}) \ | |
64 | pve-storage-dir.adoc \ | |
65 | pve-storage-glusterfs.adoc \ | |
66 | pve-storage-iscsi.adoc \ | |
67 | pve-storage-iscsidirect.adoc \ | |
68 | pve-storage-lvm.adoc \ | |
69 | pve-storage-nfs.adoc \ | |
70 | pve-storage-rbd.adoc \ | |
71 | pve-storage-zfspool.adoc \ | |
72 | pmxcfs.8-cli.adoc \ | |
73 | pve-copyright.adoc \ | |
74 | docinfo.xml | |
75 | ||
76 | GEN_SCRIPTS= \ | |
77 | gen-datacenter.cfg.5-opts.pl \ | |
78 | gen-pct.conf.5-opts.pl \ | |
79 | gen-qm.conf.5-opts.pl \ | |
80 | gen-vzdump.conf.5-opts.pl \ | |
81 | gen-pve-firewall-cluster-opts.pl \ | |
82 | gen-pve-firewall-host-opts.pl \ | |
83 | gen-pve-firewall-macros-adoc.pl \ | |
84 | gen-pve-firewall-rules-opts.pl \ | |
85 | gen-pve-firewall-vm-opts.pl | |
86 | ||
87 | SYSADMIN_SOURCES= \ | |
88 | getting-help.adoc \ | |
89 | pve-package-repos.adoc \ | |
90 | pve-installation.adoc \ | |
91 | system-software-updates.adoc \ | |
92 | sysadmin.adoc | |
93 | ||
94 | API_VIEWER_SOURCES= \ | |
95 | api-viewer/index.html \ | |
96 | api-viewer/apidoc.js | |
97 | ||
98 | PVE_ADMIN_GUIDE_SOURCES= \ | |
99 | ${DATACENTER_CONF_MAN5_SOURCES} \ | |
100 | ${QM_CONF_MAN5_SOURCES} \ | |
101 | ${PCT_CONF_MAN5_SOURCES} \ | |
102 | ${SYSADMIN_SOURCES} \ | |
103 | pve-admin-guide.adoc \ | |
104 | pve-intro.adoc \ | |
105 | pmxcfs.adoc \ | |
106 | pmxcfs.8-cli.adoc \ | |
107 | pve-faq.adoc \ | |
108 | ${PVE_FIREWALL_MAN8_SOURCES} \ | |
109 | ${PVESM_MAN1_SOURCES} \ | |
110 | ${PCT_MAN1_SOURCES} \ | |
111 | ${PVECM_MAN1_SOURCES} \ | |
112 | ${PVEUM_MAN1_SOURCES} \ | |
113 | ${QM_MAN1_SOURCES} \ | |
114 | ${QMRESTORE_MAN1_SOURCES} \ | |
115 | ${HA_MANAGER_MAN1_SOURCES} \ | |
116 | ${PVESTATD_MAN8_SOURCES} \ | |
117 | ${PVEDAEMON_MAN8_SOURCES} \ | |
118 | ${PVEPROXY_MAN8_SOURCES} \ | |
119 | ${SPICEPROXY_MAN8_SOURCES} \ | |
120 | ${PVE_HA_CRM_MAN8_SOURCES} \ | |
121 | ${PVE_HA_LRM_MAN8_SOURCES} \ | |
122 | ${VZDUMP_MAN1_SOURCES} \ | |
123 | ${PVEAM_MAN1_SOURCES} \ | |
124 | ${PVESUBSCRIPTION_MAN1_SOURCES} \ | |
125 | ${PVECEPH_MAN1_SOURCES} \ | |
126 | pve-bibliography.adoc \ | |
127 | $(addsuffix .adoc, ${COMMAND_LIST}) \ | |
128 | $(addsuffix .adoc, ${SERVICE_LIST}) \ | |
129 | $(addsuffix .adoc, ${CONFIG_LIST}) \ | |
130 | GFDL.adoc \ | |
131 | attributes.txt | |
132 | ||
133 | ADOC_STDARG= -a icons -a data-uri -a "date=$(shell date)" -a "revnumber=${DOCRELEASE}" | |
134 | ADOC_MAN1_HTML_ARGS=-a "manvolnum=1" ${ADOC_STDARG} | |
135 | ADOC_MAN5_HTML_ARGS=-a "manvolnum=5" ${ADOC_STDARG} | |
136 | ADOC_MAN8_HTML_ARGS=-a "manvolnum=8" ${ADOC_STDARG} | |
137 | ||
138 | BROWSER?=xdg-open | |
139 | ||
140 | all: index.html | |
141 | ||
142 | %-nwdiag.svg: %.nwdiag | |
143 | nwdiag -T svg $*.nwdiag -o $@; | |
144 | ||
145 | chapter-%.html: %.adoc ${PVE_COMMON_DOC_SOURCES} | |
146 | asciidoc ${ADOC_STDARG} -a toc -o $@ $*.adoc | |
147 | ||
148 | chapter-%-plain.html: %.adoc ${PVE_COMMON_DOC_SOURCES} | |
149 | asciidoc -s ${ADOC_STDARG} -a toc -o chapter-$*-plain.html $*.adoc | |
150 | ||
151 | %.1.html: %.adoc %.1-synopsis.adoc ${PVE_COMMON_DOC_SOURCES} | |
152 | asciidoc ${ADOC_MAN1_HTML_ARGS} -o $@ $*.adoc | |
153 | ||
154 | ||
155 | pmxcfs.8.html: pmxcfs.adoc pmxcfs.8-cli.adoc ${PVE_COMMON_DOC_SOURCES} | |
156 | asciidoc ${ADOC_MAN8_HTML_ARGS} -o $@ pmxcfs.adoc | |
157 | ||
158 | %.8.html: %.adoc %.8-synopsis.adoc ${PVE_COMMON_DOC_SOURCES} | |
159 | asciidoc ${ADOC_MAN8_HTML_ARGS} -o $@ $*.adoc | |
160 | ||
161 | %.5.html: %.adoc %.5-opts.adoc ${PVE_COMMON_DOC_SOURCES} | |
162 | asciidoc ${ADOC_MAN5_HTML_ARGS} -o $@ $*.adoc | |
163 | ||
164 | %.5-plain.html: %.adoc %.5-opts.adoc ${PVE_COMMON_DOC_SOURCES} | |
165 | asciidoc -s ${ADOC_MAN5_HTML_ARGS} -o $@ $*.adoc | |
166 | ||
167 | .PHONY: index | |
168 | index: index.html | |
169 | $(BROWSER) index.html & | |
170 | ||
171 | INDEX_SOURCES= \ | |
172 | index.adoc \ | |
173 | api-viewer/apidoc.js \ | |
174 | pve-admin-guide.pdf \ | |
175 | pve-admin-guide.html \ | |
176 | pve-admin-guide.epub \ | |
177 | $(addsuffix .1.html, ${COMMAND_LIST}) \ | |
178 | $(addsuffix .8.html, ${SERVICE_LIST}) \ | |
179 | $(addsuffix .5.html, ${CONFIG_LIST}) \ | |
180 | $(addsuffix .html, $(addprefix chapter-, ${CHAPTER_LIST})) \ | |
181 | $(addsuffix -plain.html, $(addprefix chapter-, ${CHAPTER_LIST}))\ | |
182 | $(addsuffix .5-plain.html, ${CONFIG_LIST}) | |
183 | ||
184 | index.html: ${INDEX_SOURCES} | |
185 | asciidoc -a "date=$(shell date)" -a "revnumber=${DOCRELEASE}" index.adoc | |
186 | ||
187 | pve-admin-guide.html: ${PVE_ADMIN_GUIDE_SOURCES} | |
188 | asciidoc -a "revnumber=${DOCRELEASE}" -a "date=$(shell date)" pve-admin-guide.adoc | |
189 | ||
190 | pve-admin-guide.chunked: ${PVE_ADMIN_GUIDE_SOURCES} | |
191 | rm -rf pve-admin-guide.chunked | |
192 | a2x -a docinfo -a docinfo1 -a icons -f chunked pve-admin-guide.adoc | |
193 | ||
194 | pve-admin-guide.pdf: ${PVE_ADMIN_GUIDE_SOURCES} docinfo.xml pve-admin-guide-docinfo.xml | |
195 | grep ">Release ${DOCRELEASE}<" pve-admin-guide-docinfo.xml || (echo "wrong release in pve-admin-guide-docinfo.xml" && false); | |
196 | a2x -a docinfo -a docinfo1 -f pdf -L --dblatex-opts "-P latex.output.revhistory=0" --dblatex-opts "-P latex.class.options=12pt" --dblatex-opts "-P doc.section.depth=2 -P toc.section.depth=2" pve-admin-guide.adoc | |
197 | ||
198 | pve-admin-guide.epub: ${PVE_ADMIN_GUIDE_SOURCES} | |
199 | a2x -f epub pve-admin-guide.adoc | |
200 | ||
201 | api-viewer/apidata.js: extractapi.pl | |
202 | ./extractapi.pl >$@ | |
203 | ||
204 | api-viewer/apidoc.js: api-viewer/apidata.js api-viewer/PVEAPI.js | |
205 | cat api-viewer/apidata.js api-viewer/PVEAPI.js >$@ | |
206 | ||
207 | .PHONY: dinstall | |
208 | dinstall: ${GEN_DEB} ${DOC_DEB} | |
209 | dpkg -i ${GEN_DEB} ${DOC_DEB} | |
210 | ||
211 | ||
212 | .PHONY: deb | |
213 | deb: | |
214 | rm -f ${GEN_DEB} ${DOC_DEB}; | |
215 | make ${GEN_DEB}; | |
216 | make ${DOC_DEB}; | |
217 | ||
218 | DOC_DEB_FILES= \ | |
219 | $(addsuffix .html, $(addprefix chapter-, ${CHAPTER_LIST})) \ | |
220 | $(addsuffix -plain.html, $(addprefix chapter-, ${CHAPTER_LIST})) \ | |
221 | $(addsuffix .5-plain.html, ${CONFIG_LIST}) \ | |
222 | $(addsuffix .1.html, ${COMMAND_LIST}) \ | |
223 | $(addsuffix .8.html, ${SERVICE_LIST}) \ | |
224 | $(addsuffix .5.html, ${CONFIG_LIST}) \ | |
225 | pve-admin-guide.pdf \ | |
226 | pve-admin-guide.html \ | |
227 | pve-admin-guide.epub \ | |
228 | index.html | |
229 | ||
230 | ${DOC_DEB}: ${DOC_DEB_FILES} | |
231 | rm -rf build | |
232 | mkdir build | |
233 | rsync -a doc-debian/ build/debian | |
234 | mkdir -p build/usr/share/${DOC_PACKAGE} | |
235 | mkdir -p build/usr/share/doc/${DOC_PACKAGE} | |
236 | echo "git clone git://git.proxmox.com/git/pve-docs.git\\ngit checkout ${GITVERSION}" > build/usr/share/doc/${DOC_PACKAGE}/SOURCE | |
237 | # install doc files | |
238 | install -m 0644 ${DOC_DEB_FILES} build/usr/share/${DOC_PACKAGE} | |
239 | # install api doc viewer | |
240 | mkdir build/usr/share/${DOC_PACKAGE}/api-viewer | |
241 | install -m 0644 ${API_VIEWER_SOURCES} build/usr/share/${DOC_PACKAGE}/api-viewer | |
242 | cd build; dpkg-buildpackage -rfakeroot -b -us -uc | |
243 | lintian ${DOC_DEB} | |
244 | ||
245 | ${GEN_DEB}: ${GEN_DEB_SOURCES} | |
246 | rm -rf build | |
247 | mkdir build | |
248 | rsync -a debian/ build/debian | |
249 | mkdir -p build/usr/share/${GEN_PACKAGE} | |
250 | mkdir -p build/usr/share/doc/${GEN_PACKAGE} | |
251 | echo "git clone git://git.proxmox.com/git/pve-docs.git\\ngit checkout ${GITVERSION}" > build/usr/share/doc/${GEN_PACKAGE}/SOURCE | |
252 | install -m 0644 ${GEN_DEB_SOURCES} build/usr/share/${GEN_PACKAGE} | |
253 | install -m 0755 ${GEN_SCRIPTS} build/usr/share/${GEN_PACKAGE} | |
254 | cd build; dpkg-buildpackage -rfakeroot -b -us -uc | |
255 | lintian ${GEN_DEB} | |
256 | ||
257 | .PHONY: upload | |
258 | upload: ${GEN_DEB} ${DOC_DEB} | |
259 | umount /pve/${DOCRELEASE}; mount /pve/${DOCRELEASE} -o rw | |
260 | mkdir -p /pve/${DOCRELEASE}/extra | |
261 | rm -f /pve/${DOCRELEASE}/extra/${GEN_PACKAGE}_*.deb | |
262 | rm -f /pve/${DOCRELEASE}/extra/${DOC_PACKAGE}_*.deb | |
263 | rm -f /pve/${DOCRELEASE}/extra/Packages* | |
264 | cp ${GEN_DEB} ${DOC_DEB} /pve/${DOCRELEASE}/extra | |
265 | cd /pve/${DOCRELEASE}/extra; dpkg-scanpackages . /dev/null > Packages; gzip -9c Packages > Packages.gz | |
266 | umount /pve/${DOCRELEASE}; mount /pve/${DOCRELEASE} -o ro | |
267 | ||
268 | .PHONY: update | |
269 | update: clean | |
270 | rm -f *.5-opts.adoc *.1-synopsis.adoc *.8-synopsis.adoc | |
271 | rm -f api-viewer/apidata.js | |
272 | rm -f pve-firewall-macros.adoc | |
273 | make all | |
274 | ||
275 | clean: | |
276 | rm -rf *.html *.pdf *.epub *.tmp *.1 *.5 *.8 *.deb *.changes build api-viewer/apidoc.js chapter-*.html chapter-*-plain.html chapter-*.html pve-admin-guide.chunked | |
277 | find . -name '*~' -exec rm {} ';' |