Catch Sphinx build errors in CI (#4751)

Author: atmyers

build_docs.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 set -e # Exit with nonzero exit code if anything fails
 
-# Doxygen
+# Build Doxygen
 echo "Build the Doxygen documentation"
 cd Docs/Doxygen
 doxygen doxygen.conf &> doxygen.out
@@ -12,26 +12,27 @@ if grep -q "warning:" doxygen.out; then
 fi
 cd ../..
 
-# sphinx
-cd Docs/sphinx_documentation
-
-echo "Build the Sphinx documentation for Amrex."
-make PYTHON="python3" latexpdf
-mv build/latex/amrex.pdf source/
-make PYTHON="python3" html &> make_source_html.out
-cd ../../
-
+# copy doxygen to target location
 mkdir build
 cd build
 mkdir docs_html docs_xml
-
-# add doxygen
 mkdir -p docs_html/doxygen
 cp -rp ../Docs/Doxygen/html/* docs_html/doxygen/
 mkdir -p docs_xml/doxygen
 cp -rp ../Docs/Doxygen/xml/* docs_xml/doxygen/
 # add tagfile to allow other docs to interlink with amrex
 cp ../Docs/Doxygen/amrex-doxygen-web.tag.xml docs_xml/doxygen/.
+cd ..
 
-# add sphinx
+# Build sphinx
+cd Docs/sphinx_documentation
+echo "Build the Sphinx documentation for Amrex."
+make PYTHON="python3" latexpdf
+mv build/latex/amrex.pdf source/
+make clean
+make SPHINXOPTS='-v -W --keep-going' PYTHON="python3" html
+cd ../../
+
+# copy sphinx to target location
+cd build
 cp -rp ../Docs/sphinx_documentation/build/html/* docs_html/