mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-13 17:21:50 +00:00
129 lines
11 KiB
Markdown
129 lines
11 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 Edition |
|
|
| ------------------------------------------------------------------------------------------------------------------ | ---------------- |
|
|
|
|
рдпрд╣ рдХрдард┐рди рд╣реИред рдЬрдм рдЖрдк рдкрд╣рд▓реА рдмрд╛рд░ рдХреБрдЫ рдХрд░рддреЗ рд╣реИрдВ рддреЛ рдпрд╣ рд╣рдореЗрд╢рд╛ рдХрдард┐рди рд╣реЛрддрд╛ рд╣реИред рдЦрд╛рд╕рдХрд░ рдЬрдм рдЖрдк рд╕рд╣рдпреЛрдЧ рдХрд░ рд░рд╣реЗ рд╣реЛрдВ, рддреЛ рдЧрд▓рддрд┐рдпрд╛рдБ рдХрд░рдирд╛ рдХреЛрдИ рд╕рд╣рдЬ рдмрд╛рдд рдирд╣реАрдВ рд╣реИред рд▓реЗрдХрд┐рди рдУрдкрди рд╕реЛрд░реНрд╕ рдХрд╛ рдорддрд▓рдм рд╕рд╣рдпреЛрдЧ рдФрд░ рд╕рд╛рде рдорд┐рд▓рдХрд░ рдХрд╛рдо рдХрд░рдирд╛ рд╣реИред рд╣рдо рдирдП рдУрдкрди-рд╕реЛрд░реНрд╕ рдпреЛрдЧрджрд╛рдирдХрд░реНрддрд╛рдУрдВ рдХреЗ рд╕реАрдЦрдиреЗ рдФрд░ рдкрд╣рд▓реА рдмрд╛рд░ рдпреЛрдЧрджрд╛рди рдХрд░рдиреЗ рдХреЗ рддрд░реАрдХреЗ рдХреЛ рд╕рд░рд▓ рдмрдирд╛рдирд╛ рдЪрд╛рд╣рддреЗ рдереЗред
|
|
|
|
рд▓реЗрдЦ рдкрдврд╝рдирд╛ рдФрд░ рдЯреНрдпреВрдЯреЛрд░рд┐рдпрд▓ рджреЗрдЦрдирд╛ рдорджрджрдЧрд╛рд░ рд╣реЛ рд╕рдХрддрд╛ рд╣реИ, рд▓реЗрдХрд┐рди рдмрд┐рдирд╛ рдХреБрдЫ рдЧрдбрд╝рдмрдбрд╝ рдХрд┐рдП рд╡рд╛рд╕реНрддрд╡ рдореЗрдВ рдХрд╛рдо рдХрд░рдиреЗ рд╕реЗ рдмреЗрд╣рддрд░ рдХреНрдпрд╛ рд╣реЛ рд╕рдХрддрд╛ рд╣реИред рдЗрд╕ рдкрд░рд┐рдпреЛрдЬрдирд╛ рдХрд╛ рдЙрджреНрджреЗрд╢реНрдп рдорд╛рд░реНрдЧрджрд░реНрд╢рди рдкреНрд░рджрд╛рди рдХрд░рдирд╛ рдФрд░ рдиреМрд╕рд┐рдЦрд┐рдпреЛрдВ рджреНрд╡рд╛рд░рд╛ рдЕрдкрдирд╛ рдкрд╣рд▓рд╛ рдпреЛрдЧрджрд╛рди рдХрд░рдиреЗ рдХреЗ рддрд░реАрдХреЗ рдХреЛ рд╕рд░рд▓ рдмрдирд╛рдирд╛ рд╣реИред рдпрд╛рдж рд░рдЦреЗрдВ рдХрд┐ рдЖрдк рдЬрд┐рддрдиреЗ рдЕрдзрд┐рдХ рд╕рд╣рдЬ рд╣реЛрдВрдЧреЗ, рдЖрдк рдЙрддрдирд╛ рд╣реА рдмреЗрд╣рддрд░ рд╕реАрдЦреЗрдВрдЧреЗред рдпрджрд┐ рдЖрдк рдЕрдкрдирд╛ рдкрд╣рд▓рд╛ рдпреЛрдЧрджрд╛рди рдХрд░рдирд╛ рдЪрд╛рд╣рддреЗ рд╣реИрдВ рддреЛ рдмрд╕ рдиреАрдЪреЗ рджрд┐рдП рдЧрдП рд╕рд░рд▓ рдЪрд░рдгреЛрдВ рдХрд╛ рдкрд╛рд▓рди рдХрд░реЗрдВред рд╣рдо рдЖрдкрд╕реЗ рд╡рд╛рджрд╛ рдХрд░рддреЗ рд╣реИрдВ, рдпрд╣ рдордЬреЗрджрд╛рд░ рд╣реЛрдЧрд╛ред
|
|
|
|
рдпрджрд┐ рдЖрдкрдХреЗ рдкрд╛рд╕ рд╡рд┐рдВрдбреЛрдЬрд╝ рдорд╢реАрди рдкрд░ Git Bash рдирд╣реАрдВ рд╣реИ, [рддреЛ рдЗрд╕реЗ рдЗрдВрд╕реНрдЯреЙрд▓ рдХрд░реЗрдВ](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" />
|
|
|
|
## рдЗрд╕ рд░рд┐рдкреЛрдЬрд┐рдЯрд░реА рдХреЛ рдлреЛрд░реНрдХ рдХрд░реЗрдВ
|
|
|
|
рдЗрд╕ рдкреЗрдЬ рдХреЗ рдКрдкрд░ рджрд╛рдИрдВ рдУрд░ рджрд┐рдП рдЧрдП рдлреЛрд░реНрдХ рдмрдЯрди рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░рдХреЗ рдЗрд╕ рд░рд┐рдкреЛ рдХреЛ рдлреЛрд░реНрдХ рдХрд░реЗрдВред
|
|
рдЗрд╕рд╕реЗ рдЖрдкрдХреЗ рдЦрд╛рддреЗ рдореЗрдВ рдЗрд╕ рд░рд┐рдкреЛ рдХреА рдПрдХ рдХреЙрдкреА рдмрди рдЬрд╛рдПрдЧреАред
|
|
|
|
## рд░рд┐рдкреЛрдЬрд┐рдЯрд░реА рдХреЛ рдХреНрд▓реЛрди рдХрд░реЗрдВ
|
|
|
|
рдЕрдм рдЗрд╕ рд░реЗрдкреЛ рдХреЛ рдЕрдкрдиреА рдорд╢реАрди рдкрд░ рдХреНрд▓реЛрди рдХрд░реЗрдВред
|
|
|
|
рдорд╣рддреНрд╡рдкреВрд░реНрдг: рдореВрд▓ рд░реЗрдкреЛ рдХреЛ рдХреНрд▓реЛрди рди рдХрд░реЗрдВред рдЕрдкрдиреЗ рдлреЛрд░реНрдХ рдкрд░ рдЬрд╛рдПрдВ рдФрд░ рдЗрд╕реЗ рдХреНрд▓реЛрди рдХрд░реЗрдВред
|
|
|
|
рд░реЗрдкреЛ рдХреЛ рдХреНрд▓реЛрди рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП, "рдХреЛрдб" рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ рдФрд░ рдлрд┐рд░ рдиреАрдЪреЗ рд╕реНрдЯреНрд░рд┐рдВрдЧ рдХреЛ рдХреЙрдкреА рдХрд░реЗрдВред
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copy string" />
|
|
|
|
рдЖрдкрдиреЗ рдЕрднреА рдЬреЛ git bash рдПрдкреНрд▓реАрдХреЗрд╢рди рдбрд╛рдЙрдирд▓реЛрдб рдХрд┐рдпрд╛ рд╣реИ рдЙрд╕реЗ рдЦреЛрд▓реЗрдВред рдЕрдЧрд░ рдпрд╣ рд╡рд┐рдВрдбреЛрдЬрд╝ рдорд╢реАрди рдкрд░ рд╣реИ рддреЛ рдпрд╣ рдиреАрдЪреЗ рджреА рдЧрдИ рдЫрд╡рд┐ рдХреА рддрд░рд╣ рджрд┐рдЦрд╛рдИ рджреЗрдЧрд╛ред
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="open git bash terminal" />
|
|
|
|
рдЗрд╕ рдХрдорд╛рдВрдб рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░рдХреЗ рдЙрд╕ рдлрд╝реЛрд▓реНрдбрд░ рдкрд░ рдЬрд╛рдПрдБ рдЬрд╣рд╛рдБ рдЖрдк рдЗрд╕ рдкреНрд░реЛрдЬреЗрдХреНрдЯ рдХреЛ рд╕рд╣реЗрдЬрдирд╛ рдЪрд╛рд╣рддреЗ рд╣реИрдВ
|
|
|
|
`cd <folder>`
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-2.png" alt="cd into a folder" />
|
|
|
|
рдЗрд╕ рдХрдорд╛рдВрдб рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░рдХреЗ рд░рд┐рдкреЙрдЬрд┐рдЯрд░реА рдХреЛ рдХреНрд▓реЛрди рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП рдКрдкрд░ рджрд┐рдП рдЧрдП рдЪрд░рдг рдореЗрдВ рдЖрдкрдХреЗ рджреНрд╡рд╛рд░рд╛ рдХреЙрдкреА рдХреА рдЧрдИ рд╕реНрдЯреНрд░рд┐рдВрдЧ рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░реЗрдВ
|
|
|
|
`git clone <repo-url>`
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-2.png" alt="clone the repository" />
|
|
|
|
рдЙрд╕ рдирд┐рд░реНрджреЗрд╢рд┐рдХрд╛ рдкрд░ рдЬрд╛рдПрдВ рдЬрд╣рд╛рдВ рд░реЗрдкреЛ рд╣реИ рдФрд░ рдЕрдкрдиреЗ рдкрд░рд┐рд╡рд░реНрддрди рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП рдЗрд╕реЗ рд╡реАрдПрд╕ рдХреЛрдб рдкрд░ рдЦреЛрд▓реЗрдВред
|
|
|
|
<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" />
|
|
|
|
## рдПрдХ рд╢рд╛рдЦрд╛ рдмрдирд╛рдПрдВ
|
|
|
|
рдЕрдм рдЗрд╕ рд╕рд░рд▓ рдХрдорд╛рдВрдб рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░рдХреЗ рдПрдХ рд╢рд╛рдЦрд╛ рдмрдирд╛рдПрдБред рдпрд╣ рдХрдорд╛рдВрдб рди рдХреЗрд╡рд▓ рдЖрдкрдХреЗ рд▓рд┐рдП рдПрдХ рд╢рд╛рдЦрд╛ рдмрдирд╛рддрд╛ рд╣реИ рдмрд▓реНрдХрд┐ рдЖрдкрдХреЛ рдЙрд╕ рд╢рд╛рдЦрд╛ рдкрд░ рд╕реНрд╡рд┐рдЪ рдХрд░рдиреЗ рдХреА рд╕реБрд╡рд┐рдзрд╛ рднреА рджреЗрддрд╛ рд╣реИред
|
|
|
|
```
|
|
git checkout -b <branch-name>
|
|
```
|
|
|
|
рдЕрдкрдиреА рд╢рд╛рдЦрд╛ рдХрд╛ рдирд╛рдо `<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" />
|
|
|
|
## рдЖрд╡рд╢реНрдпрдХ рдкрд░рд┐рд╡рд░реНрддрди рдХрд░реЗрдВ рдФрд░ рдЙрди рдкрд░рд┐рд╡рд░реНрддрдиреЛрдВ рдХреЛ рд▓рд╛рдЧреВ рдХрд░реЗрдВ
|
|
|
|
рдЕрдм `Contributors.md` рдлрд╝рд╛рдЗрд▓ рдХреЛ рдЯреЗрдХреНрд╕реНрдЯ рдПрдбрд┐рдЯрд░ рдореЗрдВ рдЦреЛрд▓реЗрдВ, рдкреЗрдЬ рдХреЗ рдиреАрдЪреЗ рд╕реНрдХреНрд░реЙрд▓ рдХрд░реЗрдВ рдФрд░ рдЙрд╕рдореЗрдВ рдЕрдкрдирд╛ рдирд╛рдо рдЬреЛрдбрд╝реЗрдВ, рдлрд┐рд░ рдлрд╝рд╛рдЗрд▓ рдХреЛ рд╕реЗрд╡ рдХрд░реЗрдВред
|
|
|
|
рдЙрджрд╛рд╣рд░рдг: рдпрджрд┐ рдЖрдкрдХрд╛ рдирд╛рдо James Smith рд╣реИ, рддреЛ рдпрд╣ рдЗрд╕ рддрд░рд╣ рджрд┐рдЦрдирд╛ рдЪрд╛рд╣рд┐рдПред
|
|
|
|
[James Smith](https://github.com/jamessmith)
|
|
|
|
рдЖрдк рдХреЗрд╡рд▓ рдпрд╣ рдЖрджреЗрд╢ рдЪрд▓рд╛рдХрд░ рджреЗрдЦ рд╕рдХрддреЗ рд╣реИрдВ рдХрд┐ Contributors.md рдореЗрдВ рдкрд░рд┐рд╡рд░реНрддрди рд╣реБрдП рд╣реИрдВ
|
|
|
|
`git status`
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="check the status" />
|
|
|
|
рдЕрдм рдЙрди рдкрд░рд┐рд╡рд░реНрддрдиреЛрдВ рдХреЛ рдкреНрд░рддрд┐рдмрджреНрдз рдХрд░реЗрдВ:
|
|
|
|
рд╕рдмрд╕реЗ рдкрд╣рд▓реЗ рдЖрдкрдХреЗ рджреНрд╡рд╛рд░рд╛ рдХрд┐рдП рдЧрдП рдкрд░рд┐рд╡рд░реНрддрди рдХреЛ рд╕реНрдЯреЗрдЬрд┐рдВрдЧ рдХреНрд╖реЗрддреНрд░ рдореЗрдВ рдЬреЛрдбрд╝реЗрдВ
|
|
|
|
`git add file-name`
|
|
|
|
рдлрд┐рд░ рдЗрд╕ рдХрдорд╛рдВрдб рдХреЛ рдЧрд╛рдХрд░ рдПрдХ рдХрдорд┐рдЯ рд╕рдВрджреЗрд╢ рд▓рд┐рдЦреЗрдВ
|
|
|
|
`git commit -m "Add your-name to Contributors list"`
|
|
|
|
`<your-name>` рдХреЛ рдЕрдкрдиреЗ рдирд╛рдо рд╕реЗ рдмрджрд▓реЗрдВред
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit changes" />
|
|
|
|
рдпрд╣ рджреЗрдЦрдиреЗ рдХреЗ рд▓рд┐рдП рдХрд┐ рдХреНрдпрд╛ рдЖрдкрдХрд╛ рдХрдорд┐рдЯ рд╣реЛ рдЧрдпрд╛ рд╣реИ, рдЖрдк рдПрдХ рд╕рд░рд▓ `git log --oneline` рдХрдорд╛рдВрдб рдЪрд▓рд╛ рд╕рдХрддреЗ рд╣реИрдВред
|
|
|
|
## рдкрд░рд┐рд╡рд░реНрддрдиреЛрдВ рдХреЛ github рдкрд░ рднреЗрдЬреЗрдВ
|
|
|
|
рдПрдХ рдмрд╛рд░ рдЬрдм рдЖрдк рдЙрдкрд░реЛрдХреНрдд рдЪрд░рдгреЛрдВ рдХреЛ рдкреВрд░рд╛ рдХрд░ рд▓реЗрдВ рддреЛ рдЖрдк рдЗрд╕ рдХрдорд╛рдВрдб рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░рдХреЗ рдЕрдкрдиреЗ рдкрд░рд┐рд╡рд░реНрддрдиреЛрдВ рдХреЛ рдкреБрд╢ рдХрд░ рд╕рдХрддреЗ рд╣реИрдВ
|
|
|
|
`git push origin <branch-name>`
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-push.png" alt="push changes" />
|
|
|
|
## рдЕрдкрдиреЗ рдкрд░рд┐рд╡рд░реНрддрди рд╕рдореАрдХреНрд╖рд╛ рдХреЗ рд▓рд┐рдП рд╕рдмрдорд┐рдЯ рдХрд░реЗрдВ
|
|
|
|
рдпрджрд┐ рдЖрдк рдЧрд┐рдЯрд╣рдм рдкрд░ рдЕрдкрдиреЗ рд░рд┐рдкреЙрдЬрд┐рдЯрд░реА рдореЗрдВ рдЬрд╛рддреЗ рд╣реИрдВ, рддреЛ рдЖрдкрдХреЛ `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" />
|
|
|
|
рдЕрдм рдкреБрд▓ рдЕрдиреБрд░реЛрдз рд╕рдмрдорд┐рдЯ рдХрд░реЗрдВ.
|
|
|
|
<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_ рд╡рд░реНрдХрдлрд╝реНрд▓реЛ рдкреВрд░рд╛ рдХрд┐рдпрд╛ рд╣реИ, рдЬрд┐рд╕рдХрд╛ рд╕рд╛рдордирд╛ рдЖрдк рдПрдХ рдпреЛрдЧрджрд╛рдирдХрд░реНрддрд╛ рдХреЗ рд░реВрдк рдореЗрдВ рдЕрдХреНрд╕рд░ рдХрд░реЗрдВрдЧреЗ!
|
|
|
|
рдЕрдкрдиреЗ рдпреЛрдЧрджрд╛рди рдХрд╛ рдЬрд╢реНрди рдордирд╛рдПрдБ рдФрд░ [рд╡реЗрдм рдРрдк](https://firstcontributions.github.io#social-share) рдкрд░ рдЬрд╛рдХрд░ рдЗрд╕реЗ рдЕрдкрдиреЗ рджреЛрд╕реНрддреЛрдВ рдФрд░ рдлрд╝реЙрд▓реЛрдЕрд░реНрд╕ рдХреЗ рд╕рд╛рде рд╢реЗрдпрд░ рдХрд░реЗрдВред
|
|
|
|
рдпрджрд┐ рдЖрдкрдХреЛ рдХрд┐рд╕реА рд╕рд╣рд╛рдпрддрд╛ рдХреА рдЖрд╡рд╢реНрдпрдХрддрд╛ рд╣реЛ рдпрд╛ рдХреЛрдИ рдкреНрд░рд╢реНрди рд╣реЛ рддреЛ рдЖрдк рд╣рдорд╛рд░реА рд╕реНрд▓реИрдХ рдЯреАрдо рдореЗрдВ рд╢рд╛рдорд┐рд▓ рд╣реЛ рд╕рдХрддреЗ рд╣реИрдВред [рд╕реНрд▓реИрдХ рдЯреАрдо рдореЗрдВ рд╢рд╛рдорд┐рд▓ рд╣реЛрдВ](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)
|