doc: Fix PDF doc build

[finger563]

Fix how the latex is transformed to PDF in doc build for upload to release

Tested and passed here: https://github.com/esp-cpp/espp/actions/runs/27444489453

espp_documentation 3.pdf

[github-actions]

✅Static analysis result - no issues found! ✅

[Copilot]

Pull request overview

This PR adjusts the documentation build pipeline to make the PDF generation path more stable by switching the LaTeX toolchain to pdflatex and applying a post-processing patch to Doxygen’s generated LaTeX style.

Changes:

• Add a Python helper to patch doxygen.sty (replacing the problematic DoxyEnumFields environment).
• Switch the GitHub Actions PDF build from xelatex to pdflatex and run the patch step before compiling.
• Update Doxygen configuration to disable inline sources to reduce LaTeX/PDF fragility; remove the Sphinx latex_engine override.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
docker_build_docs.sh	Adds a post-build step to patch generated Doxygen LaTeX (path currently inconsistent with the rest of the script).
doc/patch_doxygen_latex.py	New utility script that patches doxygen.sty to avoid LaTeX failures around enum fields.
doc/Doxyfile	Disables INLINE_SOURCES to reduce LaTeX/PDF build issues from inline code listings.
doc/conf_common.py	Removes the latex_engine = 'xelatex' config (now relying on pdflatex workflow).
.github/workflows/build_and_publish_docs.yml	Runs the patch step and swaps PDF compilation from xelatex to pdflatex.