Skip to content

docs: remove epub from Read the Docs formats#293

Open
GraemeWatt wants to merge 2 commits intomainfrom
remove-epub
Open

docs: remove epub from Read the Docs formats#293
GraemeWatt wants to merge 2 commits intomainfrom
remove-epub

Conversation

@GraemeWatt
Copy link
Member

@GraemeWatt GraemeWatt commented Mar 20, 2026

I noticed that the Read the Docs build is failing due to a warning building the epub format:

WARNING: Could not fetch remote image: https://zenodo.org/badge/DOI/10.5281/zenodo.1217998.svg [403]

I get the same warning if I try to build the epub format locally. I'm not sure of the reason, but we had a similar problem with rendering a Zenodo badge in the end-to-end tests for the main HEPData repository when using older Chrome versions. I contacted Zenodo support and they explained that they perform blocking based on rate-limiting per IP address, blocking of IP addresses and blocking of User Agent patterns.

If we don't need the epub format, the simplest solution would be not to build it. I don't see an easy way of excluding the Zenodo badge from the epub format, but including it for other formats. Sphinx has an only directive for reStructuredText files, but the Zenodo badge appears in the README.md (Markdown) file.

This PR also removes the Sphinx<7 pin from requirements.txt as I don't think it is needed, and it updates the copyright year from 2018-2024 to 2018-2026.


📚 Documentation preview 📚: https://hepdata-lib--293.org.readthedocs.build/en/293/

* Avoids warning fetching Zenodo badge for epub format.
* Also remove Sphinx<7 pin and update copyright year.
@codecov
Copy link

codecov bot commented Mar 20, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.21%. Comparing base (b7010db) to head (89e618f).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #293   +/-   ##
=======================================
  Coverage   92.21%   92.21%           
=======================================
  Files           5        5           
  Lines        1118     1118           
  Branches      237      237           
=======================================
  Hits         1031     1031           
  Misses         60       60           
  Partials       27       27           
Flag Coverage Δ
unittests-3.10 90.59% <ø> (ø)
unittests-3.11 90.59% <ø> (ø)
unittests-3.12 90.59% <ø> (ø)
unittests-3.13 90.59% <ø> (ø)
unittests-3.6 90.15% <ø> (ø)
unittests-3.7 90.15% <ø> (ø)
unittests-3.8 91.94% <ø> (ø)
unittests-3.9 90.33% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@GraemeWatt GraemeWatt marked this pull request as ready for review March 20, 2026 10:40
@GraemeWatt GraemeWatt requested a review from clelange March 20, 2026 10:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant