Asciinema¶
Mit „Asciinema“ (https://asciinema.org) kann man Terminal-Sessions aufnehmen
und später wieder abspielen. Die Aufnahmen („casts“) enthalten nur die Zeichen
die man in einem Terminalfenster sieht und ihre Änderungen im Laufe der Zeit
und sind deshalb extrem klein. Die Casts sind „stumm“, da es keine Audio-Daten
gibt. Man kann die Casts in andere Formate wie GIF und SVG umwandeln. Asciinema
ist ein Python Programm, das man mit pip install asciinema
installiert.
Die Bedienung ist extrem einfach. Zum Starten eingeben:
asciinema rec my.cast
Zum Stoppen nur Ctrl-D
drücken. Abspielen mit
asciinema play my.cast
Die aufgenommenen Casts kann man auch in Sphinx einbauen mit der Erweiterung „sphinxcontrib.asciinema“. Zu diesem Projekt geht es hier:
https://github.com/divi255/sphinxcontrib.asciinema
Man installiert die Erweiterung mit
pip install sphinxcontrib.asciinema
Die möglichen Optionen kann man hier nachschauen:
Lokale Cast-Datei¶
Anzeige eines lokalen Asciinema Cast (demo.cast) mit den folgenden Zeilen:
.. asciinema:: demo.cast
:theme: solarized-light
Anmerkung: Der Cast hat bei mir nicht funktioniert, wenn ich den Web-Browser mit den lokalen Dateien aufrufe. Es klappt jedoch, wenn man die HTML Seiten über einen Web-Browser ausliefert.
Cast von asciinema.org¶
Anzeige des Videos #261648 von https://asciinema.org
.. asciinema:: 261648
:theme: solarized-light