Les appels d'assistance sont importants et souvent satisfaisants en fin de compte, mais l'acte de communication claire peut être ardu pour toutes les personnes impliquées. Si vous avez déjà participé à un appel d'assistance, vous avez probablement passé plusieurs minutes à épeler même les commandes les plus courtes et à expliquer en détail où se situent les espaces et les retours. Bien qu'il soit souvent plus facile de simplement prendre le contrôle de l'ordinateur d'un utilisateur, ce n'est pas vraiment la meilleure façon d'éduquer. Ce que vous pourriez essayer à la place, c'est d'envoyer à un utilisateur un enregistrement d'écran, mais un enregistrement à partir duquel il pourra copier des commandes et les coller dans son propre terminal.
Asciinema est un enregistreur de session de terminal open source. Similaire au script
et scriptreplay
commandes, Asciinema enregistre exactement ce que votre terminal affiche. Il enregistre votre enregistrement "film" dans un fichier texte, puis le rejoue à la demande. Vous pouvez télécharger votre film sur Asciinema.org et le partager comme vous le feriez pour n'importe quelle autre vidéo sur Internet, et vous pouvez même intégrer votre film dans une page Web.
Install Asciinema
Sous Linux, vous pouvez installer Asciinema en utilisant votre gestionnaire de packages.
Sur Fedora, CentOS, Mageia ou similaire :
$ sudo dnf install asciinema
Sur Debian, Linux Mint ou similaire :
$ sudo apt install asciinema
Sur macOS, vous pouvez installer en utilisant Homebrew :
$ sudo brew install asciinema
Sur BSD et toute autre plate-forme utilisant Pkgsrc :
$ cd /usr/pkgsrc/misc/py-asciinema
$ sudo bmake install clean
Créer des films à partir de texte
Pour démarrer l'enregistrement avec Asciinema, vous utilisez le rec
sous-commande :
$ asciinema rec mymovie.cast
asciinema: recording asciicast to mymovie.cast
asciinema: press <ctrl-d> or type "exit" when you're done
Une sortie conviviale vous avertit que vous êtes en train d'enregistrer et vous indique comment arrêter :appuyez sur Ctrl+D ou tapez simplement exit
.
Tout ce que vous faites dans votre terminal pendant qu'Asciinema est actif est enregistré. Cela inclut les entrées, les sorties, les erreurs, les pauses maladroites, les erreurs ou les réussites. Si vous le voyez dans votre terminal pendant l'enregistrement, il fait la coupe.
Lorsque vous avez terminé la démonstration du fonctionnement du terminal, appuyez sur Ctrl+D ou tapez exit
pour arrêter l'enregistrement.
Dans cet exemple, le fichier résultant, mymovie.cast
est une collection d'horodatages et d'actions qui servent de script (au sens de script de film) pour le mécanisme de lecture.
{"version": 2, "width": 139, "height": 36, "timestamp": 1641457358, "env": {"SHELL": "/bin/bash", "TERM": "xterm-256color"}}
[0.05351, "o", "\u001b]0;seth:~\u0007"]
[0.05393, "o", "\u001b[1;31m$ \u001b[00m"]
[1.380059, "o", "e"]
[1.443823, "o", "c"]
[1.514674, "o", "h"]
[1.595238, "o", "o"]
[1.789562, "o", " "]
[2.09658, "o", "\""]
[2.19683, "o", "h"]
[2.403994, "o", "e"]
[2.466784, "o", "l"]
[2.711183, "o", "lo"]
[3.120852, "o", "\""]
[3.427886, "o", "\r\nhello\r\n"]
[...]
Si vous avez fait une erreur, vous pouvez couper l'erreur en supprimant les lignes recréant l'erreur. Si vous vous retrouvez à effectuer de nombreuses modifications ou à faire de longues pauses pendant l'enregistrement, vous pouvez installer et utiliser l'utilitaire asciinema-edit, qui peut découper des blocs de "métrage" en horodatant votre définition ou en éliminant le temps d'inactivité.
Lecture d'un film Asciinema
Vous pouvez lire votre Asciinema en utilisant le play
sous-commande :
$ asciinema play mymovie.cast
Cela prend en charge votre session de terminal et en fait l'équivalent le plus proche de l'écran d'argent tel qu'il est susceptible de l'être (à part le moment où vous avez regardé Star Wars en ASCII sur telnet
). Votre film textuel est lu, montrant à vos utilisateurs exactement comment une tâche complexe est effectuée. Bien sûr, le réel les commandes jouées ne s'exécutent pas réellement. Ce n'est pas un script shell en action, donc même si vous avez créé un fichier hello.txt
dans votre film, il n'y aura pas de nouveau hello.txt
après la lecture. C'est juste pour le spectacle.
Et pourtant, c'est plus qu'un simple spectacle. Vous pouvez mettre en pause les films Asciinema, sélectionner le texte que vous voyez à l'écran et le coller dans un terminal actif pour exécuter la commande. Asciinema est une documentation utile. Il montre aux utilisateurs comment effectuer une tâche et leur permet de copier et coller pour garantir l'exactitude.
Téléchargez votre film Asciinema
Aucun film Asciinema n'a encore atteint le statut de blockbuster, mais vous pouvez néanmoins télécharger le vôtre sur Asciinema.org et le partager avec le monde.
$ asciinema upload mymovie.cast
Plus de ressources Linux
- Aide-mémoire des commandes Linux
- Aide-mémoire des commandes Linux avancées
- Cours en ligne gratuit :Présentation technique de RHEL
- Aide-mémoire sur le réseau Linux
- Aide-mémoire SELinux
- Aide-mémoire sur les commandes courantes de Linux
- Que sont les conteneurs Linux ?
- Nos derniers articles Linux
Si vous êtes habitué aux temps de téléchargement YouTube, vous serez agréablement surpris par la rapidité avec laquelle les films Asciinema sont transférés. Un .cast
Le fichier ne fait généralement que quelques kilo-octets, ou tout au plus quelques mégaoctets, de sorte que le téléchargement est presque instantané. Vous n'avez pas besoin d'un compte pour partager votre film, mais tous les films non réclamés sont supprimés après sept jours. Pour préserver votre chef-d'œuvre, vous pouvez ouvrir un compte sur Asciinema, puis vous asseoir et attendre que l'Académie vous appelle.
Asciinema comme documentation
Asciinema est un excellent moyen de démontrer même les concepts les plus élémentaires. Parce qu'il conserve la possibilité de copier et coller le code de l'enregistrement, offre la possibilité de faire une pause et de jouer à la demande, et est complètement précis dans ce qu'il représente, ce n'est pas aussi bon qu'un enregistrement d'écran. C'est beaucoup, beaucoup mieux. Que vous l'utilisiez pour montrer vos compétences terminales à vos amis ou que vous l'utilisiez pour éduquer des collègues et des étudiants, Asciinema est un outil inestimable, social et accessible.