Undefined control sequence. \sphinxmaketitle

[Routhinator]

Describe the bug
Latext build fails due to unrecognized Sphinx control sequences.

! Undefined control sequence.
l.84 \sphinxmaketitle

To Reproduce
Steps to reproduce the behavior:

sphinx-build -M latex docs docs_output
cd docs_output/latex
make

Expected behavior
Make should have produced a PDF document.

Your project
https://gitlab.routh.io/minecraft/launchers/routh-io-skcraft

Environment info

• OS: Ubuntu 18.04
• Python version: 3.6
• Sphinx version: v2.1.2
• Sphinx extensions: autodoc, intersphinx, viewcode, coverage, todo, javasphinx
• Extra tools: Gitlab CI

Additional context

Error output

[Loading MPS to PDF converter (version 2006.09.02).]
) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/epstopdf-base.sty
(/usr/share/texlive/texmf-dist/tex/latex/oberdiek/grfext.sty)
(/usr/share/texlive/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg))
*geometry* driver: auto-detecting
*geometry* detected driver: pdftex
(/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty
(/usr/share/texlive/texmf-dist/tex/generic/oberdiek/gettitlestring.sty))
! Undefined control sequence.
l.84 \sphinxmaketitle
                     
? 
! Emergency stop.
l.84 \sphinxmaketitle
                     
!  ==> Fatal error occurred, no output PDF file produced!
Transcript written on routh-io-skcraft-launcher-docs.log.
Latexmk: Index file 'routh-io-skcraft-launcher-docs.idx' was written
Latexmk: Errors, so I did not complete making targets

[jfbu]

The \sphinxmaketitle macro is defined via the LaTeX document loading either sphinxhowto.cls or sphinxmanual.cls file, corresponding to choice of 'howto' or 'manual' in latex_documents configuration variable. Yours has

latex_documents = [
    (master_doc, 'routh-io-skcraft-launcher-docs.tex', project,
     author, 'book')
]

which contains 'book'. Please try using configuration seeting latex_docclass

latex_documents = [
    (master_doc, 'routh-io-skcraft-launcher-docs.tex', project,
     author, 'manual')
]
latex_docclass = {'manual': 'book'}

[jfbu]

Does my comment solve your problem? I would like to close this.

[jfbu]

Actually sorry, I think we do have a bug here. The documentation of 'latex_documents' allows using own classes rather than 'howto' and 'manual' Sphinx ones. Hence indeed Sphinx LaTeX should not rely on macros being defined only in its own LaTeX class files.

[jfbu]

Fixed at 59890a3

Thanks for reporting!