search

CEMeNT-PSAAP / MCDC

MC/DC: Monte Carlo Dynamic Code
https://mcdc.readthedocs.io/en/latest/
BSD 3-Clause "New" or "Revised" License
20 stars 20 forks source link

Citation box missing information on web-hosted docpages #210

Closed yardasol closed 1 month ago

yardasol commented 1 month ago

Hi MC/DC! I've been browsing your web-hosted docpages and noticed that the citation on the website is missing a lot of information: Screenshot 2024-07-16 at 12-27-29 MC_DC documentation

In the source markdown, all this information is present, so I'm not sure what is causing this discrepancy.

ilhamv commented 1 month ago

Hi, @yardasol ! Thanks for pointing that out! @jpmorgan98 , is it because the website has not been updated with the most recent source yet?

jpmorgan98 commented 1 month ago

Hmm looks like our build is currently failing and I never got an email about it. This appears to be a docs only problem with importing a colorama version. When I try and build locally I get this numba error:

/opt/homebrew/Caskroom/mambaforge/base/envs/mcdc_doc/lib/python3.12/site-packages/numba/core/errors.py:194: UserWarning: Insufficiently recent colorama version found. Numba requires colorama >= 0.3.9

My current colorama version is 0.4.6. @clemekay any ideas?

clemekay commented 1 month ago

Docs throw sphinx.ext.autosummary error starting with commit #6ed8ea8678bc7eb792389cef75bc03a7db3c3c61.

Issue was new import added to mcdc/type_.py, from mpi4py.util.dtlib import from_numpy_dtype. mpi4py.util.dtlib needed to be added specifically to MOCK_MODULES in docs/source/conf.py.

clemekay commented 1 month ago

Fixed in #219. Thanks again for pointing this out @yardasol, we hadn't realized that our docs weren't updating!