geopython / GeoHealthCheck

Service Status and QoS Checker for OGC Web Services
https://geohealthcheck.org
MIT License
86 stars 69 forks source link

Sphinx documentation does not render lists #364

Closed justb4 closed 3 years ago

justb4 commented 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

  1. Go to https://docs.geohealthcheck.org/en/latest/index.html
  2. See plain text lines for "Features" list

See screenshot: image

  1. does not happen when building directly with "Make": cd docs; make html

Expected Behavior See screenshot (local build):

image

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:

<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.

Solution Hints

Last resort is to provide a custom/local theme.css!

justb4 commented 3 years ago

Resolved via PR #382