Add a versions dropdown to the html sidebar (elixir-lang#970)

Author: michallepicki

assets/js/app.js

@@ -25,6 +25,7 @@ import showSummary from './template-helpers/showSummary'
 
 import {initialize as initEvents} from './events'
 import {initialize as initSidebar} from './sidebar'
+import {initialize as initVersions} from './versions'
 import {initialize as initNightMode} from './night'
 import {initialize as initMakeup} from './makeup'
 
@@ -57,6 +58,7 @@ $(() => {
 
   initNightMode()
   initSidebar()
+  initVersions()
   initEvents()
   initMakeup()
   hljs.initHighlighting()

assets/js/templates/versions-dropdown.handlebars

@@ -0,0 +1,9 @@
+<form autocomplete="off">
+  <select class="sidebar-projectVersionsDropdown">
+    {{#each nodes}}
+      <option value="{{url}}"{{#if isCurrentVersion}} selected disabled{{/if}}>
+        {{version}}
+      </option>
+    {{/each}}
+  </select>
+</form>

assets/js/versions.js

@@ -0,0 +1,45 @@
+// sidebar versions dropdown
+/* globals versionNodes */
+
+// Dependencies
+// ------------
+import $ from 'jquery'
+import find from 'lodash.find'
+import versionsTemplate from './templates/versions-dropdown.handlebars'
+
+// Local Variables
+// ---------------
+
+const sidebarProjectVersion = $('.sidebar-projectVersion')
+const currentVersion = sidebarProjectVersion.text().trim()
+
+// Local Methods
+// -------------
+
+function addCurrentVersionIfNotPresent () {
+  if (!find(versionNodes, function (element) { return element.version === currentVersion })) {
+    versionNodes.unshift({ version: currentVersion, url: '#' })
+  }
+}
+
+function addIsCurrentVersion (element) {
+  element.isCurrentVersion = element.version === currentVersion
+  return element
+}
+
+// Public Methods
+// --------------
+
+export function initialize () {
+  if (typeof versionNodes !== 'undefined') {
+    addCurrentVersionIfNotPresent()
+
+    let versionsDropdown = versionsTemplate({nodes: versionNodes.map(addIsCurrentVersion)})
+    sidebarProjectVersion.text('')
+    sidebarProjectVersion.append(versionsDropdown)
+
+    $('.sidebar-projectVersionsDropdown').change(function () {
+      window.location.href = $(this).val()
+    })
+  }
+}

assets/less/sidebar.less

@@ -35,7 +35,7 @@
     }
   }
 
-  .sidebar-projectLink {
+  .sidebar-header {
     margin: 18px 30px 0;
   }
 
@@ -66,6 +66,7 @@
   }
 
   .sidebar-projectVersion {
+    position: relative;
     margin: 0;
     padding: 0;
     font-weight: 300;
@@ -74,6 +75,34 @@
     color: @white;
   }
 
+  .sidebar-projectVersionsDropdown {
+    cursor: pointer;
+    margin: 0;
+    padding: 0 8px 0 0;
+    border: none;
+    -moz-appearance: none;
+    -webkit-appearance: none;
+    appearance: none;
+    background-color: transparent;
+    color: @white;
+    option {
+      color: initial;
+    }
+  }
+
+  .sidebar-projectVersion form::after {
+    position: absolute;
+    right: 0;
+    top: 0;
+    content: '\25BC';
+    z-index: -1;
+    font-size: 9px;
+  }
+
+  .sidebar-projectVersionsDropdown::-ms-expand {
+    display: none;
+  }
+
   .sidebar-listNav {
     padding: 10px 30px 20px 30px;
     margin: 0;

formatters/epub/dist/epub-a84049b89018916e0043.css renamed to formatters/epub/dist/epub-7b73f2ed8c1683aa4f8b.css

@@ -30,6 +30,7 @@ defmodule ExDoc.Config do
             groups_for_modules: [],
             groups_for_functions: [],
             homepage_url: nil,
+            javascript_config_path: "config.js",
             language: "en",
             logo: nil,
             main: nil,
@@ -59,6 +60,7 @@ defmodule ExDoc.Config do
           filter_prefix: nil | String.t(),
           formatter: nil | String.t(),
           homepage_url: nil | String.t(),
+          javascript_config_path: nil | String.t(),
           language: String.t(),
           logo: nil | Path.t(),
           main: nil | String.t(),