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

Запис 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.