mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-13 17:21:50 +00:00
Kostiantyn Semenenko
143 lines
8.6 KiB
Markdown
143 lines
8.6 KiB
Markdown
[](https://github.com/ellerbrock/open-source-badges/)
|
|
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-old-version-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
|
[](https://opensource.org/licenses/MIT)
|
|
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
|
|
|
# Перші внески
|
|
|
|
| <img alt="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> | Версія з Git Bash |
|
|
| ------------------------------------------------------------------------------------------------------------------ | ----------------- |
|
|
|
|
Це складно. Завжди складно робити щось уперше. Особливо, коли ви працюєте у команді — помилятися завжди некомфортно. Але open source — це саме про співпрацю та командну роботу. Ми хотіли спростити спосіб, у який новачки в open-source навчаються та роблять свій перший внесок.
|
|
|
|
Читати статті й дивитися відеоуроки корисно, але немає нічого кращого, ніж спробувати на практиці без ризику щось зіпсувати. Цей проєкт має на меті зробити зрозумілий посібник і спростити спосіб, у який новачки роблять свій перший внесок. Пам’ятайте: чим спокійніше вам, тим краще ви навчаєтесь. Якщо ви хочете зробити свій перший внесок — просто дотримуйтесь інструкцій нижче. Обіцяємо — це буде весело!
|
|
|
|
Якщо у вас немає Git Bash на Windows, [встановіть його](https://git-scm.com/download/win).
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt="fork this repository" />
|
|
|
|
## Форкніть цей репозиторій
|
|
|
|
Натисніть кнопку Fork у верхньому правому куті цієї сторінки.
|
|
Це створить копію репозиторію у вашому акаунті.
|
|
|
|
## Клонуйте репозиторій
|
|
|
|
Тепер клонуйте репозиторій на ваш комп'ютер.
|
|
|
|
ВАЖЛИВО: НЕ КЛОНУЙТЕ ОРИГІНАЛЬНИЙ РЕПОЗИТОРІЙ. Перейдіть до вашого форку і клонуте його.
|
|
|
|
Щоб клонувати, натисніть на "Code" і скопіюйте запропонований рядок.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copy string" />
|
|
|
|
Відкрийте програму git bash, яку ви щойно встановили. Вона має виглядати як на наступній картинці, якщо ви використовуєте операційну систему Windows.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="open git bash terminal" />
|
|
|
|
Перейдіть до папки, куди хочете зберегти проєкт, використовуючи наступну команду:
|
|
|
|
```bash
|
|
cd <папка>
|
|
```
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-2.png" alt="cd into a folder" />
|
|
|
|
Вставте скопійований раніше рядок і виконайте команду клонування:
|
|
|
|
```bash
|
|
git clone <url-репозиторію>
|
|
```
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-2.png" alt="clone the repository" />
|
|
|
|
Перейдіть у директорію репозиторію та відкрийте його у VS Code для редагування.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-3.png" alt="cd into the newly cloned repo" />
|
|
|
|
## Створіть гілку (branch)
|
|
|
|
Використайте наступну просту команду для створення гілки. Ця команда не тільки створює нову гілку, а також переходить на цю гілку.
|
|
|
|
```bash
|
|
git checkout -b <назва-гілки>
|
|
```
|
|
|
|
Назвіть свою гілку у форматі `<add-your-name>`, наприклад: `add-james-smith`
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-branch.png" alt="create a branch" />
|
|
|
|
## Зробіть необхідні зміни і зафіксуйте їх (commit)
|
|
|
|
Відкрийте файл `Contributors.md` у текстовому редакторі, додайте ваше ім'я внизу сторінки і збережіть файл:
|
|
|
|
Приклад: якщо ваше ім’я — James Smith, результат повинен виглядати так.
|
|
|
|
\[James Smith](https://github.com/jamessmith)
|
|
|
|
Перевірте зміни командою:
|
|
|
|
```bash
|
|
git status
|
|
```
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="check the status" />
|
|
|
|
Зафіксуйте ці зміни:
|
|
|
|
Спочатку додайте зміну, яку ви зробили, до області індексації (staging area), використовуючи команду:
|
|
|
|
```bash
|
|
git add ім'я_файлу
|
|
```
|
|
|
|
Потім напишіть повідомлення до коміту за допомогою цієї команди:
|
|
|
|
```bash
|
|
git commit -m "Add <ваше-ім'я> to Contributors list"
|
|
```
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit changes" />
|
|
|
|
Щоб перевірити історію комітів:
|
|
|
|
```bash
|
|
git log --oneline
|
|
```
|
|
|
|
## Відправте зміни на GitHub
|
|
|
|
Коли ви завершите виконання наведених вище кроків, ви можете надіслати свої зміни за допомогою цієї команди:
|
|
|
|
```bash
|
|
git push origin <назва-гілки>
|
|
```
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-push.png" alt="push changes" />
|
|
|
|
## Надішліть запит для перевірки
|
|
|
|
Перейдіть до вашого репозиторію на GitHub. Ви побачите кнопку "Compare & pull request". Натисніть її.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="create a pull request" />
|
|
|
|
Після цього відправте pull request.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="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)
|