Docs failing with build script

[nicolemarsaglia]

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]

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

[cyrush]

@nicolemarsaglia

Can you try adding: sphinxcontrib-packages

To the pip install at:

ascent/scripts/build_ascent/build_ascent.sh

Line 351 in bd1182d

${venv_python_exe} -m pip install numpy sphinx sphinx_rtd_theme

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

[cyrush]

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