From 130d259cb1bcb7959a669220c4b9965e9a6c97f8 Mon Sep 17 00:00:00 2001
From: Simon Michael <simon@joyful.com>
Date: Sat, 16 Apr 2016 04:44:33 -0700
Subject: [PATCH] site: show version links on manuals

---
 doc/lib.m4                                |  7 +++++++
 hledger-api/doc/hledger-api.1.m4.md       |  2 ++
 hledger-lib/doc/hledger_csv.5.m4.md       |  2 ++
 hledger-lib/doc/hledger_journal.5.m4.md   |  2 ++
 hledger-lib/doc/hledger_timeclock.5.m4.md |  2 ++
 hledger-lib/doc/hledger_timedot.5.m4.md   |  2 ++
 hledger-ui/doc/hledger-ui.1.m4.md         |  2 ++
 hledger-web/doc/hledger-web.1.m4.md       |  2 ++
 hledger/doc/hledger.1.m4.md               |  2 ++
 site/css/style.css                        |  7 ++++++-
 site/js/site.js                           | 19 +++++++++++++++++++
 site/site.tmpl                            |  1 +
 12 files changed, 49 insertions(+), 1 deletion(-)
 create mode 100644 site/js/site.js

diff --git a/doc/lib.m4 b/doc/lib.m4
index 2c20e86b4..db185e7f3 100644
--- a/doc/lib.m4
+++ b/doc/lib.m4
@@ -20,3 +20,10 @@ m4_define({{_col3_}},
 m4_define({{_shell_}}, {{```{.shell .clear}$1```}})m4_dnl
 m4_define({{_shellbold_}}, {{```{.shell .bold .clear}$1```}})m4_dnl
 m4_define({{_journal_}}, {{```{.journal .clear}$1```}})m4_dnl
+m4_define({{_currentrelease_}}, {{0.27}})m4_dnl
+m4_define({{_versions_}},
+{{<div class="versions">
+version:
+<a href="$1.html">dev</a>
+| <a href="_currentrelease_()/$1.html">_currentrelease_()</a>
+</div>}})m4_dnl
diff --git a/hledger-api/doc/hledger-api.1.m4.md b/hledger-api/doc/hledger-api.1.m4.md
index 97429c9aa..609008ac5 100644
--- a/hledger-api/doc/hledger-api.1.m4.md
+++ b/hledger-api/doc/hledger-api.1.m4.md
@@ -3,6 +3,8 @@
 % January 2016
 
 <div class="web">
+_versions_({{hledger-api}})
+
 * toc
 </div>
 <div class="man">
diff --git a/hledger-lib/doc/hledger_csv.5.m4.md b/hledger-lib/doc/hledger_csv.5.m4.md
index 25b4f9292..09d2d3112 100644
--- a/hledger-lib/doc/hledger_csv.5.m4.md
+++ b/hledger-lib/doc/hledger_csv.5.m4.md
@@ -3,6 +3,8 @@
 % April 2016
 
 <div class="web">
+_versions_({{csv}})
+
 * toc
 </div>
 <div class="man">
diff --git a/hledger-lib/doc/hledger_journal.5.m4.md b/hledger-lib/doc/hledger_journal.5.m4.md
index 613c79fa5..be35b970e 100644
--- a/hledger-lib/doc/hledger_journal.5.m4.md
+++ b/hledger-lib/doc/hledger_journal.5.m4.md
@@ -3,6 +3,8 @@
 % April 2016
 
 <div class="web">
+_versions_({{journal}})
+
 * toc
 </div>
 <div class="man">
diff --git a/hledger-lib/doc/hledger_timeclock.5.m4.md b/hledger-lib/doc/hledger_timeclock.5.m4.md
index 4bda18317..f6f41d92f 100644
--- a/hledger-lib/doc/hledger_timeclock.5.m4.md
+++ b/hledger-lib/doc/hledger_timeclock.5.m4.md
@@ -3,6 +3,8 @@
 % April 2016
 
 <div class="web">
+_versions_({{timeclock}})
+
 * toc
 </div>
 <div class="man">
diff --git a/hledger-lib/doc/hledger_timedot.5.m4.md b/hledger-lib/doc/hledger_timedot.5.m4.md
index b8e890ccf..55e83d5a0 100644
--- a/hledger-lib/doc/hledger_timedot.5.m4.md
+++ b/hledger-lib/doc/hledger_timedot.5.m4.md
@@ -3,6 +3,8 @@
 % April 2016
 
 <div class="web">
+_versions_({{timedot}})
+
 * toc
 </div>
 <div class="man">
diff --git a/hledger-ui/doc/hledger-ui.1.m4.md b/hledger-ui/doc/hledger-ui.1.m4.md
index c930cb3af..23975e66b 100644
--- a/hledger-ui/doc/hledger-ui.1.m4.md
+++ b/hledger-ui/doc/hledger-ui.1.m4.md
@@ -3,6 +3,8 @@
 % October 2015
 
 <div class="web">
+_versions_({{hledger-ui}})
+
 * toc
 
 <style>
diff --git a/hledger-web/doc/hledger-web.1.m4.md b/hledger-web/doc/hledger-web.1.m4.md
index 705c2433d..1506966f8 100644
--- a/hledger-web/doc/hledger-web.1.m4.md
+++ b/hledger-web/doc/hledger-web.1.m4.md
@@ -3,6 +3,8 @@
 % October 2015
 
 <div class="web">
+_versions_({{hledger-web}})
+
 * toc
 </div>
 <div class="man">
diff --git a/hledger/doc/hledger.1.m4.md b/hledger/doc/hledger.1.m4.md
index 3d257446b..248f7b554 100644
--- a/hledger/doc/hledger.1.m4.md
+++ b/hledger/doc/hledger.1.m4.md
@@ -3,6 +3,8 @@
 % April 2016
 
 <div class="web">
+_versions_({{hledger}})
+
 * toc
 </div>
 <div class="man">
diff --git a/site/css/style.css b/site/css/style.css
index 57f77d8d9..8fbbe50cb 100644
--- a/site/css/style.css
+++ b/site/css/style.css
@@ -78,7 +78,8 @@ h4, h5, h6 {
 .navbar       { font-size:x-large;  }
 .navbar-brand { font-weight:bold; font-size:xx-large; }
 .navbar-nav   { margin-left:1em;  }
-/* table of contents styling */
+
+/* table of contents */
 /* based on https://github.com/blaenk/blaenk.github.io/blob/source/provider/scss/_article.scss */
 #toc {
 		max-width:40%;
@@ -146,6 +147,10 @@ h4, h5, h6 {
 
 /* */
 
+/* documentation version selector */
+#versions {
+}
+
 h2 {
 		margin-top:1.5em;
 }
diff --git a/site/js/site.js b/site/js/site.js
new file mode 100644
index 000000000..3b4e129ba
--- /dev/null
+++ b/site/js/site.js
@@ -0,0 +1,19 @@
+$(document).ready( function() {
+  highlightDocVersion();
+});
+
+function highlightDocVersion() {
+  $('.versions').each( function() {
+    var parts = window.location.pathname.split('/');
+    var dir = parts.length > 1 ? parts[parts.length-2] : '';
+    var ver = $.isNumeric(dir) ? dir : 'dev';
+    $(this).find('a').each( function() {
+      if ($(this).html() == ver)
+        $(this)
+        .removeAttr('href')
+        .css('text-decoration', 'none')
+        .css('color', 'initial')
+        // .css('font-weight','bold');
+    });
+  });
+}
diff --git a/site/site.tmpl b/site/site.tmpl
index 7b402f91e..d32064db7 100644
--- a/site/site.tmpl
+++ b/site/site.tmpl
@@ -12,6 +12,7 @@
         <link href="http://maxcdn.bootstrapcdn.com/bootswatch/3.3.0/readable/bootstrap.min.css" rel="stylesheet">
         <script src="http://code.jquery.com/jquery-1.11.0.min.js"></script>
         <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+        <script src="/js/site.js"></script>
         <script src="/js/highslide/highslide.js"></script>
         <script type="text/javascript">
             hs.graphicsDir = 'js/highslide/graphics/';