circuitpython/docs
Tony DiCola c281b44cbd Update docs README to mention requirement for recommonmark dependency. 2017-08-16 15:23:42 -07:00
..
differences tools: Add gen-cpydiff.py to generate docs differences. 2017-02-20 17:14:34 +11:00
esp8266 Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
library Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
pyboard Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
readthedocs/settings docs: Add RTD local_settings file, to add custom templates. 2014-12-21 11:21:06 +00:00
reference docs/*/quickref.rst: Use new semantics of ticks_diff() 2016-11-08 02:01:05 +03:00
sphinx_selective_exclude various: Spelling fixes 2017-05-29 11:36:05 +03:00
static Update favicon to blinka. 2017-07-28 16:33:07 -07:00
templates docs: Add link to PDF version of docs in sidebar. 2016-06-06 11:37:40 +01:00
wipy Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
Makefile docs/Makefile: define and use PYTHON as the interpreter for CPYDIFF 2017-02-27 15:39:55 +11:00
README.md Update docs README to mention requirement for recommonmark dependency. 2017-08-16 15:23:42 -07:00
c2rst.py Documentation rework to unify the docs together rather than having them 2016-10-18 17:42:47 -07:00
common_hal.md docs: Minor updates before 1.0.0 2017-07-19 15:13:23 -04:00
design_guide.rst docs: Minor updates before 1.0.0 2017-07-19 15:13:23 -04:00
drivers.rst docs: Add link to SD card driver. 2017-08-07 17:55:39 -07:00
esp8266_contents.rst docs: Modify Makefile and indexes to generate cPy-differences pages. 2017-02-20 17:14:35 +11:00
esp8266_index.rst docs: Modify Makefile and indexes to generate cPy-differences pages. 2017-02-20 17:14:35 +11:00
pyboard_contents.rst docs: Modify Makefile and indexes to generate cPy-differences pages. 2017-02-20 17:14:35 +11:00
pyboard_index.rst docs: Modify Makefile and indexes to generate cPy-differences pages. 2017-02-20 17:14:35 +11:00
supported_ports.rst docs: Typos and rename to CircuitPython. 2017-06-27 17:37:03 -07:00
topindex.html docs: Change single occurrence of "Micropython" to "MicroPython". 2017-05-17 12:38:33 +10:00
unix_contents.rst docs: Modify Makefile and indexes to generate cPy-differences pages. 2017-02-20 17:14:35 +11:00
unix_index.rst docs: Modify Makefile and indexes to generate cPy-differences pages. 2017-02-20 17:14:35 +11:00
unsupported_ports.rst This introduces an alternative hardware API called nativeio structured around different functions that are typically accelerated by native hardware. Its not meant to reflect the structure of the hardware. 2016-11-21 14:11:52 -08:00
wipy_contents.rst docs: Modify Makefile and indexes to generate cPy-differences pages. 2017-02-20 17:14:35 +11:00
wipy_index.rst docs: Modify Makefile and indexes to generate cPy-differences pages. 2017-02-20 17:14:35 +11:00

README.md

Adafruit's CircuitPython Documentation

The latest documentation can be found at: http://circuitpython.readthedocs.io/en/latest/

The documentation you see there is generated from the files in the whole tree: https://github.com/adafruit/circuitpython/tree/master

Building the documentation locally

If you're making changes to the documentation, you should build the documentation locally so that you can preview your changes.

Install Sphinx, recommonmark, and optionally (for the RTD-styling), sphinx_rtd_theme, preferably in a virtualenv:

 pip install sphinx
 pip install recommonmark
 pip install sphinx_rtd_theme

In circuitpython/, build the docs:

sphinx-build -v -b html . _build/html

You'll find the index page at _build/html/index.html.