ReadTheDocs: Switch to the Alabaster theme

Refs #1477
Closes gh-1840

docs/_static/custom.css

@@ -0,0 +1,16 @@
+div.section pre {
+    padding: 7px;
+}
+
+div.section table {
+    border-collapse: collapse;
+}
+
+div.section table, div.section th, div.section td {
+    border: 1px solid #bbb;
+    padding: 8px;
+}
+
+div.section table tr th {
+    background-color: #eee;
+}

docs/conf.py

@@ -11,9 +11,26 @@
 pygments_style = 'sphinx'
 
 # HTML output
-import sphinx_rtd_theme
-html_theme = "sphinx_rtd_theme"
-html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+html_theme = "alabaster"
+html_theme_options = {
+        'fixed_sidebar': False,
+        'logo_name': True,
+        'description': 'ECMAScript parsing infrastructure for multipurpose analysis',
+        'logo': 'esprima.png',
+        'github_user': 'jquery',
+        'github_repo': 'esprima',
+        'github_type': 'star',
+        'font_family': '-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Oxygen,Ubuntu,Cantarell,"Fira Sans","Droid Sans","Helvetica Neue",sans-serif',
+        'head_font_family': '-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Oxygen,Ubuntu,Cantarell,"Fira Sans","Droid Sans","Helvetica Neue",sans-serif',
+        'code_font_family': '"Roboto Mono",Menlo,Monaco,Consolas,"Courier New",monospace',
+}
+html_sidebars = {
+    '**': [
+        'about.html',
+        'searchbox.html',
+        'navigation.html',
+    ]
+}
 html_static_path = ['_static']
 html_show_sourcelink = False
 html_show_sphinx = True

docs/lexical-analysis.md

@@ -18,8 +18,8 @@ The `input` argument is mandatory. Its type must be a string, otherwise the toke
 
 The description of various properties of `config` is summarized in the following table:
 
-<table border="1" cellpadding="8" cellspacing="8">
-<tr><td>Name</td> <td>Type</td> <td>Default</td> <td>Description</td></tr>
+<table>
+<tr><th>Name</th> <th>Type</th> <th>Default</th> <th>Description</th></tr>
 <tr><td>range</td> <td>Boolean</td> <td>false</td> <td>Annotate each token with its zero-based start and end location</td></tr>
 <tr><td>loc</td> <td>Boolean</td> <td>false</td> <td>Annotate each token with its column and row-based location</td></tr>
 <tr><td>comment</td> <td>Boolean</td> <td>false</td> <td>Include every line and block comment in the output</td></tr>

docs/syntactic-analysis.md

@@ -23,8 +23,8 @@ The object returned by the `parseScript`/`parseModule` function is the [syntax t
 
 The description of various parsing configuration is summarized in the following table:
 
-<table border="1" cellpadding="8" cellspacing="8">
-<tr><td>Name</td> <td>Type</td> <td>Default</td> <td>Description</td></tr>
+<table>
+<tr><th>Name</th> <th>Type</th> <th>Default</th> <th>Description</th></tr>
 <tr><td>jsx</td> <td>Boolean</td> <td>false</td> <td>Support JSX syntax</td></tr>
 <tr><td>range</td> <td>Boolean</td> <td>false</td> <td>Annotate each node with its index-based location</td></tr>
 <tr><td>loc</td> <td>Boolean</td> <td>false</td> <td>Annotate each node with its column and row-based location</td></tr>