Asciinema
Asciinema provides a great way for sharing shell sessions recording, making documentation more lively !
Syntax example
Once you have created a .cast
file, you can add it to your document with the following markup
Click to see the source code
[asciinema,rows=30,autoPlay=true]
....
include::image$bcd.cast[]
....
AutoPlay disabled
Click to see the source code
[asciinema,rows=10]
....
{"version": 2, "width": 80, "height": 24}
[1.0, "o", "hello "]
[2.0, "o", "world!"]
[3.0, "o", "Auto play is disabled"]
Mandatory setup
In bonita documentation site, the asciinema extension is already declared. So you can use the previous syntax without more configuration. |
To be allowed to use the asciinema extension, you need to add the following configuration to your playbook:
antora:
extensions:
- require: '@springio/antora-extensions/asciinema-extension'
This extension is available in the @springio/antora-extensions
package.