HTML References Broken in PDF Output

[sanssecours]

Description

Unfortunately links using HTML anchors (<a name="…"></a> do not work in the LaTeX/PDF output of bookdown. You can see the list of broken links using the command make pdf in the root folder of the repository:

Warning: LaTeX Warning: Hyper reference `page:system-configuration' on page 5 undefined
Warning: on input line 405.
…
Warning: LaTeX Warning: Hyper reference `command:Test-pfeifferl' on page 42 undefined on
Warning:  input line 3969.
Warning: LaTeX Warning: There were undefined references.

Possible Fixes

• Remove links altogether
  • Very bad for “reading experience” of document (a lot of scrolling)
• Use bookdown references instead of HTML anchors
  • Might not work inside tables
• Remove PDF version of documentation
• Do nothing 😅 and accept that the PDF version should only be used, if you want to print the documentation