search

Alpine-DAV / ascent

A flyweight in situ visualization and analysis runtime for multi-physics HPC simulations
https://alpine-dav.github.io/ascent/
Other
196 stars 66 forks source link

Docs failing with build script #1404

Open nicolemarsaglia opened 3 weeks ago

nicolemarsaglia commented 3 weeks ago

I'm encountering the docs failing to build when installing Ascent on Lassen via scrippts/build_ascent/build_ascent.sh Cyrus has mentioned encountering the same while building with uberenv

Building HTML documentation with Sphinx for ascent_sphinx target
cd /usr/workspace/nicolem/lassen/src/ascent_warpx/ascent/scripts/build_ascent/build/ascent-checkout/docs/sphinx && /usr/tce/packages/python/python-3.8.2/bin/sphinx-build -q -b html -d /usr/workspace/nicolem/lassen/src/ascent_warpx/ascent/scripts/build_ascent/build/ascent-checkout/docs/sphinx/_doctrees /usr/workspace/nicolem/lassen/src/ascent_warpx/ascent/src/docs/sphinx /usr/workspace/nicolem/lassen/src/ascent_warpx/ascent/scripts/build_ascent/build/ascent-checkout/docs/sphinx/html

Extension error:
Could not import extension sphinxcontrib.jquery (exception: No module named 'sphinxcontrib.jquery')
gmake[4]: *** [docs/sphinx/CMakeFiles/ascent_sphinx.dir/build.make:74: docs/sphinx/CMakeFiles/ascent_sphinx] Error 2
gmake[4]: Leaving directory '/usr/WS1/nicolem/lassen/src/ascent_warpx/ascent/scripts/build_ascent/build/ascent-checkout'
gmake[3]: *** [CMakeFiles/Makefile2:11618: docs/sphinx/CMakeFiles/ascent_sphinx.dir/all] Error 2
gmake[3]: Leaving directory '/usr/WS1/nicolem/lassen/src/ascent_warpx/ascent/scripts/build_ascent/build/ascent-checkout'
gmake[2]: *** [CMakeFiles/Makefile2:11625: docs/sphinx/CMakeFiles/ascent_sphinx.dir/rule] Error 2
gmake[2]: Leaving directory '/usr/WS1/nicolem/lassen/src/ascent_warpx/ascent/scripts/build_ascent/build/ascent-checkout'
gmake[1]: *** [Makefile:179: docs/sphinx/CMakeFiles/ascent_sphinx.dir/rule] Error 2
gmake[1]: Leaving directory '/usr/WS1/nicolem/lassen/src/ascent_warpx/ascent/scripts/build_ascent/build/ascent-checkout/docs/sphinx'
JustinPrivitera commented 3 weeks ago

I know there are issues with building VisIt docs on BlueOS systems. Maybe same problem for Ascent?

cyrush commented 2 weeks ago

@nicolemarsaglia

Can you try adding: sphinxcontrib-packages

To the pip install at:

https://github.com/Alpine-DAV/ascent/blob/bd1182d37940b45b1eb9e2946c2e7f53aaaf6fe4/scripts/build_ascent/build_ascent.sh#L351

And see if that fixes in the platform hit this on?

cyrush commented 2 weeks ago

On rzhound, I see that sphinx contrib does get installed out of the box.

I wonder if lassen -- being p9 system and quite a bit older is impacting the versions used.

Installing collected packages: snowballstemmer, zipp, urllib3, tomli, sphinxcontrib-serializinghtml, sphinxcontrib-qthelp, sphinxcontrib-jsmath, sphinxcontrib-htmlhelp, sphinxcontrib-devhelp, sphinxcontrib-applehelp, Pygments, packaging, numpy, MarkupSafe, imagesize, idna, docutils, charset-normalizer, certifi, babel, alabaster, requests, Jinja2, importlib-metadata, sphinx, sphinxcontrib-jquery, sphinx_rtd_theme
Successfully installed Jinja2-3.1.4 MarkupSafe-3.0.2 Pygments-2.18.0 alabaster-0.7.16 babel-2.16.0 certifi-2024.8.30 charset-normalizer-3.4.0 docutils-0.21.2 idna-3.10 imagesize-1.4.1 importlib-metadata-8.5.0 numpy-2.0.2 packaging-24.1 requests-2.32.3 snowballstemmer-2.2.0 sphinx-7.4.7 sphinx_rtd_theme-3.0.1 sphinxcontrib-applehelp-2.0.0 sphinxcontrib-devhelp-2.0.0 sphinxcontrib-htmlhelp-2.1.0 sphinxcontrib-jquery-4.1 sphinxcontrib-jsmath-1.0.1 sphinxcontrib-qthelp-2.0.0 sphinxcontrib-serializinghtml-2.0.0 tomli-2.0.2 urllib3-2.2.3 zipp-3.20.2