From: Dietmar Maurer Date: Fri, 29 Apr 2016 18:01:12 +0000 (+0200) Subject: include chapters as individual html files X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=commitdiff_plain;h=f96bdfd86ed008c1306133b157ebd8064018f9d9 include chapters as individual html files --- diff --git a/Makefile b/Makefile index bf7eaa9..9c278c4 100644 --- a/Makefile +++ b/Makefile @@ -15,6 +15,21 @@ GITVERSION:=$(shell cat .git/refs/heads/master) GEN_DEB=${GEN_PACKAGE}_${DOCRELEASE}-${GEN_PKGREL}_amd64.deb DOC_DEB=${DOC_PACKAGE}_${DOCRELEASE}-${DOC_PKGREL}_all.deb +CHAPTER_LIST= \ + sysadmin \ + pvecm \ + pmxcfs \ + pvesm \ + qm \ + pve-firewall \ + pveum \ + pct \ + ha-manager \ + vzdump \ + pve-faq \ + pve-bibliography + + COMMAND_LIST= \ pvesubscription \ pvecm \ @@ -129,6 +144,10 @@ all: pve-admin-guide.html %-nwdiag.svg: %.nwdiag nwdiag -T svg $*.nwdiag -o $@; +chapter-%.html: %.adoc ${PVE_COMMON_DOC_SOURCES} + asciidoc ${ADOC_STDARG} -o $@ $*.adoc + test -n "$${NOVIEW}" || $(BROWSER) $@ & + %.1.html: %.adoc %.1-synopsis.adoc ${PVE_COMMON_DOC_SOURCES} asciidoc ${ADOC_MAN1_HTML_ARGS} -o $@ $*.adoc test -n "$${NOVIEW}" || $(BROWSER) $@ & @@ -149,6 +168,7 @@ pmxcfs.8.html: pmxcfs.adoc pmxcfs.8-cli.adoc ${PVE_COMMON_DOC_SOURCES} index.html: index.adoc ${PVE_ADMIN_GUIDE_SOURCES} ${API_VIEWER_SOURCES} $(MAKE) NOVIEW=1 pve-admin-guide.pdf pve-admin-guide.html pve-admin-guide.epub $(MAKE) NOVIEW=1 $(addsuffix .1.html, ${COMMAND_LIST}) $(addsuffix .8.html, ${SERVICE_LIST}) $(addsuffix .5.html, ${CONFIG_LIST}) + $(MAKE) NOVIEW=1 $(addsuffix .html, $(addprefix chapter-, ${CHAPTER_LIST})) asciidoc -a "date=$(shell date)" -a "revnumber=${DOCRELEASE}" index.adoc test -n "$${NOVIEW}" || $(BROWSER) index.html & @@ -187,10 +207,11 @@ deb: make ${GEN_DEB}; make ${DOC_DEB}; -DOC_DEB_FILES= \ - $(addsuffix .1.html, ${COMMAND_LIST}) \ - $(addsuffix .8.html, ${SERVICE_LIST}) \ - $(addsuffix .5.html, ${CONFIG_LIST}) \ +DOC_DEB_FILES= \ + $(addsuffix .html, $(addprefix chapter-, ${CHAPTER_LIST})) \ + $(addsuffix .1.html, ${COMMAND_LIST}) \ + $(addsuffix .8.html, ${SERVICE_LIST}) \ + $(addsuffix .5.html, ${CONFIG_LIST}) \ pve-admin-guide.pdf \ pve-admin-guide.html \ pve-admin-guide.epub \ @@ -242,7 +263,7 @@ update: clean make all clean: - rm -rf *.html *.pdf *.epub *.tmp *.1 *.5 *.8 *.deb *.changes build api-viewer/apidata.js api-viewer/apidoc.js pve-admin-guide.chunked + rm -rf *.html *.pdf *.epub *.tmp *.1 *.5 *.8 *.deb *.changes build api-viewer/apidata.js api-viewer/apidoc.js chapter-*.html pve-admin-guide.chunked find . -name '*~' -exec rm {} ';' diff --git a/index.adoc b/index.adoc index c0ab53c..95c67ab 100644 --- a/index.adoc +++ b/index.adoc @@ -15,6 +15,27 @@ include::attributes.txt[] |E-Book version |link:pve-admin-guide.epub[] |=========================================================== + +Individual Chapters +------------------- +[width="100%",options="header"] +|=========================================================== +|Title |Download link +|Host System Administration |link:chapter-sysadmin.html[] +|Cluster Manager |link:chapter-pvecm.html[] +|Proxmox Cluster File System (pmxcfs) |link:chapter-pmxcfs.html[] +|{pve} Storage |link:chapter-pvesm.html[] +|Qemu/KVM Virtual Machines |link:chapter-qm.html[] +|{pve} Firewall |link:chapter-pve-firewall.html[] +|User Management |link:chapter-pveum.html[] +|Proxmox Container Toolkit |link:chapter-pct.html[] +|High Availability |link:chapter-ha-manager.html[] +|Backup and Restore |link:chapter-vzdump.html[] +|Frequently Asked Questions |link:chapter-pve-faq.html[] +|Bibliography |link:chapter-pve-bibliography.html[] +|=========================================================== + + {pve} Manual Pages ------------------