Add a "Format" page which contains the format/schema specification

ffdnispdb/static/css/style.css

@@ -167,3 +167,32 @@ input#search-input {
 .form-horizontal .help-block {
     margin-top: 0 !important;
 }
+
+/**
+ * Schema Spec / RST
+ */
+
+#schema_spec {
+    margin-bottom: 30px;
+}
+
+.rst .docinfo-name {
+    text-align: left;
+    padding-right: 7px;
+}
+
+.rst .title {
+    font-size: 2.2em;
+    line-height: normal;
+    margin: 0;
+}
+
+.rst .subtitle {
+    font-size: 1.5em;
+    line-height: normal;
+    margin: 0 0 25px 0;
+}
+
+.rst .section > :first-child {
+    margin-top: 15px;
+}

ffdnispdb/templates/format_spec.html

@@ -0,0 +1,10 @@
+{% extends "layout.html" %}
+{% block container %}
+  <div class="row-fluid">
+    <div class="span12">
+      <div id="schema_spec" class="rst">
+        {{ spec }}
+      </div>
+    </div>
+  </div>
+{% endblock %}

ffdnispdb/templates/layout.html

@@ -37,7 +37,7 @@
         <ul class="nav pull-right">
           {{ menu_item(_("Home"), 'home') }}
           {{ menu_item(_("Project List"), 'project_list') }}
-          {{ menu_item(_("Schema")) }}
+          {{ menu_item(_("Format"), 'format') }}
           {{ menu_item(_("API")) }}
           <li class="divider-vertical"></li>
         </ul>

ffdnispdb/views.py

@@ -1,8 +1,11 @@
 # -*- coding: utf-8 -*-
 
 from flask import request, g, redirect, url_for, abort, \
-    render_template, flash, json, session, Response
+    render_template, flash, json, session, Response, Markup
 from flask.ext.babel import gettext as _
+import docutils.core
+import ispformat.specs
+
 from datetime import date, time, timedelta, datetime
 from urlparse import urlunsplit
 import locale
@@ -159,6 +162,21 @@ def search():
     return render_template('search.html')
 
 
+@app.route('/format', methods=['GET'])
+def format():
+    parts = cache.get('format-spec')
+    if parts is None:
+        spec=open(ispformat.specs.versions[0.1]).read()
+        overrides = {
+            'initial_header_level' : 3,
+        }
+        parts = docutils.core.publish_parts(spec,
+                    destination_path=None, writer_name='html',
+                    settings_overrides=overrides)
+        cache.set('format-spec', parts, timeout=60*60*24)
+    return render_template('format_spec.html', spec=Markup(parts['html_body']))
+
+
 #------
 # Filters
 

requirements.txt

@@ -13,3 +13,4 @@ requests==2.0.0
 # ndg & pyasn required for SNI
 ndg-httpsclient==0.3.2
 pyasn1==0.1.7
+docutils==0.11