diff --git a/Contributors.md b/Contributors.md index 68b1550a..97dbdb18 100644 --- a/Contributors.md +++ b/Contributors.md @@ -1052,6 +1052,7 @@ - [square-story](https://github.com/square-story) - [tomasbennett](https://github.com/tomasbennett) - [Rahmatulloh Ibrohim](https://github.com/raxmatulloxswe/) +- [Kostiantyn Semenenko](https://github.com/NureSemenenkoKostiantyn) - [saravanan](https://github.com/saravanan27-learner) - [aidenliu](https://github.com/aiden-liu) - [Ariyan Bhakat](https://github.com/arywk40-hue) diff --git a/docs/cli-tool-tutorials/translations/Ukrainian/git-bash-windows-tutorial.ua.md b/docs/cli-tool-tutorials/translations/Ukrainian/git-bash-windows-tutorial.ua.md new file mode 100644 index 00000000..dbcd5c70 --- /dev/null +++ b/docs/cli-tool-tutorials/translations/Ukrainian/git-bash-windows-tutorial.ua.md @@ -0,0 +1,142 @@ +[![Любов до Open Source](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) +[](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) +[![Ліцензія: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) +[![Помічники Open Source](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) + +# Перші внески + +| Git Bash | Версія з Git Bash | +| ------------------------------------------------------------------------------------------------------------------ | ----------------- | + +Це складно. Завжди складно робити щось уперше. Особливо, коли ви працюєте у команді — помилятися завжди некомфортно. Але open source — це саме про співпрацю та командну роботу. Ми хотіли спростити спосіб, у який новачки в open-source навчаються та роблять свій перший внесок. + +Читати статті й дивитися відеоуроки корисно, але немає нічого кращого, ніж спробувати на практиці без ризику щось зіпсувати. Цей проєкт має на меті зробити зрозумілий посібник і спростити спосіб, у який новачки роблять свій перший внесок. Пам’ятайте: чим спокійніше вам, тим краще ви навчаєтесь. Якщо ви хочете зробити свій перший внесок — просто дотримуйтесь інструкцій нижче. Обіцяємо — це буде весело! + +Якщо у вас немає Git Bash на Windows, [встановіть його](https://git-scm.com/download/win). + +fork this repository + +## Форкніть цей репозиторій + +Натисніть кнопку Fork у верхньому правому куті цієї сторінки. +Це створить копію репозиторію у вашому акаунті. + +## Клонуйте репозиторій + +Тепер клонуйте репозиторій на ваш комп'ютер. + +ВАЖЛИВО: НЕ КЛОНУЙТЕ ОРИГІНАЛЬНИЙ РЕПОЗИТОРІЙ. Перейдіть до вашого форку і клонуте його. + +Щоб клонувати, натисніть на "Code" і скопіюйте запропонований рядок. + +copy string + +Відкрийте програму git bash, яку ви щойно встановили. Вона має виглядати як на наступній картинці, якщо ви використовуєте операційну систему Windows. + +open git bash terminal + +Перейдіть до папки, куди хочете зберегти проєкт, використовуючи наступну команду: + +```bash +cd <папка> +``` + +cd into a folder + +Вставте скопійований раніше рядок і виконайте команду клонування: + +```bash +git clone +``` + +clone the repository + +Перейдіть у директорію репозиторію та відкрийте його у VS Code для редагування. + +cd into the newly cloned repo + +## Створіть гілку (branch) + +Використайте наступну просту команду для створення гілки. Ця команда не тільки створює нову гілку, а також переходить на цю гілку. + +```bash +git checkout -b <назва-гілки> +``` + +Назвіть свою гілку у форматі ``, наприклад: `add-james-smith` + +create a branch + +## Зробіть необхідні зміни і зафіксуйте їх (commit) + +Відкрийте файл `Contributors.md` у текстовому редакторі, додайте ваше ім'я внизу сторінки і збережіть файл: + +Приклад: якщо ваше ім’я — James Smith, результат повинен виглядати так. + +\[James Smith](https://github.com/jamessmith) + +Перевірте зміни командою: + +```bash +git status +``` + +check the status + +Зафіксуйте ці зміни: + +Спочатку додайте зміну, яку ви зробили, до області індексації (staging area), використовуючи команду: + +```bash +git add ім'я_файлу +``` + +Потім напишіть повідомлення до коміту за допомогою цієї команди: + +```bash +git commit -m "Add <ваше-ім'я> to Contributors list" +``` + +commit changes + +Щоб перевірити історію комітів: + +```bash +git log --oneline +``` + +## Відправте зміни на GitHub + +Коли ви завершите виконання наведених вище кроків, ви можете надіслати свої зміни за допомогою цієї команди: + +```bash +git push origin <назва-гілки> +``` + +push changes + +## Надішліть запит для перевірки + +Перейдіть до вашого репозиторію на GitHub. Ви побачите кнопку "Compare & pull request". Натисніть її. + +create a pull request + +Після цього відправте pull request. + +submit pull request + +Незабаром ваші зміни буде об'єднано з основною гілкою проєкту. Ви отримаєте сповіщення електронною поштою після злиття вашої гілки з основною. + +## Що далі? + +Вітаємо! Ви щойно завершили стандартний процес: _fork -> clone -> edit -> PR_! + +Поділіться своєю участю з друзями або підпишіться на нашу спільноту [web app](https://firstcontributions.github.io#social-share). + +Приєднуйтесь до нашої Slack-групи, якщо у вас виникли питання або потрібна допомога: [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +### [Додаткові матеріали](../additional-material/git_workflow_scenarios/additional-material.md) + +## Інструкції для інших інструментів + +[Повернутись на головну сторінку](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)