fix(docs): generate PDF docs from readthedocs

.editorconfig

@@ -8,6 +8,10 @@ indent_style = space
 indent_size = 2
 max_line_length = 80
 
+[*.py]
+indent_style = space
+indent_size = 4
+
 [Makefile]
 indent_style = tab
 indent_size = 4

docs/README.rst

@@ -6,20 +6,19 @@
 Welcome to Bemuse's documentation!
 ==================================
 
-Contents:
+Bemuse is a BMS player with a gameplay similar to Lunatic Rave 2.
+
+Bemuse is web-based, which means that you don't have to download any special
+software to play this game; simply use your web browser.
+
+Bemuse is built on new, cutting-edge HTML5 technologies.
+It does not require any plugin (like Flash or Unity Web Player).
+This game can be played on browsers that implement these technologies
+(such as Firefox, Google Chrome, and Safari).
 
 .. toctree::
    :maxdepth: 2
 
    bms-extensions
    developers/README
 
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-

docs/conf.py

@@ -12,8 +12,22 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
-import sys
 import os
+import sys
+
+# Monkey-patch Sphinx to use XeTeX
+from os import path
+from sphinx.builders import latex
+
+class XeLaTeXBuilder(latex.LaTeXBuilder):
+    def finish(self):
+        super(XeLaTeXBuilder, self).finish()
+        makefile_name = path.join(self.outdir, 'Makefile')
+        with open(makefile_name, 'r') as f: makefile = f.read()
+        makefile = makefile.replace('pdflatex', 'xelatex')
+        with open(makefile_name, 'w') as f: f.write(makefile)
+
+latex.LaTeXBuilder = XeLaTeXBuilder
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
@@ -194,14 +208,19 @@
 
 # Additional stuff for the LaTeX preamble.
 #'preamble': '',
+    'inputenc': '',
+    'utf8extra': '',
+    'preamble': '''
+    \usepackage{fontspec}
+    ''',
 }
 
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
   ('README', 'Bemuse.tex', u'Bemuse Documentation',
-   u'The BEAT☆MUSIC☆SEQUENCE team', 'manual'),
+   u'The Bemuse team', 'manual'),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of

docs/developers/getting-started.rst

@@ -6,6 +6,7 @@ This page describes how to setup the project on your computer
 for local development.
 
 .. contents::
+   :local:
 
 
 Prerequisites

docs/developers/skinning.rst

@@ -6,6 +6,8 @@ To make it easy to adjust the gameplay screen's appearance,
 the *skin* is not built into the game's source code.
 
 .. contents::
+   :local:
+
 
 Location
 --------