Sort guides in descending version order

Author: holly-cummins

_plugins/version_permalink.rb

@@ -14,9 +14,27 @@ def generate(site)
 
         # This will be returned
         version = data["slug"].gsub re, repl_str
-        doc.data.merge!('version' => version)
+        data.merge!('version' => version)
+      }
+
+      number_pattern = /^[0-9.]+$/
 
+      # Also add a version scalar that we can use for sorting
+      i = 0
+      collection.docs.filter { |doc| doc.data["version"].match?(number_pattern) }.sort_by { |doc| Gem::Version.new(doc.data["version"]) }.reverse.each { |doc|
+        data = doc.data
+        i +=1
+        data.merge!('version_counter' => i)
       }
+
+      j = 0
+      # Add a marker for things that don't have a version, because liquid filters are not as flexible as we'd like
+      collection.docs.filter { |doc| ! doc.data["version"].match?(number_pattern) }.each { |doc|
+        data = doc.data
+        j +=1
+        data.merge!('unversion_counter' => j)
+      }
+
     end
 
     Jekyll::Hooks.register :migrations, :pre_render do |doc|

migration-guides.html

@@ -4,10 +4,19 @@
 
 <h1>Migration Guides</h1>
 
-{% assign doclist = site.migrations   %}
-    <ul>
-       {% for doc in doclist %}
-        <li><a href="{{ site.baseurl }}{{ doc.url }}">{{ doc.version }}</a></li>
-        {% endfor %}
-    </ul>
 
+
+{% assign doclist = site.migrations | sort: 'version_counter' | where: 'unversion_counter', nil  %}
+<ul>
+    {% for doc in doclist %}
+    <li><a href="{{ site.baseurl }}{{ doc.url }}">{{ doc.version }}</a></li>
+    {% endfor %}
+</ul>
+
+{% assign doclist = site.migrations | sort: 'version_counter' | where: 'version_counter', nil  %}
+<h2>Special Guides</h2>
+<ul>
+    {% for doc in doclist %}
+    <li><a href="{{ site.baseurl }}{{ doc.url }}">{{ doc.version }}</a></li>
+    {% endfor %}
+</ul>