Записи терминала

Запись asciinema (asciicast v2 или v3) — это изображение, файл которого оканчивается на .cast:

![cast](demo.cast)
![The failing build](demo.cast#t=12.5)

Синтаксис

Файл читается из папки презентации: URL, абсолютный путь или путь, выходящий за пределы папки, отклоняется. Альтернативный текст называет запись для программ чтения с экрана; одно слово cast означает собственное название записи. #t=12.5 или #t=1:23 в минутах и секундах выбирает момент, который показывают выходы, не способные двигаться; без него это конец записи.

Что показывает каждый выход

• HTML (страница и предпросмотр в playground): запись воспроизводится в небольшом проигрывателе go-slides, встроенном в страницу: воспроизведение и пауза, кнопка скорости и полоса позиции. Он не загружает скриптов ниоткуда и не использует сеть.
• PDF, PowerPoint и OpenDocument (--pdf, --pptx, --odp): терминал в момент, который указывает #t=, как векторный текст моноширинным шрифтом темы, с цветами 16, 256 и прямыми, полужирным, курсивом, подчёркиванием и инвертированным текстом. Текст можно выделять и искать. Это никогда не картинка. Полужирный и курсив рисуются там, где моноширинный шрифт темы их имеет (Roboto Mono в теме gaia).

Проигрыватель

Он проигрывает один раз, когда запись впервые появляется на экране. Когда браузер просит меньше движения (prefers-reduced-motion), он стартует на паузе, показывая момент, который указывает #t=, и проигрывает, когда вы нажимаете воспроизведение. Его кнопки и клавиши не переключают слайд.

Ограничения

Запись — это недоверенный ввод, поэтому она ограничена: файл (16 MiB), события (500 000), длительность (3 часа), терминал (400 на 200 ячеек) и работа, которую может выполнить эмулятор. Запись, превышающая ограничение или не являющаяся правильно составленным файлом asciicast, отклоняется: сборка продолжается, слайд показывает на её месте заметку, а проблема становится предупреждением с кодом: cast.syntax, cast.limit, cast.version или cast.path.

В playground

Добавьте файл .cast в проект из панели «Файлы», перетащив его или через выбор файлов. Он попадает в media/ и вставляется как изображение. Это текст, который читает презентация, поэтому он учитывается вместе с другими текстовыми файлами проекта, ограниченными 2 MiB. Попробуйте в playground.