From b4e818d16d24ba2be68bb8060412ffa644692c44 Mon Sep 17 00:00:00 2001
From: leonarduschen <leonardus.chen@gmail.com>
Date: Tue, 8 Sep 2020 16:14:47 +0800
Subject: [PATCH 1/9] Change logo href back to index

---
 pydata_sphinx_theme/docs-navbar.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pydata_sphinx_theme/docs-navbar.html b/pydata_sphinx_theme/docs-navbar.html
index 69d4f7967..5fdb74cba 100644
--- a/pydata_sphinx_theme/docs-navbar.html
+++ b/pydata_sphinx_theme/docs-navbar.html
@@ -2,7 +2,7 @@
 <div class="container-xl">
 
     {% if logo %}
-    <a class="navbar-brand" href="{{ pathto(master_doc) }}">
+    <a class="navbar-brand" href="{{ pathto('index') }}">
       <img src="{{ pathto('_static/' + logo, 1) }}" class="logo" alt="logo">
     </a>
     {% endif %}

From eacf0b17a076f8f7deb0f94eb934b61564f6cb72 Mon Sep 17 00:00:00 2001
From: leonarduschen <leonardus.chen@gmail.com>
Date: Sat, 12 Sep 2020 12:43:48 +0800
Subject: [PATCH 2/9] Add logo_doc theme option

---
 pydata_sphinx_theme/docs-navbar.html | 13 ++++++++++---
 pydata_sphinx_theme/theme.conf       |  1 +
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/pydata_sphinx_theme/docs-navbar.html b/pydata_sphinx_theme/docs-navbar.html
index 5fdb74cba..b98035c92 100644
--- a/pydata_sphinx_theme/docs-navbar.html
+++ b/pydata_sphinx_theme/docs-navbar.html
@@ -1,10 +1,17 @@
 
 <div class="container-xl">
 
+
     {% if logo %}
-    <a class="navbar-brand" href="{{ pathto('index') }}">
-      <img src="{{ pathto('_static/' + logo, 1) }}" class="logo" alt="logo">
-    </a>
+      {% if theme_logo_doc %}
+      <a class="navbar-brand" href="{{ pathto(theme_logo_doc) }}">
+        <img src="{{ pathto('_static/' + logo, 1) }}" class="logo" alt="logo">
+      </a>
+      {% else %}
+      <a class="navbar-brand" href="{{ pathto(master_doc) }}">
+        <img src="{{ pathto('_static/' + logo, 1) }}" class="logo" alt="logo">
+      </a>
+      {% endif %}
     {% endif %}
     <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbar-menu" aria-controls="navbar-menu" aria-expanded="false" aria-label="Toggle navigation">
         <span class="navbar-toggler-icon"></span>
diff --git a/pydata_sphinx_theme/theme.conf b/pydata_sphinx_theme/theme.conf
index 862752282..ae0675375 100644
--- a/pydata_sphinx_theme/theme.conf
+++ b/pydata_sphinx_theme/theme.conf
@@ -9,6 +9,7 @@ use_edit_page_button = False
 external_links =
 github_url =
 twitter_url =
+logo_doc =
 google_analytics_id =
 show_prev_next = True
 search_bar_text = Search the docs ...

From f44864b7df5a4e1ca01dcf24f40c48f983f17ff5 Mon Sep 17 00:00:00 2001
From: leonarduschen <leonardus.chen@gmail.com>
Date: Sun, 13 Sep 2020 03:51:15 +0800
Subject: [PATCH 3/9] Check if link is url

---
 pydata_sphinx_theme/docs-navbar.html | 12 ++++++++----
 pydata_sphinx_theme/theme.conf       |  2 +-
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/pydata_sphinx_theme/docs-navbar.html b/pydata_sphinx_theme/docs-navbar.html
index b98035c92..204b0ea43 100644
--- a/pydata_sphinx_theme/docs-navbar.html
+++ b/pydata_sphinx_theme/docs-navbar.html
@@ -3,14 +3,18 @@
 
 
     {% if logo %}
-      {% if theme_logo_doc %}
-      <a class="navbar-brand" href="{{ pathto(theme_logo_doc) }}">
+      {% if not theme_logo_link %}
+      <a class="navbar-brand" href="{{ pathto(master_doc) }}">
         <img src="{{ pathto('_static/' + logo, 1) }}" class="logo" alt="logo">
       </a>
-      {% else %}
-      <a class="navbar-brand" href="{{ pathto(master_doc) }}">
+      {% elif theme_logo_link[:4] == 'http' %}
+      <a class="navbar-brand" href="{{ theme_logo_link }}">
         <img src="{{ pathto('_static/' + logo, 1) }}" class="logo" alt="logo">
       </a>
+      {% else %}
+      <a class="navbar-brand" href="{{ pathto(theme_logo_link) }}">
+        <img src="{{ pathto('_static/' + logo, 1) }}" class="logo" alt="logo">
+      </a>      
       {% endif %}
     {% endif %}
     <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbar-menu" aria-controls="navbar-menu" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/pydata_sphinx_theme/theme.conf b/pydata_sphinx_theme/theme.conf
index ae0675375..4639233ce 100644
--- a/pydata_sphinx_theme/theme.conf
+++ b/pydata_sphinx_theme/theme.conf
@@ -7,9 +7,9 @@ sidebarwidth = 270
 sidebar_includehidden = True
 use_edit_page_button = False
 external_links =
+logo_link =
 github_url =
 twitter_url =
-logo_doc =
 google_analytics_id =
 show_prev_next = True
 search_bar_text = Search the docs ...

From c596803aafda620f0fe90658a2745f56c97a5b63 Mon Sep 17 00:00:00 2001
From: leonarduschen <leonardus.chen@gmail.com>
Date: Sun, 25 Oct 2020 12:54:01 +0800
Subject: [PATCH 4/9] Add configuring documentation

---
 docs/user_guide/configuring.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index 3dbfa121b..50967a747 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -19,6 +19,15 @@ doc path's _static folder, and use the following configuration:
 
    html_logo = "_static/logo.png"
 
+The logo links to `master_doc` by default. If you'd like to link to other page
+or use an external link instead, use the following configuration:
+
+.. code:: python
+
+   html_theme_options = {
+      "logo_link": "<other page or external link>"
+
+
 Configure social media buttons
 ==============================
 

From e1e9298a2e8c028f053ade2166f6ec83b05a1a10 Mon Sep 17 00:00:00 2001
From: leonarduschen <leonardus.chen@gmail.com>
Date: Sun, 25 Oct 2020 13:00:20 +0800
Subject: [PATCH 5/9] Fix typo causing tests to fail

---
 pydata_sphinx_theme/docs-navbar.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pydata_sphinx_theme/docs-navbar.html b/pydata_sphinx_theme/docs-navbar.html
index bc5c2623c..0f163a6e7 100644
--- a/pydata_sphinx_theme/docs-navbar.html
+++ b/pydata_sphinx_theme/docs-navbar.html
@@ -17,11 +17,11 @@
       </a>      
       {% endif %}
     {% else %}
-    <a class="navbar-brand" href="{{ pathto(master_doc) }}"></a>
+    <a class="navbar-brand" href="{{ pathto(master_doc) }}">
       <p class="title">{{ project }}</p>
     </a>
     {% endif %}
-    
+
     <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbar-menu" aria-controls="navbar-menu" aria-expanded="false" aria-label="Toggle navigation">
         <span class="navbar-toggler-icon"></span>
     </button>

From 4bf7559b6d249a1d2b570ed4de6579bb93de6c31 Mon Sep 17 00:00:00 2001
From: Leonardus Chen <leonardus.chen@gmail.com>
Date: Sun, 25 Oct 2020 13:21:58 +0800
Subject: [PATCH 6/9] Fixed typo in configuring.rst

---
 docs/user_guide/configuring.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index 50967a747..7b5efd653 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -19,7 +19,7 @@ doc path's _static folder, and use the following configuration:
 
    html_logo = "_static/logo.png"
 
-The logo links to `master_doc` by default. If you'd like to link to other page
+The logo links to ``master_doc`` by default. If you'd like to link to other page
 or use an external link instead, use the following configuration:
 
 .. code:: python

From d8b57b8851cc950363637f287463f4b0b12fc715 Mon Sep 17 00:00:00 2001
From: Leonardus Chen <leonardus.chen@gmail.com>
Date: Sun, 25 Oct 2020 22:09:14 +0800
Subject: [PATCH 7/9] Fix grammatical error in configuring.rst

---
 docs/user_guide/configuring.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index 7b5efd653..e8070b4db 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -19,7 +19,7 @@ doc path's _static folder, and use the following configuration:
 
    html_logo = "_static/logo.png"
 
-The logo links to ``master_doc`` by default. If you'd like to link to other page
+The logo links to ``master_doc`` by default. If you'd like it to link to another page
 or use an external link instead, use the following configuration:
 
 .. code:: python

From e7d3dde6024fc6656f49b2e139f2417742fb1f3b Mon Sep 17 00:00:00 2001
From: Leonardus Chen <leonardus.chen@gmail.com>
Date: Sun, 25 Oct 2020 22:35:26 +0800
Subject: [PATCH 8/9] Update configuring.rst again

Add a description of what ``master_doc`` is
---
 docs/user_guide/configuring.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index e8070b4db..f9fd0196d 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -19,8 +19,8 @@ doc path's _static folder, and use the following configuration:
 
    html_logo = "_static/logo.png"
 
-The logo links to ``master_doc`` by default. If you'd like it to link to another page
-or use an external link instead, use the following configuration:
+The logo links to ``master_doc`` (usually the first page of your documentation) by default. 
+If you'd like it to link to another page or use an external link instead, use the following configuration:
 
 .. code:: python
 

From a3836e8c30925a821642aec4f7e9070c2a51459b Mon Sep 17 00:00:00 2001
From: Joris Van den Bossche <jorisvandenbossche@gmail.com>
Date: Mon, 28 Dec 2020 22:11:10 +0100
Subject: [PATCH 9/9] Update docs/user_guide/configuring.rst

---
 docs/user_guide/configuring.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/user_guide/configuring.rst b/docs/user_guide/configuring.rst
index f9fd0196d..bacef23d2 100644
--- a/docs/user_guide/configuring.rst
+++ b/docs/user_guide/configuring.rst
@@ -25,7 +25,8 @@ If you'd like it to link to another page or use an external link instead, use th
 .. code:: python
 
    html_theme_options = {
-      "logo_link": "<other page or external link>"
+       "logo_link": "<other page or external link>"
+   }
 
 
 Configure social media buttons