diff options
-rw-r--r-- | Makefile | 7 | ||||
-rw-r--r-- | README | 4 |
2 files changed, 7 insertions, 4 deletions
@@ -60,8 +60,8 @@ diagrams: arch-api.png # The html-linked builder does not support caching, so we # remove all cached state first. html: diagrams -# -W = exit 1 on warning; --keep-going = complete build anyway; write log to ~/warnings.log - $(SPHINXBUILD) -W --keep-going -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html +# -W = exit 1 on warning; --keep-going = complete build anyway; -w /tmp/sphinx-warnings.log = write log to ~/warnings.log + $(SPHINXBUILD) -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." @@ -122,8 +122,7 @@ latex: "(use \`make latexpdf' here to do that automatically)." latexpdf: - # -W = exit 1 on warning; --keep-going = complete build anyway - $(SPHINXBUILD) -W --keep-going -w $(shell echo $HOME)/logs/sphinx-warnings.log -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." @@ -4,3 +4,7 @@ Before building the documentation, make sure that you have the required dependencies installed using pip3: $ pip3 install --user --upgrade recommonmark sphinx + +Note by Buck: when setting up on VM, I also needed: + +# apt install texlive-latex-extra graphviz |