diff --git a/.all-contributorsrc b/.all-contributorsrc
index a3dd1f7..4fd2e1f 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -18,7 +18,8 @@
"docs/README.ta.md",
"docs/README.tr.md",
"docs/README.tw.md",
- "docs/README.in.md"
+ "docs/README.in.md",
+ "docs/README.ua.md",
],
"imageSize": 100,
"commit": false,
diff --git a/README.md b/README.md
index 95f5203..01ccc38 100644
--- a/README.md
+++ b/README.md
@@ -74,7 +74,10 @@
Indonesia
|
-
+ |
+ Українська
+ |
+
Add +
|
diff --git a/docs/README.ua.md b/docs/README.ua.md
new file mode 100644
index 0000000..06c9c5c
--- /dev/null
+++ b/docs/README.ua.md
@@ -0,0 +1,280 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## Введення
+
+Ви знаєте [всі](https://twitter.com/dan_abramov/status/890191815567175680) [ці](https://twitter.com/reactjs/status/890511993261654017) [зображення коду](https://twitter.com/notquiteleo/status/873483329345028096) в Twitter? Хоча код зазивчай вражає, ми побачили місце для вдосконалення у естетичному плані. Carbon полегшує створення та обмін чудовими зображеннями коду. То що ти чекаєш? Вперед здивовувати всіх своїх підписників новими дизайнерськими шматочками коду.
+
+
+
+
+
+## Особливості
+
+- **Налаштування**. Налаштуйте такі речі, як тему синтаксису вашого зображення, стиль шрифту, тощо
+- **Поділіться швидко**. Збережіть своє зображення або посилання на нього одним клацанням миші
+- **Збереження фрагментів**. Створіть обліковий запис, щоб зберегти фрагмети на потім. Спільні фрагменти автоматично розгортають в Twitter та Slack.
+
+## Використання
+
+#### Імпорт
+
+Існує кілька різних способів імпорту коду в Carbon:
+
+- Перекиньте файл у редактор
+- Додайте GitHub gist ID до URL-адреси (e.g. [`carbon.now.sh/`](https://carbon.now.sh/3208813b324d82a9ebd197e4b1c3bae8))
+- Або просто починайте друкувати!
+
+#### Налаштування
+
+Помістивши ваш код до 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 доступними](https://help.twitter.com/en/using-twitter/picture-descriptions).
+
+##### Завантажте зображення напряму
+
+Carbon підтримує завантаження вашого зображення у форматі PNG та SVG. Ви також можете натиснути `Експорт → Відкрити`, щоб відкрити зображення безпосередньо у браузері. Нарешті, ви можете скопіювати Carbon зображення безпосередньо у буфер обміну, перейшовши до пункту `Копіювати → Зображення`.
+
+#### Встановлення Carbon на комп'ютер (Offline)
+Якщо ви використовуєте Google Chrome або інший браузер, який підтримує Progressive Web Apps, ви можете встановити Carbon для використання в автономному режимі, виконавши такі дії:
+
+1. Перейдіть [carbon.now.sh](https://carbon.now.sh)
+2. Натисніть на меню налаштувань браузера
+3. Натисніть "Встановити Carbon..."
+
+## Спільнота
+
+Ознайомтеся з цими проєктами, які створила наша дивовижна спільнота:
+
+##### Плагіни для редакторів
+
+- [IntelliJ IDEA `carbon-now-sh`](https://plugins.jetbrains.com/plugin/10469-carbon-now-sh) - Відкрийте виділення у поточному файлі IntelliJ IDEA у Carbon за допомогою контекстного меню
+- [Atom `carbon-now-sh`](https://atom.io/packages/carbon-now-sh) - Відкрийте поточний Atom файл в Carbon за допомогою команди `shift-cmd-A`
+- [VS Code `carbon-now-sh`](https://marketplace.visualstudio.com/items?itemName=ericadamski.carbon-now-sh) - Відкрийте поточний VS Code файл в Carbon за допомогою команди `carbon`
+- [Sublime Text 3 `carbon-now-sh`](https://github.com/molnarmark/carbonSublime) - Відкрийте виділення у поточному файлі Sublime Text 3 за допомогою спеціально пов’язаного ключа
+- [Vim `carbon-now-sh`](https://github.com/kristijanhusak/vim-carbon-now-sh) - Відкрийте виділення у вашому поточному Vim / Neovim за допомогою функції `CarbonNowSh()`
+- [Emacs `carbon-now-sh`](https://github.com/veelenga/carbon-now-sh.el) - Відкрийте вибір у вашому поточному Emacs за допомогою інтерактивної функції `carbon-now-sh`
+- [Xcode `carbon-now-sh`](https://github.com/StevenMagdy/CarboNow4Xcode) - Відкрийте ваш поточний вибір у `carbon.now.sh`
+- [Xcode `nef`](https://github.com/bow-swift/nef-plugin) - Це розширення Xcode дозволяє експортувати виділений код, як фрагмент Carbon за одну дію
+
+##### Інструменти
+
+- [CLI `carbon-now-cli`](https://github.com/mixn/carbon-now-cli) - Відкрийте файл у Carbon або завантажте його безпосередньо за допомогою `carbon-now`, що включає інтерактивний режим, вибіркове підсвічування, тощо.
+- [CodeExpander](https://codeexpander.com) - Розумний GitHub gist клієнт з функціями TextExpander.
+- [`nef`](https://github.com/bow-swift/nef#-exporting-carbon-code-snippets) - Експорт кількох фрагментів Carbon коду із `Xcode Playground`.
+- [`@carbonshbot`](https://t.me/carbonshbot) - Telegram чат-бот, який бере фрагмент коду або посилання на gist та генерує Carbon зображення.
+- [R `carbonate`](https://yonicd.github.io/carbonate/) - Ітеративно маніпулюйте естетикою зображення у символі `R` і відкривайте у Carbon або завантажуйте напряму.
+
+##### Цитати
+
+- ["CS 101 - An Introduction to Computational Thinking"](https://itunes.apple.com/us/book/id1435714196) - підручник з інформатики від Sarbo Roy.
+
+## Автори
+
+Carbon - це проєкт від:
+
+- Mike Fix ([@mfix22](https://twitter.com/fixitup2))
+- Brian Dennis ([@briandennis](https://github.com/briandennis))
+- Jake Dexheimer ([@jakedex](https://github.com/jakedex))
+
+#### Ліцензія
+
+[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fcarbon-app%2Fcarbon.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fcarbon-app%2Fcarbon?ref=badge_large)
+
+
+
+
+---
+
+## Сприяння та підтримка
+
+PR вітаються! Будь ласка, перегляньте наші [рекомендації](/.github/CONTRIBUTING.md) для більш детальної інформації.
+
+### Спонсори
+
+
+
+
+
+
+
+
+
+
+
+
+### Дякуємо
+
+[ ▲ Vercel ](https://vercel.com/) за спонсорство хостингу Carbon.
+
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/import/git?s=https%3A%2F%2Fgithub.com%2Fcarbon-app%2Fcarbon&project-name=carbon&repo-name=carbon)
+
+### Усі учасники
+
+Подяка всім цим чудовим людям ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):
+
+
+
+
+
+
+
+
+
+