Slides: терминальные слайды на Linux

Презентации со слайдами остаются ключевым способом донести информацию до аудитории в бизнесе и образовании. Однако визуальные украшения и переходы часто отнимают время и отвлекают от сути. Slides — это терминальное приложение для Linux, которое рендерит Markdown в последовательность слайдов и позволяет вести показ прямо в терминале.

Важные преимущества терминальных слайдов:

• Простота подготовки: Markdown — минималистичный синтаксис, его быстро освоить
• Концентрированный контент: без отвлекающих переходов и излишних декоративных элементов
• Код и вывод вживую: можно показывать исполняемые блоки кода при наличии поддержки терминала
• Легкая версия для резервного копирования и совместной работы: просто хранить файлы в Git

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

Кому Slides подходит лучше всего

• Инженерам и разработчикам, демонстрирующим код
• Техническим преподавателям, читающим лекции в аудиториях с терминалом
• Командам, использующим Git и предпочитающим текстовый рабочий процесс
• Тем, кто хочет быструю и надежную презентацию без графических изысков

Когда терминальные слайды не подойдут

• Для маркетинговых и брендовых презентаций с высокими визуальными требованиями
• Для конференций, где ожидается анимация, видео и сложная типографика
• Для событий с большим экраном и аудиторией, привыкшей к крупным визуальным эффектам

Сильные стороны:

• Скорость создания и правки
• Удобство версионирования и совместной разработки
• Возможность запуска и демонстрации кода вживую

Ограничения:

• Ограниченная визуальная выразительность
• Зависимость от возможностей терминала для отображения изображений
• Не всегда подходит для непрофессиональных аудиторий, ожидающих «красивую» графику

Slides принимает Markdown-файл и показывает его как последовательность слайдов. Разделы слайдов отделяются тройным дефисом на отдельной строке. Блоки кода можно показывать как код или исполнять и выводить результат прямо в слайдах.

Термин “Markdown” в одном предложении: это простой язык разметки для форматирования текста с минимумом синтаксиса.

Slides написан на языке Go. Для установки потребуется Go на машине.

1. Если в системе есть поддержка snap-пакетов, сначала установите Go (пример для систем с snap):

sudo snap install go --classic

2. Затем установите Slides через систему установки Go:

go install github.com/maaslalani/slides@latest

3. Для пользователей Arch Linux Slides доступен в AUR. Установка через yay:

yay -S slides

4. В Snap Store есть сборка Slides, но в ней могут быть ограничения при выполнении кода из слайдов. Если вы не используете запуск кода из презентации, можно установить как snap:

sudo snap install slides

После установки бинарник slides оказывается в каталоге, доступном для запуска. Убедитесь, что путь к Go bin добавлен в переменную PATH, если вы устанавливали через go install.

1. Создайте файл с расширением md, например test_slideshow.md

nano test_slideshow.md

2. Пишите содержимое первого слайда как обычный Markdown. Для перехода к следующему слайду вставьте тройной дефис на отдельной строке:

# Заголовок первого слайда

Текст и пункты списка

---

# Заголовок второго слайда

Еще текст

3. Основные элементы Markdown поддерживаются: заголовки, списки, таблицы, цитаты, жирный/курсив и блоки кода.

4. Запуск презентации:

slides test_slideshow.md

Slides поддерживает показ блоков кода для множества языков: bash, python, javascript, elixir, go и др. Формат блока кода: три обратные кавычки, за ними метка языка.

Пример блока кода bash:

cat foo.txt

Чтобы выполнить код в блоке и показать вывод, в режиме показа слайдов нажмите Ctrl + E. Для предварительной обработки кода используйте три тильды внутри блока и поместите метку языка на первой строке блока. Пример, который выполнит запрос к интернету и покажет результат:

~~~bash
curl wttr.in/chicago
~~~

Примечание по правам: для того чтобы Slides мог предварительно обрабатывать файл, сделайте его исполняемым:

sudo chmod +x test_slideshow.md

Это полезно, если вы встроили в слайды интерактивные отрывки, которые нужно запускать на лету.

Slides читает front matter в начале файла Markdown. Он оформляется тремя дефисами, в которых можно задать тему, автора, дату и шаблон пагинации.

Пример front matter:

---
theme: ./path/to/theme.json
author: Gopher
date: 25 июня 2025
paging: Slide %d / %d
---

• theme: указывает путь к JSON-файлу темы для Glamour или другой поддержки стилизации терминала
• author: автор презентации, по умолчанию текущий пользователь
• date: дата, может быть локализована
• paging: шаблон, который показывает номер текущего слайда

Вы можете транслировать презентацию и подключать зрителей по SSH:

slides serve test_slideshow.md

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

ssh host.machine.ip.address -p 53531

Это полезно для удаленных показов в локальной сети или в защищенных окружениях.

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

• Используйте правило KISS: держите слайды простыми
• Один слайд — одна мысль
• Пункты списка должны быть краткими
• Не читайте слайды слово в слово, говорите дополнительную ценность
• Завершайте слайды коротким take-home сообщением

Краткая техника репетиции:

1. Прогонить презентацию вслух минимум 2 раза
2. Засечь время и убрать лишние слайды, чтобы не превосходить лимит
3. Попрактиковаться с управлением демонстрацией кода, если она есть

Чек-лист для автора слайдов:

• Написать сценарий выступления
• Создать Markdown с разделением тройным дефисом
• Проверить блоки кода и вывод
• Добавить front matter с метаданными
• Протестировать в режиме slides serve при необходимости

Чек-лист для ведущего перед показом:

• Убедиться, что терминал настроен и шрифты читаемы
• Проверить, что файл исполняем, если есть предварительная обработка
• Проверить доступность SSH-порта, если показываете по сети
• Подготовить запасной план: PDF-версия слайдов или локальная копия

Мини-справочник по синтаксису слайдов в Markdown:

• Заголовки: #, ##, ###
• Переход между слайдами: строка с тремя дефисами —
• Списки: -, *, 1.
• Таблицы: стандартный Markdown-таблица
• Блоки кода: lang ... или для предобработки ~lang … ~
• Front matter: в начале файла между тройными дефисами

Пример простого файла:

---
theme: ./theme.json
author: Команда
date: 10 августа 2025
---

# Тема презентации

- Цель 1
- Цель 2

---

# Демонстрация кода

echo “Привет, мир“

---

# Заключение

Краткая мысль для запоминания

Если вам нужна графическая насыщенность, подумайте о следующих вариантах:

• PowerPoint или Keynote для сложной графики и анимации
• Google Slides для совместной редакции в реальном времени
• reveal.js или remark.js для веб-презентаций с кастомизацией через HTML/CSS

Ментальная модель выбора: выберите инструмент, который делает упор либо на содержание и скорость создания (Markdown + Slides), либо на визуальную выразительность (PowerPoint, Keynote). Если нужна гибридность — пишите контент в Markdown и экспортируйте в HTML/PDF для дальнейшей стилизации.

1. Технический митап с демонстрацией кода
2. Внутренние обучения и воркшопы, где важна скорость обновления материалов
3. Документирование процессов в виде презентации вместе с репозиторием кода

Если вы используете блоки кода, которые обращаются к сетевым ресурсам, будьте осторожны с конфиденциальными данными. Не вставляйте API-ключи или пароли в Markdown. Всегда проверяйте, какие команды будут выполняться, если вы получаете файл от внешнего автора.

Рекомендации:

• Храните конфиденциальные данные в переменных окружения, не в файлах слайдов
• Не выполняйте непроверенный код на продакшен-машинах
• При трансляции по SSH используйте защищенные каналы и авторизацию по ключам

Перед тем как считать презентацию готовой, проверьте:

• Все слайды читаемы в терминале с целевыми настройками шрифта
• Блоки кода корректно отображаются и, при необходимости, исполняются
• Front matter соответствует желаемой теме и метаданным
• Презентация уложится по времени, отрепетированная версия не превышает лимит

Проблема: код не исполняется в слайдах

• Причина: установленная snap-сборка может блокировать исполнение
• Решение: установить Slides через go install или AUR, сделать файл исполняемым

Проблема: изображения не показываются

• Причина: терминал не поддерживает inline-изображения
• Решение: либо проверить поддержку терминала, либо использовать текстовые диаграммы

• Правило 5x5: не более 5 пунктов по 5 слов на слайд в большинстве случаев
• Пирамида: сначала основная мысль, затем поддерживающие факты
• Переходы: планируйте вопросы-брейки каждые 10 15 минут

1. Определите ключевую мысль и цель презентации
2. Напишите сценарий и разметьте его заголовками
3. Переведите структуру в Markdown, добавьте front matter
4. Наполните слайды краткими пунктами и кодом при необходимости
5. Проведите репетицию и отредактируйте по времени
6. Подготовьте запасной формат (PDF) и проверьте подключение по SSH

flowchart TD
  A[Нужна богатая графика?] -->|Да| B[PowerPoint или Keynote]
  A -->|Нет| C[Техническая презентация]
  C --> D{Показывать код на лету?}
  D -->|Да| E[Slides в терминале]
  D -->|Нет| F[reveal.js или Google Slides]
  E --> G[Использовать go install или AUR]

Тест-кейсы:

• Открыть презентацию и пройти по всем слайдам без ошибок рендеринга
• Исполнить блок кода и получить ожидаемый вывод
• Проверить отображение таблицы и списка на разных ширинах терминала

Критерии приёмки:

• Нет битых ссылок или синтаксических ошибок в Markdown
• Все интеграции (front matter, tema) применены корректно
• Презентация проходима в пределах отведенного времени

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

Important: протестируйте запись экрана и SSH-трансляцию заранее, особенно в окружениях с ограниченными правами.

• Если вы разработчик или технический преподаватель, попробуйте создать одну небольшую презентацию в Markdown и прогнать ее через Slides
• Добавьте файл в репозиторий, чтобы отслеживать изменения и использовать версионирование
• Подготовьте PDF-резерв и протестируйте показ по SSH

Дополнительные ресурсы и ссылки

• Документация проекта Slides на GitHub
• Руководства по Markdown и Glamour темам

КОНЕЦ