update documentation style with rtd_theme

- fix #80
- removed un-necessary stuff (readable.css, colors from conf.py)
- add @lilyminium to authors

Author: lilyminium

AUTHORS

@@ -2,7 +2,7 @@
  gridDataFormats
 =================
 
-Copyright (c) 2007-2019 Oliver Beckstein <orbeckst@gmail.com> and Contributors
+Copyright (c) 2007-2020 Oliver Beckstein <orbeckst@gmail.com> and Contributors
 
 Published under the GNU Lesser General Public Licence, version 3
 
@@ -19,3 +19,4 @@ Contributors:
 * Giacomo Fiorin <giacomofiorin>
 * Eloy Félix <eloyfelix>
 * René Hafner (Hamburger) <renehamburger1993>
+* Lily Wang <lilyminium>

CHANGELOG

@@ -13,17 +13,17 @@ The rules for this file:
   * accompany each entry with github issue/PR number (Issue #xyz)
 
 ------------------------------------------------------------------------------
-??/??/2019 eloyfelix, renehamburger1993
+??/??/2019 eloyfelix, renehamburger1993, lilyminium
 
   * 0.6.0
 
   Enhancements
 
   * Allow parsing/writing gzipped DX files
-  
-  
+  * Update doc theme to use sphinx-rtd-theme (#80)
+
   Fixes
-  
+
   * fix initialization of mutable instance variable of Grid class (metadata dict) (#71)
   * fix multiple __init__ calls (#73)
 

doc/source/_static/custom.css

@@ -5,8 +5,10 @@
 /* MDAnalysis gray: #808080 */
 /* MDAnalysis white: #FFFFFF */
 /* MDAnalysis black: #000000 */
-
-@import url('readable.css');
+/* Darker orange: e76900 */
+/* Even darker orange: #a24900 */
+/* RTD dark grey: #343131 */
+/* RTD light grey: #e6e6e6 */
 
 /* -- page layout --------------------------------------------------------- */
 
@@ -20,27 +22,53 @@ div.body {
 }
 
 div.sphinxsidebar a:hover {
-    color: #FF9200;
+    text-decoration: none !important;
 }
 
 div.sphinxsidebar p {
     color: #808080;
 }
 
+/* Home MDAnalysis colour */
+.wy-side-nav-search > a {
+    color: #343131;
+}
+
+/* Side MDAnalysis version colour */
+.wy-side-nav-search > div.version {
+    color: #808080;
+}
+
+/* Menubar caption colour */
+div.wy-menu-vertical span.caption-text {
+    color: #FF9200;
+}
+
+/* Mobile layout menubar option */
+nav.wy-nav-top {
+    background: #343131;
+}
+
+/* Menu search bar outline (default blue) */
+.wy-side-nav-search input[type="text"] {
+    border-color: #808080;
+}
+
 
 /* -- body styles --------------------------------------------------------- */
 
-a {
+/* Different coloured links for sidebar vs body) */
+div.rst-content a {
     color: #FF9200;
     text-decoration: none;
 }
 
-a:visited {
+div.rst-content a:visited {
     color: #FF9200;
 }
 
 a:hover {
-    color: #FF9200;
+    color: #FF9200 !important;
     text-decoration: underline;
 }
 
@@ -66,6 +94,7 @@ a.headerlink:hover {
     color: #fff;
 }
 
+/* ------- admonition boxes ------- */
 
 div.admonition {
     margin: 10px 0px;
@@ -75,4 +104,103 @@ div.admonition {
 div.admonition p.admonition-title {
     font-size: 100%;
     font-weight: bolder;
+}
+
+/* ----- Tables ----- */
+
+/* override table width restrictions */
+/* wrap tables instead of scrolling */
+@media screen and (min-width: 767px) {
+
+    .wy-table-responsive table td, .wy-table-responsive table th {
+       /* !important prevents the common CSS stylesheets from overriding
+          this as on RTD they are loaded after this stylesheet */
+       white-space: normal !important;
+    }
+ 
+    .wy-table-responsive {
+       overflow: visible !important;
+       max-width: 100% !important;
+    }
+ }
+
+/* ----- Field lists ------ */
+
+.section > dl.field-list {
+    display: flex;
+    flex-wrap: wrap;
+    margin: 0;
+    padding: 0;
+}
+
+dl.field-list > dt::after {
+    content: ":";
+}
+
+.rst-content dl:not(.docutils) dt {
+    background: none;
+    color: #000000;
+    border-top: none;
+}
+
+.section > dl.field-list dt {
+    margin: 0;
+    padding: 0;
+    flex-basis: 20%;
+    display: block;
+}
+
+.section > dl.field-list > dd {
+    flex-basis: 70%;
+    margin: 0;
+}
+
+.section > dl.field-list > dd p {
+    margin: 0;
+}
+
+/* ----- MDAnalysis coloured elements ------ */
+
+.rst-content dl.class dt, .rst-content dl.function dt {
+    color: #ca6500;
+    background: #FFEBD0;
+    border-top: solid 3px #FF9200;
+}
+
+.rst-content .viewcode-link, .rst-content .viewcode-back {
+    color: #808080;
+}
+
+.rst-content .guilabel {
+    background: #efefef;
+    border: 1px solid #808080;
+}
+
+
+.rst-content .seealso p.admonition-title {
+    background: #808080;
+}
+
+.rst-content .seealso {
+    background: #e3e3e3;
+}
+
+.rst-content  .error p.admonition-title, .rst-content  .warning p.admonition-title {
+    background: #F45F4B;
+}
+
+.rst-content .error, .rst-content .warning {
+    background: #FFEEED;
+}
+
+.rst-content .caution p.admonition-title, .rst-content .note p.admonition-title, .rst-content .important p.admonition-title  {
+    background: #FF9200;
+}
+
+.rst-content .caution, .rst-content .note, .rst-content .important {
+    background: #FFEBD0;
+}
+
+.rst-content code:not(.xref).literal {
+    color: #ca6500;
 }