Quarto: один файл замість PowerPoint, конспекту і сайту для студентів

💡 Усі статті, обговорення, новини про Python — в одному місці. Приєднуйтесь до Python спільноти!

Кожен, хто викладає технічні дисципліни, знає цей цикл: готуєш лекцію в PowerPoint, робиш скріншоти коду — бо вставити живий код у слайди незручно, — потім окремо оформлюєш конспект, окремо думаєш, як студенти відкриють це з телефону. На виході три різних файли, які треба синхронізувати вручну.

Розповідаю, як за допомогою коду створити одразу і слайди, і звіти, і документи, і візуалізації, і сайт, щоб доступ до матеріалів був у всіх і з телефону, і з лептопа.

Що таке Quarto і навіщо він викладачеві

Quarto — науково-технічна система публікації з відкритим кодом. Ідея проста: ви пишете один файл (.qmd), а система сама генерує з нього все, що потрібно.

З одного файлу одним рендером отримуєте:

• HTML-сторінку — студенти відкривають з телефону без жодних додатків
• PDF або Word — для друку чи офіційної документації
• Інтерактивну презентацію на базі Reveal JS

Змінили дані в розрахунках — не треба переробляти графіки і вручну правити цифри по всьому документу. Quarto оновлює все автоматично.

Чому це особливо корисно для технічних курсів

Quarto побудований на концепції літературного програмування: текст лекції і живий код існують в одному документі. Python або R-код виконується при рендері, результат одразу вбудовується в матеріал.

Для студентів є окрема корисна функція — анотований код. Ви додаєте нумеровані пояснення до конкретних рядків, студент клікає на цифру — і система підсвічує відповідний рядок з поясненням. Замість «дивіться рядок 12» — інтерактивна навігація по коду прямо в браузері.

Що вміють презентації в Quarto

Презентації в Quarto — повноцінний інструмент для живої лекції:

• Клавіша C — малюєш прямо на слайді
• Клавіша B — відкриваєш чисту віртуальну дошку
• Режим доповідача — нотатки і таймінг видно тільки тобі
• Інтерактивні віджети — можна вбудувати калькулятор або вікно, де студенти запускають код прямо в браузері

Як це влаштовано технічно

Документ складається з трьох частин:

1. YAML-шапка — метаінформація: назва, автор, формат виводу
2. Текст у Markdown — заголовки, списки, виділення
3. Чанки коду — блоки з Python або R, де відбуваються розрахунки і будуються графіки

Ви самі вирішуєте, що бачать студенти: можна показати тільки результат і сховати код, можна навпаки — зробити акцент на самому коді.

Скільки часу це займає

Підготовка якісної лекції не стає миттєвою, але в парі з AI-помічниками (Copilot у VS Code або RStudio) процес прискорюється суттєво — за досвідом, на 70-80%. ШІ добре генерує структуру Markdown і діаграми Mermaid прямо всередині документа.

З чого почати

Офіційна документація з прикладами — quarto.org. Для старту достатньо VS Code і розширення Quarto. Якщо вже працюєте в RStudio — підтримка вбудована з коробки.