sphinxcontrib-asciinema
Easily embed asciinema videos into Sphinx rst docs.
Installation
Clone and cd into this repository, then:
pip install .
or install from PyPI:
pip install sphinxcontrib.asciinema
Usage
Append extension to sphinx conf.py:
extensions = ['sphinxcontrib.asciinema']
Insert videos into .rst docs by embedding them from asciinema.org:
.. asciinema:: 261648
or for a local file with a self-hosted web player:
.. asciinema:: local_file.cast
It is possible to give options as well:
.. asciinema:: local_file.cast
:preload: 1
:theme: solarized-dark
You can enter all options from the asciinema Player Options.
Default options can be set in conf.py:
sphinxcontrib_asciinema_defaults = {
'theme': 'solarized-dark',
'preload': 1,
'font-size': '15px',
# 'path': 'path/to/castdir'
}
The "path" option can be specified to set the default cast file directory. If a local file path starts with "./", the option is ignored.
1 maintainer
Release files for sphinxcontrib.asciinema 0.4.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sphinxcontrib_asciinema-0.4.3.tar.gz | 74.4 kB | Details |
Release files / sphinxcontrib_asciinema-0.4.3.tar.gz
| Download URL | sphinxcontrib_asciinema-0.4.3.tar.gz |
|---|---|
| Size | 74.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
aeb480e33b3ac75edec76b8ad705487c4dff978e523a0143cc3962944dbd5d52
|
|
BLAKE2b-256 checksum How to use checksums |
312361585345d0ad185acbd9d150d899a67d2f933c4e908c1df61a25f371e669
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
