You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
39 lines
1.0 KiB
39 lines
1.0 KiB
4 years ago
|
MicroPython Documentation
|
||
|
|
=========================
|
||
|
|
|
||
|
|
The MicroPython documentation can be found at:
|
||
|
|
http://docs.micropython.org/en/latest/
|
||
|
|
|
||
|
|
The documentation you see there is generated from the files in the docs tree:
|
||
|
|
https://github.com/micropython/micropython/tree/master/docs
|
||
|
|
|
||
|
|
Building the documentation locally
|
||
|
|
----------------------------------
|
||
|
|
|
||
|
|
If you're making changes to the documentation, you may want to build the
|
||
|
|
documentation locally so that you can preview your changes.
|
||
|
|
|
||
|
|
Install Sphinx, and optionally (for the RTD-styling), sphinx_rtd_theme,
|
||
|
|
preferably in a virtualenv:
|
||
|
|
|
||
|
|
pip install sphinx
|
||
|
|
pip install sphinx_rtd_theme
|
||
|
|
|
||
|
|
In `micropython/docs`, build the docs:
|
||
|
|
|
||
|
|
make html
|
||
|
|
|
||
|
|
You'll find the index page at `micropython/docs/build/html/index.html`.
|
||
|
|
|
||
|
|
PDF manual generation
|
||
|
|
---------------------
|
||
|
|
|
||
|
|
This can be achieved with:
|
||
|
|
|
||
|
|
make latexpdf
|
||
|
|
|
||
|
|
but require rather complete install of LaTeX with various extensions. On
|
||
|
|
Debian/Ubuntu, try (500MB+ download):
|
||
|
|
|
||
|
|
apt-get install texlive-latex-recommended texlive-latex-extra
|