carbon/docs

Введення

Ви знаєте всі ці зображення коду в Twitter? Хоча код зазивчай вражає, ми побачили місце для вдосконалення у естетичному плані. Carbon полегшує створення та обмін чудовими зображеннями коду. То що ти чекаєш? Вперед здивовувати всіх своїх підписників новими дизайнерськими шматочками коду.

Особливості

• Налаштування. Налаштуйте такі речі, як тему синтаксису вашого зображення, стиль шрифту, тощо
• Поділіться швидко. Збережіть своє зображення або посилання на нього одним клацанням миші
• Збереження фрагментів. Створіть обліковий запис, щоб зберегти фрагмети на потім. Спільні фрагменти автоматично розгортають в Twitter та Slack.

Використання

Імпорт

Існує кілька різних способів імпорту коду в Carbon:

• Перекиньте файл у редактор
• Додайте GitHub gist ID до URL-адреси (e.g. carbon.now.sh/<gist_id_помістіть_сюди>)
• Або просто починайте друкувати!

Налаштування

Помістивши ваш код до Carbon, ви можете налаштувати своє зображення, змінивши тему синтаксису, колір тла, тему вікна, відступів, тіней, шрифтів тощо.

Експорт та спільний доступ

Після того, як ви налаштували своє зображення, ви можете поділитися своїм фрагментом кількома способами

Створіть збережений фрагмент

Спільний доступ до збереженого фрагмента автоматично опублікує зображення на таких платформах, як Twitter і Slack. Це дозволяє користувачам бачити ваше творіння, а також надає їм доступ до вихідного коду за посиланням. А ще краще, якщо вам потрібно зробити оновлення, просто перейдіть за посиланням та відредагуйте фрагмент.

Для того щоб створити збережений фрагмент:

1. Увійдіть використовуючи "Sign in/Sign up" кнопку
2. Редагуйте, як зазвичай — ваш фрагмент збережеться автоматично
3. Скопіюйте 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 для використання в автономному режимі, виконавши такі дії:

1. Перейдіть carbon.now.sh
2. Натисніть на меню налаштувань браузера
3. Натисніть "Встановити 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):

briandennis 💻 📖 🚇 👀	mfix22 💬 💻 🤔	jakedex 💬 💻 🎨 📹	andrewda 💬 💻 🐛 👀	yeskunall 💻 📖 🔧 🐛	stoshfabricius 💻	jkling38 📖
otobrglez 💻	darahak 📖	dom96 💻	elrumordelaluz 💻	cjb 💻	Krzysztof-Cieslak 💻	fernahh 📖
g3r4n 💻	Mat Gadd 🐛 💻	Brad Davies 🐛 💻	Rafael Câmara 💻	Gleb Bahmutov ⚠️ 🔧	Iván Munguía 💻	Dillon Mulroy 💻
Nihad Abbasov 💻	Hugo Torzuoli 📖	Bruno C. Couto 💻	Mark Molnar 💻	Takahiko Inayama 💻	François Martin 💻	Raphael Amorim 💻
Camron Flanders 💻	Eric Adamski 💻	Winner Crespo 💻 🎨	Milos 💻 🔧 📖 🌍	Yashu Mittal 💻	Rachel M. Carmena 📖	Miguel Salazar 📖 🌍
Vyom Jain 📖 🌍	racaljk 🌍	Sean 💻	Izabela Borges 🌍	Shinil M S 🌍	Berke Atac 🌍	LEE YONGJUN 🌍
Matthew Nielsen 💻	Boy 📦	Vetrivel Chinnasamy 🌍	Farzad YZ 💻 🤔	Yannick Loriot 🌍	Joel Hanson 💻	Muhammad Muzzammil 💻
souppower 🚇	Masato Urai (@uraway_) 🌍	Fernando 🌍	Megha Sachdev 💻 ⚠️	Anudeep Reddy 🚇	Munieru 🌍	Adam Lusted 💻
Jose Noriega 🌍	Merlin Fuchs 🌍	Ramy Majouji 💻	Viktor Nemes 💻	Eric Bailey 💻	Nazeefa 🌍	Pratik Butani 📝
Bakti Aditya 💻	Caleb Taylor 💻	Rogério Munhoz 💻	Technoknol 💻	Tymoteusz Makowski 💻	Nisar Hassan Naqvi 🐛	Ilyas Karim 🐛
Nick Fix 🤔	Melanie Sumner 🤔	aluc 💻	B. Mearns 🤔	Peng Jie 💻	Binyamin Aron Green 💻	Michal 🌍
Quinn Blenkinsop 💻	Dwiferdio Seagal Putra 💻	Ashley Woodall Clark 💻	Tim Wienk 🌍	Jeremy Shih 🌍	George McCarron 📖	Erwin Rahayu 🌍 📖
Luca 💻	Andrew Hayes 💻	Bereket Semagn 💻	Lorenzo Lancia 🌍	Guy Adler 🌍	Dan Bamikiya 🤔	kewang 🌍
Rizda Dwi Prasetya 🖋	AbreuY 🌍	>_Rizky.dev 🌍 📖	Abidemi Harry 💻	Marco 🌍	Sam Robbins 📖	alceil 💻