Carbon: код картинкой в Telegram

Вы пишете пост про программирование и вставляете код в канал. В мобильном клиенте он выглядит серо, строки переносятся, отступы съезжают. Carbon в Telegram решает эту проблему: отправляете текст, получаете оформленную картинку. 🖼️

Приложение работает с сервисом Carbon, который известен разработчикам как способ быстро получить красивый снимок исходного кода. Автор бота подключил его к чату, поэтому ничего устанавливать не нужно.

Отправил фрагмент, забрал картинку

Сценарий минимальный. В описании бота сказано: просто пришлите любой текст или фрагмент кода.

1. Откройте чат с ботом и нажмите «Запустить».
2. Вставьте код обычным сообщением. Лучше сразу целым куском, а не по строчке.
3. Заберите изображение и перешлите его туда, где оно нужно.

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

Зачем вообще нужна картинка вместо текста

У Telegram есть свой моноширинный блок для кода, и для обсуждения в чате он удобен: можно скопировать и вставить. Но у картинки свои плюсы.

• Одинаковый вид везде. Шрифт, цвета и отступы не зависят от приложения читателя.
• Подсветка синтаксиса. Ключевые слова, строки и комментарии отличаются цветом, читать проще.
• Подходит для соцсетей и слайдов. Картинку можно вставить в презентацию, статью или обложку поста.

Минус тоже очевиден: из картинки код не скопируешь. Поэтому, если читателю важно запустить пример, добавьте текстовую версию отдельным сообщением.

Как сделать снимок кода читаемым

Хороший скриншот кода отличается не темой оформления, а подготовкой самого фрагмента. Несколько правил, которые работают с любым подобным сервисом.

• Короче лучше. Десять-пятнадцать строк читаются с телефона, сто строк превращаются в мелкую кашу.
• Уберите лишнее. Пустые строки подряд, закомментированный мусор и длинные импорты отвлекают.
• Следите за шириной. Очень длинные строки на узком экране будут слишком мелкими.
• Проверьте отступы. Для языков, где отступ значим, ошибка в пробелах меняет смысл примера.

Что нельзя отправлять в такого бота

Код уходит на обработку, поэтому относитесь к нему как к любому публичному сервису. Не вставляйте ключи доступа, пароли, токены, строки подключения к базе и персональные данные клиентов.

Если фрагмент взят из рабочего проекта, сначала замените секреты заглушками. Привычка проверять текст перед отправкой избавит от неприятных историй с утечками. 🔐

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

Кому пригодится

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