suspect-devices/circuitpython/docs/conf.py, branch v1.9.3CircuitPython - a Python implementation for teaching coding with microcontrollershttps://git.suspectdevices.com/suspect-devices/circuitpython/atom?h=v1.9.32017-11-01T00:19:56+00:00docs: Bump version to 1.9.3.2017-11-01T00:19:56+00:00Damien Georgedamien.p.george@gmail.com2017-11-01T00:19:56+00:00urn:sha1:fe45d78b1edd6d2202c3544797885cb0b12d4f03docs: Bump version to 1.9.2.2017-08-23T01:46:35+00:00Damien Georgedamien.p.george@gmail.com2017-08-23T01:46:35+00:00urn:sha1:1f78e7a43130acfa4bedf16c1007a1b0f37c75c3docs/conf.py: Set "version" and "release" to the same value.2017-07-02T12:50:22+00:00Paul Sokolovskypfalcon@users.sourceforge.net2017-07-02T12:50:22+00:00urn:sha1:90c1d54464498237912476d1f02b55b457575105
We don't use alpha/beta/RC, so for us version and release should be the
same, or it leads to confusion (for example, current, 1.9.1 docs are
marked as 1.9 at places).
docs/conf.py: Add file for global replacements definition.2017-07-02T12:15:31+00:00Paul Sokolovskypfalcon@users.sourceforge.net2017-07-02T12:15:31+00:00urn:sha1:ebce7984c66b4d977f4540506e243cf65a80db2f
The idea is to allow to define a kind of "macros" for repeatitive text,
so all occurrances can be updated in one place. Unfortunately, RST doesn't
support replacements with arguments, which limits usefulness of them and
should be taken into account.
docs/conf.py: Switch to "new" format of intersphinx_mapping.2017-07-02T11:35:52+00:00Paul Sokolovskypfalcon@users.sourceforge.net2017-07-02T11:34:20+00:00urn:sha1:5f0c56bcf1fcb7f2d36a0c420b4681a812047c59
As described at
http://www.sphinx-doc.org/en/stable/ext/intersphinx.html#confval-intersphinx_mapping
This will allow to explicitly refer to CPython docs for cross-references.
docs/conf.py: Add .venv dir to exclude_patterns.2017-07-01T17:01:05+00:00Paul Sokolovskypfalcon@users.sourceforge.net2017-07-01T17:01:05+00:00urn:sha1:ef47dee4bfacaaff507775b7d4739a7901e8d352
It's useful to try different Sphinx versions using virtualenv/venv, so
exclude a common venv dir name from Sphinx processing.
docs/conf.py: Set default_role = 'any'.2017-06-24T21:57:44+00:00Paul Sokolovskypfalcon@users.sourceforge.net2017-06-24T21:57:44+00:00urn:sha1:ba33c544bb9b5bd0476e07a12a34d2f72579075e
This causes `symbol` syntax to be equivalent to :any:`symbol`, which is
in turn the easiest way to cross-reference an arbitrary symbol in the
docs:
http://www.sphinx-doc.org/en/stable/markup/inline.html#role-any
:any: requires at least Sphinx 1.3 (for reference, Ubuntu 16.03 ships
with 1.3.6, the latest 1.6.3).
Any many of our docs, `symbol` is misused to specify arguments to
functions, etc. Refactoring that is in progress. (CODECONVENTIONS
already specify proper syntax for both arguments and xrefs, based
on CPython conventions).
docs/conf.py: Include 3 levels of ToC in latexpdf output.2017-06-23T21:25:29+00:00Paul Sokolovskypfalcon@users.sourceforge.net2017-06-23T21:25:29+00:00urn:sha1:b50659e13775fbf44c5b8f4b1261fc8f46635321
Instead of default 2. 3 are required to access description of individual
library modules.
docs: Bump version to 1.9.1.2017-06-11T13:04:00+00:00Damien Georgedamien.p.george@gmail.com2017-06-11T13:04:00+00:00urn:sha1:869cdcfdfc860b1177baf9b0f8818915ba54f3f5docs: Bump version to 1.9.2017-05-26T09:07:37+00:00Damien Georgedamien.p.george@gmail.com2017-05-26T09:07:37+00:00urn:sha1:825460a093a6bcd8fb79119b5f6ee8408f63603b