merge libmaple docs ("leaflabs-docs") into ./docs

In the past, libample documentation was forked out of this repository
because the documentation had increased in scope. For the librambutan,
and the rambutan project in general, we will try to keep documentation
closer to the source code, so the librambutan-specific documentation
should live here. Other sections of leaflabs-docs will be culled in a
following commit.

This merge attempts to maintain history by using a subtree strategy.
Followed directions at:

    http://nuclearsquid.com/writings/subtree-merging-and-you/

Full history for files should be accessible using the "--follow" flag to
git log, eg:

    git log --follow docs/source/adc.rst

It should be possible to pull patches from leaflabs-docs with:

    git pull -s subtree leaflabs-docs master

... at least until the docs in this repository diverge significantly.

3 files changed, 128 insertions, 0 deletions

diff --git a/docs/source/_templates/.gitignore b/docs/source/_templates/.gitignore
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/docs/source/_templates/.gitignore
diff --git a/docs/source/_templates/indexcontent.html b/docs/source/_templates/indexcontent.html
new file mode 100644
index 0000000..a043f8a
--- /dev/null
+++ b/docs/source/_templates/indexcontent.html
@@ -0,0 +1,117 @@
+{# This file generates the top-level index.html file. We are very
+   obviously stealing from the Python docs' style ;).
+#}
+
+<!-- Extend our layout.html. So inheritance hierarchy is Sphinx's
+     layout, then our layout.html, then this file. -->
+{% extends "layout.html" %}
+
+<!-- Pull in extra index stylesheet -->
+{% set css_files = css_files + ["_static/index-style.css"] %}
+
+<!-- Separator for contents lists -->
+{% set content_sep = "&middot;" %}
+
+<!-- Content -->
+{% block body %}
+<h1>Hi!</h1>
+
+This is the documentation for the LeafLabs Maple boards, version {{
+release }}.
+
+<h2>Read This First</h2>
+
+<p>Just getting started? Try the <a href="{{
+pathto("maple-quickstart") }}">Quickstart</a>. Having problems? Check
+out <a href="{{ pathto("troubleshooting") }}">Troubleshooting</a> and
+the <a href="{{ pathto("faq") }}">FAQ</a>. Can't find what you want
+here?  Look on the <a href="http://wiki.leaflabs.com/">LeafLabs
+wiki</a>.
+</p>
+
+<p>See the <a href="{{ pathto("whats-new") }}">What's New</a> page for
+changes that are new in {{ release }}.</p>
+
+<h2>Contents at a Glance</h2>
+
+<table class="contents-table">
+  <tr>
+    <td><p><strong>Getting Started</strong></p>
+      <ul>
+        <li><a href="{{ pathto("maple-quickstart") }}">Quickstart</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("maple-ide-install") }}">Installing Maple&nbsp;IDE</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("ide") }}">Using Maple&nbsp;IDE</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("unix-toolchain") }}">Command-Line
+                Toolchain</a></li>
+      </ul>
+    </td>
+    <td><p><strong>Boards</strong></p>
+      <ul>
+        <li><a href="{{ pathto("hardware/maple") }}">Maple</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("hardware/maple-ret6") }}">Maple RET6&nbsp;Edition</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("hardware/maple-mini") }}">Maple Mini</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("hardware/maple-native-beta") }}">Maple
+                Native β</a></li>
+      </ul>
+    </td>
+  </tr>
+  <tr>
+    <td><p><strong>Programming</strong></p>
+      <ul>
+        <li><a href="{{ pathto("language") }}">Language Reference</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("troubleshooting") }}">Troubleshooting</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("faq") }}">FAQ</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("libraries") }}">Libraries</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("libmaple") }}"><tt>libmaple</tt></a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("bootloader") }}">Bootloader</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("arm-gcc") }}">GCC and libc</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("arduino-compatibility") }}">Arduino
+                Compatibility</a></li>
+      </ul>
+    </td>
+    <td><p><strong>Hardware and Peripherals</strong></p>
+      <ul>
+        <li><a href="{{ pathto("stm32") }}">STM32</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("adc") }}">ADC</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("external-interrupts") }}">External
+            Interrupts</a> {{ content_sep }}</li>
+        <li><a href="{{ pathto("fsmc") }}">FSMC</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("gpio") }}">GPIO</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("i2c") }}">I<sup>2</sup>C</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("jtag") }}">JTAG</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("pwm") }}">PWM</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("spi") }}">SPI</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("systick") }}">SysTick</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("timers") }}">Timers</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("usart") }}">USART</a>
+            {{ content_sep }}</li>
+        <li><a href="{{ pathto("usb") }}">USB</a></li>
+      </ul>
+    </td>
+  </tr>
+</table>
+
+{% endblock %}
diff --git a/docs/source/_templates/layout.html b/docs/source/_templates/layout.html
new file mode 100644
index 0000000..2fd81ce
--- /dev/null
+++ b/docs/source/_templates/layout.html
@@ -0,0 +1,11 @@
+{% extends "!layout.html" %}
+
+{% set css_files = css_files + ["_static/leaflabs-docs.css"] %}
+
+{% block rootrellink %}
+    <li><a href="http://leaflabs.com/">
+            <img width="16px" src="_static/img/round_logo_32x32.ico"></img>
+            leaflabs.com
+        </a>&middot;</li>
+    <li><a href="{{ pathto('index') }}">{{ shorttitle }}</a>{{ reldelim1 }}</li>
+{% endblock %}