Broken links and images in the documentation

Summary

A few things are broken in the gitlab-pages deployed doc.

1. Only one of mermaid-sourced images is displayed (legend). Also, the addresses for the images are looking weird for the broken ones:

• the address for the figure that's displayed correctly: http://cta-computing.gitlab-pages.cta-observatory.org/dpps/calibrationpipeline/calibpipe/_images/legend.png
• the address for the figure that's not displayed: http://cta-computing.gitlab-pages.cta-observatory.org/dpps/calibrationpipeline/calibpipe/introduction/introduction/images/molecular_atmosphere_mindmap.png

2. Link to example configurations is not a permanent link and points to a non-existing branch: https://gitlab.cta-observatory.org/cta-computing/dpps/calibrationpipeline/calibpipe/-/tree/feature/update_documentation/doc/source/examples?ref_type=heads
3. Formulas are rendered incorrectly
4. There's a number of errors and warnings in the CI log

Steps to reproduce

Trigger a doc building job in CI. Another possibility is to run the build locally, e.g. with the gitlab-runner: gitlab-runner --debug exec docker --docker-image almalinux:9 pages

What is the expected correct behavior?

All images and formulas should be rendered correctly, links shall not be broken, there should be no errors during the build and the number of warnings shall be minimized.

Relevant logs and/or screenshots

https://gitlab.cta-observatory.org/cta-computing/dpps/calibrationpipeline/calibpipe/-/jobs/175066

Environment

• Version used: fd12166e
• Operation System: almalinux:9