Make doc on master fails
Bug report
Running make doc
to build the documentation fails.
Problem description:
The CI for building of the website failed, unfortunately I did not see any artifacts there,
which should be fixed too. I tried then subsequently the build_documentation.sh from the CI in my local environment and
also manually make doc
and also pdflatex
direct onto 0_dumux-handbook.tex
in the dumux/doc/handbook
directory.
What you expected to happen:
The pdf-file of the handbook should be build without errors. The return status of 'make doc' and 'pdflatex' should be 0.
For the make doc
the process for building the doxygen-docs should be started after a clean build of the doc/handbook/0_dumux-handbook.pdf
.
How to reproduce it:
Checkout first appropriate dune-modules together with dumux master. Do
./dune-common/bin/dunecontrol --opts=dumux/cmake.opts configure
cd dumux/build-cmake
make doc
echo $? # show the status of the last command in your shell.
Or a shortcut to see directly the latex problem do:
git clone https://git.iws.uni-stuttgart.de/dumux-repositories/dumux
cd dumux/doc/handbook
pdflatex 0_dumux-handbook.tex
Anything else we need to know?:
It looks like that dumux/build-cmake/doc/handbook/0_dumux-handbook.log
indicates that there are latex-errors in
dumux/doc/handbook/5_scripts.tex
. One can comment out the last section of this file and the 'make doc' succeeds to start doxygen.
Environment:
- Dune version: 2.8
- DuMux version: 81767483 (master from 2022-07-30)
- Others: 'pdfTeX 3.141592653-2.6-1.40.24 (TeX Live 2022/Arch Linux)'