X-Git-Url: http://sru.miketaylor.org.uk/?a=blobdiff_plain;f=doc%2FMakefile;h=1e436d4d24f3d05199e91aa879c7459048c6261d;hb=30c1759f3d924bc1b9772ae1de5e36a4edf9c88c;hp=36cf736aae871192c4b11fcb383ea5ed4adaedd2;hpb=3ac07a63bde404eca1cc6b1e34dffba33c872a24;p=mkws-moved-to-github.git diff --git a/doc/Makefile b/doc/Makefile index 36cf736..1e436d4 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -1,43 +1,66 @@ -DOCS = README.html README.odt README.pdf \ - whitepaper.html whitepaper.odt whitepaper.pdf +# Copyright (c) 2013-2014 Index Data ApS. http://indexdata.com +# +# To build the PDFs, you will need these Debian packages: +# texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended -# Default rule when "make" is invoked without a target -**default**: README.html whitepaper.html +# Older versions of pandoc don't do PDF output, but have a companion program +MARKDOWN2PDF = $(shell if which markdown2pdf > /dev/null; then echo markdown2pdf; else echo pandoc --standalone; fi) +HAVE_PDFLATEX = $(shell which pdflatex 2>/dev/null) -INSTALLABLE = README.html whitepaper.html -INSTALLED = $(INSTALLABLE:%=../tools/htdocs/%) +DOCS = index.html \ + mkws-manual.html \ + mkws-developer.html \ + mkws-doc.css -install: $(INSTALLED) +PDFS = index.pdf \ + mkws-manual.pdf \ + mkws-developer.pdf -uninstall: - rm -f $(INSTALLED) +# +# skip PDF creation if pdflatex is not installed +# The debian tex package may download up to 650MB +# +ifneq "${HAVE_PDFLATEX}" "" +DOCS+= ${PDFS} +endif -all: $(DOCS) +INSTALLED = $(DOCS:%=../tools/htdocs/%) -# For a description of pandoc's markdown format, see: -# http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markdown.html --> +all: $(INSTALLED) -# for older pandoc (<1.9) run first: -# perl -i.bak -npe 's/"(Authors|Subjects)": "(.*?)"/"$1": "test"/' tools/htdocs/whitepaper.markdown -# -%.html: %.markdown +../tools/htdocs/%: % rm -f $@ - pandoc --standalone --toc -c mkws-doc.css $< | sed '/^