Add support for docutils 0.17

This should'nt be a breaking change as backward compatibility is preserved so this change could go into 1.0 or wait until 1.1.

I know a lot of users are asking for this so it might be nice to include this in 1.0.

Fixes #1115

Author: Blendify

setup.py

@@ -119,7 +119,7 @@ def run(self):
     python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
     install_requires=[
         'sphinx>=1.6',
-        'docutils<0.17', # https://github.com/sphinx-doc/sphinx/issues/9001
+        'docutils<=0.17.1',
     ],
     tests_require=[
         'pytest',

sphinx_rtd_theme/static/css/theme.css

@@ -16,22 +16,18 @@
 .rst-content
   // Sphinx by default applies HxW style attributes to images. This fixes that oversite.
   img
+    margin-bottom: $base-line-height
     max-width: 100%
     height: auto
 
-  div.figure
+  div.figure, figure
     margin-bottom: $base-line-height
     p.caption
       font-style: italic
     p:last-child.caption
       margin-bottom: 0px
-
-  div.figure.align-center
-    text-align: center
-
-  // Usually it's a good idea to give images some space.
-  .section > img,   .section > a > img
-    margin-bottom: $base-line-height
+    &.align-center
+      text-align: center
 
   // normalize browser styling
   abbr[title]
@@ -147,36 +143,39 @@
     td, th
       background: transparent !important
       border-color: rgba(0, 0, 0, 0.1) !important
-  .section ul, .toctree-wrapper ul
-    @extend .wy-plain-list-disc
-  .section ol.loweralpha, .section ol.loweralpha > li
-    list-style: lower-alpha
-  .section ol.upperalpha, .section ol.upperalpha > li
-    list-style: upper-alpha
-  .section ol, ol.arabic
-    @extend .wy-plain-list-decimal
-  // Complex bullet lists, they have more item margins than simple lists
-  .section ol li, .section ul li
-    > *
-      margin-top: $base-line-height / 2
-      margin-bottom: $base-line-height / 2
-      &:first-child
-        margin-top: 0rem
-    > p
-      &, &:last-child
+
+  .section, section
+    ul, .toctree-wrapper ul
+      @extend .wy-plain-list-disc
+    ol.loweralpha, ol.loweralpha > li
+      list-style: lower-alpha
+    ol.upperalpha, ol.upperalpha > li
+      list-style: upper-alpha
+    ol, ol.arabic
+      @extend .wy-plain-list-decimal
+    // Complex bullet lists, they have more item margins than simple lists
+    ol li, ul li
+      > *
+        margin-top: $base-line-height / 2
+        margin-bottom: $base-line-height / 2
+        &:first-child
+          margin-top: 0rem
+      > p
+        &, &:last-child
+          margin-bottom: $base-line-height / 2
+        &:only-child, &:only-child:last-child
+          margin-bottom: 0rem
+      > ul, > ol
         margin-bottom: $base-line-height / 2
-      &:only-child, &:only-child:last-child
+    // Simple lists, no item margins
+    ol.simple li, ul.simple li
+      > *
+        margin-top: 0rem
         margin-bottom: 0rem
-    > ul, > ol
-      margin-bottom: $base-line-height / 2
-  // Simple lists, no item margins
-  .section ol.simple li, .section ul.simple li
-    > *
-      margin-top: 0rem
-      margin-bottom: 0rem
-    ul, ol
-      margin-top: 0rem
-      margin-bottom: 0rem
+      ul, ol
+        margin-top: 0rem
+        margin-bottom: 0rem
+
   .line-block
     margin-left: 0px
     margin-bottom: $base-line-height