X-Git-Url: http://git.indexdata.com/?p=mkws-moved-to-github.git;a=blobdiff_plain;f=doc%2FMakefile;h=1e436d4d24f3d05199e91aa879c7459048c6261d;hp=64c94d53baf04fe311d8c96175f389b3285ab050;hb=172cbfe894f84b595d7bce78528596a6b6612df4;hpb=f11a8d68001cbc474b14d8c8d00f0eb4b0cac463 diff --git a/doc/Makefile b/doc/Makefile index 64c94d5..1e436d4 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -1,61 +1,66 @@ # 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 -DOCS = index.html index.odt index.pdf \ - README.html README.odt README.pdf \ - mkws-manual.html mkws-manual.odt mkws-manual.pdf \ - mkws-developer.html mkws-developer.odt mkws-developer.pdf +# 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 = index.html README.html mkws-manual.html mkws-developer.html mkws-doc.css -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 + +INSTALLED = $(DOCS:%=../tools/htdocs/%) + +all: $(INSTALLED) ../tools/htdocs/%: % rm -f $@ - cp -p $? $@ + cp $< $@ chmod ugo-w $@ -all: $(DOCS) - # For a description of pandoc's markdown format, see: -# http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markdown.html --> +# http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markdown.html # for older pandoc (<1.9) run first: # perl -i.bak -npe 's/"(Authors|Subjects)": "(.*?)"/"$1": "test"/' tools/htdocs/mkws-manual.markdown # -%.html: %.markdown tweak-html +../tools/htdocs/%.html: %.markdown tweak-html rm -f $@ pandoc --standalone --toc -c mkws-doc.css $< | ./tweak-html > $@ chmod ugo-w $@ -%.odt: %.markdown - rm -f $@ - pandoc --standalone $< -o $@ - chmod ugo-w $@ - -# ### In order to compile the manual, which has tables, to PDF, -# you will need to install the Debian package -# texlive-latex-recommended -%.pdf: %.markdown +../tools/htdocs/%.pdf: %.markdown rm -f $@ - pandoc --standalone $< -o $@ + $(MARKDOWN2PDF) $< -o $@ chmod ugo-w $@ clean: - rm -f $(DOCS) + rm -f $(INSTALLED) rm -f *.drupal.html -distclean: clean uninstall +distclean: clean + # Nothing more to remove in the doc directory push: - pandoc --toc README.markdown > README.drupal.html + pandoc --toc index.markdown > index.drupal.html pandoc --toc mkws-manual.markdown > mkws-manual.drupal.html - cat README.drupal.html | ./drupaljson.pl | curl --upload-file - http://www.indexdata.com/script/node/332?services_token=cda1e26e5733ce3f604773e94f0721df5c31a948 -v --header "Content-Type:application/json" + cat index.drupal.html | ./drupaljson.pl | curl --upload-file - http://www.indexdata.com/script/node/332?services_token=cda1e26e5733ce3f604773e94f0721df5c31a948 -v --header "Content-Type:application/json" cat mkws-manual.drupal.html | ./drupaljson.pl | curl --upload-file - http://www.indexdata.com/script/node/323?services_token=cda1e26e5733ce3f604773e94f0721df5c31a948 -v --header "Content-Type:application/json" help: - @echo "make [ all | install | clean | distclean | push ]" - + @echo "make [ all | clean | push ]"