mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-13 17:21:50 +00:00
Roshanjossey
131 lines
6.7 KiB
Markdown
131 lines
6.7 KiB
Markdown
[](https://github.com/ellerbrock/open-source-badges/)
|
|
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/Readme/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)
|
|
|
|
|
|
# Iminikelo Yokuqala
|
|
|
|
Sifuna ukusiza nokubonisa abanikeli abasha indlela yokuqala ngokunikela. Uma ufuna ukunikela kokuqala, landela lezinyathelo ezilandelayo.
|
|
|
|
#### *Uma ungakhululekile ngomugqa womyalo, [nazi izifundo ezisebenzisa amathuluzi we-GUI.](#Izinto-ezengeziwe)*
|
|
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
|
|
|
|
|
Uma ungenayo i-git kumshini wakho, [ifake]( https://help.github.com/articles/set-up-git/).
|
|
|
|
## Fometha le ndawo yokugcina
|
|
|
|
Fometha le repo ngokuchofoza inkinobho yemfoloko phezulu kwaleli khasi. Lokhu kuzokhipha ikhophi yalesi sikhwama ku-akhawunti yakho.
|
|
|
|
## Qalisa i-repository
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
|
|
|
Manje faka i-repo efakwe emshini wakho kumshini wakho. Yiya ku-akhawunti yakho ye-GitHub, vula i-repo evuliwe, chofoza inkinobho ye-clone bese uchofoza ikhophi ku-clipboard icon.
|
|
|
|
Vula i-console bese ugijima umyalo we-git:
|
|
|
|
```bash
|
|
git clone "url you just copied"
|
|
```
|
|
lapho "u-url osuvele ukopishe khona" (ngaphandle kwama-quote marks) yi-url kule ndawo yokugcina (ifomu lakho lephrojekthi). Bona izinyathelo zangaphambilini ukuthola i-url.
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
|
|
|
|
|
Ngokwesibonelo:
|
|
|
|
```bash
|
|
git clone https://github.com/this-is-you/first-contributions.git
|
|
```
|
|
|
|
La kubalwe `this-is-you` faka i-username yakho yaku GitHub. Lapha ukopisha okuqukethwe kokulondoloza kokuqala ku-GitHub kwikhompyutha yakho.
|
|
|
|
## Dala igatsha
|
|
|
|
Shintsha kwirekhodi lokugcina ekhompyutheni yakho (uma ungasekho kakade):
|
|
|
|
```bash
|
|
cd first-contributions
|
|
```
|
|
|
|
Manje dala igatsha usebenzisa `git checkout` umyalo:
|
|
|
|
```bash
|
|
git checkout -b <add-igama lakho>
|
|
```
|
|
|
|
Ngokwesibonelo
|
|
|
|
```bash
|
|
git checkout -b engeza-adam-kowalski
|
|
```
|
|
(Igama legatsha alidingi ukuba izwi engeza kuwo, kodwa into enengqondo ukufaka ngoba inhloso yaleli gatsha ukwengeza igama lakho uhlu.)
|
|
|
|
## Yenza ushintsho oludingekile bese wenza lezo zinguquko
|
|
|
|
Manje `Contributors.md` ifayela evulekile kumhleli wombhalo, engeza igama lakho kuyo. Ungayifaki ekuqaleni noma ekupheleni kwefayela. Beka noma kuphi phakathi. Manje, londoloza ifayela.
|
|
|
|
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
|
|
|
Uma uya encwadini yomhlahlandlela bese wenza umyalo `git status`, uzobona kukhona izinguquko.
|
|
|
|
|
|
Engeza lezo zinguquko egatsheni owake wadala usebenzisa `git add` umyalo:
|
|
|
|
```bash
|
|
git add Contributors.md
|
|
```
|
|
|
|
Manje yenza lezo zinguquko usebenzisa `git commit` umyalo:
|
|
|
|
```bash
|
|
git commit -m "Add <your-name> to Contributors list"
|
|
```
|
|
|
|
ukufaka esikhundleni `<your-name>` ngegama lakho.
|
|
|
|
## Shintsha izinguquko ku-GitHub
|
|
|
|
Pusha izinguquko zakho ngokusebenzisa umyalo `git push`:
|
|
|
|
```bash
|
|
git push origin <add-your-branch-name>
|
|
```
|
|
|
|
kufaka esikhundleni `<add-your-branch-name>` igama legatsha owadala ngaphambilini.
|
|
|
|
## Thumela izinguquko zakho ukuze zibuyekezwe
|
|
|
|
Uma uya endaweni yakho yokugcina ku-GitHub, uzobona `Compare & pull request` inkinobho. Chofoza kuleyo nkinobho.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
|
|
|
Manje thumela isicelo sokudonsa.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
|
|
|
Ngizohlanganisa zonke izinguquko zakho ngokushesha zibe yigatsha eliyinhloko laphrojekthi. Uzothola i-imeyili yesaziso uma izinguquko sezihlanganisiwe.
|
|
|
|
## Ungaphi lapho?
|
|
|
|
Siyakuhalalisela! Usanda kuqedela umshini ojwayelekile -> clone -> edit -> PR ukuhamba komsebenzi ozohlangana ngaso sonke isikhathi njengomnikelo!
|
|
|
|
Gubha umnikelo wakho bese uwabelana nabangani bakho nabalandeli ngokuya kuhlelo [lokusebenza lewebhu](https://firstcontributions.github.io/#social-share).
|
|
|
|
Ungakwazi ukujoyina ithimba lethu elihle uma kwenzeka udinga noma yiluphi usizo noma unemibuzo. [Joyina ithimba le-slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
|
|
|
Manje ake siqale ngokunikela ngeminye imiklamo. Senze uhlu lwamaphrojekthi ngezinkinga ezilula ongaqala ngazo. Hlola [uhlu lwamaphrojekthi kuhlelo lokusebenza lewebhu .](https://firstcontributions.github.io/#project-list).
|
|
|
|
### [Izinto ezengeziwe](../additional-material/git_workflow_scenarios/additional-material.md)
|
|
|
|
|
|
## Izinto ezengeziwe
|
|
|
|
| <a href="../gui-tool-tutorials/github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="../gui-tool-tutorials/github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a> | <a href="../gui-tool-tutorials/gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="100"></a> | <a href="../gui-tool-tutorials/github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/1/1c/Visual_Studio_Code_1.35_icon.png" width=100></a> | <a href="../gui-tool-tutorials/sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a> | <a href="../gui-tool-tutorials/github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/9c/IntelliJ_IDEA_Icon.svg/512px-IntelliJ_IDEA_Icon.svg.png" width=100></a> |
|
|
| --- | --- | --- | --- | --- | --- |
|
|
| [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |
|