CORE-GATECH-GROUP / serpent-tools

A suite of parsers designed to make interacting with SERPENT output files simple and flawless
http://serpent-tools.readthedocs.io/en/latest/
MIT License
52 stars 33 forks source link

BUG Docs are failing on read the docs #448

Closed drewejohnson closed 1 year ago

drewejohnson commented 3 years ago

Summary of issue

https://readthedocs.org/projects/serpent-tools/builds/13844425/

Produces two warnings (which can be replicated locally)

home/docs/checkouts/readthedocs.org/user_builds/serpent-tools/checkouts/master/serpentTools/parsers/sensitivity.py:docstring of serpentTools.SensitivityReader.plot:64: WARNING: Unknown interpreted text role "method".
/home/docs/checkouts/readthedocs.org/user_builds/serpent-tools/checkouts/master/docs/publications.rst:5: WARNING: Duplicate explicit target name: "nuclear engineering and design (2020)".

Documentation still appears to be built properly

Code for reproducing the issue

cd docs
make clean html

Actual outcome including console output and error traceback if applicable

(error message above) Locally it looks like the SensitivityReader issue is causing a more serious error (red rather than magenta)

Expected outcome

No warning message

Versions

857b9f5

drewejohnson commented 3 years ago

While we're at it

intersphinx inventory has moved: https://docs.scipy.org/doc/numpy/objects.inv -> https://numpy.org/doc/stable/objects.inv
drewejohnson commented 3 years ago

https://github.com/CORE-GATECH-GROUP/serpent-tools/blob/857b9f51b1e4224c77c9458121af2188e36931f9/serpentTools/parsers/sensitivity.py#L394