44 KiB
Введення
Ви знаєте всі ці зображення коду в Twitter? Хоча код зазивчай вражає, ми побачили місце для вдосконалення у естетичному плані. Carbon полегшує створення та обмін чудовими зображеннями коду. То що ти чекаєш? Вперед здивовувати всіх своїх підписників новими дизайнерськими шматочками коду.
Особливості
- Налаштування. Налаштуйте такі речі, як тему синтаксису вашого зображення, стиль шрифту тощо
- Поділіться швидко. Збережіть своє зображення або посилання на нього одним клацанням миші
- Збереження фрагментів. Створіть обліковий запис, щоб зберегти фрагмети на потім. Спільні фрагменти автоматично розгортають в Twitter та Slack.
Використання
Імпорт
Існує кілька різних способів імпорту коду в Carbon:
- Перекиньте файл у редактор
- Додайте GitHub gist ID до URL-адреси (e.g.
carbon.now.sh/<gist_id_помістіть_сюди>) - Або просто починайте друкувати!
Налаштування
Помістивши ваш код до Carbon, ви можете налаштувати своє зображення, змінивши тему синтаксису, колір тла, тему вікна, відступів, тіней, шрифтів тощо.
Експорт та спільний доступ
Після того, як ви налаштували своє зображення, ви можете поділитися своїм фрагментом кількома способами
Створіть збережений фрагмент
Спільний доступ до збереженого фрагмента автоматично опублікує зображення на таких платформах, як Twitter і Slack. Це дозволяє користувачам бачити ваше творіння, а також надає їм доступ до вихідного коду за посиланням. А ще краще, якщо вам потрібно зробити оновлення, просто перейдіть за посиланням та відредагуйте фрагмент.
Для того щоб створити збережений фрагмент:
- Увійдіть використовуючи кнопки "Sign in" або "Sign up"
- Редагуйте, як зазвичай — ваш фрагмент збережеться автоматично
- Скопіюйте URL-адресу з вікна веб-переглядача та діліться з ким завгодно!
Вбудований фрагмент
Це рекомендований спосіб обміну Carbon на вашому власному веб-сайті або в блозі. Читачі, навіть, можуть скопіювати код одним натисканням кнопки.
Ви можете вбудувати будь-який фрагмент коду Carbon на власному веб-сайті за допомогою URL-адреси carbon.now.sh/embed. "Меню копіювання" дозволяє швидко скопіювати правильний iFrame фрагмент, або URL для вбудування на платформах, як Medium.
Нарешті, ви можете вбудувати збережені фрагменти або GitHub gist, використовуючи carbon.now.sh/embed/:id.
Використовуйте кнопку Tweet
Кнопка Tweet не лише дозволить поділитися зображенням у Twitter, але й правильно закодує alt текст щоб упевнитися, що ваші зображення будуть доступні. Однак, якщо ви хочете твітнути зображення самостійно, перевірте як зробити ваші зображення у Twitter доступними.
Завантажте зображення напряму
Carbon підтримує завантаження вашого зображення у форматах PNG та SVG. Ви також можете натиснути Експорт → Відкрити, щоб відкрити зображення безпосередньо у браузері. Нарешті, ви можете скопіювати Carbon зображення безпосередньо у буфер обміну, перейшовши до пункту Копіювати → Зображення.
Встановлення Carbon на комп'ютер (Offline)
Якщо ви використовуєте Google Chrome або інший браузер, який підтримує Progressive Web Apps, ви можете встановити Carbon для використання в автономному режимі, виконавши такі дії:
- Перейдіть carbon.now.sh
- Натисніть на меню налаштувань браузера
- Натисніть "Встановити Carbon..."
Спільнота
Ознайомтеся з цими проєктами, які створила наша дивовижна спільнота:
Плагіни для редакторів
- IntelliJ IDEA
carbon-now-sh- Відкрийте виділення у поточному файлі IntelliJ IDEA у Carbon за допомогою контекстного меню - Atom
carbon-now-sh- Відкрийте поточний Atom файл в Carbon за допомогою командиshift-cmd-A - VS Code
carbon-now-sh- Відкрийте поточний VS Code файл в Carbon за допомогою командиcarbon - Sublime Text 3
carbon-now-sh- Відкрийте виділення у поточному файлі Sublime Text 3 за допомогою спеціально пов’язаного ключа - Vim
carbon-now-sh- Відкрийте виділення у вашому поточному Vim / Neovim за допомогою функціїCarbonNowSh() - Emacs
carbon-now-sh- Відкрийте вибір у вашому поточному Emacs за допомогою інтерактивної функціїcarbon-now-sh - Xcode
carbon-now-sh- Відкрийте ваш поточний вибір уcarbon.now.sh - Xcode
nef- Це розширення Xcode дозволяє експортувати виділений код, як фрагмент Carbon за одну дію
Інструменти
- CLI
carbon-now-cli- Відкрийте файл у Carbon або завантажте його безпосередньо за допомогоюcarbon-now, що включає інтерактивний режим, вибіркове підсвічування тощо. - CodeExpander - Розумний GitHub gist клієнт з функціями TextExpander.
nef- Експорт кількох фрагментів Carbon коду ізXcode Playground.@carbonshbot- Telegram чат-бот, який бере фрагмент коду або посилання на gist та генерує Carbon зображення.- R
carbonate- Ітеративно маніпулюйте естетикою зображення у символіRі відкривайте у Carbon або завантажуйте напряму.
Цитати
- "CS 101 - An Introduction to Computational Thinking" - підручник з інформатики від Sarbo Roy.
Автори
Carbon - це проєкт від:
- Mike Fix (@mfix22)
- Brian Dennis (@briandennis)
- Jake Dexheimer (@jakedex)
Ліцензія
Сприяння та підтримка
PR вітаються! Будь ласка, перегляньте наші рекомендації для більш детальної інформації.
Спонсори
Дякуємо
▲ Vercel за спонсорство хостингу Carbon.
Усі учасники
Подяка всім цим чудовим людям (emoji key):
