Failed to build the docs
tui95 opened this issue · comments
Khemmatat Theanvanichpant commented
Describe the bug
I cannot build the docs
To Reproduce
Running the command according to build the docs section results in failure.
$ make html
sphinx-build -b html -d _build/doctrees . _build/html
Running Sphinx v4.3.2
Extension error:
Could not import extension sphinxcontrib.mermaid (exception: cannot import name 'ENOENT' from 'sphinx.util.osutil' (/Users/tui/Library/Caches/pypoetry/virtualenvs/django-generate-series-Vs9BvJIc-py3.9/lib/python3.9/site-packages/sphinx/util/osutil.py))
make: *** [html] Error 2
Expected behavior
No error should occur and HTML docs should be generated.
Version:
- python: 3.9.0
- django-generate-series: 0.4.5
Additional context
The bug comes from sphinxcontrib-mermaid version 0.6.x not adapting to sphinx version 4.0.0 API changes.
Solutions
- Workaround according to mgaitan/sphinxcontrib-mermaid#72 (comment)
- Update
sphinxcontrib-mermaid
version to 0.7.0
Jack Linke commented
Not sure how I missed this before, but fixed in latest version. Thank you for the report.