sphinx-codeautolink makes code examples clickable by inserting links from individual code elements to the corresponding reference documentation. We aim for a minimal setup assuming your examples are already valid Python.
For a live demo, see our online documentation on Read The Docs.
Installation
sphinx-codeautolink can be installed from the following sources:
$ pip install sphinx-codeautolink
$ conda install -c conda-forge sphinx-codeautolink
Note that the library is in early development, so version pinning is advised. To enable sphinx-codeautolink, modify the extension list in conf.py. Note that the extension name uses an underscore rather than a hyphen.
extensions = [
...,
"sphinx_codeautolink",
]
That’s it! Now your code examples are linked. For ways of concatenating examples, setting default import statements, or customising link style among other things, see the online documentation.
Release files for sphinx-codeautolink 0.19.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sphinx_codeautolink-0.19.0.tar.gz | 65.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sphinx_codeautolink-0.19.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 103.1 kB
Release files / sphinx_codeautolink-0.19.0.tar.gz
| Download URL | sphinx_codeautolink-0.19.0.tar.gz |
|---|---|
| Size | 65.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
abd8367831bb0b084ecad7b0a9b77f8458294e4468cadd5f37861da9b38e3e7e
|
|
BLAKE2b-256 checksum How to use checksums |
264e92425c60359fa7b5b9ac0e0f1f788b86a89c4e65cf29139e1174e21e3adf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.7
|
Release files / sphinx_codeautolink-0.19.0-py3-none-any.whl
| Download URL | sphinx_codeautolink-0.19.0-py3-none-any.whl |
|---|---|
| Size | 37.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ebbaf815efee63cfdc5320a97ece7eb01af38f22ed404439bee520e9c8175605
|
|
BLAKE2b-256 checksum How to use checksums |
fd86260d30033dbc48f8a0c37334159d56a1a731a7ce752d2803a6b5174e8731
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.7
|