From e629c9ccc4036dead932109c33391987d8bf49d6 Mon Sep 17 00:00:00 2001
From: Martin Fischer <martin@push-f.com>
Date: Mon, 31 Jan 2022 18:07:48 +0100
Subject: [PATCH] [docs] link instance-specific pages via searx.space

Fixes #659.
---
 docs/conf.py             |  2 +-
 docs/go-to-instance.html | 21 +++++++++++++++++++++
 docs/go-to-instance.rst  | 13 ++++++++++---
 3 files changed, 32 insertions(+), 4 deletions(-)
 create mode 100644 docs/go-to-instance.html

diff --git a/docs/conf.py b/docs/conf.py
index 15af14042..9da80cf02 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -69,7 +69,7 @@ jinja_filters = {
 
 def process_link(href):
     if href.startswith('/'):
-        return '../go-to-instance.html'
+        return '../go-to-instance.html#' + href
     else:
         return href
 
diff --git a/docs/go-to-instance.html b/docs/go-to-instance.html
new file mode 100644
index 000000000..0944626ab
--- /dev/null
+++ b/docs/go-to-instance.html
@@ -0,0 +1,21 @@
+<noscript>This requires JavaScript.</noscript>
+<ul id=links></ul>
+<script>
+(async function() {
+    const links = document.getElementById('links');
+    let res = await fetch('https://searx.space/data/instances.json');
+    let instances = await res.json();
+    for (const [url, info] of Object.entries(instances.instances)) {
+        if (info.error)
+            continue;
+        if (url.startsWith('https://')) {
+            const li = document.createElement('li');
+            const a = document.createElement('a');
+            a.href = url + location.hash.substr(2);
+            a.textContent = url + location.hash.substr(2);
+            li.appendChild(a);
+            links.appendChild(li);
+        }
+    }
+})();
+</script>
diff --git a/docs/go-to-instance.rst b/docs/go-to-instance.rst
index 1b6c818d9..ee2bfd971 100644
--- a/docs/go-to-instance.rst
+++ b/docs/go-to-instance.rst
@@ -1,7 +1,14 @@
 :orphan:
 
-=======================
-We cannot link there :(
-=======================
+=================
+Go to instance...
+=================
 
+The link you followed depends on the instance.
 We don't know which instance you're using.
+
+For your convenience the instances from
+`searx.space <https://searx.space/>`_ are linked below:
+
+.. raw:: html
+   :file: go-to-instance.html