cleanup doc generation

.travis.yml

@@ -16,6 +16,10 @@ addons:
       - gfortran  # scipy
       - libatlas-base-dev  # scipy
       - graphviz  # sphinx inheritance diagrams
+      - texlive-latex-base  # pdf from sphinx latex
+      - texlive-latex-recommended
+      - texlive-latex-extra
+      - texlive-fonts-recommended
 
 install:
   - pip install --upgrade pip
@@ -25,8 +29,7 @@ install:
 
 script:
   - make test
-  - make doc
-  - make -C doc linkcheck
+  - make docall
 #  - make lint
 
 after_success:

Makefile

@@ -1,8 +1,9 @@
-.PHONY: clean doc lint test release dist
+.PHONY: clean doc docall lint test release dist
 
 help:
 	@echo "clean    remove non-source files"
 	@echo "doc      generate Sphinx HTML documentation, including API doc"
+	@echo "docall   generate HTML & PDF documentation, check links"
 	@echo "lint     check style with flake8"
 	@echo "test     run tests and check code coverage"
 	@echo "release  package and upload a release"
@@ -22,7 +23,12 @@ clean:
 	rm -rf *.egg-info
 
 doc:
-	$(MAKE) -C doc html
+	sphinx-build -b html -d doc/_build/doctrees doc doc/_build/html
+
+docall: doc
+	sphinx-build -b latex -d doc/_build/doctrees doc doc/_build/latex
+	$(MAKE) -C doc/_build/latex all-pdf > doc/_build/latex/pdflatex.log
+	sphinx-build -b linkcheck -d doc/_build/doctrees doc doc/_build/linkcheck
 
 lint:
 	flake8