use rst2html5 to render docs
authorChristian Weiske <cweiske@cweiske.de>
Wed, 1 Jul 2015 18:14:02 +0000 (20:14 +0200)
committerChristian Weiske <cweiske@cweiske.de>
Wed, 1 Jul 2015 18:14:02 +0000 (20:14 +0200)
README.rst
build.sh
styles.css [new file with mode: 0644]

index 0954cf11240b14b2b7661e9ae090de2b91b74c7b..e910d599a474d66c81e72e773a071ccbe9ec92d7 100644 (file)
@@ -2,7 +2,7 @@
 OUYA store API documentation
 ****************************
 
 OUYA store API documentation
 ****************************
 
-This is an attempt to document the API used by OUYA gaming devices to
+This is an attempt to document the API used by OUYA gaming consoles to
 speak with ``devs.ouya.tv``.
 
 .. contents::
 speak with ``devs.ouya.tv``.
 
 .. contents::
@@ -66,3 +66,16 @@ Home page
 =========
 A rendered version of this documentation is available at
 http://cweiske.de/ouya-store-api-docs.htm
 =========
 A rendered version of this documentation is available at
 http://cweiske.de/ouya-store-api-docs.htm
+
+
+
+Building
+========
+You need to install ``rst2html5`` before::
+
+    $ pip install rst2html5-tools
+
+Rendering the docs is done via a build script::
+
+    $ ./build.sh
+
index 5854090994295569a1bb6af7e1f90d1fce3588e1..3c4854e44e1c86e31c2b9d277bea6522458af677 100755 (executable)
--- a/build.sh
+++ b/build.sh
@@ -1,2 +1,10 @@
 #!/bin/sh
 #!/bin/sh
-rst2html README.rst ouya-store-api-docs.htm
+#rst2html README.rst ouya-store-api-docs.htm
+rst2html5\
+ --bootstrap-css\
+ --stylesheet-path=styles.css --embed-stylesheet\
+ README.rst ouya-store-api-docs.htm
+
+# workaround for https://github.com/marianoguerra/rst2html5/issues/70
+sed -i 's#<title></title>#<title>OUYA store API documentation</title>#'\
+ ouya-store-api-docs.htm
diff --git a/styles.css b/styles.css
new file mode 100644 (file)
index 0000000..2860ace
--- /dev/null
@@ -0,0 +1,25 @@
+body {
+    margin: 3ex 15%;
+    font-family: helvetica;
+    color: #222;
+}
+
+header code, #contents code {
+    font-size: inherit;
+    border: none;
+    background-color: transparent;
+    color: inherit;
+}
+h1 {
+    text-align: center;
+    margin-bottom: 2ex;
+}
+h2 {
+    margin-top: 3ex;
+    padding-top: 1ex;
+    border-top: 1px solid grey;
+}
+
+dd {
+    margin-left: 3ex;
+}
\ No newline at end of file