Port theme CSS to support page generated with docutils>=0.17

Partially backported the changes from:

- readthedocs/sphinx_rtd_theme#1185
- readthedocs/sphinx_rtd_theme#1199

BUG: 440203

Author: alvinhochun

theme/static/css/theme.css

@@ -360,13 +360,15 @@ small {
     p,
     h2,
     .rst-content .toctree-wrapper p.caption,
+    .rst-content .toctree-wrapper figcaption > p,
     h3 {
         orphans: 3;
         widows: 3;
     }
 
     h2,
     .rst-content .toctree-wrapper p.caption,
+    .rst-content .toctree-wrapper figcaption > p,
     h3 {
         page-break-after: avoid;
     }
@@ -386,6 +388,7 @@ small {
 .rst-content dl dt .headerlink::before,
 .rst-content table > caption .headerlink::before,
 .rst-content p.caption .headerlink::before,
+.rst-content figcaption .headerlink::before,
 .rst-content tt.download span:first-child::before,
 .rst-content code.download span:first-child::before,
 .icon::before,
@@ -478,6 +481,7 @@ textarea,
 .rst-content h6 .headerlink,
 .rst-content dl dt .headerlink,
 .rst-content p.caption .headerlink,
+.rst-content figcaption .headerlink,
 .rst-content table > caption .headerlink,
 .rst-content tt.download span:first-child,
 .rst-content code.download span:first-child,
@@ -566,6 +570,7 @@ textarea,
 .rst-content h6 .fa-pull-left.headerlink,
 .rst-content dl dt .fa-pull-left.headerlink,
 .rst-content p.caption .fa-pull-left.headerlink,
+.rst-content figcaption .fa-pull-left.headerlink,
 .rst-content table > caption .fa-pull-left.headerlink,
 .rst-content tt.download span.fa-pull-left:first-child,
 .rst-content code.download span.fa-pull-left:first-child,
@@ -586,6 +591,7 @@ textarea,
 .rst-content h6 .fa-pull-right.headerlink,
 .rst-content dl dt .fa-pull-right.headerlink,
 .rst-content p.caption .fa-pull-right.headerlink,
+.rst-content figcaption .fa-pull-right.headerlink,
 .rst-content table > caption .fa-pull-right.headerlink,
 .rst-content tt.download span.fa-pull-right:first-child,
 .rst-content code.download span.fa-pull-right:first-child,
@@ -614,6 +620,7 @@ textarea,
 .rst-content h6 .pull-left.headerlink,
 .rst-content dl dt .pull-left.headerlink,
 .rst-content p.caption .pull-left.headerlink,
+.rst-content figcaption .pull-left.headerlink,
 .rst-content table > caption .pull-left.headerlink,
 .rst-content tt.download span.pull-left:first-child,
 .rst-content code.download span.pull-left:first-child,
@@ -634,6 +641,7 @@ textarea,
 .rst-content h6 .pull-right.headerlink,
 .rst-content dl dt .pull-right.headerlink,
 .rst-content p.caption .pull-right.headerlink,
+.rst-content figcaption .pull-right.headerlink,
 .rst-content table > caption .pull-right.headerlink,
 .rst-content tt.download span.pull-right:first-child,
 .rst-content code.download span.pull-right:first-child,
@@ -3609,6 +3617,7 @@ textarea,
 .rst-content h6 .headerlink,
 .rst-content dl dt .headerlink,
 .rst-content p.caption .headerlink,
+.rst-content figcaption .headerlink,
 .rst-content table > caption .headerlink,
 .rst-content tt.download span:first-child,
 .rst-content code.download span:first-child,
@@ -3634,6 +3643,7 @@ textarea,
 .rst-content h6 .headerlink::before,
 .rst-content dl dt .headerlink::before,
 .rst-content p.caption .headerlink::before,
+.rst-content figcaption .headerlink::before,
 .rst-content table > caption .headerlink::before,
 .rst-content tt.download span:first-child::before,
 .rst-content code.download span:first-child::before,
@@ -3673,7 +3683,9 @@ a .rst-content h6 .headerlink,
 a .rst-content dl dt .headerlink,
 .rst-content dl dt a .headerlink,
 a .rst-content p.caption .headerlink,
+a .rst-content figcaption .headerlink,
 .rst-content p.caption a .headerlink,
+.rst-content figcaption a .headerlink,
 a .rst-content table > caption .headerlink,
 .rst-content table > caption a .headerlink,
 a .rst-content tt.download span:first-child,
@@ -3709,7 +3721,9 @@ a .icon {
 .btn .rst-content dl dt .headerlink,
 .rst-content dl dt .btn .headerlink,
 .btn .rst-content p.caption .headerlink,
+.btn .rst-content figcaption .headerlink,
 .rst-content p.caption .btn .headerlink,
+.rst-content figcaption .btn .headerlink,
 .btn .rst-content table > caption .headerlink,
 .rst-content table > caption .btn .headerlink,
 .btn .rst-content tt.download span:first-child,
@@ -3741,7 +3755,9 @@ a .icon {
 .nav .rst-content dl dt .headerlink,
 .rst-content dl dt .nav .headerlink,
 .nav .rst-content p.caption .headerlink,
+.nav .rst-content figcaption .headerlink,
 .rst-content p.caption .nav .headerlink,
+.rst-content figcaption .nav .headerlink,
 .nav .rst-content table > caption .headerlink,
 .rst-content table > caption .nav .headerlink,
 .nav .rst-content tt.download span:first-child,
@@ -3772,7 +3788,9 @@ a .icon {
 .btn .rst-content dl dt .fa-large.headerlink,
 .rst-content dl dt .btn .fa-large.headerlink,
 .btn .rst-content p.caption .fa-large.headerlink,
+.btn .rst-content figcaption .fa-large.headerlink,
 .rst-content p.caption .btn .fa-large.headerlink,
+.rst-content figcaption .btn .fa-large.headerlink,
 .btn .rst-content table > caption .fa-large.headerlink,
 .rst-content table > caption .btn .fa-large.headerlink,
 .btn .rst-content tt.download span.fa-large:first-child,
@@ -3800,7 +3818,9 @@ a .icon {
 .nav .rst-content dl dt .fa-large.headerlink,
 .rst-content dl dt .nav .fa-large.headerlink,
 .nav .rst-content p.caption .fa-large.headerlink,
+.nav .rst-content figcaption .fa-large.headerlink,
 .rst-content p.caption .nav .fa-large.headerlink,
+.rst-content figcaption .nav .fa-large.headerlink,
 .nav .rst-content table > caption .fa-large.headerlink,
 .rst-content table > caption .nav .fa-large.headerlink,
 .nav .rst-content tt.download span.fa-large:first-child,
@@ -3831,7 +3851,9 @@ a .icon {
 .btn .rst-content dl dt .fa-spin.headerlink,
 .rst-content dl dt .btn .fa-spin.headerlink,
 .btn .rst-content p.caption .fa-spin.headerlink,
+.btn .rst-content figcaption .fa-spin.headerlink,
 .rst-content p.caption .btn .fa-spin.headerlink,
+.rst-content figcaption .btn .fa-spin.headerlink,
 .btn .rst-content table > caption .fa-spin.headerlink,
 .rst-content table > caption .btn .fa-spin.headerlink,
 .btn .rst-content tt.download span.fa-spin:first-child,
@@ -3859,7 +3881,9 @@ a .icon {
 .nav .rst-content dl dt .fa-spin.headerlink,
 .rst-content dl dt .nav .fa-spin.headerlink,
 .nav .rst-content p.caption .fa-spin.headerlink,
+.nav .rst-content figcaption .fa-spin.headerlink,
 .rst-content p.caption .nav .fa-spin.headerlink,
+.rst-content figcaption .nav .fa-spin.headerlink,
 .nav .rst-content table > caption .fa-spin.headerlink,
 .rst-content table > caption .nav .fa-spin.headerlink,
 .nav .rst-content tt.download span.fa-spin:first-child,
@@ -3881,6 +3905,7 @@ a .icon {
 .rst-content h6 .btn.headerlink::before,
 .rst-content dl dt .btn.headerlink::before,
 .rst-content p.caption .btn.headerlink::before,
+.rst-content figcaption .btn.headerlink::before,
 .rst-content table > caption .btn.headerlink::before,
 .rst-content tt.download span.btn:first-child::before,
 .rst-content code.download span.btn:first-child::before,
@@ -3902,6 +3927,7 @@ a .icon {
 .rst-content h6 .btn.headerlink:hover::before,
 .rst-content dl dt .btn.headerlink:hover::before,
 .rst-content p.caption .btn.headerlink:hover::before,
+.rst-content figcaption .btn.headerlink:hover::before,
 .rst-content table > caption .btn.headerlink:hover::before,
 .rst-content tt.download span.btn:first-child:hover::before,
 .rst-content code.download span.btn:first-child:hover::before,
@@ -3929,7 +3955,9 @@ a .icon {
 .btn-mini .rst-content dl dt .headerlink::before,
 .rst-content dl dt .btn-mini .headerlink::before,
 .btn-mini .rst-content p.caption .headerlink::before,
+.btn-mini .rst-content figcaption .headerlink::before,
 .rst-content p.caption .btn-mini .headerlink::before,
+.rst-content figcaption .btn-mini .headerlink::before,
 .btn-mini .rst-content table > caption .headerlink::before,
 .rst-content table > caption .btn-mini .headerlink::before,
 .btn-mini .rst-content tt.download span:first-child::before,
@@ -5625,6 +5653,7 @@ a.wy-text-neutral:hover {
 h1,
 h2,
 .rst-content .toctree-wrapper p.caption,
+.rst-content .toctree-wrapper figcaption > p,
 h3,
 h4,
 h5,
@@ -5676,13 +5705,15 @@ code.code-large,
 
 .wy-plain-list-disc,
 .rst-content .section ul,
+.rst-content section ul,
 .rst-content .toctree-wrapper ul,
 article ul {
     margin-bottom: 24px;
 }
 
 .wy-plain-list-disc li,
 .rst-content .section ul li,
+.rst-content section ul li,
 .rst-content .toctree-wrapper ul li,
 article ul li {
     margin-left: 24px;
@@ -5691,6 +5722,7 @@ article ul li {
 
 .wy-plain-list-disc li p:last-child,
 .rst-content .section ul li p:last-child,
+.rst-content section ul li p:last-child,
 .rst-content .toctree-wrapper ul li p:last-child,
 article ul li p:last-child {
     margin-bottom: 0;
@@ -5699,6 +5731,7 @@ article ul li p:last-child {
 
 .wy-plain-list-disc li ul,
 .rst-content .section ul li ul,
+.rst-content section ul li ul,
 .rst-content .toctree-wrapper ul li ul,
 article ul li ul {
     margin-bottom: 0;
@@ -5707,6 +5740,7 @@ article ul li ul {
 
 .wy-plain-list-decimal,
 .rst-content .section ol,
+.rst-content section ol,
 .rst-content ol.arabic,
 article ol {
     line-height: 24px;
@@ -5715,20 +5749,23 @@ article ol {
 
 .wy-plain-list-decimal li,
 .rst-content .section ol li,
+.rst-content section ol li,
 .rst-content ol.arabic li,
 article ol li {
     margin-left: 24px;
 }
 
 .wy-plain-list-decimal li p:last-child,
 .rst-content .section ol li p:last-child,
+.rst-content section ol li p:last-child,
 .rst-content ol.arabic li p:last-child,
 article ol li p:last-child {
     margin-bottom: 0;
 }
 
 .wy-plain-list-decimal li ul,
 .rst-content .section ol li ul,
+.rst-content section ol li ul,
 .rst-content ol.arabic li ul,
 article ol li ul {
     margin-bottom: 0;
@@ -5879,7 +5916,8 @@ ul > li {
 }
 
 .wy-menu-vertical header,
-.wy-menu-vertical p.caption {
+.wy-menu-vertical p.caption,
+.wy-menu-vertical figcaption > p {
     height: 32px;
     line-height: 32px;
     padding: 0 1.618em;
@@ -6487,7 +6525,9 @@ footer span.commit .rst-content tt,
 .rst-versions .rst-current-version .rst-content dl dt .headerlink,
 .rst-content dl dt .rst-versions .rst-current-version .headerlink,
 .rst-versions .rst-current-version .rst-content p.caption .headerlink,
+.rst-versions .rst-current-version .rst-content figcaption .headerlink,
 .rst-content p.caption .rst-versions .rst-current-version .headerlink,
+.rst-content figcaption .rst-versions .rst-current-version .headerlink,
 .rst-versions .rst-current-version .rst-content table > caption .headerlink,
 .rst-content table > caption .rst-versions .rst-current-version .headerlink,
 .rst-versions .rst-current-version .rst-content tt.download span:first-child,
@@ -6608,24 +6648,30 @@ footer span.commit .rst-content tt,
     height: auto;
 }
 
-.rst-content div.figure {
+.rst-content div.figure,
+.rst-content figure {
     margin-bottom: 24px;
 }
 
-.rst-content div.figure p.caption {
+.rst-content div.figure .caption-text,
+.rst-content figure .caption-text {
     font-style: italic;
 }
 
-.rst-content div.figure p:last-child.caption {
+.rst-content div.figure p:last-child.caption,
+.rst-content div.figure figcaption:last-child > p {
     margin-bottom: 0;
 }
 
-.rst-content div.figure.align-center {
+.rst-content div.figure.align-center,
+.rst-content figure.align-center {
     text-align: center;
 }
 
 .rst-content .section > img,
-.rst-content .section > a > img {
+.rst-content section > img,
+.rst-content .section > a > img,
+.rst-content section > a > img {
     margin-bottom: 24px;
 }
 
@@ -6728,17 +6774,23 @@ footer span.commit .rst-content tt,
 }
 
 .rst-content .section ol.loweralpha,
-.rst-content .section ol.loweralpha li {
+.rst-content section ol.loweralpha,
+.rst-content .section ol.loweralpha li,
+.rst-content section ol.loweralpha li {
     list-style: lower-alpha;
 }
 
 .rst-content .section ol.upperalpha,
-.rst-content .section ol.upperalpha li {
+.rst-content section ol.upperalpha,
+.rst-content .section ol.upperalpha li,
+.rst-content section ol.upperalpha li {
     list-style: upper-alpha;
 }
 
 .rst-content .section ol p,
-.rst-content .section ul p {
+.rst-content section ol p,
+.rst-content .section ul p,
+.rst-content section ul p {
     margin-bottom: 12px;
 }
 
@@ -6779,12 +6831,14 @@ footer span.commit .rst-content tt,
 .rst-content h1 .headerlink,
 .rst-content h2 .headerlink,
 .rst-content .toctree-wrapper p.caption .headerlink,
+.rst-content .toctree-wrapper figcaption .headerlink,
 .rst-content h3 .headerlink,
 .rst-content h4 .headerlink,
 .rst-content h5 .headerlink,
 .rst-content h6 .headerlink,
 .rst-content dl dt .headerlink,
 .rst-content p.caption .headerlink,
+.rst-content figcaption .headerlink,
 .rst-content table > caption .headerlink {
     visibility: hidden;
     font-size: 14px;
@@ -6793,12 +6847,14 @@ footer span.commit .rst-content tt,
 .rst-content h1 .headerlink::after,
 .rst-content h2 .headerlink::after,
 .rst-content .toctree-wrapper p.caption .headerlink::after,
+.rst-content .toctree-wrapper figcaption .headerlink::after,
 .rst-content h3 .headerlink::after,
 .rst-content h4 .headerlink::after,
 .rst-content h5 .headerlink::after,
 .rst-content h6 .headerlink::after,
 .rst-content dl dt .headerlink::after,
 .rst-content p.caption .headerlink::after,
+.rst-content figcaption .headerlink::after,
 .rst-content table > caption .headerlink::after {
     content: "";
     font-family: FontAwesome;
@@ -6807,12 +6863,14 @@ footer span.commit .rst-content tt,
 .rst-content h1:hover .headerlink::after,
 .rst-content h2:hover .headerlink::after,
 .rst-content .toctree-wrapper p.caption:hover .headerlink::after,
+.rst-content .toctree-wrapper figcaption:hover .headerlink::after,
 .rst-content h3:hover .headerlink::after,
 .rst-content h4:hover .headerlink::after,
 .rst-content h5:hover .headerlink::after,
 .rst-content h6:hover .headerlink::after,
 .rst-content dl dt:hover .headerlink::after,
 .rst-content p.caption:hover .headerlink::after,
+.rst-content figcaption:hover .headerlink::after,
 .rst-content table > caption:hover .headerlink::after {
     visibility: visible;
 }