Closed justb4 closed 3 years ago
Describe the bug The documentation generated on RTD and deployments does not show the layout rendering expected. Especially lists like bullet lists are not rendered.
To Reproduce
See screenshot:
cd docs; make html
Expected Behavior See screenshot (local build):
Screenshots or Logfiles See above.
Context (please complete the following information):
Additional context May be a problem with the RTD theming. Somehow the CSS (_static/css/theme.css) disables lists, while the HTML still shows like:
_static/css/theme.css
<h2>Features<a class="headerlink" href="#features" title="Permalink to this headline">¶</a></h2> <ul class="simple"> <li><p>lightweight (Python with Flask)</p></li> <li><p>easy setup</p></li> <li><p>support for numerous OGC resources</p></li> <li><p>flexible and customizable: look and feel, scoring matrix</p></li> <li><p>user management</p></li> <li><p>database agnostic: any SQLAlchemy supported backend</p></li>
https://docs.geohealthcheck.org/en/latest/_static/css/theme.css does not seem to be an RTD theme file.
Sphinx
sphinx-rtd-theme
docs/conf.py
Last resort is to provide a custom/local theme.css!
theme.css
Resolved via PR #382
Describe the bug The documentation generated on RTD and deployments does not show the layout rendering expected. Especially lists like bullet lists are not rendered.
To Reproduce
See screenshot:
cd docs; make html
Expected Behavior See screenshot (local build):
Screenshots or Logfiles See above.
Context (please complete the following information):
Additional context May be a problem with the RTD theming. Somehow the CSS (
_static/css/theme.css
) disables lists, while the HTML still shows like:https://docs.geohealthcheck.org/en/latest/_static/css/theme.css does not seem to be an RTD theme file.
Solution Hints
Sphinx
andsphinx-rtd-theme
packages in requirements.txtsphinx-rtd-theme
indocs/conf.py
Last resort is to provide a custom/local
theme.css
!