I like using dirhtml over html because I think the index table looks nicer in it, but it shouldn't really affect how content pages are rendered.
The following example (which is just the all-in-one.rst) works as expected with sphinx-build -b html docs/ public/ and is a mess when build with sphinx-build -b dirhtml docs/ public/.
Any idea why?
pip freeze
alabaster==0.7.12
Babel==2.7.0
certifi==2019.9.11
chardet==3.0.4
docutils==0.15.2
idna==2.8
imagesize==1.1.0
Jinja2==2.10.1
MarkupSafe==1.1.1
packaging==19.2
pkg-resources==0.0.0
Pygments==2.4.2
pyparsing==2.4.2
pytz==2019.2
requests==2.22.0
six==1.12.0
snowballstemmer==1.9.1
Sphinx==2.2.0
sphinxcontrib-applehelp==1.0.1
sphinxcontrib-contentui==0.2.4
sphinxcontrib-devhelp==1.0.1
sphinxcontrib-htmlhelp==1.0.2
sphinxcontrib-jsmath==1.0.1
sphinxcontrib-qthelp==1.0.2
sphinxcontrib-serializinghtml==1.1.3
urllib3==1.25.5
docs/conf.py
extensions = ["sphinxcontrib.contentui"]
docs/index.rst
https://raw.githubusercontent.com/ulrobix/sphinxcontrib-contentui/master/docs/example-all.rst
I like using
dirhtmloverhtmlbecause I think the index table looks nicer in it, but it shouldn't really affect how content pages are rendered.The following example (which is just the all-in-one.rst) works as expected with
sphinx-build -b html docs/ public/and is a mess when build withsphinx-build -b dirhtml docs/ public/.Any idea why?
pip freeze
docs/conf.py
docs/index.rst
https://raw.githubusercontent.com/ulrobix/sphinxcontrib-contentui/master/docs/example-all.rst