# A very simple Makefile to generate the HTML docs
# @author Vinod Kurup (vinod@kurup.com)
# @author Modified by Roberto Mello (rmello@fslc.usu.edu) to have PDF generation
# plus refactored it a bit to have rules and dependencies.
# @author davis@xarg.net Added automatic creation of an XSL link so we don't edit openacs.xsl,
# added a lint target which runs xmllint, changed pdf generation to use FOP. Made it
# work on the mac. OSX note: xmllint from fink does not work, use /usr/bin/xmllint
#
# @creation-date 2002-08-10
# @modified-date 2003-12-06
#
# This simply copys all the 'files' and 'images'
# to the appropriate directory in www so that they are accessible
#
# It then moves into the www directory and runs the XSLT generation
# and runs htmldoc to generate PDFs.
#
# I'm a Makefile newbie, so feel free to comment/slash/change.
# Paths
XSLTPROC=xsltproc
HTMLDOC=htmldoc
all: html
XSL:
if [ ! -d XSL -a ! -L XSL ]; then \
echo -e "\n\nNo XSL directory here. I am looking for one...\n"; \
for d in \
/sw/share/xml/docbook-xsl \
/usr/share/sgml/docbook/xsl-stylesheets-* \
/usr/share/sgml/docbook/xsl-stylesheets \
/usr/share/sgml/docbook/stylesheet/xsl/nwalsh; \
do \
if [ -d $$d ]; then \
echo "Found $$d"; \
EXISTS=$$d; \
fi; \
done; \
if [ "$$EXISTS" = "" ]; then \
echo -e "\
\nNo xsl stylesheets found in /usr/share/sgml/docbook/\n\
You need to install them on your system or if they exist already,\n\
symlink them here so that XSL/html/chunk.xsl exists\n\
see http://sourceforge.net/projects/docbook/ for the docbook-xsl stylesheets\n"; \
exit 1; \
else \
echo "I think $$EXISTS is the best one\n\n"; \
ln -s $$EXISTS XSL; \
fi; \
fi;
prelim:
cp images/*.{pdf,png,gif,jpg} ../images/
# put all non-regenerated html in a sub-dir so that we can delete html
# in the main directory and regenerate
cp non-xml/*.html ../
cp openacs.css ..
html: prelim XSL
# adding --nonet --novalid is much faster but generates a bunch of bogus error messages
cd .. ; $(XSLTPROC) --nonet --novalid --xinclude xml/openacs.xsl xml/index.xml
# I got this to work with FOP 0.20.5 and docbook-xsl 1.62, and Jimi 1.0
# see README.fop for some notes.
pdf: XSL
cd ..; $(XSLTPROC) --xinclude --output fop.fo xml/fo.xsl xml/index.xml
cd ..; fop -fo fop.fo -pdf full.pdf
# Validate with xmllint. --postvalid is needed so validation takes place after xincludes.
# In emacs do M-x compile then make lint; then C-x ` to walk through the resulting errors.
#
lint: XSL
xmllint --xinclude --noout --postvalid index.xml 2>&1 | grep -v 'No declaration for attribute base of element'