From 70eb6e9d05e8b0ec3bb4ab85785b8cba250ae58d Mon Sep 17 00:00:00 2001
From: Ashley Smith <ashley.smith@magneticearth.org>
Date: Fri, 6 May 2022 15:27:01 +0100
Subject: [PATCH] Switch docs back to readthedocs theme (#80)

* Revert to sphinx-rtd-theme and store logo in repo

* Move readme content to index page
---
 docs/conf.py                   |  17 ++---
 docs/images/vre_logo_light.svg | 126 +++++++++++++++++++++++++++++++++
 docs/index.rst                 |  16 ++---
 docs/readme.rst                |   4 --
 pyproject.toml                 |   2 +-
 5 files changed, 139 insertions(+), 26 deletions(-)
 create mode 100644 docs/images/vre_logo_light.svg
 delete mode 100644 docs/readme.rst

diff --git a/docs/conf.py b/docs/conf.py
index 6c84dd3..1a123bc 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -11,9 +11,7 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
-import os
-import sys
-import urllib.request
+
 
 # -- Project information -----------------------------------------------------
 
@@ -73,13 +71,13 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = "sphinx_book_theme"
+html_theme = "sphinx_rtd_theme"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
 #
-# html_theme_options = {}
+html_theme_options = {"style_external_links": True}
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
@@ -96,14 +94,7 @@
 #
 # html_sidebars = {}
 
-# Fetch and use external logo
-logo_filename = "vre_logo_light.svg"
-if not os.path.exists(logo_filename):
-    urllib.request.urlretrieve(
-        "https://raw.githubusercontent.com/ESA-VirES/Swarm-VRE/staging/docs/_static/vre_logo_light.svg",
-        logo_filename,
-    )
-html_logo = logo_filename
+html_logo = "images/vre_logo_light.svg"
 
 
 # -- Options for HTMLHelp output ---------------------------------------------
diff --git a/docs/images/vre_logo_light.svg b/docs/images/vre_logo_light.svg
new file mode 100644
index 0000000..d6bae8c
--- /dev/null
+++ b/docs/images/vre_logo_light.svg
@@ -0,0 +1,126 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="182.69917mm"
+   height="46.849133mm"
+   viewBox="0 0 182.69917 46.849133"
+   version="1.1"
+   id="svg8"
+   inkscape:version="0.92.3 (2405546, 2018-03-11)"
+   sodipodi:docname="vre_logo_light.svg"
+   enable-background="new">
+  <defs
+     id="defs2" />
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="0.35"
+     inkscape:cx="51.299427"
+     inkscape:cy="-256.5103"
+     inkscape:document-units="mm"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     inkscape:window-width="1814"
+     inkscape:window-height="1094"
+     inkscape:window-x="84"
+     inkscape:window-y="53"
+     inkscape:window-maximized="0" />
+  <metadata
+     id="metadata5">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(-70.190369,-154.65092)"
+     style="display:inline">
+    <g
+       id="g850"
+       transform="matrix(0.07590035,0,0,0.07590035,70.190369,154.65092)">
+      <g
+         transform="translate(-8.1013276,-41.377366)"
+         style="display:inline;fill:#c8c4b7;fill-opacity:1"
+         inkscape:label="Layer 1"
+         id="layer3">
+        <path
+           inkscape:connector-curvature="0"
+           d="m 218.94869,43.14764 c -41.3,7 -73.6,28.7 -99.6,66.9 -2.4,3.6 -4.9,7.4 -5.5,8.5 -8.7,15.9 -14.200002,28.3 -19.000002,43 l -3.3,10 -8.3,3.2 c -15.9,6.3 -34.2,16.2 -44.3,24.1 -7.1,5.5 -17,16.3 -21.2,23 -16.6000003,26.6 -11.7000003,57.5 14.1,87.7 7.2,8.4 14.4,15.4 26.3,25.7 4,3.4 27.4,19.6 33.4,23.1 2.6,1.4 4.9,3.6 5.2,4.8 0.3,1.2 -0.5,6.5 -1.8,11.8 -3,12.1 -7.1,33.7 -8,41.6 -0.4,3.3 -0.9,7.1 -1.1,8.5 -1,6.2 -1.7,22.7 -1.7,36 0.4,92.3 46.500002,159.4 119.800002,174.5 18.3,3.7 41.8,4.1 64.5,1 4.6,-0.7 23.3,-4.6 24.1,-5.1 0.4,-0.2 3.9,1.2 7.7,3.1 27.2,13.4 53.9,21.5 76.2,23.1 4.1,0.3 8,0.7 8.7,0.9 0.7,0.2 1.5,0 1.8,-0.6 0.4,-0.5 0.3,-0.9 -0.2,-0.7 -0.8,0.2 -12.6,-1.1 -15.3,-1.8 -18.8,-4.3 -40,-12.5 -58.8,-22.6 l -8.3,-4.5 12.8,-4.8 c 56.7,-21.1 114.6,-64.3 163.4,-122 10.5,-12.5 26.7,-34.1 34.5,-46.2 6.5,-10.1 5.3,-9.4 19.4,-10.8 3,-0.3 6.5,-0.8 7.8,-1.1 2.3,-0.5 2.4,-0.3 2.5,24.1 0,5.1 -1.2,26.8 -1.8,31.5 -0.8,6.6 -2.4,17.1 -3,20 -0.3,1.4 -0.8,4.1 -1.1,6 -3.9,22.8 -18.3,59.4 -29,73.7 -3.1,4.1 -3.1,5.3 -0.1,1.6 7.4,-8.8 22.8,-36 25.2,-44.3 0.4,-1.4 1.1,-3 1.5,-3.5 1.4,-1.8 7,-19.7 10,-31.5 2.9,-11.7 5.5,-26.1 6.5,-36 0.3,-3 0.8,-7.7 1.1,-10.3 0.3,-2.6 0.7,-11.2 0.9,-19 l 0.3,-14.2 4.3,-0.8 c 30.4,-5.7 58.7,-14.2 77.7,-23.2 4,-1.9 7.6,-3.5 7.9,-3.5 1.5,0 25.3,-15.6 25.3,-16.7 0,-0.2 -1.4,0.5 -3,1.7 -14.4,10.2 -48.3,23.5 -70.9,27.7 -1.4,0.2 -2.7,0.6 -3,0.8 -0.4,0.2 -5.8,1.3 -12.1,2.4 -6.3,1.2 -12.4,2.3 -13.5,2.5 -1.1,0.2 -4.5,0.7 -7.6,1 l -5.6,0.7 -0.2,-7.5 c -0.1,-4 -0.3,-8.3 -0.6,-9.4 -0.7,-3.7 -1.8,-17.6 -1.8,-23.2 -0.1,-4.6 1,-7.9 6.2,-19.9 13.7,-31.9 26.2,-75.2 29.7,-103.1 0.4,-3.6 0.8,-6.7 0.9,-7 0.6,-2.1 2.1,-19.9 2.4,-27.8 0.1,-1.8 0.4,-2 1.9,-1.3 0.9,0.6 6.4,3.5 12.2,6.7 40.3,21.8 69.6,46.1 85.7,71 1,1.5 1,1.2 0,-1.1 -1.8,-4.5 -8.2,-14.1 -14.7,-22 -15.5,-19 -43.1,-40.5 -73.2,-57.3 l -11.8,-6.5 -0.1,-8.6 c 0,-8.3 -0.1,-10.2 -1.4,-22.1 -1.6,-15.1 -3.5,-24.9 -7.4,-38.7 -7.6,-26.2 -18.4,-46.8 -34.6,-65.6 -3.7,-4.2 -6.8,-7.7 -7.1,-7.7 -0.2,0 1.6,2.6 4,5.7 10.7,14.3 17.7,27.7 23.5,45.7 4.3,13.1 7.5,27.3 8.6,37.6 0.4,3.6 0.9,7.4 1.2,8.5 0.7,3.6 1,38.5 0.3,38.5 -0.4,0 -5.2,-2.1 -10.6,-4.6 -5.5,-2.5 -10.8,-4.9 -11.9,-5.4 -28.1,-11.8 -76.4,-28.3 -89.8,-30.7 -1.5,-0.3 -3.2,-1.3 -3.7,-2.3 -0.6,-1 -1.6,-2.4 -2.3,-3.2 -0.7,-0.7 -3.7,-4.5 -6.6,-8.3 -29,-37.4 -67.1,-71.6 -102.6,-92 l -5,-2.9 9,-4.3 c 13,-6.1 31.9,-12.9 45.9,-16.4 6.6,-1.7 12.3,-3.3 12.6,-3.6 0.3,-0.3 -0.8,-0.3 -2.5,0.1 -1.6,0.3 -4.3,0.8 -6,1.1 -15.9,2.7 -30.2,6.6 -45.6,12.4 -5.7,2.2 -12.4,4.8 -14.9,5.8 l -4.4,2 -10.6,-5 c -10.1,-4.8 -29.5,-12.2 -34.2,-13.1 -1.3,-0.2 -5.9,-1.3 -10.3,-2.4 -20,-5.1 -46.8,-6.3 -66,-3.1 z m 38.5,1.3 c 21.2,2.4 49.6,11.7 69.7,22.9 l 5.2,2.8 -8.7,4.6 c -32.3,17 -66.6,42.1 -93.5,68.6 -3.2,3.1 -6.1,5.7 -6.5,5.8 -0.4,0 -1.4,0.2 -2.2,0.4 -0.9,0.1 -7.2,0.6 -14,0.9 -12.4,0.7 -14.5,0.9 -29,2.6 -4.1,0.5 -9.7,1.2 -12.5,1.5 -2.7,0.3 -7.2,1 -10,1.5 -2.7,0.5 -6.1,1.1 -7.5,1.4 -8.9,1.4 -21.1,4 -30.8,6.5 -9.8,2.5 -11.2,2.7 -10.8,1.3 0.3,-1 1,-3.7 1.6,-6.2 3.5,-13.9 12.4,-35.1 20.5,-48.7 7.8,-13 14.3,-21.4 24.4,-31.3 24.3,-24 53.8,-35.9 87.6,-35.4 5.5,0 12.9,0.4 16.5,0.8 z m 91.8,35.8 c 29.4,19 61.9,50 88.1,83.8 5.5,7.1 6.1,8.2 4,7.8 -8.3,-1.9 -36,-7.7 -38.9,-8.2 -1.9,-0.3 -6,-1 -9,-1.6 -6.2,-1.2 -4.6,-1 -28,-4.4 -9.6,-1.4 -20.9,-2.8 -25,-3.2 -4.1,-0.3 -8.4,-0.8 -9.5,-1 -1.1,-0.2 -5.4,-0.7 -9.5,-1 -4.1,-0.3 -9.3,-0.7 -11.5,-0.9 -10.5,-1 -33.8,-1.9 -50.2,-1.9 -10.1,-0.1 -18.3,-0.5 -18.3,-1 0,-0.4 2.1,-2.9 4.8,-5.3 15.3,-14.6 19.6,-18.5 27.7,-25.3 11,-9.2 22.4,-17.9 33,-25.1 11.9,-8 29.8,-18.8 31.3,-18.8 0.8,-0.1 5.7,2.7 11,6.1 z m -138,82.7 c -2.9,3 -5.5,5.8 -5.8,6.1 -0.3,0.3 -4.1,4.8 -8.6,10 -24.8,29.3 -47.2,62.9 -64.6,97.1 -8.6,16.8 -9.2,18.1 -18.3,40.3 l -5.3,12.9 -1,-3.9 c -1.3,-4.9 -2,-8.6 -2.7,-14.4 -0.3,-2.5 -1,-6.8 -1.5,-9.5 -3.3,-17.9 -4.500002,-34.1 -4.500002,-62.5 0,-21.4 0.6,-35.8 1.900002,-42.5 0.3,-1.8 0.7,-4.1 2.2,-13.5 1.6,-10.9 2.6,-12.1 9.9,-13.3 1.7,-0.3 5.3,-1 8,-1.6 7.7,-1.7 20.5,-4.1 25,-4.6 2.2,-0.3 6.5,-1 9.6,-1.5 3.1,-0.6 8.7,-1.3 12.5,-1.6 3.8,-0.2 8,-0.7 9.4,-0.9 1.4,-0.3 8.8,-0.8 16.5,-1.1 7.7,-0.4 14.1,-0.7 14.2,-0.8 0.1,-0.1 2,-0.2 4.3,-0.2 h 4.1 z m 75.7,-4.4 c 2.2,0.2 7.8,0.6 12.5,0.9 10.2,0.8 19.6,1.6 23,2.1 1.4,0.2 5.4,0.6 9,1 3.6,0.3 7.6,0.8 9,1 1.4,0.3 4.5,0.7 7,1 2.5,0.2 9.2,1.1 15,2 5.8,0.9 11.4,1.8 12.5,1.9 5.5,0.8 12.4,2 26.5,4.8 8.5,1.6 16.6,3.2 18,3.4 8.8,1.7 32.6,7.6 33.3,8.3 0.5,0.5 1.4,1.8 2.1,2.9 0.6,1.2 3.6,5.8 6.7,10.4 18.9,27.9 40.4,70.5 52.8,104.4 6.1,16.6 14.7,44.4 16.7,53.9 0.2,1.1 1.5,6.5 2.7,12 l 2.3,10.1 -3.9,8.4 c -4.8,10.4 -17.8,34 -24.4,44.3 l -4.8,7.6 -34.5,-0.4 c -19,-0.3 -36.3,-0.7 -38.5,-0.9 -2.2,-0.2 -8.8,-0.7 -14.8,-1.1 -5.9,-0.3 -11.5,-0.8 -12.5,-1 -0.9,-0.1 -5.1,-0.6 -9.2,-0.9 -6.4,-0.6 -18.9,-2.1 -35.5,-4.2 -2.2,-0.2 -9.6,-1.4 -16.5,-2.5 -6.9,-1.2 -13.4,-2.2 -14.5,-2.4 -3.8,-0.5 -10,-1.7 -21.5,-4 -1.4,-0.3 -4,-0.8 -5.9,-1.1 -19.6,-3.3 -93.7,-23.7 -106.6,-29.4 -1.1,-0.5 -7,-2.7 -13.1,-4.9 -25,-8.9 -62.8,-26 -64.4,-29.2 -1.1,-1.9 1.6,-10.5 10.3,-32.4 17.9,-45.2 48.8,-98.1 78.6,-134.6 2.6,-3 6.2,-7.5 8.1,-9.9 1.9,-2.4 4,-4.8 4.5,-5.4 0.6,-0.6 4.4,-4.9 8.5,-9.5 l 7.5,-8.4 25,0.7 c 13.8,0.4 26.8,0.9 29,1.1 z m -198.000002,24 c -0.8,3.3 -1.7,7.6 -2,9.5 -2.2,13.3 -3.6,23.8 -4.2,32 -1.4,17.8 -0.8,56.1 1.1,70.5 0.2,1.6 0.7,5.5 1,8.6 0.4,3.1 0.9,6.7 1.1,8 0.3,1.3 0.7,4.1 1,6.4 0.3,2.2 0.8,4.7 1,5.5 0.2,0.8 0.7,3.3 1,5.5 0.3,2.2 1.2,6.7 1.9,10 0.8,3.3 1.3,6.1 1.2,6.2 -0.9,0.9 -31.2,-20.4 -41.2,-28.9 -2.9,-2.5 -13.8,-13.6 -17.9,-18.3 -4.7,-5.3 -13.2,-18.8 -16,-25.5 -14.1000003,-33.5 2.9,-64.5 47,-85.5 7,-3.3 25.7,-10.6 26.2,-10.1 0.1,0 -0.5,2.8 -1.2,6.1 z m 392.300002,9.6 c 27.3,8.4 53.3,17.3 65.7,22.4 2.2,0.9 5.1,2.1 6.5,2.7 1.4,0.5 7.5,3.1 13.5,5.7 l 11,4.7 -0.3,6 c -0.3,5.5 -2.5,22.2 -3.7,28.9 -0.9,4.7 -4.5,21.8 -5.1,24 -0.3,1.1 -0.7,3.1 -1,4.5 -1.9,10.3 -16.9,55.2 -21.2,63.5 -1.5,2.9 -1.5,2.9 -5.2,-11.8 -12.7,-49.7 -34.6,-99.7 -62.6,-143 -3.5,-5.3 -5.9,-9.7 -5.3,-9.7 0.5,0 4,0.9 7.7,2.1 z m -340.4,191.9 c 0.3,0 3.4,1.4 6.9,3 21,9.7 61.9,24 94.2,32.8 23.1,6.4 64.3,15.4 81,17.7 2.8,0.4 5.9,0.9 7,1.1 1.8,0.4 10.1,1.6 19.5,2.9 6.8,0.9 11.6,1.5 17.5,2.1 3.3,0.3 6.7,0.7 7.5,0.9 0.8,0.2 6,0.7 11.5,1.1 5.5,0.3 10.8,0.8 11.8,1 5.7,1 34.8,1.9 64.8,1.9 l 34.6,-0.1 -10.1,14.1 c -9,12.4 -28.3,37.3 -31.2,40 -0.5,0.5 -5,5.4 -10,10.9 -23.8,26.3 -56.3,55 -81.9,72.3 -17.9,12 -46.4,27.1 -62.2,32.9 -7.4,2.7 -7.5,2.7 -10.6,0.9 -4.6,-2.7 -23,-16.6 -30.6,-23.2 -12.3,-10.6 -37.3,-36.3 -47.4,-48.8 -30.4,-37.5 -56,-80.2 -75.2,-125 -4.5,-10.6 -17.5,-45.8 -17.5,-47.5 0,-0.5 4.5,1.4 10,4.1 5.5,2.7 10.2,4.9 10.4,4.9 z m -28.5,27 c 1.5,4.6 15,34.4 20.1,44.5 18.9,36.9 40.7,69 68.2,100.5 11.8,13.6 31.8,32.6 46.8,44.5 11.5,9.1 32.4,23.5 34.1,23.5 3.3,0 -1.4,2 -9.1,3.9 -22.3,5.4 -49,7.3 -66.5,4.5 -43.5,-6.8 -74.8,-30.8 -94,-71.9 -12.000002,-25.6 -17.900002,-54.4 -17.900002,-87 0,-11.3 1.2,-33.7 1.9,-35.7 0.2,-0.7 0.6,-3.6 0.9,-6.3 0.7,-8.8 2.5,-18.7 7.100002,-39.5 0.2,-0.8 0.4,-1.7 0.5,-2 0.1,-0.5 6.3,15.8 7.9,21 z m 430.7,15.7 0.7,9.3 -3.9,0.1 c -2.2,0 -5.8,0.2 -8.1,0.5 -4.6,0.5 -5.1,0 -3,-3.1 0.8,-1.1 3.5,-6.1 6.2,-11 2.6,-5 5,-9.4 5.3,-10 0.9,-1.5 2.1,4.3 2.8,14.2 z"
+           id="path4"
+           style="fill:#c8c4b7;fill-opacity:1;stroke:none;stroke-width:0.1" />
+      </g>
+      <g
+         transform="translate(-8.1013276,-41.377366)"
+         style="display:inline"
+         inkscape:label="Layer 2"
+         id="layer4">
+        <g
+           style="fill:#ff0031;fill-opacity:1;stroke:none"
+           id="g6-3"
+           transform="matrix(0.1,0,0,-0.1,-0.55131234,689.04764)">
+          <path
+             inkscape:connector-curvature="0"
+             id="path4-6"
+             transform="matrix(7.5000002,0,0,-7.5000002,5.5131234,6890.4764)"
+             d="m 550.59766,60.179688 c -0.6,0.01667 -1.53269,0.151302 -2.66602,0.417968 -2.13333,0.4 -5.73333,1.066797 -8,1.466797 -21.2,3.6 -40.26745,8.79987 -60.80078,16.533203 -7.6,2.933334 -16.53183,6.399089 -19.86524,7.732422 l -5.86718,2.666016 -0.22656,-0.107422 c -0.0136,0.0057 -0.0255,0.01186 -0.0391,0.01758 2.67371,1.322715 5.32267,2.674211 7.9336,4.072266 0.0718,-0.03533 0.14095,-0.0722 0.21289,-0.107422 l -0.0137,-0.0078 12,-5.732422 c 17.33341,-8.133333 42.53256,-17.200521 61.19922,-21.867187 8.8,-2.266667 16.40079,-4.400781 16.80078,-4.800781 0.20007,-0.2 -0.068,-0.299877 -0.66796,-0.283203 z m -107.51172,33.373046 -11.55469,6.111328 c -43.06667,22.666668 -88.79935,56.133468 -124.66602,91.466798 -1.37184,1.32897 -2.6482,2.52641 -3.83984,3.62891 v 0.0137 c -1.66946,1.62311 -3.19642,3.15228 -4.69336,4.67187 7.37241,-0.342 14.74478,-0.54194 22.11719,-0.57031 2.07494,-2.10174 4.15265,-4.19996 6.23828,-6.29102 l 0.0996,-0.0215 c 0.49555,-0.47432 1.00698,-0.95347 1.54492,-1.43164 20.4,-19.46667 26.1336,-24.66771 36.93359,-33.73438 14.66674,-12.26666 29.86667,-23.86679 44,-33.46679 12.45926,-8.37594 29.80631,-19.02467 37.66993,-23.22461 v -0.0117 c 1.43206,-0.819035 2.88932,-1.638452 4.33789,-2.458985 -2.72925,-1.589463 -5.45825,-3.138602 -8.1875,-4.681641 z m 278.04492,17.177736 c -0.26667,0 2.13398,3.46627 5.33398,7.59961 14.26667,19.06666 23.60065,36.93359 31.33399,60.93359 5.73333,17.46667 10.00013,36.39948 11.46679,50.13281 0.53341,4.8 1.19961,9.86732 1.59961,11.33399 0.83722,4.30564 1.24296,42.08951 0.64454,49.84765 -0.21974,5.30507 -0.52409,10.52731 -1.04102,15.53516 l -0.27148,5.41602 c -0.4,7.33333 -3.33158,29.60182 -4.93165,38.53515 -1.19999,6.26667 -6.00078,29.06667 -6.80078,32 -0.4,1.46667 -0.93398,4.13334 -1.33398,6 -2.42544,13.14845 -20.8264,68.46879 -27.42383,82.87891 -3.26524,7.68824 -7.75882,17.86776 -15.0293,33.67773 l 0.0547,0.24219 -5.20117,11.20117 c -6.4,13.86667 -23.7332,45.33308 -32.5332,59.06641 l -4.63086,7.33203 c -2.90596,5.15581 -6.083,10.31099 -9.63867,15.4668 h 0.13671 l -13.46679,18.80078 c -12,16.53333 -37.73295,49.73398 -41.59961,53.33398 -0.66667,0.66667 -6.66732,7.19987 -13.33399,14.53321 -31.73333,35.06666 -75.06581,73.33177 -109.19922,96.39843 -23.86666,16 -61.86692,36.13386 -82.93359,43.86719 -4.07969,1.48854 -6.48438,2.35268 -8.20703,2.69531 -6.10915,2.03813 -12.28484,3.95474 -18.50195,5.79493 -2.04882,1.01109 -6.56573,2.48105 -12.35743,3.91015 -29.73333,7.2 -65.33463,9.73334 -88.66796,6 -58,-9.06666 -99.73197,-41.06719 -125.33204,-95.86719 -15.99999,-34.13333 -23.86718,-72.53333 -23.86718,-116 0,-15.06666 1.59987,-44.93294 2.5332,-47.5996 0.26667,-0.93341 0.79922,-4.8004 1.19922,-8.4004 0.83493,-10.49628 2.86683,-22.24945 7.67187,-44.44726 l -0.0664,-0.22461 c 0.4632,-2.76999 1.35199,-6.74021 2.49414,-11.35156 -2.96379,-10.36675 -5.99711,-21.20037 -9.24024,-33.38282 -0.90228,3.54244 -1.80908,7.19474 -2.73632,11.11915 -0.20616,0.93255 -0.4243,1.87466 -0.65625,2.82031 -0.2606,1.05105 -0.53909,2.28162 -0.81055,3.43164 -0.80968,3.54089 -1.63602,7.22037 -2.49805,11.15429 -3.24008,15.27332 -6.46873,33.08019 -7.35742,40.88086 -0.53333,4.4 -1.20013,9.46732 -1.4668,11.33399 -1.33333,8.26667 -2.26562,30.26667 -2.26562,48 0.53333,123.06666 61.99909,212.53268 159.73242,232.66601 24.4,4.93334 55.73333,5.46732 86,1.33399 4.48034,-0.68179 18.86667,-3.6205 26.7793,-5.42578 0.47986,-0.10877 0.96482,-0.21861 1.45898,-0.33399 2.12102,-0.49832 3.65783,-0.89307 3.89453,-1.04101 0.0677,-0.0339 0.20507,-0.032 0.39844,0 6.90527,-1.72975 14.23865,-3.82089 18.91602,-5.47461 l 1.53515,-0.57617 c 0.37588,-0.14497 0.81305,-0.30123 1.13086,-0.43555 l 0.01,0.008 10.81054,-4.05469 c 75.6,-28.13333 152.80053,-85.73268 217.86719,-162.66601 7.41324,-8.82529 16.93446,-21.03912 25.81836,-32.98633 l 0.0293,-0.0586 c 0.0293,-0.0325 0.068,-0.0822 0.0977,-0.11524 7.84459,-10.55474 15.18842,-20.89049 20.05469,-28.43945 3.07258,-4.77431 4.85486,-7.71773 6.71289,-9.63867 3.58519,-5.56372 7.05011,-11.03842 10.01758,-15.9043 -0.19346,-0.67115 0.36036,-1.78922 1.53516,-3.52344 1.06666,-1.46666 4.66758,-8.13463 8.26757,-14.66797 3.46674,-6.66666 6.66641,-12.53203 7.06641,-13.33203 0.1125,-0.1875 0.22901,-0.29062 0.34766,-0.31054 0.0723,-0.0121 0.14469,0.007 0.21875,0.0547 5.55193,-10.58299 11.95716,-23.10211 16.9414,-34.4414 1.08592,-3.35296 2.85755,-7.72733 5.5293,-13.94922 0.007,-0.0195 0.015,-0.0411 0.0215,-0.0606 l 0.006,-0.004 c 0.35914,-0.83612 0.67469,-1.58177 1.06836,-2.49024 18.26667,-42.53333 34.93295,-100.2668 39.59961,-137.4668 0.53334,-4.8 1.06784,-8.93203 1.20117,-9.33203 0.44171,-1.54577 1.23377,-9.48576 1.93555,-18.04883 0.71248,-10.22065 1.50365,-19.70374 1.33399,-38.30468 l 0.002,-0.002 -0.0723,-6.17968 c 0,-11.06667 -0.13385,-13.59818 -1.86718,-29.46485 -2.13334,-20.13333 -4.66524,-33.20156 -9.86524,-51.60156 -10.13333,-34.93333 -24.53476,-62.40013 -46.13476,-87.4668 -4.93334,-5.6 -9.0668,-10.26562 -9.4668,-10.26562 z m -410.67383,98.42187 c -7.26368,0.0273 -14.52734,0.22551 -21.79101,0.55664 -0.071,0.0782 -0.13164,0.14191 -0.20313,0.22071 h 0.26953 l -7.06836,7.33398 c -3.86666,4 -7.33242,7.73281 -7.73242,8.13281 -0.4,0.4 -5.4668,6.40066 -11.4668,13.33399 -33.06666,39.06666 -62.93281,83.8668 -86.13281,129.4668 -11.46667,22.4 -12.26706,24.13242 -24.40039,53.73242 l -4.81836,11.73047 c -0.84819,2.11489 -1.63865,4.14466 -2.42383,6.17187 2.51125,10.06009 5.18095,20.54097 8.35157,32.35938 1.07555,-3.17445 2.096,-6.0819 2.95898,-8.29493 l 0.0996,-0.16601 c 2.19307,-6.82503 5.91519,-16.77945 11.56445,-31 23.86667,-60.26667 65.06745,-130.80013 104.80078,-179.4668 3.46667,-4 8.26745,-9.99922 10.80078,-13.19922 2.53341,-3.2 5.33334,-6.40117 6,-7.20117 0.80007,-0.8 5.86537,-6.53268 11.33204,-12.66601 l 6.27929,-7.03321 L 307,212.95898 c 0.5539,-0.6121 1.12291,-1.20912 1.68164,-1.8164 z"
+             style="fill:#ff0031;fill-opacity:1;stroke-width:0.13333333" />
+        </g>
+      </g>
+    </g>
+    <g
+       aria-label="VirES "
+       transform="matrix(0.26458333,0,0,0.26458333,-16.630952,69.991071)"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:192px;line-height:1.25;font-family:'Latin Modern Mono Light';-inkscape-font-specification:'Latin Modern Mono Light, ';letter-spacing:0px;word-spacing:0px;fill:#4d4d4d;fill-opacity:1;stroke:none"
+       id="flowRoot852">
+      <g
+         id="g829"
+         transform="matrix(0.96305779,0,0,0.96305779,19.140689,-6.6331249)">
+        <path
+           id="path966"
+           d="m 621.43676,367.97602 c 0,-4.032 -4.032,-4.032 -6.144,-4.032 h -20.352 c -2.112,0 -6.144,0 -6.144,4.032 0,4.032 3.648,4.032 11.712,4.032 l -24.768,102.72 -1.344,0.192 -24.96,-102.912 c 8.064,0 11.712,0 11.712,-4.032 0,-4.032 -4.032,-4.032 -6.144,-4.032 h -20.352 c -2.112,0 -6.144,0 -6.144,4.032 0,4.032 3.648,4.032 10.944,4.032 l 26.496,104.832 c 1.536,5.952 4.224,5.952 9.024,5.952 4.416,0 7.488,0 9.024,-5.76 l 26.496,-105.024 c 7.296,0 10.944,0 10.944,-4.032 z"
+           inkscape:connector-curvature="0"
+           style="fill:#e84a4a;fill-opacity:1" />
+        <path
+           id="path968"
+           d="m 712.13576,477.22402 c 0,-4.032 -4.032,-4.032 -6.144,-4.032 h -22.848 v -67.392 c 0,-4.608 -0.768,-6.144 -5.952,-6.144 h -28.224 c -2.112,0 -6.144,0 -6.144,4.032 0,4.032 4.032,4.032 6.144,4.032 h 24.576 v 65.472 h -26.112 c -2.304,0 -6.144,0 -6.144,4.032 0,4.032 4.032,4.032 6.144,4.032 h 58.56 c 2.112,0 6.144,0 6.144,-4.032 z m -28.224,-104.064 c 0,-4.608 -3.456,-8.064 -7.872,-8.064 -4.416,0 -7.872,3.456 -7.872,8.064 0,4.416 3.456,7.872 7.872,7.872 4.416,0 7.872,-3.456 7.872,-7.872 z"
+           inkscape:connector-curvature="0"
+           style="fill:#999999;fill-opacity:1" />
+        <path
+           id="path970"
+           d="m 819.34676,408.87202 c 0,-3.648 -2.304,-10.368 -16.896,-10.368 -9.6,0 -21.696,3.456 -35.712,19.392 v -12.096 c 0,-4.608 -0.768,-6.144 -5.952,-6.144 h -21.696 c -2.304,0 -5.952,0 -5.952,4.032 0,4.032 3.648,4.032 5.952,4.032 h 18.048 v 65.472 h -18.048 c -2.304,0 -5.952,0 -5.952,3.84 0,4.224 3.648,4.224 5.952,4.224 h 51.648 c 2.304,0 6.144,0 6.144,-4.032 0,-4.032 -3.84,-4.032 -6.144,-4.032 h -24 v -26.88 c 0,-19.584 12.48,-39.744 39.744,-39.744 0,5.568 2.688,8.832 6.528,8.832 3.456,0 6.336,-2.496 6.336,-6.528 z"
+           inkscape:connector-curvature="0"
+           style="fill:#e84a4a;fill-opacity:1" />
+        <path
+           id="path972"
+           d="m 923.29376,475.11202 v -17.664 c 0,-2.88 0,-6.144 -4.8,-6.144 -4.992,0 -4.992,3.264 -4.992,6.144 v 15.744 h -57.024 v -48.768 h 30.144 c 0,8.448 0,11.328 4.8,11.328 4.8,0 4.8,-3.264 4.8,-6.144 v -18.432 c 0,-2.688 0,-6.144 -4.8,-6.144 -4.8,0 -4.8,2.88 -4.8,11.328 h -30.144 v -44.352 h 52.608 v 12.672 c 0,2.688 0,6.144 4.8,6.144 4.992,0 4.992,-3.264 4.992,-6.144 v -14.592 c 0,-4.608 -0.96,-6.144 -5.952,-6.144 h -74.112 c -2.112,0 -6.144,0 -6.144,4.032 0,4.032 4.032,4.032 6.144,4.032 h 8.064 v 101.184 h -8.064 c -2.304,0 -6.144,0 -6.144,4.032 0,4.032 4.032,4.032 6.144,4.032 h 78.528 c 4.8,0 5.952,-1.344 5.952,-6.144 z"
+           inkscape:connector-curvature="0"
+           style="fill:#e84a4a;fill-opacity:1" />
+        <path
+           id="path974"
+           d="m 1018.2167,450.34402 c 0,-11.904 -6.72,-19.776 -9.024,-22.272 -7.8719,-7.68 -13.05594,-8.832 -28.03194,-12.288 l -16.128,-3.648 c -9.216,-2.688 -17.28,-10.368 -17.28,-20.544 0,-11.136 10.368,-21.696 25.728,-21.696 24.384,0 28.22404,19.776 29.75994,27.456 0.576,2.304 2.112,2.88 4.608,2.88 4.992,0 4.992,-3.264 4.992,-6.144 v -26.112 c 0,-2.304 0,-6.144 -4.032,-6.144 -3.264,0 -4.032,3.072 -6.144,10.752 -10.17594,-8.64 -20.35194,-10.752 -28.99194,-10.752 -20.736,0 -34.944,14.592 -34.944,30.528 0,12.48 8.64,24.768 24.192,29.184 l 22.656,5.376 c 6.144,1.344 23.61594,5.76 23.61594,24.384 0,11.136 -9.21592,24 -26.11194,24 -5.952,0 -16.128,-0.96 -24.384,-6.528 -9.024,-5.76 -9.984,-14.784 -10.176,-18.816 -0.192,-2.304 -0.384,-4.992 -4.8,-4.992 -4.992,0 -4.992,3.264 -4.992,6.144 v 26.112 c 0,2.304 0,6.144 4.032,6.144 3.264,0 4.032,-2.496 6.144,-10.368 9.984,7.488 21.696,10.368 33.984,10.368 21.69594,0 35.32794,-16.32 35.32794,-33.024 z"
+           inkscape:connector-curvature="0"
+           style="fill:#999999;fill-opacity:1" />
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/docs/index.rst b/docs/index.rst
index dd2d35f..186063e 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,22 +1,22 @@
-Welcome to viresclient's documentation!
-===============================================
+Introduction
+============
 
-Get started `at the introduction <readme.html>`_
+.. include:: ../README.rst
 
 .. toctree::
   :caption: Virtual Research Environments
 
-  VirES for Swarm <https://vires.services>
-  Swarm Notebooks <https://notebooks.vires.services>
-  VirES for Aeolus <https://aeolus.services>
-  Aeolus Notebooks <https://notebooks.aeolus.services>
+  🔗 VirES for Swarm <https://vires.services>
+  🔗 Swarm Notebooks <https://notebooks.vires.services>
+  🔗 VirES for Aeolus <https://aeolus.services>
+  🔗 Aeolus Notebooks <https://notebooks.aeolus.services>
 
 
 .. toctree::
   :maxdepth: 2
   :caption: Information on viresclient
 
-  readme
+  self
   installation
   config_details
   access_token
diff --git a/docs/readme.rst b/docs/readme.rst
deleted file mode 100644
index 2b9a587..0000000
--- a/docs/readme.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-Introduction
-============
-
-.. include:: ../README.rst
diff --git a/pyproject.toml b/pyproject.toml
index 3aee07b..75bb3f7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -56,7 +56,7 @@ dev = [
 ]
 docs = [
     "Sphinx == 4.5.0",
-    "sphinx-book-theme == 0.2.0",
+    "sphinx_rtd_theme == 1.0.0",
     "sphinx_copybutton == 0.5.0",
 ]