feat: added articles about recording terminal sessions with asciinema

knowledge base/agg.md

@@ -0,0 +1,40 @@
+# `agg`
+
+Command-line tool for generating animated GIF files from asciicast files produced by [Asciinema].
+
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
+## TL;DR
+
+```sh
+# Installation.
+brew install agg
+
+# Convert asciicast files from Asciinema.
+agg 'path/to/file.cast' 'path/to/file.gif'
+```
+
+## Further readings
+
+- [Asciinema] to record terminal sessions
+
+## Sources
+
+All the references in the [further readings] section, plus the following:
+
+<!--
+  references
+  -->
+
+<!-- project -->
+<!-- article sections -->
+[further readings]: #further-readings
+
+<!-- knowledge base -->
+[asciinema]: asciinema.md
+
+<!-- others -->

knowledge base/asciinema.md

@@ -0,0 +1,59 @@
+# Asciinema
+
+Terminal session recorder.
+
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
+## TL;DR
+
+```sh
+# Installation.
+sudo apt-get install asciinema
+brew install 'asciinema'
+sudo dnf install 'asciinema'
+sudo pacman -S 'asciinema'
+python3 -m 'pip' install --user 'asciinema'
+
+# Record sessions locally.
+asciinema rec 'path/to/file.cast'
+asciinema rec -i 2 'path/to/file.cast' --overwrite
+
+# Record sessions and upload them to the website.
+asciinema rec
+
+# Play local sessions.
+asciinema play 'path/to/file.cast'
+
+# Share local recordings on the website.
+asciinema upload 'path/to/file.cast'
+```
+
+## Further readings
+
+- [Website]
+- [Github]
+- [`agg`][agg] to convert cast files into GIFs
+
+## Sources
+
+All the references in the [further readings] section, plus the following:
+
+<!--
+  references
+  -->
+
+<!-- project -->
+[github]: https://github.com/asciinema/asciinema
+[website]: https://asciinema.org/
+
+<!-- article sections -->
+[further readings]: #further-readings
+
+<!-- knowledge base -->
+[agg]: agg.md
+
+<!-- others -->

knowledge base/log a terminal session.md

@@ -1,3 +0,0 @@
-# Log (record) a terminal session
-
-See [`script`](script.md).

knowledge base/log aka record a terminal session.md

@@ -0,0 +1,6 @@
+# Log (record) a terminal session
+
+See:
+
+- [`script`](script.md)
+- [Asciinema](asciinema.md)