Wrong version recommendation of shpinx when building documentation

[emiliostassios]

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)

[hkaiser]

@dimitraka could you fix the docs according to @emiliostassios report, please?

[dimitraka]

Eventually which sphinx version worked? We need the exact version to list it in the prerequisites.

[emiliostassios]

Hello, I just created a pull request for this, I think this time is correct. The sphinx version is 5.3 and I have updated some other packages as well, you can find them all in the doc_requirments.txt. Best, E

…

On Mon, 2 Dec 2024 at 5:21 PM, Dimitra Karatza ***@***.***> wrote: Eventually which sphinx version worked? We need the exact version to list it in the prerequisites. — Reply to this email directly, view it on GitHub <#6528 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/A5FTHI5LWQKW7BGMPEIF5Z32DR3I5AVCNFSM6AAAAABMJYL3HOVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDKMJRHAZDMOBWG4> . You are receiving this because you were mentioned.Message ID: ***@***.***>