Make it possible to generate a PDF of the documentation

[tovrstra]

This PR is just a side-effect of a small experiment, but still useful to have.

With this change, one can build a PDF of the documentation as follows:

cd docs
make latexpdf

(A fairly complete texlive installation is needed for this to work.)

I will YOLO-merge this on Wednesday, July 10 unless reviewed earlier.

Summary by Sourcery

This pull request introduces the capability to generate a PDF version of the documentation using Sphinx. It also includes enhancements to the LaTeX engine configuration and improvements to the LaTeX math rendering in the documentation.

• New Features:
  • Added the ability to generate a PDF of the documentation using Sphinx with the command make latexpdf.
• Enhancements:
  • Updated the LaTeX engine configuration in Sphinx to use 'xelatex' for better PDF generation.
• Documentation:
  • Improved the LaTeX math rendering in the documentation for the compute_overlap function.

[sourcery-ai]

Reviewer's Guide by Sourcery

This pull request introduces the ability to generate a PDF version of the documentation by configuring the LaTeX engine in 'docs/conf.py'. Additionally, it updates the LaTeX math notation in the docstring of the 'compute_overlap' function in 'iodata/overlap.py'.

File-Level Changes

Files	Changes
docs/conf.py iodata/overlap.py	Added support for generating PDF documentation and updated LaTeX math notation in docstrings.

---

Tips

• Trigger a new Sourcery review by commenting @sourcery-ai review on the pull request.
• Continue your discussion with Sourcery by replying directly to review comments.
• You can change your review settings at any time by accessing your dashboard:
  • Enable or disable the Sourcery-generated pull request summary or reviewer's guide;
  • Change the review language;
• You can always contact us if you have any questions or feedback.

[deepsource-io]

Here's the code health analysis summary for commits dafc156..6bc170a. View details on DeepSource ↗.

Analysis Summary

Analyzer	Status	Summary	Link
Shell	✅ Success		View Check ↗
Python	✅ Success		View Check ↗

---

💡 If you’re a repository administrator, you can configure the quality gates from the settings.

[sourcery-ai]

Hey @tovrstra - I've reviewed your changes and they look great!

Here's what I looked at during the review

• 🟡 General issues: 2 issues found
• 🟢 Security: all looks good
• 🟢 Testing: all looks good
• 🟢 Complexity: all looks good
• 🟢 Documentation: all looks good

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment to tell me if it was helpful.}

[PaulWAyers]

Cool new feature, thanks.

[tovrstra]

Thanks for checking Paul!