manual/Makefile

   1 # Makefile for Sphinx documentation
   2 #
   3
   4 PYTHON ?= python
   5
   6 # You can set these variables from the command line.
   7 SPHINXOPTS    =
   8 SPHINXBUILD   = sphinx-build
   9 PAPER         =
  10 BUILDDIR      = _build
  11
  12 # Internal variables.
  13 PAPEROPT_a4     = -D latex_paper_size=a4
  14 PAPEROPT_letter = -D latex_paper_size=letter
  15 ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
  16
  17 .PHONY: help clean all html latexpdf figs
  18
  19 all: html latexpdf
  20         @echo "Done."
  21
  22 clean:
  23         -rm -rf $(BUILDDIR)/* *.pdf *.png
  24
  25 html: figs
  26         $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
  27         @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
  28
  29 latexpdf: figs
  30         $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
  31         @echo "Running LaTeX files through pdflatex..."
  32         make -C $(BUILDDIR)/latex all-pdf
  33         @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
  34
  35 figs: $(patsubst %.py, %.png, $(filter-out conf.py,$(wildcard *.py)))
  36
  37 %.png: %.py
  38         export PYTHONPATH=$(CURDIR)/.. ; $(PYTHON) $^
  39         $(PYTHON) ../contrib/epstopng.py -o $@ $*.pdf