From e942d513001b6fec22d53493daeee4a6363d5564 Mon Sep 17 00:00:00 2001
From: Carl-Erik Kopseng <carlerik@gmail.com>
Date: Fri, 12 Oct 2018 02:36:02 +0200
Subject: [PATCH] Add banner that points to latest version

closes #1923

Only displays on doc pages for non-recent versions
---
 docs/_includes/banner.html | 10 ++++++++++
 docs/_includes/head.html   |  8 +++++++-
 docs/_layouts/default.html |  2 ++
 docs/_layouts/page.html    | 12 ++++++------
 docs/assets/css/main.scss  |  4 ++++
 5 files changed, 29 insertions(+), 7 deletions(-)
 create mode 100644 docs/_includes/banner.html

diff --git a/docs/_includes/banner.html b/docs/_includes/banner.html
new file mode 100644
index 000000000..6b64d73f7
--- /dev/null
+++ b/docs/_includes/banner.html
@@ -0,0 +1,10 @@
+<div class="bg-info hidden" id="banner-message">
+    These docs are from an older version of sinon.
+    Do you want the <a href="/releases/latest/">latest</a> docs?
+</div>
+
+<script>
+    if (site.showBanner) {
+        document.getElementById("banner-message").classList.remove("hidden");
+    }
+</script>
diff --git a/docs/_includes/head.html b/docs/_includes/head.html
index 7a6c3a62a..3617bad7a 100644
--- a/docs/_includes/head.html
+++ b/docs/_includes/head.html
@@ -6,6 +6,9 @@
     <meta name="description" content="{% if page.excerpt %}{{ page.excerpt | strip_html | strip_newlines | truncate: 160 }}{% else %}{{ site.description }}{% endif %}" />
     <link rel="stylesheet" href="{{ "/assets/css/main.css" | prepend: site.baseurl }}">
     <link rel="shortcut icon" href="{{ "/assets/images/favicon.png" | prepend: site.baseurl }}">
+    <script>
+        var site = {}; // site settings
+    </script>
 
     {% comment %}
     To make all documentation pages, regardless of version, lead search traffic to the latest version,
@@ -14,8 +17,11 @@
 
     {% assign url_parts = page.url | split: "/" %}
 
-    {%if page.url contains "/releases/v" %}
+    {%if page.url contains "/releases/v" and url_parts[2] != "latest" and url_parts[2] != {site.sinon.current_release} %}
         {% assign canonical_page_url = "/releases/latest/" | append: url_parts[3] %}
+        <script>
+            site.showBanner = true; // cannot dynamically create a globally available Liquid variable
+        </script>
     {% else %}
         {% assign canonical_page_url = page.url | replace:'index.html','' %}
     {% endif %}
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html
index 68c748c6d..54a06d5fe 100644
--- a/docs/_layouts/default.html
+++ b/docs/_layouts/default.html
@@ -6,6 +6,8 @@
 
   <div class="content">
     <div class="container container-2">
+      {% include banner.html %}
+
       {{ content }}
     </div>
   </div>
diff --git a/docs/_layouts/page.html b/docs/_layouts/page.html
index ce233ad75..9655bad55 100644
--- a/docs/_layouts/page.html
+++ b/docs/_layouts/page.html
@@ -3,12 +3,12 @@
 ---
 <article class="post">
 
-  <header class="post-header">
-    <h1 class="post-title">{{ page.title }}</h1>
-  </header>
+    <header class="post-header">
+        <h1 class="post-title">{{ page.title }}</h1>
+    </header>
 
-  <div class="post-content">
-    {{ content }}
-  </div>
+    <div class="post-content">
+        {{ content }}
+    </div>
 
 </article>
diff --git a/docs/assets/css/main.scss b/docs/assets/css/main.scss
index 209b2150f..3c9306d78 100644
--- a/docs/assets/css/main.scss
+++ b/docs/assets/css/main.scss
@@ -18,6 +18,10 @@ body {
   background: #fff;
 }
 
+.hidden {
+    display: none;
+}
+
 .navbar {
   background: #fff;
   margin-top: 10px;