Move custom CSS and default highlight language away from include.rst

_static/css/86box.css

@@ -0,0 +1,48 @@
+/* Give some spacing to icons in headings. */
+h1 > img {
+	padding-right: 5px;
+}
+h2 > img {
+	padding-right: 5px;
+}
+
+/* Remove bottom spacing from lists in tables and admonitions. */
+table.docutils > tbody > tr > td > ul, table.docutils > tbody > tr > td > ol {
+	margin-bottom: 0 !important;
+}
+div.admonition > p:nth-child(2) {
+	margin-bottom: 0;
+}
+
+/* Avoid horizontal scrolling of API documentation tables. */
+.wy-table-responsive table td {
+	white-space: normal;
+}
+
+/* Make API documentation table titles normal-monospace, and give them less spacing. */
+.rst-content table.docutils caption {
+	padding-top: 0;
+	font-family: monospace;
+	font-style: normal;
+}
+
+/* Fix font size for lists in table cells. */
+table.docutils > tbody > tr > td > ul > li > p, table.docutils > tbody > tr > td > ol > li > p {
+	font-size: inherit;
+}
+
+/* Tweak top and bottom spacing for tables in table cells. */
+table.docutils > tbody > tr > td > div.wy-table-responsive {
+	margin-top: 0.5em;
+	margin-bottom: 0;
+}
+
+/* Fix odd row background on tables in table cells. */
+tr.row-odd > td {
+	background-color: #fcfcfc !important;
+}
+
+/* Vertical text for tables. */
+div.vertical-text {
+	transform: rotate(270deg);
+}

conf.py

@@ -55,4 +55,10 @@ html_theme = 'sphinx_rtd_theme'
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+html_static_path = ['_static']
+
+html_css_files = [
+	'css/86box.css',
+]
+
+highlight_language = 'c'

dev/api/device.rst

@@ -1,5 +1,3 @@
-.. include:: /include.rst
-
 Devices
 =======
 
@@ -113,7 +111,7 @@ Most devices need a place to store their internal state. We discourage the use o
 
     typedef struct {
         uint32_t type; /* example: copied from device_t.local */
-        uint8_t regs[256]; /* example: 256*8-bit registers */
+        uint8_t  regs[256]; /* example: 256*8-bit registers */
     } foo_t;
 
     /* ... */

dev/api/dma.rst

@@ -1,5 +1,3 @@
-.. include:: /include.rst
-
 DMA
 ===
 

dev/api/io.rst

@@ -1,5 +1,3 @@
-.. include:: /include.rst
-
 Port I/O
 ========
 

dev/api/thread.rst

@@ -1,5 +1,3 @@
-.. include:: /include.rst
-
 Threads
 =======
 

dev/api/timer.rst

@@ -1,5 +1,3 @@
-.. include:: /include.rst
-
 Timers
 ======
 

include.rst

@@ -54,43 +54,3 @@
 .. |storage_controllers_small| image:: /usage/images/storage_controllers_small.png
 .. |zip| image:: /usage/images/zip.png
 .. |zip_small| image:: /usage/images/zip_small.png
-
-.. raw:: html
-
-  <style>
-    h1 > img {
-      padding-right: 5px;
-    }
-    h2 > img {
-      padding-right: 5px;
-    }
-    div.admonition > p:nth-child(2) {
-      margin-bottom: 0;
-    }
-    .wy-table-responsive table td {
-      white-space: normal;
-    }
-    .rst-content table.docutils caption {
-      padding-top: 0;
-      font-family: monospace;
-      font-style: normal;
-    }
-    table.docutils > tbody > tr > td > ul {
-      margin-bottom: 0 !important;
-    }
-    table.docutils > tbody > tr > td > ul > li > p {
-      font-size: inherit;
-    }
-    table.docutils > tbody > tr > td > div.wy-table-responsive {
-      margin-top: 0.5em;
-      margin-bottom: 0;
-    }
-    tr.row-odd > td {
-      background-color: #fcfcfc !important;
-    }
-    .vertical-text {
-      transform: rotate(270deg);
-    }
-  </style>
-
-.. highlight:: c

usage/menubar.rst

@@ -1,5 +1,3 @@
-.. include:: /include.rst
-
 Menu bar
 ========