В Telegram удобно рассказать, что я собрал за вечер. Показывать там сложный эксперимент уже веселее: код сворачивается, таблица уезжает, а интерактивная кнопка философски смотрит в пустоту.
Поэтому появился Papper — отдельная полка для материалов канала «Лось в проде».
Три вида материалов
Статья хранится в Markdown и собирается в обычную быструю страницу. Для заметок, инструкций и результатов замеров этого хватает.
Эксперимент получает своё демо. Оно открывается внутри статьи и отдельной ссылкой на весь экран.
Мини-сервис может работать на любом стеке. Nginx подключит его к маршруту внутри papper.xedoc.ru, а статья останется документацией и входной точкой.
Как всё связано с каналом
В канале остаётся живая история: что запустил, где удивился и сколько часов добровольно отдал очередному конфигу. В конце поста появляется ссылка сюда.
На Papper лежат детали, которые пригодятся через месяц: команды, диаграммы, исходники, ограничения и работающий результат. Ссылку можно обновить, а старый пост продолжит вести в актуальную версию материала.
Что под капотом
Основной сайт собран на Astro. При публикации Markdown превращается в статический HTML, поэтому для чтения не нужен Node-процесс или база данных.
Интерактивные демо лежат в /labs. Если эксперименту понадобится Python, Go или своя база, он получит контейнер и отдельный маршрут. Так один странный вечер с WebSocket не сможет уронить весь архив. По крайней мере, это план :D