From 6b5b8432b3761484f3e36910575f5fd844c09400 Mon Sep 17 00:00:00 2001
From: Mark Haines <mark.haines@matrix.org>
Date: Fri, 18 Sep 2015 17:26:10 +0100
Subject: [PATCH] Turn on code highlighting for HTTP api responses and add a
 code highlighting stylesheet for the specification.

---
 scripts/codehighlight.css                           | 6 ++++++
 scripts/gendoc.py                                   | 2 +-
 templating/matrix_templates/templates/http-api.tmpl | 4 +++-
 3 files changed, 10 insertions(+), 2 deletions(-)
 create mode 100644 scripts/codehighlight.css

diff --git a/scripts/codehighlight.css b/scripts/codehighlight.css
new file mode 100644
index 00000000..5c9b0c36
--- /dev/null
+++ b/scripts/codehighlight.css
@@ -0,0 +1,6 @@
+pre.code .comment, code .comment { color: green }
+pre.code .keyword, code .keyword { color: darkred; font-weight: bold }
+pre.code .name.builtin, code .name.builtin { color: darkred; font-weight: bold }
+pre.code .literal.number, code .literal.number { color: blue }
+pre.code .name.tag, code .name.tag { color: darkgreen }
+pre.code .literal.string, code .literal.string { color: darkblue }
diff --git a/scripts/gendoc.py b/scripts/gendoc.py
index 3521efed..a821aea7 100755
--- a/scripts/gendoc.py
+++ b/scripts/gendoc.py
@@ -12,7 +12,7 @@ import sys
 os.chdir(os.path.dirname(os.path.abspath(__file__)))
 
 stylesheets = {
-    "stylesheet_path": ["basic.css", "nature.css"]
+    "stylesheet_path": ["basic.css", "nature.css", "codehighlight.css"]
 }
 
 title_style_matchers = {
diff --git a/templating/matrix_templates/templates/http-api.tmpl b/templating/matrix_templates/templates/http-api.tmpl
index a0b25924..a03ffa7d 100644
--- a/templating/matrix_templates/templates/http-api.tmpl
+++ b/templating/matrix_templates/templates/http-api.tmpl
@@ -62,7 +62,9 @@ Response{{"s" if endpoint.example.responses|length > 1 else "" }}:
 
 {{res["description"]}}
 
-Example::
+Example
+
+.. code:: json
 
   {{res["example"] | indent_block(2)}}