119 lines
4 KiB
Makefile
119 lines
4 KiB
Makefile
IMAGE_FILES = images/asciidoc.png \
|
|
images/hostedby.png \
|
|
images/nut_layering.png \
|
|
images/nut-logo.png \
|
|
images/note.png \
|
|
images/warning.png \
|
|
images/blue-arrow.png \
|
|
images/simple.png \
|
|
images/advanced.png \
|
|
images/bigbox.png \
|
|
images/bizarre.png \
|
|
images/old-cgi.png
|
|
|
|
# Only track here the local deps
|
|
SHARED_DEPS = nut-names.txt asciidoc.conf
|
|
|
|
USER_MANUAL_DEPS = acknowledgements.txt cables.txt config-notes.txt \
|
|
configure.txt download.txt documentation.txt features.txt history.txt \
|
|
outlets.txt scheduling.txt security.txt support.txt user-manual.txt \
|
|
stable-hcl.txt
|
|
|
|
DEVELOPER_GUIDE_DEPS = contact-closure.txt design.txt developers.txt \
|
|
developer-guide.txt hid-subdrivers.txt macros.txt \
|
|
new-clients.txt new-drivers.txt net-protocol.txt sock-protocol.txt
|
|
|
|
CABLES_DEPS = cables/apc-rs500-serial.txt \
|
|
cables/apc.txt cables/ge-imv-victron.txt cables/imv.txt \
|
|
cables/mgeups.txt cables/powerware.txt cables/repotec.txt \
|
|
cables/sms.txt
|
|
|
|
CABLES_IMAGES = images/cables/73-0724.png images/cables/940-0024C.jpg \
|
|
images/cables/belkin-f6cx-rkm-xu-cable.jpg images/cables/Lansafecable.jpg \
|
|
images/cables/mac-940-0024C.png images/cables/mge-66049.png \
|
|
images/cables/mge-db9-rj12.jpg images/cables/mge-db9-rj45.jpg \
|
|
images/cables/SOLA-330.png
|
|
|
|
EXTRA_DIST = $(SHARED_DEPS) $(USER_MANUAL_DEPS) $(DEVELOPER_GUIDE_DEPS) \
|
|
$(CABLES_DEPS) FAQ.txt nut-hal.txt nut-qa.txt packager-guide.txt snmp.txt \
|
|
$(IMAGE_FILES) $(CABLES_IMAGES) docinfo.xml
|
|
|
|
ASCIIDOC_HTML_SINGLE = user-manual.html \
|
|
developer-guide.html \
|
|
packager-guide.html \
|
|
FAQ.html
|
|
|
|
ASCIIDOC_HTML_CHUNKED = user-manual.chunked \
|
|
developer-guide.chunked \
|
|
packager-guide.chunked \
|
|
FAQ.html
|
|
|
|
ASCIIDOC_PDF = user-manual.pdf \
|
|
developer-guide.pdf \
|
|
packager-guide.pdf \
|
|
FAQ.pdf
|
|
|
|
# Force build in ./ and man/ before website
|
|
SUBDIRS = . man website
|
|
SUFFIXES = .txt .html .pdf
|
|
|
|
all: doc
|
|
|
|
doc: @DOC_BUILD_LIST@
|
|
|
|
pdf: $(ASCIIDOC_PDF)
|
|
# also build the HTML manpages with these targets
|
|
html-single: $(ASCIIDOC_HTML_SINGLE)
|
|
html-chunked: $(ASCIIDOC_HTML_CHUNKED)
|
|
|
|
if HAVE_ASCIIDOC
|
|
website: html-chunked pdf
|
|
else !HAVE_ASCIIDOC
|
|
website:
|
|
@echo "Not building website documentation since 'asciidoc' was not found."
|
|
endif !HAVE_ASCIIDOC
|
|
|
|
clean-local:
|
|
rm -rf *.pdf *.html *.chunked docbook-xsl.css
|
|
|
|
# Static HCL is generated automatically
|
|
# This is more of a harness, since this file should have already been
|
|
# generated, due to the top level Makefile SUBDIRS ordering (tools before docs)
|
|
ups-html.txt:
|
|
cd ../tools; $(MAKE) $(AM_MAKEFLAGS) website
|
|
|
|
### TODO: automatic dependency generation
|
|
# Add other directory deps (not for local EXTRA_DIST) and generated contents
|
|
FULL_USER_MANUAL_DEPS = $(USER_MANUAL_DEPS) $(SHARED_DEPS) ../README \
|
|
../INSTALL ../UPGRADING ../TODO ../scripts/ufw/README
|
|
FULL_DEVELOPER_GUIDE_DEPS = $(DEVELOPER_GUIDE_DEPS) $(SHARED_DEPS) \
|
|
../scripts/augeas/README ../TODO ../lib/README \
|
|
../tools/nut-scanner/README
|
|
|
|
user-manual.html user-manual.chunked user-manual.pdf: $(FULL_USER_MANUAL_DEPS)
|
|
developer-guide.html developer-guide.chunked developer-guide.pdf: $(FULL_DEVELOPER_GUIDE_DEPS)
|
|
packager-guide.html packager-guide.chunked packager-guide.pdf: packager-guide.txt asciidoc.conf
|
|
|
|
# Note: without the "-v", asciidoc (circa 8.6.2) sometimes hangs when
|
|
# generating the chunked HTML. In this case, export the environment
|
|
# variable ASCIIDOC_VERBOSE to "-v", ie:
|
|
# $ ASCIIDOC_VERBOSE=-v make
|
|
A2X_COMMON_OPTS = $(ASCIIDOC_VERBOSE) --attribute icons \
|
|
--attribute localdate=`TZ=UTC date +%Y-%m-%d` \
|
|
--attribute localtime=`TZ=UTC date +%H:%M:%S` \
|
|
--attribute iconsdir=$(srcdir)/images \
|
|
--attribute=badges \
|
|
--attribute=external_title \
|
|
--attribute tree_version=@TREE_VERSION@ \
|
|
-a toc -a numbered --destination-dir=.
|
|
|
|
.txt.html:
|
|
$(A2X) $(A2X_COMMON_OPTS) --attribute=xhtml11_format --format=xhtml $<
|
|
|
|
.txt.chunked:
|
|
$(A2X) $(A2X_COMMON_OPTS) --attribute=chunked_format --format=chunked $<
|
|
|
|
.txt.pdf: docinfo.xml
|
|
$(A2X) $(A2X_COMMON_OPTS) --attribute=pdf_format --format=pdf -a docinfo1 $<
|
|
|
|
.PHONY: html html-single pdf website
|