resolves #16 allow components to be rearranged (PR #17)

Author: mojavelinux

preview-src/index.adoc

@@ -5,6 +5,7 @@ Author Name
 :!example-caption:
 :!table-caption:
 :page-pagination:
+:page-component-order: *, abc
 
 image:multirepo-ssg.svg[Multirepo SSG,200,float=right]
 Platonem complectitur mediocritatem ea eos.

src/helpers/rearrange.js

@@ -0,0 +1,18 @@
+'use strict'
+
+module.exports = (collection, property, orderSpec) => {
+  if (!orderSpec || orderSpec === '*') return Object.values(collection)
+  const order = orderSpec.split(',').map((it) => it.trim())
+  const sourceCollection = Object.values(collection).reduce((accum, it) => accum.set(it[property], it), new Map())
+  const restIdx = order.indexOf('*')
+  if (~restIdx) order.splice(restIdx, 1)
+  const targetCollection = order.reduce((accum, key) => {
+    if (sourceCollection.has(key)) {
+      accum.push(sourceCollection.get(key))
+      sourceCollection.delete(key)
+    }
+    return accum
+  }, [])
+  if (~restIdx) targetCollection.splice(restIdx, 0, ...sourceCollection.values())
+  return targetCollection
+}

src/partials/nav-explore.hbs

@@ -6,7 +6,7 @@
   </div>
   {{/if}}
   <ul class="components">
-    {{#each site.components}}
+    {{#each (rearrange site.components 'name' page.attributes.component-order)}}
     <li class="component{{#if (eq this @root.page.component)}} is-current{{/if}}">
       <a class="title" href="{{{relativize ./url}}}">{{{./title}}}</a>
       {{#if (or ./versions.[1] (not (eq ./versions.[0].displayVersion 'current')))}}