Categorise specifications

i2p2www/pages/spec/index.html

@@ -27,6 +27,7 @@ If you find any inaccuracies in the documents linked below, please
 <table>
   <tr>
     <th>Title</th>
+    <th>Category</th>
     <th>Last updated</th>
     <th>Accurate for</th>
     <th>Link</th>
@@ -34,6 +35,7 @@ If you find any inaccuracies in the documents linked below, please
   {% for spec in specs %}
   <tr>
     <td>{{ spec.title }}</td>
+    <td>{{ spec.category }}</td>
     <td><time>{{ spec.lastupdated }}</time></td>
     <td>{{ spec.accuratefor }}</td>
     <td>

i2p2www/spec/common-structures.rst

@@ -2,6 +2,7 @@
 Common structures Specification
 ===============================
 .. meta::
+    :category: Design
     :lastupdated: February 2016
     :accuratefor: 0.9.24
 

i2p2www/spec/cryptography.rst

@@ -2,6 +2,7 @@
 Low-level Cryptography Specification
 ====================================
 .. meta::
+    :category: Design
     :lastupdated: December 2014
     :accuratefor: 0.9.17
 

i2p2www/spec/datagrams.rst

@@ -2,6 +2,7 @@
 Datagram Specification
 ======================
 .. meta::
+    :category: Protocols
     :lastupdated: July 2014
     :accuratefor: 0.9.14
 

i2p2www/spec/i2cp.rst

@@ -2,6 +2,7 @@
 I2CP Specification
 ==================
 .. meta::
+    :category: Protocols
     :lastupdated: June 2015
     :accuratefor: 0.9.21
 

i2p2www/spec/i2np.rst

@@ -2,6 +2,7 @@
 I2NP Specification
 ==================
 .. meta::
+    :category: Protocols
     :lastupdated: January 2016
     :accuratefor: 0.9.24
 

i2p2www/spec/ssu.rst

@@ -2,6 +2,7 @@
 SSU Protocol Specification
 ==========================
 .. meta::
+    :category: Transports
     :lastupdated: November 2015
     :accuratefor: 0.9.24
 

i2p2www/spec/streaming.rst

@@ -2,6 +2,7 @@
 Streaming Library Specification
 ===============================
 .. meta::
+    :category: Protocols
     :lastupdated: June 2015
     :accuratefor: 0.9.20
 

i2p2www/spec/tunnel-creation.rst

@@ -2,6 +2,7 @@
 Tunnel Creation Specification
 =============================
 .. meta::
+    :category: Design
     :lastupdated: January 2016
     :accuratefor: 0.9.24
 

i2p2www/spec/tunnel-message.rst

@@ -2,6 +2,7 @@
 Tunnel Message Specification
 ============================
 .. meta::
+    :category: Design
     :lastupdated: February 2014
     :accuratefor: 0.9.11
 

i2p2www/spec/views.py

@@ -23,11 +23,18 @@ from i2p2www import helpers
 
 SPEC_METATAGS = {
     'accuratefor': None,
+    'category': '',
     'lastupdated': None,
     }
 
 SPEC_LIST_METATAGS = [
     ]
+SPEC_CATEGORY_SORT = {
+    'Design': 1,
+    'Transports': 2,
+    'Protocols': 3,
+    '': 999,
+    }
 
 
 def spec_index():
@@ -52,7 +59,7 @@ def spec_index():
             spec.update(meta)
             specs.append(spec)
 
-    specs.sort(key=lambda s: s['name'])
+    specs.sort(key=lambda s: (SPEC_CATEGORY_SORT[s['category']], s['title']))
     return render_template('spec/index.html', specs=specs)
 
 def spec_show(name, txt=False):
@@ -76,8 +83,9 @@ def spec_show(name, txt=False):
         # Change highlight formatter
         content = content.replace('{% highlight', "{% highlight formatter='textspec'")
         # Other string changes
-        content = content.replace('    :lastupdated', '- Last updated')
         content = content.replace('    :accuratefor', '- Accurate for')
+        content = content.replace('    :category', '- Category')
+        content = content.replace('    :lastupdated', '- Last updated')
 
     # render the post with Jinja2 to handle URLs etc.
     rendered_content = render_template_string(content)