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:

* https://asciinema.org/docs/embedding 
* https://github.com/asciinema/asciinema-player


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.


.. asciinema:: demo.cast
   :theme: solarized-light

.. Die Werte werden ignoriert, es geht nur um die Anwesenheit der Option!
   :preload: 1
   :autoplay: 0


Cast von asciinema.org
----------------------


Anzeige des Videos #261648 von https://asciinema.org

::

  .. asciinema:: 261648
     :theme: solarized-light
  

.. asciinema:: 261648
   :theme: solarized-light



Cast auf RTLab-Remote Server
----------------------------

Asciinema ist installiert 

Kleine Demo zum Vim Editor:

 .. asciinema:: rtlab.cast
   :theme: solarized-light