Fix the hierarchy for the Front Matter in LaTeX

This is an ugly hack but necessary for the LaTeX generation.
Basically the problem is that in order to get the Chapters
as \chapters generated there needs to be a ### heading present
before the *** Front Matter ***. If not Sphinx will
generate the chapters as \part in LaTeX. I tried conditional
`.. only:: latex` syntax but that does not work with top level
section (needs always to be one level lower). So I ended up to
hack this by inserting the needed ### heading via Makefile for
the LaTeX version only (the HTML version would be messed up if
this header is present).

Drawbacks:
 * I use `git checkout` to make sure the `index.rst` is
   pristine before adding my the header. This means any
   changes to that file need to be committed before
   running `make`.
 * The PDF version contains the "Front Matter" entry in the TOC

Author: dietmarw

text/Makefile

@@ -231,15 +231,32 @@ ebook:  epub mobi
 
 latex: latex-letter latex-a4
 
-latex-letter:	specs results images
+latex-letter: specs results images
+	@echo
+	@echo "Applying horrible LaTeX hack..."
+	git checkout $(SOURCEDIR)/index.rst # make sure we have pristine index.rst
+	cp $(SOURCEDIR)/index.rst $(SOURCEDIR)/index.rst.orig
+	(echo "#####\nDUMMY\n#####"; cat $(SOURCEDIR)/index.rst.orig) > $(SOURCEDIR)/index.rst
+	@echo
 	$(SPHINXBUILD) -b latex -t latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Reverting horrible LaTeX hack..."
+	git checkout $(SOURCEDIR)/index.rst # revert back to pristine index.rst
 	@echo
 	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
 	@echo "Run \`make' in that directory to run these through (pdf)latex" \
 	      "(use \`make latexpdf' here to do that automatically)."
 
-latex-a4:	specs results images
+
+latex-a4: specs results images
+	@echo
+	@echo "Applying horrible LaTeX hack..."
+	git checkout $(SOURCEDIR)/index.rst # make sure we have pristine index.rst
+	cp $(SOURCEDIR)/index.rst $(SOURCEDIR)/index.rst.orig
+	(echo "#####\nDUMMY\n#####"; cat $(SOURCEDIR)/index.rst.orig) > $(SOURCEDIR)/index.rst
+	@echo
 	$(SPHINXBUILD) -b latex -t latex -t a4 $(ALLSPHINXOPTS) $(BUILDDIR)/latex-a4
+	@echo "Reverting horrible LaTeX hack..."
+	git checkout $(SOURCEDIR)/index.rst # revert back to pristine index.rst
 	@echo
 	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex-a4."
 	@echo "Run \`make' in that directory to run these through (pdf)latex" \