datalad-handbook · mih · Jun 2, 2020 · Jun 2, 2020 · Jun 2, 2020 · Jun 2, 2020
diff --git a/docs/_static/custom.css b/docs/_static/custom.css
@@ -94,3 +94,11 @@ progress::-webkit-progress-value {
 progress::-webkit-progress-bar {
   background: #ffa200;
 }
+
+.redirect {
+  font-family: monospace, monospace;
+}
+
+.redirect::before {
+  content: "↷ "
+}
diff --git a/docs/artwork b/docs/artwork
diff --git a/docs/index.rst b/docs/index.rst
@@ -92,7 +92,6 @@ Appendix
    teaching
    acknowledgements
    intro/user_types
-   r
 
 ########################
 Code lists from chapters
@@ -116,3 +115,4 @@ Code lists from chapters
        :hidden:
 
        usecases/datasets
+       r
diff --git a/docs/r.rst b/docs/r.rst
@@ -1,24 +1,71 @@
 Redirection
 -----------
 
+This page exists for redirection purposes only.
 
-.. raw:: HTML
-
-   <html>
-     <head>
-        <p id="demo"></p>
-
-        <script>
-        let redirects = new Map([
-            ['demo', 'url1'],
-            ['GIN', 'basics/101-139-gin.html']
-        ]);
-        redirect = redirects.get(window.location.href.replace(/.*\?/, ""));
-        if (redirect == undefined) {
-          document.getElementById("demo").innerHTML = "no idea"
-        } else {
-          window.location.replace(window.location.href.replace(/r.html\?.*/, redirect))
-        }
-        </script>
-     </head>
-   </html>
+..
+   Include a named paragraph in the page, where the javascript code below will
+   place any message.
+
+.. raw:: html
+
+   <p><strong id="successmessage">
+     You will be redirected to your target page in a few seconds.
+   </strong></p>
+
+.. figure:: artwork/src/redirection.svg
+
+..
+   use a custom role to identify redirect codes so that a bit of JS can find
+   them again
+
+.. role:: redirect
+   :class: redirect
+
+If you continue to see this page, you've ended up in here accidentally and redirection
+failed -- sorry about this.
+
+**Here are some links that may take you to where you need to go:**
+
+..
+   This defines a mapping of redirect codes to their present URLs
+
+:redirect:`GIN`
+  :ref:`gin`
+:redirect:`HCP-dataset`
+  :ref:`usecase_HCP_dataset`
+:redirect:`reproducible-paper`
+  :ref:`usecase_reproducible_paper`
+
+Alternatively, try searching in the "Quick Search" at the left-hand side, or
+scan the handbook's front page at `handbook.datalad.org <http://handbook.datalad.org/en/latest/>`_
+for directions.
+
+..
+   This code replaces the r.html?key part with the final URL, while keeping
+   the rest of URL intact.
+
+.. raw:: html
+
+   <script>
+   // take everything after "?" as a code to identify the redirect
+   redirect_code = window.location.href.replace(/.*\?/, "");
+   success = false;
+   // loop over all redirect definitions (see above)
+   for (rd of document.getElementsByClassName('redirect')){
+     if (rd.innerText != redirect_code) {continue;}
+     // read the href from the link in the <dd> matching the <dt> of the redirect
+     // this assumes a very simple, and particular structure
+     // let's hope that sphinx doesn't break it
+     target = rd.parentElement.nextElementSibling.getElementsByTagName("a")[0].href;
+     // and jump
+     window.location.replace(target);
+     success = true;
+     break;
+   }
+   // if we get here, we didn't find a match
+   if (success == false) {
+     document.getElementById("successmessage"
+       ).innerHTML = "Whoops - redirection went wrong, we are lost!"
+   }
+   </script>