Merge pull request #3 from Rantanen/master

Voice Data & random tweaks

_static/mumble.css

@@ -4,4 +4,16 @@
 
 th {
 	background-color: #adadad;
-}
+}
+
+table.bits8 {
+	text-align: center;
+	table-layout: fixed;
+	width: 300px;
+}
+
+table.bits16 {
+	text-align: center;
+	table-layout: fixed;
+}
+

conf.py

@@ -2,6 +2,9 @@
 
 import sys, os
 
+# on_rtd is whether we are on readthedocs.org
+on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
+
 extensions = [
 	'sphinx.ext.pngmath',
 ]
@@ -32,16 +35,22 @@
 
 pygments_style = 'sphinx'
 
-html_theme = 'default'
-html_theme_options = {
-	'footerbgcolor':    '#555555',
-	'relbarbgcolor':    '#222222',
-	'sidebarbgcolor':   '#333333',
-	'linkcolor':        '#696969',
-	'visitedlinkcolor': '#adadad',
-	'sidebarlinkcolor': '#cacaca',
-	'headtextcolor':    '#000000',
-}
+if not on_rtd:  # only import and set the theme if we're building docs locally
+    import sphinx_rtd_theme
+    html_theme = 'sphinx_rtd_theme'
+    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+else:
+    html_theme = 'default'
+
+    html_theme_options = {
+            'footerbgcolor':    '#555555',
+            'relbarbgcolor':    '#222222',
+            'sidebarbgcolor':   '#333333',
+            'linkcolor':        '#696969',
+            'visitedlinkcolor': '#adadad',
+            'sidebarlinkcolor': '#cacaca',
+            'headtextcolor':    '#000000',
+    }
 
 # Add any paths that contain custom themes here, relative to this directory.
 #html_theme_path = []
@@ -80,4 +89,4 @@
 html_domain_indices = False
 
 html_show_sphinx = True
-html_show_copyright = True
+html_show_copyright = True

index.rst

@@ -1,10 +1,11 @@
 Mumble Protocol Documentation
 =============================
 
-Contents:
+Contents
+--------
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 3
 
    introduction
    overview
@@ -13,8 +14,10 @@ Contents:
    voice_data
 
 
-Indices and tables
-==================
+.. # These are empty pages:
 
-* :ref:`genindex`
-* :ref:`search`
+.. # Indices and tables
+.. # ==================
+
+.. # * :ref:`genindex`
+.. # * :ref:`search`

introduction.rst

@@ -2,8 +2,9 @@ Introduction
 ============
 
 This document is meant to be a reference for the Mumble VoIP 1.2.X
-server-client communication protocol.  It reflects the state of the
-protocol implemented in the Mumble 1.2.2 client and might be outdated
-by the time you are reading this. Be sure to check for newer revisions
-of this document on our website \url{http://www.mumble.info}. At the
-moment this document is work in progress.
+server-client communication protocol. It reflects the state of the protocol
+implemented in the Mumble 1.2.8 client and might be outdated by the time you
+are reading this. Be sure to check for newer revisions of this document at
+http://mumble-protocol.readthedocs.org/.
+
+This document is a constant work in progress.