Как записывать демо в терминале и CLI, за которыми реально успевают

Демонстрации в терминале — одни из самых полезных видео, которые может сделать разработчик. И одни из самых тяжёлых для просмотра. Крошечный моноширинный шрифт, стена прокручивающегося вывода, команда, уезжающая за верхний край экрана раньше, чем её успевают прочитать, — и зритель сдаётся на второй минуте.

Решение почти целиком лежит в подготовке. Читаемая запись терминала создаётся до нажатия кнопки записи, а не спасается после. Вот весь процесс целиком.

Почему записи терминала так тяжело смотреть

В записи графического интерфейса есть визуальные ориентиры: кнопки, иконки, компоновка. В терминале их нет. Всё одного размера, одного цвета и быстро движется. Проблемы всегда одни и те же:

• Слишком мелкий текст: кегль, удобный на расстоянии вытянутой руки, нечитаем в видео 1080p, запущенном в маленьком окне
• Малоконтрастные темы: тусклый серый на почти чёрном выглядит изящно на мониторе и исчезает после сжатия видео
• Вывод, который уезжает: нужная строка пролетает, пока вы ещё рассказываете о команде
• Невидимый ввод: зритель не видит нажатий клавиш, поэтому быстро набранный флаг выглядит как фокус
• Пустое время: установка, сборка и прогон тестов дают тридцать секунд, в которые ничего не происходит

Каждая из этих проблем решается меньше чем за пять минут.

Настройте терминал до записи

Относитесь к демонстрационному терминалу как к отдельной среде, не совпадающей с рабочей. Большинство терминалов поддерживают профили — создайте профиль «Recording» и настройте его один раз.

• Кегль 18–24 pt: примерно вдвое больше обычного. Если на мониторе это выглядит нелепо, для видео размер, скорее всего, подходящий
• Контрастная тема: светлый текст на сплошном тёмном фоне. Полностью откажитесь от прозрачности и фоновых изображений — они плохо сжимаются и добавляют визуальный шум
• Размер окна, а не полный экран: слишком большой полноэкранный терминал уменьшает текст относительно кадра. Окно шириной 90–100 колонок хорошо заполняет кадр 16:9
• Отключите лигатуры, если они сбивают с толку: красивые стрелки вместо -> и != путают тех, кто переписывает ваши команды
• Немного увеличьте межстрочный интервал: небольшой воздух заметно облегчает чтение плотного вывода

Приведите в порядок оболочку

Промпт и история хранят больше, чем вам кажется. Перед записью:

• Упростите промпт: длинный промпт с веткой Git, версией Node, отметкой времени и путём в две строки съедает ширину и отвлекает. Идеален короткий ~/project $
• Скройте имя пользователя и хоста: они идентифицируют вас и вашу машину в видео, которое вы, возможно, опубликуете
• Очистите буфер прокрутки и историю: предыдущие команды могут раскрыть имена клиентов, внутренние хосты или посторонние задачи
• Проверьте переменные окружения: вывод env в видео утёк больше API-ключей, чем любой фрагмент кода
• Используйте одноразовый каталог: чистая папка проекта избавит вывод ls от посторонних файлов
• Отключите уведомления: и системный звонок терминала, и всплывающие окна одинаково портят дубль

Если демо затрагивает настоящие учётные данные, используйте фиктивные значения. Замазывать их на монтаже гораздо дольше, чем заранее задать API_KEY=demo-key-1234.

Продумайте последовательность команд

Запишите команды до записи — в черновой файл, а не по памяти. Короткий сценарий с точным перечнем того, что и в каком порядке вы наберёте, даёт три вещи: он не даёт опечататься в напряжении, удерживает демо на прямой линии и сразу становится планом закадрового текста.

Затем пройдите всё целиком без записи. Так вскрываются сюрпризы: уже прогретый кеш, недостающая зависимость, забытый запрос на подтверждение. После прогона верните каталог в исходное состояние, чтобы запись стартовала с той же точки.

Настройки записи для работы в терминале

Содержимое терминала — почти целиком статичный текст, поэтому в чём-то оно снисходительно, а в чём-то требовательно.

• Снимайте окно, а не весь экран: захват окна держит кадр плотно на терминале и скрывает остальной рабочий стол
• 30 кадров/с более чем достаточно: тексту не нужны 60 кадров/с. Более низкая частота к тому же даёт более чёткий текст при том же битрейте
• Пишите в родном разрешении дисплея: размытие возникает именно от последующего увеличения текста
• Откажитесь от веб-камеры или сделайте её маленькой: в демо терминала главное — вывод. Крупная картинка в картинке закрывает нижний угол, а именно там появляются новые строки

Темп: то, что чаще всего делают неправильно

Ритм хорошей демонстрации в терминале — не тот ритм, в котором вы работаете.

1. Скажите, что собираетесь сделать, прежде чем набирать: «Сейчас установлю CLI глобально»
2. Печатайте ровно и размеренно — медленнее обычного, но без нарочитой замедленности
3. Сделайте паузу перед Enter, чтобы команда целиком была видна и её успели прочитать
4. Молчите, пока идёт вывод, и говорите уже после
5. Показывайте главное, а не зачитывайте весь вывод вслух

Длинные команды набирайте в два видимых шага — сначала основную команду, затем флаги — и поясняйте назначение каждого флага. Так следить намного легче, чем за строкой в сорок символов, появившейся разом.

Что делать с долгими командами

Никто не хочет смотреть на npm install длиной в полторы минуты. Есть три хороших варианта:

• Плавное ускорение: команда остаётся на экране, а ожидание идёт на скорости 4x–10x — зритель видит, что это произошло, но не ждёт вместе с вами
• Вырезать ожидание: режьте от запуска команды до момента перед появлением результата. Если резать по строке промпта, склейка незаметна
• Прогреть кеш: выполните команду один раз до записи, и в дубле она естественным образом завершится за секунды

Что бы вы ни выбрали, проговорите реальную длительность — «обычно это занимает около двух минут», — чтобы никто не удивился, повторяя у себя.

Сделайте вывод читаемым на монтаже

Именно монтаж превращает неплохую запись терминала в хорошую.

• Приближайте важный вывод: зум на три значимые строки работает несравнимо лучше, чем предложение всматриваться в экран, забитый логами
• Добавляйте текстовые наложения для ключевых команд: команда в виде подписи даёт зрителю что читать, пока вы говорите
• Комментируйте сообщения об ошибках: если вы намеренно показываете сбой, подсветите строку с объяснением
• Добавьте главы: Установка, Настройка, Первый запуск, Разбор проблем — за демо в терминале повторяют, и зрителям нужно возвращаться назад
• Уберите тишину: автоматическое удаление пауз подтянет промежутки вокруг команд, не затрагивая вашу подачу

Терминал вместе с другими окнами

Реальные демо редко состоят из одного терминала. Вы выполняете команду, проверяете браузер, правите конфиг.

• Определите раскладку до записи: терминал и браузер рядом или переключение в полноэкранном режиме — выберите одно и держитесь этого
• Перед переключением окна сделайте паузу: дайте зрителю полсекунды осознать смену картинки, прежде чем продолжать говорить
• Держите единый кегль: крупный шрифт терминала рядом с мелким шрифтом редактора делает редактор нечитаемым
• Рассмотрите захват области: при фиксированной раскладке из двух окон захват этой области сохраняет стабильную композицию на всё видео

Чек-лист перед записью

[ ] Профиль записи активен: крупный шрифт, контрастная тема, без прозрачности
[ ] Промпт упрощён, имя пользователя и хоста скрыты
[ ] Буфер прокрутки и история очищены
[ ] Секреты заменены фиктивными значениями
[ ] Последовательность команд выписана и прогнана один раз
[ ] Рабочий каталог возвращён в чистое состояние
[ ] Уведомления и звонок терминала отключены
[ ] Выбран захват окна, 30 кадров/с, родное разрешение
[ ] Десятисекундная проба проверена на читаемость

Последний пункт важнее всех. Запишите десять секунд, воспроизведите в том размере, в каком видео реально будут смотреть, и спросите себя, комфортно ли читается текст. Если нет — увеличьте шрифт и проверьте ещё раз, прежде чем браться за двенадцатиминутный дубль.

Частые ошибки

• Полноэкранная запись на 4K-дисплее: в экспортированном видео текст становится микроскопическим
• Постоянная очистка экрана: зритель теряет связь с тем, что только что произошло
• Изменение размера терминала во время записи: текст переформатируется, и это режет глаз
• Чтение вывода дословно: лучше обобщайте — «все двенадцать тестов проходят»
• Мигающий курсор на застывшем кадре: обрезайте такие хвосты, из-за них видео кажется зависшим
• Уверенность, что все знают ваши алиасы: если набираете gs, скажите, что это git status

Заключение

Успех демо в терминале определяется читаемостью. Крупный шрифт, контрастная тема, чистый промпт, отрепетированная последовательность и такт паузы перед каждым Enter. Дальше зум и плавное ускорение на монтаже удержат внимание там, где важен вывод. Сделайте так — и ваши разборы командной строки перестанут быть тем, что терпят, и станут тем, что повторяют с открытым рядом терминалом.