STEllAR-GROUP/hpx

Wrong version recommendation of shpinx when building documentation

Opened this issue · 0 comments

The page suggests to use:
pip install --user "sphinx<5" sphinx-book-theme breathe sphinxcontrib-bibtex sphinx-copybutton

Actual Behavior

There are version conflicts with sphinx<5 (4.5.0, recommended on the page).

Solution

I succeded in building HPX with these steps:
Install docutils<0.18
and pip install --user "sphinx<6" sphinx-book-theme breathe sphinxcontrib-bibtex sphinx-copybutton

... Please describe your environment

  • HPX Version: HPX v1.10.0
  • Python version: Python 3.10.12
  • Platform (compiler, OS): WSL (Ubuntu)