mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-13 17:21:50 +00:00
remove files i accidently added
This commit is contained in:
true_lock
@@ -1,129 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Eerste Bydraes
|
||||
|
||||
Dit is moeilik. Dit is altyd moeilik om die eerste keer iets te doen. Veral wanneer jy saamwerk, maak foute nie 'n gemaklike ding nie. Ons wou die manier waarop nuwe open source bydraers vir die eerste keer leer en bydra, vereenvoudig.
|
||||
|
||||
Lees artikels en kyk tutoriale kan help, maar wat is beter as om die goed in die praktyk te doen? Hierdie projek het ten doel om leiding te gee en die manier waarop beginners hul eerste bydrae maak, te vereenvoudig. As jy jou eerste bydrae wil maak, volg die onderstaande stappe.
|
||||
|
||||
#### *As jy nie gemaklik is met die opdraglyn nie, [is daar tutoriale wat GUI-instrumente gebruik.](#Bykomende-materiaal )*
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
As jy nie git op jou masjien het nie, [installeer dit]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Vork hierdie bewaarplek
|
||||
|
||||
Vork hierdie repo deur op die vurk knoppie bo-aan hierdie bladsy te klik. Dit sal 'n kopie van hierdie repository in u rekening skep.
|
||||
|
||||
## Klone die repository
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Klone nou die vurk repo aan jou masjien. Gaan na jou GitHub-rekening, maak die vurk repo oop, klik op die kloonknop en klik dan op die kopie na die knipbord- ikoon.
|
||||
|
||||
Open 'n terminaal en voer die volgende git opdrag uit:
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
waar "url jy net gekopieer" het (sonder die aanhalingstekens) is die url na hierdie repository (jou vurk van hierdie projek). Sien die vorige stappe om die url te verkry.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Byvoorbeeld:
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
waar `this-is-youis` jou GitHub gebruikersnaam Hier kopieer jy die inhoud van die eerste bydrae repository in GitHub na jou rekenaar.
|
||||
|
||||
## Skep 'n tak
|
||||
|
||||
Verander na die repository gids op jou rekenaar (as jy nie reeds daar is nie):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Skep nou 'n tak met die git `checkout` opdrag:
|
||||
|
||||
```
|
||||
git checkout -b <add-your-new-branch-name>
|
||||
```
|
||||
|
||||
Byvoorbeeld:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
(Die naam van die tak hoef nie die woord by te voeg nie, maar dit is 'n redelike ding om in te sluit omdat die doel van hierdie tak is om jou naam by 'n lys te voeg.)
|
||||
|
||||
## Maak die nodige veranderinge en verbind die veranderinge
|
||||
|
||||
Nou oop `Contributors.md` lêer in 'n teksredigeerder, voeg jou naam daarby. Moet dit nie aan die begin of einde van die lêer byvoeg nie. Sit dit oral tussenin. Stoor nou die lêer.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
As u na die projekgids gaan en die opdrag uitvoer `git status`, sal u sien dat daar veranderinge is.
|
||||
|
||||
|
||||
Voeg die veranderinge by die tak wat jy net geskep het deur die `git add` opdrag te gebruik:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Doen nou die veranderinge deur die `git commit` opdrag te gebruik:
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
vervang `<your-name>` met jou naam.
|
||||
|
||||
## Druk veranderinge na GitHub
|
||||
|
||||
Druk jou veranderinge deur die opdrag te gebruik `git push`:
|
||||
|
||||
```
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
|
||||
vervang `<add-your-branch-name>` met die naam van die tak wat jy vroeër geskep het.
|
||||
|
||||
## Dien jou veranderinge in vir hersiening
|
||||
|
||||
As jy na jou repository op GitHub gaan, sal jy 'n `Compare & pull` requestknoppie sien. Klik op daardie knoppie.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Dien nou die trekversoek in.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Binnekort sal ek al jou veranderinge in die meestertak van hierdie projek saamsmelt. U sal 'n kennisgewing-e-pos ontvang sodra die veranderinge saamgesmelt is.
|
||||
|
||||
## Waarheen gaan jy vandaan?
|
||||
|
||||
Geluk! Jy het net die standaardvurk voltooi -> klone -> wysig -> PR- werkvloei wat jy dikwels as 'n bydraer sal ervaar!
|
||||
|
||||
Vier jou bydrae en deel dit met jou vriende en volgelinge deur na die [webprogram te](https://firstcontributions.github.io/#social-share) gaan .
|
||||
|
||||
U kan by ons span aansluit indien u enige hulp nodig het of enige vrae het. [Sluit aan by 'n slapende span](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Kom ons begin met die bydrae tot ander projekte. Ons het 'n lys van projekte saamgestel met maklike probleme waarmee u kan begin. Kyk na [die lys van projekte in die web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Bykomende materiaal](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
| <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) | [Visuele Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visuele Studio Kode](../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) |
|
||||
@@ -1,127 +0,0 @@
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Kontributet e Para
|
||||
|
||||
Është gjithmonë e vështirë hera e parë kur bën diçka. Sidomos kur bashkëpunon, të bësh gabime nuk është një ndjenjë e mirë. Ne duam ta thjeshtësojmë mënyrën se si kontribuesit e open-source mësojnë dhe kontribuojnë për herë të parë.
|
||||
Leximi i artikujve & shikimi i tutorialve ndihmojnë, por ç'është më mirë se sa ta bësh këtë gjë në një vend praktike? Ky projekt synon të udhëzojë & të thjeshtësojë mënyrën se si fillestarët bëjnë kontributin e tyre të parë. Nëse dëshiron të bësh kontributin tënd të parë, ndiqi hapat më poshtë.
|
||||
|
||||
#### _Nëse ende nuk ndjehesh komod me command line, [këtu ke tutoriale që përdorin veglat e GUI](#Tutoriale-duke-përdorur-vegla-tjera)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Nëse nuk ke Git të instaluar në pajisjen tënde, [instaloje](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Bëje fork këtë repozitor
|
||||
|
||||
Për të bërë fork këtë repozitor kliko butonin fork në majë të kësaj faqeje. Kjo do të krijojë një kopje të ketij repozitori në llogarinë tënde.
|
||||
|
||||
## Klonoje këtë repozitor
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Tani klonoje në pajisjen tënde repozitorin që bëre fork. Shko te llogaria e GitHub, hap forked repository, kliko butonin Code dhe pastaj kliko ikonën _copy to clipboard_.
|
||||
|
||||
Hap terminalin dhe bëje run git komandën në vazhdim:
|
||||
|
||||
```
|
||||
git clone "url që sapo ke kopjuar"
|
||||
```
|
||||
|
||||
ku "url që sapo ke kopjuar" (pa thonjëzat) është url e këtij repozitori (repozitori që bëre fork). Shiko hapat e mëparshëm për të marrë url-në.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Për shembull:
|
||||
|
||||
```
|
||||
git clone https://github.com/ky-je-ti/first-contributions.git
|
||||
```
|
||||
|
||||
ku `ky-je-ti` është emri jot në GitHub. Këtu ti e kopjon përmbajtjen e repozitorit first-contributions në GitHub te kompjuteri jot.
|
||||
|
||||
## Krijo një degë (branch)
|
||||
|
||||
Ndryshoje lokacionin te repozitori në kompjuterin tënd (nëse nuk je në lokacionin e duhur):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Tani krijo një degë duke përdorur komandën `git checkout`:
|
||||
|
||||
```
|
||||
git checkout -b <emri-i-degës-tënde>
|
||||
```
|
||||
|
||||
Për shembull:
|
||||
|
||||
```
|
||||
git checkout -b add-filan-fisteku
|
||||
```
|
||||
|
||||
(Emri i degës nuk është i nevojshëm të ketë fjalën _add_ në të, por është e arsyeshme të përfshihet pasi që qëllimi i kësaj dege është të shtojë emrin tënd në një listë.)
|
||||
|
||||
## Bëji ndryshimet e nevojshme dhe bëji commit
|
||||
|
||||
Tani hap dosjën `Contributors.md` në një program për editim të tekstit dhe shto emrin tënd. Mos e shto në fillim ose në fund. Shtoje ku të duash në mes. Tani, ruaj dosjën.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Nëse shkon te lokacioni i projektit dhe e ekzekuton komandën `git status`, do shohësh se ka ndryshime.
|
||||
|
||||
Shtoji këto ndryshime te dega që sapo krijove duke përdorur komandën `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Tani bëji commit këto ndryshime duke përdorur komandën `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Add <emri-jot> to Contributors list"
|
||||
```
|
||||
|
||||
zëvendëso `<emri-jot>` me emrin tënd.
|
||||
|
||||
## Bëji push (shtyji) ndryshimet në GitHub
|
||||
|
||||
Bëji push ndryshimet duke përdorur komandën `git push`:
|
||||
|
||||
```
|
||||
git push origin <emri-i-degës-tënde>
|
||||
```
|
||||
|
||||
zëvendëso `<emri-i-degës-tënde>` me emrin e degës që krijove më herët.
|
||||
|
||||
## Paraçiti ndryshimet për shqyrtim
|
||||
|
||||
Nëse shkon te repozitori jot në GitHub, do të shohësh një buton `Compare & pull request`. Klikoje.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Tani paraqisni këtë kërkesë tërheqjeje.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Së shpejti do të bashkoj (bëj merge) të gjitha ndryshimet te dega master e këtij projekti. Ti do të njoftohesh me email kur të bëhen ndryshimet.
|
||||
|
||||
## Ku të shkosh nga këtu?
|
||||
|
||||
Urime! Ti sapo ke kompletuar procesin _fork -> clone -> edit -> PR_ që do ta hasësh shpesh si kontributor!
|
||||
|
||||
Festoje kontributin tënd dhe ndaje me shokët dhe ndjekësit duke shkuar te [web aplikacioni](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Nëse dëshiron më shumë praktikë, shiko [kontributet e kodit](https://github.com/roshanjossey/code-contributions)
|
||||
|
||||
Tani të të ndihmojmë që të kontribuosh në projekte tjera. Ne kemi krijuar një listë projektesh me probleme të lehta tek të cilat mund të fillosh. Shiko [listën e projekteve në web apliacion](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Materiale shtesë](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Tutoriale duke përdorur vegla tjera
|
||||
|
||||
| <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) |
|
||||
@@ -1,124 +0,0 @@
|
||||
[](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/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
# የመጀመሪያ አስተዋጽዖዎች
|
||||
|
||||
ይህ ፕሮጀክት ጀማሪዎች የመጀመሪያ አስተዋጾ የሚያደርጉበትን መንገድ ለማቅለል እና ለመምራት ያለመ ነው። የመጀመሪያዎን አስተዋፅዖ ለማድረግ ከፈለጉ ከታች ያሉትን ደረጃዎች ይከተሉ
|
||||
|
||||
|
||||
#### command line ካልተመቸህ, [GUI መሳሪያዎችን በመጠቀም አጋዥ ስልጠናዎች አሉ።.](#Tutorials-Usin'-Other-Tools)
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
በማሽንዎ ላይ git ከሌለዎት, [ይጫኑት](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Fork this repository
|
||||
|
||||
በዚህ ገጽ ላይኛው ክፍል ላይ ያለውን fork ቁልፍን ጠቅ በማድረግ ይህንን ይጫኑት።
|
||||
ይህ በአንተ መለያ ውስጥ የዚህን repository ቅጂ ይፈጥራል።
|
||||
|
||||
## Clone the repository
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
አሁን Fork ይህን repository ወደ ማሽንዎ. ወደ GitHub መለያዎ ይሂዱ, የእርሶን repository ይክፈቱ. የኮድ ምልክቱን ጠቅ ያድርጉ እና ከዚያ ቅጂውን ምልክቱን ጠቅ ያድርጉ ለመቅዳት.
|
||||
|
||||
```
|
||||
git clone "የቀዱትን url' ያስገቡ"
|
||||
```
|
||||
"የቀዱትን url' ያስገቡ" (ያለ ጥቅስ ምልክቶች) ይህ የዚህ repository url ነው(የእርሶ ቅጂ ፕሮጀክት). url ለማግኘት የቀደመውን ደረጃዎች ይመልከቱ.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
ለምሳሌ:
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
where `this-is-you` የእርስዎ GitHub መለያ ስም ነው።. እዚህ በ GitHub ላይ ያለውን የመጀመሪያ አስተዋፅዖ repository ይዘቶችን ወደ ኮምፒውተርዎ እየገለበጡ ነው።
|
||||
|
||||
## Create a branch(ቅርንጫፍ ይፍጠሩ)
|
||||
|
||||
በኮምፒተርዎ ላይ ያለውን repository ማውጫ ይቀይሩ (እዚያ ከሌለዎት):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
አሁን የ `git checkout` ትዕዛዝን በመጠቀም ቅርንጫፍ ይፍጠሩ:
|
||||
|
||||
```
|
||||
git checkout -b <add-your-new-branch-name>
|
||||
```
|
||||
|
||||
ለምሳሌ:
|
||||
|
||||
```
|
||||
git checkout -b github-ethiopia
|
||||
```
|
||||
|
||||
## አስፈላጊ ለውጦችን ያድርጉ እና ለውጦችን commit ያድርጉ
|
||||
|
||||
አሁን የ Contributors.md ፋይልን በጽሑፍ አርታኢ(editor) ውስጥ ይክፈቱ፣ ስምዎን በእሱ ላይ ያክሉ። በፋይሉ መጀመሪያ ወይም መጨረሻ ላይ አይጨምሩት። በመካከል የትኛውም ቦታ ላይ ያስቀምጡት. አሁን, ፋይሉን ያስቀምጡ(save).
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
ወደ የፕሮጀክት ማውጫው ሄደው የ git status ከፈጸሙ ለውጦች እንዳሉ ያያሉ።
|
||||
|
||||
የ `git add` ትእዛዝን በመጠቀም እነዚያን ለውጦች አሁን በፈጠሩት ቅርንጫፍ ላይ አክል፡
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
አሁን የ `git commit` ትዕዛዝ በመጠቀም እነዚህን ለውጦች ያድርጉ፡
|
||||
|
||||
```
|
||||
git commit -m "Add <የእርስዎ-ስም> to Contributors list"
|
||||
```
|
||||
|
||||
<የእርስዎ-ስም> ፋንታ የራስዎትን ስም ይጻፉ.
|
||||
|
||||
## ለውጦችን ወደ GitHub ይጫኑ
|
||||
|
||||
`git push` የሚለውን ትዕዛዝ በመጠቀም ለውጦችዎን ይጫኑ
|
||||
|
||||
```
|
||||
git push origin <የእርስዎ-branch-name>
|
||||
```
|
||||
|
||||
`<የእርስዎ-branch-name>` ፋንታ የራስዎትን branch ስም ያስገቡ
|
||||
|
||||
## ለውጦችዎን ለግምገማ ያስገቡ
|
||||
|
||||
በ GitHub ላይ ወደ repository ከሄዱ፣ `Compare & pull request` ጥያቄን ያያሉ። በዚያ ቁልፍ ላይ ጠቅ ያድርጉ።
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
አሁን pull request ጥያቄውን ያስገቡ
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
በቅርቡ ሁሉንም ለውጦችዎን ወደ የዚህ ፕሮጀክት ዋና ቅርንጫፍ አዋህዳለሁ. ለውጦቹ ከተዋሃዱ በኋላ የማሳወቂያ ኢሜይል ይደርስዎታል።
|
||||
|
||||
## ከዚህ ወዴት መሄድ አለብዎት ?
|
||||
|
||||
እንኳን ደስ ያለህ! አሁን መደበኛ fork -> clone -> edit -> pull request ሂደትን ጨርሰዋል. እንደ አስተዋጽዖ አበርካች ብዙ ጊዜ ይህ ሂደት ያጋትሞታል
|
||||
|
||||
አስተዋጾዎን ያክብሩ እና ለጓደኞችዎ እና ተከታዮችዎ ያካፍሉ ወደ [ዲህረ ገጾ በመሄድ](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
ማንኛውም እርዳታ ከፈለጉ ወይም ማንኛውም ጥያቄ ካለዎት የእኛን [Slack ቡድን](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY) መቀላቀል ይችላሉ.
|
||||
|
||||
አሁን ለሌሎች ፕሮጀክቶች በማበርከት እንጀምር. እርስዎ ሊጀምሩባቸው የሚችሉ ቀላል ጉዳዮች ያላቸውን የፕሮጀክቶች ዝርዝር አዘጋጅተናል።. [እኚህን ማስፈተሪያ ይከተሉ](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [ተጨማሪ ቁሳቁስ](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## ሌሎች መሳሪያዎችን በመጠቀም አጋዥ ስልጠናዎች
|
||||
|
||||
|<a href="../github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a>|<a href="../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="../gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/Readme/gk-icon.png" width="100"></a>|
|
||||
|---|---|---|
|
||||
|[GitHub Desktop](../github-desktop-tutorial.md)|[Visual Studio 2017](../github-windows-vs2017-tutorial.md)|[GitKraken](../gitkraken-tutorial.md)|
|
||||
@@ -1,146 +0,0 @@
|
||||
## የመጀመሪያ አስተዋፅኦዎች
|
||||
|
||||
ይህ ፕሮጀክት ጀማሪዎች የመጀመሪያ አስተዋጾ የሚያደርጉበትን መንገድ ለማቅለል እና ለመምራት ያለመ ነው። የመጀመሪያዎን አስተዋፅዖ ለማድረግ ከፈለጉ ከታች ያሉትን ደረጃዎች ይከተሉ።
|
||||
|
||||
***በcommand line(ተርሚናል) ካልተመቸዎት፣ [የGUI መሳሪያዎችን ለመጠቀም አጋዥ ስልጠናዎች እዚህ ያገኛሉ።](#tutorials-using-other-tools)***
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
### በማሽንዎ ላይ ጊት(git) ከሌለዎት ፤ [ይጫኑት](https://docs.github.com/en/get-started/quickstart/set-up-git) ።
|
||||
|
||||
## ይህንን ማከማቻ **fork** ያድርጉ
|
||||
|
||||
በዚህ ገጽ ላይኛው ክፍል ላይ ያለውን የfork button ጠቅ በማድረግ ይህንን ማከማቻ fork ያድርጉት።
|
||||
ይህ በአንተ account ውስጥ የዚህን repository ቅጂ ይፈጥራል።
|
||||
|
||||
## የማከማቻውን ተመሳሳይ ይፍጠሩ
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
አሁን fork የተደረገውን ማከማቻ (repository) ቅጂ በማሽንዎ(በኮምፒውተርዎ) ይፍጥሩ። ወደ GitHub (account)መለያዎ ይሂዱ፤ fork የተደረገውን ማከማቻ ይክፈቱ፤ ኮድ የሚለውን button ጠቅ ያድርጉ እና ከዚያ *ወደ clipboard ቅዳ* የሚለውን ጠቅ ያድርጉ::
|
||||
|
||||
ተርሚናል ይክፈቱ እና የሚከተለውን የgit ትዕዛዝ run
|
||||
|
||||
```bash
|
||||
git clone "የቀዱትን url"
|
||||
|
||||
```
|
||||
|
||||
"አሁን የገለበጡት url" (ያለ ጥቅስ ምልክቶቹ) የማከማቻው (የዚህ ፕሮጀክት fork) url ነው። urlን ለማግኘት የቀደመውን ደረጃዎች ይመልከቱ።
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
ለምሳሌ:-
|
||||
|
||||
```bash
|
||||
git clone git@github.com:ይህ-አንተ-ነህ/first-contributions.git
|
||||
|
||||
```
|
||||
|
||||
'ይህ-አንተ-ነህ' የእርሶ GitHub ተጠቃሚ username ነው። አሁን በ GitHub ላይ ያለውን የመጀመሪያ አስተዋፅዖ(first-contributions) ማከማቻ ይዘቶችን ወደ ኮምፒውተርዎ እየገለበጡ ነው።
|
||||
|
||||
## ቅርንጫፍ ይፍጠሩ
|
||||
|
||||
በኮምፒተርዎ ላይ ወዳለው የማከማቻ ማህደር ይግቡ (እዚያው ከሌሉ ማለት ነው!)፡
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
|
||||
```
|
||||
|
||||
አሁን የ‹git switch› ትዕዛዝን በመጠቀም ቅርንጫፍ ይፍጠሩ፡
|
||||
|
||||
```bash
|
||||
git switch -c የእርስዎ-አዲሱ-ቅርንጫፍ-ስም
|
||||
|
||||
```
|
||||
|
||||
ለምሳሌ:-
|
||||
|
||||
```bash
|
||||
git switch -c ይሁን-አለማየሁ
|
||||
|
||||
```
|
||||
|
||||
## አስፈላጊ ለውጦችን ያድርጉ እና ለውጦችን ይፈጥሙ(commit)
|
||||
|
||||
አሁን የ‹[Contributors.md](http://contributors.md/)› ፋይልን በጽሑፍ አርታኢ ውስጥ ይክፈቱ እና ስምዎትን ይጨምሩበት። በፋይሉ መጀመሪያ ወይም መጨረሻ ላይ አይጨምሩት። በመካከል የትኛውም ቦታ ላይ ያስቀምጡት። አሁን, ፋይሉን save ያድርጉ።
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
ወደ የፕሮጀክት ማህደሩ ሄደው ይህን ትዕዛዝ (`git status`) ከፈጸሙ፣ ለውጦች እንዳሉ ያያሉ።
|
||||
|
||||
የ‹git add› ትዕዛዙን በመጠቀም እነዚያን ለውጦች ወደ ፈጠሩት ቅርንጫፍ ያክሉ።
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
|
||||
```
|
||||
|
||||
አሁን የ‹git commit› ትዕዛዙን በመጠቀም እነዚህን ለውጦች ያድርጉ፡:
|
||||
|
||||
```bash
|
||||
git commit -m "የአስተዋጽዖ አበርካቾች ዝርዝር ውስጥ የእርስዎን-ስም ያክሉ"
|
||||
|
||||
```
|
||||
|
||||
'የእርስዎን-ስም' የሚለውን በስምዎ ይተኩ፡፡
|
||||
|
||||
ለውጦችን ወደ GitHub ይግፉ
|
||||
|
||||
‹git push› የሚለውን ትዕዛዝ በመጠቀም ለውጦችዎን ይግፉ፡፡
|
||||
|
||||
```bash
|
||||
git push -u origin የእርስዎ-ቅርንጫፍ-ስም
|
||||
|
||||
```
|
||||
|
||||
ቀደም ብለዉ በፈጠሩት የቅርንጫፍ ስም 'የእርስዎን-ቅርንጫፍ-ስም'ን ይትኩ።
|
||||
|
||||
<details>
|
||||
<summary> <strong>በመግፋት ላይ ማንኛውም ስህተት ካጋጠሞት ፤ እዚህ ጠቅ ያድርግ:</strong> </summary>
|
||||
|
||||
- Authentication Error
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Go to [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account.
|
||||
|
||||
</details>
|
||||
|
||||
## ለውጦችዎን ለግምገማ ያስገቡ
|
||||
|
||||
በ GitHub ላይ ወደ ማከማቻዎ ከሄዱ፣ ‘compare & pull request' የሚለውን ቁልፍ ያያሉ። በዚያ ቁልፍ ላይ ጠቅ ያድርጉ።
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
አሁን pull request ያስገቡ።
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
በቅርቡ ሁሉንም ለውጦችዎን ወደ የዚህ ፕሮጀክት ዋና ቅርንጫፍ አዋህዳቸዋለሁ። ለውጦቹ ከተዋሃዱ በኋላ የማሳወቂያ ኢሜይል ይደርስዎታል።
|
||||
|
||||
## ከዚህስ ወዴት ልሂድ?
|
||||
|
||||
እንኳን ደስ ያሎዎት! ልክ እንደ አስተዋጽዖ አበርካች የሚያጋጥሙትን መደበኛ _fork -> clone -> አርትዕ -> የመሳብ ጥያቄ_ የስራ ፍሰትን አጠናቀዋል!
|
||||
|
||||
አስተዋጾዎን ያጣጣጥሙ እና ወደ ድር በመሄድ ለጓደኞችዎ እና ተከታዮችዎ ያካፍሉ።(https://firstcontributions.github.io/#social-share).
|
||||
|
||||
ማንኛውም እርዳታ ከፈለጉ ወይም ማንኛውም ጥያቄ ካለዎት የእኛን 'slack' ቡድን መቀላቀል ይችላሉ::(https://join.slack.com/t/firstcontributors/shared_invite/zt-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w).
|
||||
|
||||
አሁን ለሌሎች ፕሮጀክቶች በማበርከት እንጀምር። እርስዎ ሊጀምሩባቸው የሚችሉ ቀላል ጉዳዮች ያላቸውን የፕሮጀክቶች ዝርዝር አዘጋጅተናል። በድር መተግበሪያ ውስጥ ያሉትን የፕሮጀክቶች ዝርዝር ይመልከቱ(https://firstcontributions.github.io/#project-list).
|
||||
|
||||
## [ተጨማሪ ቁሳቁስ](https://www.notion.so/additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## የሌሎች መሳሪያዎች አጠቃቀም አጋዥ ስልጠናዎች
|
||||
|
||||
| <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) |
|
||||
|
||||
<p>ይህ ፕሮጀክት የሚደገፈው በ:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,176 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# <div dir="rtl">مساهمتك الأولى</div>
|
||||
|
||||
<div dir="rtl">
|
||||
الصعوبة متوقعة عندما تبدأ بأي عمل جديد، خصوصاً إذا كان العمل يتضمن أشخاصًا آخرين، مما يجعل الوقوع في الخطأ مزعجًا.
|
||||
<br>
|
||||
لكن المساهمة في مشاريع مفتوحة المصدر يتطلب ويتوقع الخطأ ولهذا السبب سيساعدك الآخرون في تصحيح هذا الخطأ.
|
||||
<br>
|
||||
في هذا المشروع هدفنا هو تسهيل الطريق لمساهمتك الأولى.
|
||||
</div>
|
||||
|
||||
<div dir="rtl">
|
||||
قراءة ومتابعة التعليمات المتاحة على الإنترنت ستساعدك بالتأكيد. ومع ذلك، ستستفيد بشكل أكبر إذا استطعت المشاركة في مشروع معين دون الخوف من الوقوع في الأخطاء. يهدف هذا المشروع إلى تقديم توجيهات وإرشادات أولية لمساعدتك في البدء بأول مساهمة لك.
|
||||
|
||||
تذكر أن الخطأ أمر متوقع، والهدف الأسمى هو التعلم من هذه البيئة. نشجعك على أن تركز أثناء متابعة الخطوات التالية لإكمال مساهمتك الأولى. نعدك بأنك ستستمتع بالتجربة وسوف تستفيد منها
|
||||
|
||||
</div>
|
||||
|
||||
<div dir="rtl">
|
||||
إذا لم يكن لديك git على الجهاز الخاص بك،<a href="https://help.github.com/articles/set-up-git/">قم بتثبيته من هنا</a>
|
||||
</div>
|
||||
|
||||
## <div dir="rtl"> افرق هذا المشروع - Fork this Repository </div>
|
||||
|
||||
<img style="float: left;" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
<div dir="rtl">
|
||||
افرق هذا المشروع بالضغط على زر Fork في أعلى هذه الصفحة.
|
||||
من خلال ذلك ستنشأ نسخة من هذا المشروع على حسابك الخاص.
|
||||
</div>
|
||||
|
||||
## <div dir="rtl"> استنسخ هذا المشروع - Clone the repository </div>
|
||||
|
||||
<img style="float: left;" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
<div dir="rtl">
|
||||
استنسخ هذا المشروع على جهازك.
|
||||
انقر على زر Clone ثم انقر على أيقونة Copy to clipboard
|
||||
</div>
|
||||
<img style="float: left;" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
<div dir="rtl">
|
||||
افتح terminal واكتُب الأمر التالي:
|
||||
</div>
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
<div dir="rtl">قم باستبدال "url you just copied" بالرابط الذي نسخته من الخطوة السابقة، هذا الرابط يحتوي على المشروع.</div>
|
||||
|
||||
<div dir="rtl">على سبيل المثال:</div>
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
<div dir="rtl">
|
||||
في هذا المثال لاحظ 'this-is-you' سيكون اسم حسابك في موقع github يليه رابط المشروع الذي فرقته في أول خطوة، هذا الأمر سينسخ محتويات المشروع على جهازك لتتمكن من التعديل عليه بحرية.
|
||||
</div>
|
||||
<br>
|
||||
|
||||
## <div dir="rtl"> إنشاء فرع - Create a branch </div>
|
||||
|
||||
<div dir="rtl"> انتقل إلى المجلد الذي يحتوي على المشروع عن طريق الأمر التالي: </div>
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
<div dir="rtl"> الآن قم بإنشاء فرع عن طريق الأمر التالي: </div>
|
||||
|
||||
```
|
||||
git checkout -b "add-your-name"
|
||||
```
|
||||
|
||||
<div dir="rtl">اسمك بدل add-your-name</div>
|
||||
|
||||
<div dir="rtl">على سبيل المثال:</div>
|
||||
|
||||
```
|
||||
git checkout -b "add-alonzo-church"
|
||||
```
|
||||
|
||||
<br>
|
||||
|
||||
## <div dir="rtl">قم بإجراء التعديلات المطلوبة وأتممها</div></h2>
|
||||
|
||||
<div dir="rtl">
|
||||
الآن قم بفتح الملف "Contributors.md" في محرر النصوص المفضل لديك وأضف اسمك ثم احفظ الملف.
|
||||
بعد ذلك اذهب إلى terminal واكتب الأمر <code>git status</code>. هذا الأمر سيظهر لك التغييرات التي حدثت في المشروع.
|
||||
لإضافة هذه التغييرات قم بإضافتها عن طريق هذا الأمر <code>git add</code>.
|
||||
</div>
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
<div dir="rtl">الآن قم بإتمام التغييرات باستخدام الأمر <code>git commit</code>.</div>
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
<div dir="rtl"> استبدل <code><your-name></code> باسمك. </div>
|
||||
<br>
|
||||
|
||||
## <div dir="rtl"> ارفع التغييرات إلى Push changes to Github - Github </div>
|
||||
|
||||
<div dir="rtl">ارفع التغييرات عن طريق الأمر <code>git push</code></div>
|
||||
|
||||
```
|
||||
git push origin "add-your-name"
|
||||
```
|
||||
|
||||
<div dir="rtl">استبدل <code><add-your-name></code> باسم الفرع الذي أنشأته من قبل.</div>
|
||||
|
||||
<br>
|
||||
<h2 id="سلم-تغيراتك-للمراجعة"><a name="سلم-تغيراتك-للمراجعة" href="#سلم-تغيراتك-للمراجعة"></a><div dir="rtl">سلم تغيراتك للمراجعة</div></h2>
|
||||
|
||||
<div dir="rtl">في صفحة المشروع الخاصة بك يوجد زر <code>Compare & pull request</code>. اضغط على هذا الزر.</div>
|
||||
|
||||
<img style="float: left;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
<div dir="rtl">والآن سلم طلبك لتتم مراجعته </div>
|
||||
|
||||
<img style="float: left;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
<div dir="rtl">بعد المراجعة سوف أقوم بدمج تغييراتك إلى الفرع الرئيسي في المشروع. سيتم تنبيهك عن طريق البريد الإلكتروني بذلك.</div>
|
||||
|
||||
<div dir="rtl">الفرع الرئيسي الخاص بك لن يحتوي على هذه التغييرات. عليك مزامنته مع الفرع الرئيسي عن طريق الخطوات التالية.</div>
|
||||
|
||||
## <div dir="rtl">مزامنة نسختك مع المشروع الرئيسي</div>
|
||||
|
||||
<div dir="rtl">الخطوة الأولى، انتقل إلى الفرع الرئيسي.</div>
|
||||
|
||||
```
|
||||
git checkout master
|
||||
```
|
||||
|
||||
<div dir="rtl">ثانياً، أضف رابط مشروعي كـ<code>upstream remote url</code>.</div>
|
||||
|
||||
```
|
||||
git remote add upstream https://github.com/Roshanjossey/first-contributions
|
||||
```
|
||||
|
||||
<div dir="rtl">بهذه الطريقة نخبر git أن هناك نسخة أخرى من هذا المشروع في هذا الرابط ونسميها <code>upstream</code>.
|
||||
بعد أن أوافق على تغييراتك، قم بسحب النسخة الجديدة من المشروع عن طريق الأمر التالي:
|
||||
</div>
|
||||
|
||||
```
|
||||
git fetch upstream
|
||||
```
|
||||
|
||||
<div dir="rtl">هنا سنقوم بسحب جميع التغييرات من <code>(upstream remote)</code>. والآن، عليك أن تدمج التحديثات الجديدة من فرعي إلى فرعك الرئيسي.</div>
|
||||
|
||||
```
|
||||
git rebase upstream/master
|
||||
```
|
||||
|
||||
<div dir="rtl">وهنا تطبق التغييرات إلى الفرع الرئيسي. إذا رفعت التغييرات لفرعك الرئيسي سيتم تحديث مشروعك</div>
|
||||
|
||||
```
|
||||
git push origin master
|
||||
```
|
||||
|
||||
<div dir="rtl">لاحظ أنك ترفع إلى <code>remote</code> اسمه <code>origin</code>.</div>
|
||||
<br>
|
||||
|
||||
## <div dir="rtl">توجيهات بإستخدام أدوات أخرى</div>
|
||||
|
||||
| <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) |
|
||||
@@ -1,144 +0,0 @@
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Առաջին ներդրումները
|
||||
|
||||
Այս նախագիծը նպատակ ունի պարզեցնել և ուղղորդել, թե ինչպես են սկսնակները կատարում իրենց առաջին ներդրումը: Եթե ցանկանում եք կատարել ձեր առաջին ներդրումը, հետևեք ստորև նշված քայլերին.
|
||||
|
||||
_Եթե ձեզ դուր չի գալիս հրամանի տողը, [այստեղ կան ձեռնարկներ՝ օգտագործելով GUI գործիքները](#tutorials-using-other-tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="պատառաքաղել այս պահոցը" />
|
||||
|
||||
#### Եթե դուք չունեք git ձեր մեքենայի վրա, [տեղադրեք այն](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## Պատառաքաղեք այս պահոցը
|
||||
|
||||
Պատառաքաղեք այս պահոցը՝ սեղմելով այս էջի վերևի պատառաքաղի կոճակը:
|
||||
Այս կստեղծի այս պահոցի պատճենը ձեր հաշվում.
|
||||
|
||||
## Կլոնավորեք պահեստը
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="Կլոնավորեք պահեստը" />
|
||||
|
||||
Այժմ կլոնավորեք պատառաքաղված պահոցը ձեր մեքենայի մեջ: Գնացեք ձեր GitHub հաշիվ, բացեք պատառաքաղված պահոցը, սեղմեք կոճակի կոճակը և սեղմեք _copy to clipboard_ պատկերակը.
|
||||
|
||||
Բացեք տերմինալ և գործարկեք հետևյալ git հրամանը:
|
||||
|
||||
```bash
|
||||
git clone "url-ը որ դուք հենց նոր պատճենեցիք"
|
||||
```
|
||||
|
||||
որտեղ «url-ը, որը հենց նոր պատճենեցիր» (առանց չակերտների) այս պահոցի url-ն է (այս նախագծի ձեր պատառաքաղը): Դիտեք նախորդ քայլերը՝ URL-ը ստանալու համար
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="պատճենել URL-ը clipboard-ում" />
|
||||
|
||||
Օրինակ:
|
||||
|
||||
```bash
|
||||
git clone git@github.com:this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
որտեղ `this-is-you` ձեր GitHub օգտանունն է: Այստեղ դուք պատճենում եք GitHub-ի առաջին ներդրումների պահոցի բովանդակությունը ձեր համակարգչում.
|
||||
|
||||
## Ստեղծեք մասնաճյուղ
|
||||
|
||||
Փոխեք ձեր համակարգչի պահեստի գրացուցակը (եթե արդեն այնտեղ չեք):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Այժմ ստեղծեք մասնաճյուղ՝ օգտագործելով «git switch» հրամանը:
|
||||
|
||||
```bash
|
||||
git switch -c քո-նոր-մասնաճյուղի-անունը
|
||||
```
|
||||
|
||||
Օրինակ:
|
||||
|
||||
```bash
|
||||
git switch -c add-sarkis-cult
|
||||
```
|
||||
|
||||
## Կատարեք անհրաժեշտ փոփոխությունները և commit կատարեք այդ փոփոխությունները
|
||||
|
||||
Այժմ բացեք `Contributors.md` ֆայլը տեքստային խմբագրիչում, ավելացրեք ձեր անունը դրան: Մի ավելացրեք այն ֆայլի սկզբում կամ վերջում: Տեղադրեք այն ցանկացած տեղ արանքում: Այժմ պահեք ֆայլը.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Եթե գնաք նախագծի գրացուցակ և կատարեք `git status` հրամանը, կտեսնեք, որ փոփոխություններ կան.
|
||||
|
||||
Ավելացրե՛ք այդ փոփոխությունները այն ճյուղին, որը հենց նոր ստեղծեցիք՝ օգտագործելով `git add` հրամանը:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Այժմ կատարեք այդ փոփոխությունները՝ օգտագործելով `git commit` հրամանը:
|
||||
|
||||
```bash
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
`your-name` փոխարինելով ձեր անունով.
|
||||
|
||||
## Փոփոխությունները մղեք GitHub-ին
|
||||
|
||||
Կատարեք ձեր փոփոխությունները՝ օգտագործելով `git push` հրամանը:
|
||||
|
||||
```bash
|
||||
git push -u origin your-branch-name
|
||||
```
|
||||
|
||||
`your-branch-name`-ը փոխարինելով ավելի վաղ ստեղծված մասնաճյուղի անունով.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Եթե հրելիս սխալներ եք ստանում, սեղմեք այստեղ.</strong> </summary>
|
||||
|
||||
- ### Վավերացման սխալ
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Գնացեք [GitHub-ի ձեռնարկ](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ձեր հաշվի համար SSH բանալի ստեղծելու և կազմաձևելու վերաբերյալ.
|
||||
</details>
|
||||
|
||||
## Ներկայացրեք ձեր փոփոխությունները վերանայման
|
||||
|
||||
Եթե գնաք ձեր պահոց GitHub-ում, կտեսնեք `Compare & pull request` կոճակը: Սեղմեք այդ կոճակի վրա.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Այժմ ներկայացրեք pull request-ը.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Շուտով ես կմիավորեմ ձեր բոլոր փոփոխությունները այս նախագծի հիմնական ճյուղի մեջ: Փոփոխությունները միաձուլվելուց հետո դուք կստանաք ծանուցման նամակ.
|
||||
|
||||
## Որտեղ գնալ այստեղից?
|
||||
|
||||
|
||||
Շնորհավորում եմ Դուք հենց նոր ավարտեցիք ստանդարտ _fork -> clone -> edit -> pull request_ աշխատանքային հոսքը, որը հաճախ կհանդիպեք որպես ներդրող!
|
||||
|
||||
Նշեք ձեր ներդրումը և կիսվեք այն ձեր ընկերների և հետևորդների հետ՝ գնալով [վեբ հավելված](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Եթե ցանկանում եք ավելի շատ փորձ ձեռք բերել, տեսեք [ծածկագրի ներդրումները](https://github.com/roshanjossey/code-contributions)։
|
||||
|
||||
|
||||
Հիմա եկեք սկսենք ձեր ներդրումն ունենալ այլ նախագծերում: Մենք կազմել ենք հեշտ խնդիրներ ունեցող նախագծերի ցանկ, որոնցից կարող եք սկսել: Ստուգեք [վեբ հավելվածի նախագծերի ցանկը](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Լրացուցիչ նյութ](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Ձեռնարկներ՝ օգտագործելով այլ գործիքներ
|
||||
|
||||
| <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) |
|
||||
|
||||
<p>Այս նախագծին աջակցում են:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,167 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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-2vqegkew0-ZuzGM1LO33C6Ts4nZyat1Q)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
# First Contributions
|
||||
|
||||
এই প্ৰকল্পই আৰম্ভণকাৰীসকলৰ বাবে প্ৰথম অৱদানটো সহজ আৰু পোষকভাৱে কৰিবলৈ সহায় কৰে। যদি আপুনি আপোনাৰ প্রথম অৱদানটো কৰিবলৈ বিচাৰে, তলত দিয়া পদক্ষেপসমূহ অনুসৰণ কৰক।
|
||||
|
||||
যদি আপুনি command lineৰ সৈতে আৰামদায়ক নোহোৱাঁ, GUI tools ব্যৱহাৰ কৰি ইয়াত tutorial আছে।
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
যদি আপোনাৰ মেচিনত git নাই, ইনষ্টল কৰক [install it](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## এই ৰেপ'জিট'ৰিটো Fork কৰক
|
||||
এই পৃষ্ঠাৰ ওপৰত থকা fork বুটামত ক্লিক কৰি এই ৰেপ'জিট'ৰিটো Fork কৰক। এইটো আপোনাৰ একাউণ্টত এই ৰেপ'জিট'ৰিটোৰ এটা কপি সৃষ্টি কৰিব।
|
||||
|
||||
## ৰেপ'জিট'ৰিটো ক্লোন কৰক
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
এতিয়া fork কৰা ৰেপ'জিট'ৰিটো আপোনাৰ মেচিনত ক্লোন কৰক। আপোনাৰ GitHub একাউণ্টত যাওক, fork কৰা ৰেপ'জিট'ৰিটো খোলক, code বুটামত ক্লিক কৰক আৰু তাৰপিছত copy to clipboard আইকনটোত ক্লিক কৰক।
|
||||
|
||||
টাৰ্মিনেল খোলক আৰু নিম্নলিখিত git কমাণ্ডটো চলাওক:
|
||||
|
||||
```bash
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
য'ত "url you just copied" (নাম উদ্ধৃতিহীন) হৈছে এই ৰেপ'জিট'ৰিটোৰ url (এই প্ৰকল্পৰ আপোনাৰ fork)। url পোৱা আগৰ পদক্ষেপসমূহ চাওক।
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
উদাহৰণ স্বৰূপে
|
||||
|
||||
```bash
|
||||
git clone git@github.com:this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
য'ত this-is-you হৈছে আপোনাৰ GitHub ইউজাৰনেম। ইয়াত আপুনি first-contributions ৰেপ'জিট'ৰিটোৰ বিষয়বস্তু GitHub ৰ পৰা আপোনাৰ কম্পিউটাৰত কপি কৰি থৈছা।
|
||||
|
||||
## Branch সৃষ্টি কৰক
|
||||
আপোনাৰ কম্পিউটাৰৰ ৰেপ'জিট'ৰিৰ ডাইৰেক্টৰীত পৰিৱৰ্তন কৰক (যদি আপুনি ইতিমধ্যেই তাত নোহোৱাঁ):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
এতিয়া git switch কমাণ্ড ব্যৱহাৰ কৰি এখন শাখা সৃষ্টি কৰক:
|
||||
|
||||
```bash
|
||||
git switch -c <আপোনাৰ-নতুন-শাখা-নাম-যোগ-বনাওক>
|
||||
|
||||
```
|
||||
|
||||
উদাহৰণ স্বৰূপে
|
||||
|
||||
```bash
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary> <strong>যদি আপুনি git switch ব্যৱহাৰ কৰি কোনো ত্ৰুটি পায়, ইয়াত ক্লিক কৰক:</strong> </summary>
|
||||
|
||||
যদি আপুনি "Git: ‘switch’ is not a git command. See ‘git –help’" ত্ৰুটি পায়, তেতিয়া আপুনি পুরণি সংস্কৰণৰ git ব্যৱহাৰ কৰি থকা সম্ভাৱনা আছে।
|
||||
এই ক্ষেত্ৰত, git switchৰ পৰিবৰ্তে git checkout ব্যৱহাৰ কৰাৰ চেষ্টা কৰক:
|
||||
|
||||
```bash
|
||||
git checkout -b your-new-branch-name
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## প্ৰয়োজনীয় পৰিবৰ্তন কৰক আৰু সেই পৰিবৰ্তনসমূহ Commit কৰক
|
||||
|
||||
এতিয়া Contributors.md ফাইলটো এটা টেক্সট সম্পাদকত খোলক। আপোনাৰ নামটো ইয়াত যোগ কৰক। নামটো ফাইলৰ আৰম্ভণিতে বা শেষত যোগ নকৰিব। নামটো মাজৰ যিকোনো স্থানত ৰাখক। এতিয়া, ফাইলটো সংৰক্ষণ(save) কৰক।
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
যদি আপুনি প্ৰকল্প ডাইৰেক্টৰীত যোৱা আৰু কমাণ্ড `git status` চলোৱা, আপুনি পৰিবৰ্তনসমূহ দেখিব।
|
||||
|
||||
এই পৰিবৰ্তনসমূহকে আপুনি সৃষ্টি কৰা নতুন শাখাত যোগ কৰিবলৈ `git add` কমাণ্ডটো ব্যৱহাৰ কৰক:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
এতিয়া সেই পৰিবৰ্তনসমূহ `git commit` কমাণ্ড ব্যৱহাৰ কৰি commit কৰক:
|
||||
|
||||
```bash
|
||||
git commit -m "Add <আপোনাৰ-নাম> to Contributors list"
|
||||
|
||||
```
|
||||
|
||||
আপোনাৰ-নাম স্থলৱি দি আপোনাৰ নাম যোগ কৰক:
|
||||
|
||||
## পৰিবৰ্তনসমূহ GitHub ত Push কৰক
|
||||
|
||||
আপোনাৰ পৰিবৰ্তনসমূহ নিম্নলিখিত কমাণ্ড ব্যৱহাৰ কৰি GitHub ত Push কৰক:
|
||||
|
||||
```bash
|
||||
git push -u origin your-branch-name
|
||||
```
|
||||
|
||||
নিম্নলিখিত কমাণ্ডটো ব্যৱহাৰ কৰক, `your-branch-name` স্থলৱি দি আপোনাৰ শাখাৰ নাম যোগ কৰক:
|
||||
|
||||
<details>
|
||||
<summary> <strong>যদি আপুনি Push কৰাৰ সময়ত কোনো ত্ৰুটি পায়, ইয়াত ক্লিক কৰক:</strong> </summary>
|
||||
|
||||
- ### প্ৰমাণীকৰণ ত্ৰুটি
|
||||
<pre>remote: পাসৱৰ্ড প্ৰমাণীকৰণৰ সহায়তা অপসাৰণ কৰা হৈছিল 13 আগষ্ট, 2021 তাৰিখে
|
||||
remote: অনুগ্ৰহ কৰি চাওক:: https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ অধিক তথ্যৰ বাবে
|
||||
অনুগ্ৰহ কৰি এইটো চাওক: 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
যাওক [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) SSH কী সৃষ্ট আৰু কনফিগাৰ কৰাৰ জন্য যোৱা
|
||||
|
||||
আপুনি 'git remote -v' কমাণ্ডটো চলাব পাৰে আপোনাৰ দূৰৱর্তী ঠিকনাটো পৰীক্ষা কৰিবলৈ।
|
||||
|
||||
যদি ইয়াৰ আউটপুটটি এইদৰে দেখায়:
|
||||
<pre>origin https://github.com/your-username/your_repo.git (fetch)
|
||||
origin https://github.com/your-username/your_repo.git (push)</pre>
|
||||
|
||||
কমাণ্ড ব্যৱহাৰ কৰি ইয়াক পৰিবৰ্তন কৰক:
|
||||
```bash
|
||||
git remote set-url origin git@github.com:your-username/your_repo.git
|
||||
```
|
||||
নহলে আপুনি কেতিয়াও লগইনৰ বাবে নিৰ্দিষ্ট নাম আৰু পাছৱৰ্ড দিয়া হব আৰু লগইন ত্ৰুটি হব।
|
||||
</details>
|
||||
|
||||
## আপোনাৰ পৰিবৰ্তনসমূহ পৰ্যালোচনাৰ বাবে জমা দিয়ক
|
||||
যদি আপুনি GitHub ত আপোনাৰ ৰেপ'জিট'ৰিটোত যায়, আপুনি `Compare & pull request` বুটামটো দেখিব। এই বুটামটোত ক্লিক কৰক।
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Pull Request জমা দিয়ক
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
আপোনাৰ পৰিবৰ্তনসমূহ তাড়তে প্ৰকল্পৰ মুখ্য শাখাত মিলাই দিম। পৰিবৰ্তনসমূহ মিলোৱা হ'লে আপুনি এটা অৱগতিমূলক ইমেইল লাভ কৰিব।
|
||||
|
||||
## য়াৰ পৰা ক’লৈ যাব?
|
||||
অভিনন্দন! আপুনি কেৱল সম্পূৰ্ণ কৰিলে fork -> clone -> edit -> pull request কাৰ্যধাৰাটোৰ মানসংগত ৰূপ যি প্ৰায়ে এক অবদানকাৰী হিচাপে সন্মুখীন হ'ব!
|
||||
|
||||
আপোনাৰ অৱদান উদযাপন কৰক আৰু আপোনাৰ বন্ধু আৰু অনুসাৰকসকলৰ সৈতে ইয়াক শেয়াৰ কৰক [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
যদি আপুনি অধিক অনুশীলন কৰিব বিচাৰে, [code contributions](https://github.com/roshanjossey/code-contributions) পৰীক্ষা কৰক।
|
||||
|
||||
এতিয়া আপোনাক আন প্ৰকল্পত অৱদান কৰিবলৈ আৰম্ভ কৰা যাক। আমি সহজ সমস্যাসমূহ সহ কিছু প্ৰকল্পৰ তালিকা সংকলন কৰিছো যাৰ সহায়ত আপুনি আৰম্ভ কৰিব পাৰে। [ৱেব এপত প্ৰকল্পসমূহৰ তালিকা পৰীক্ষা কৰক](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
|
||||
### [অতিৰিক্ত সামগ্ৰী](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## অন্য সঁজুলিসমূহ ব্যৱহাৰ কৰি টিউট'ৰিয়েলসকল
|
||||
|
||||
| <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) |
|
||||
|
||||
<p>এই প্ৰকল্পৰ সহায়ত:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
|
||||
|
||||
@@ -1,115 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# İlk töhfələr
|
||||
|
||||
Bu layihə yeni başlayanların ilk töhfələrini vermə yollarını sadələşdirmək və istiqamətləndirmək məqsədini daşıyır. İlk töhfənizi vermək istəyirsinizsə, aşağıdakı addımları izləyin.
|
||||
|
||||
_Əgər komanda sətri ilə rahat deyilsinizsə, [burada GUI alətlərindən istifadə edən təlimatlar tapa bilərsiniz.](#Digər-alətlərin-istifadəsi-üçün-təlimlər)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### Maşınınızda (yəni, kompüterinizdə) GIT yoxdursa, [buradan quraşdıra bilərsiniz](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Layihəni "çəngəlləmək"
|
||||
|
||||
Səhifənin yuxarı hissəsindəki "Fork" düyməsini vuraraq bu layihəni çəngəlləyin.
|
||||
Bu hesabınızda deponun bir kopyasını yaradacaqdır.
|
||||
|
||||
## Deponu (Repository) klonlaşdırma
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
İndi çəngəlli deponu kompüterinizə klonlaşdırın. GitHub hesabınıza daxil olun, çəngəlli deponu açın, kod düyməsinə vurun və sonra _copy to clipboard_ simgəsinə klikləyin.
|
||||
|
||||
Daha sonra terminalı açın və aşağıdakı git komandasını daxil edin:
|
||||
|
||||
```
|
||||
git clone "kopyaladığınız-url"
|
||||
```
|
||||
"kopyaladığınız-url" (dırnaq işarəsi olmadan) yerinə bu deponun GitHub səhifəsindən aldığınız linki kopyalayın.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Misal üçün:
|
||||
```
|
||||
git clone https://github.com/istifadəçi-adı/first-contributions.git
|
||||
```
|
||||
`istifadəçi-adı` sizin GitHub istifadəçi adınızdır. Burada siz GitHub-da ilk töhfələr deposunun məzmununu kompüterinizə köçürürsünüz.
|
||||
|
||||
## Budaq (Branch) yaratmaq
|
||||
|
||||
Kompüterinizdəki depo qovluğuna keçin (əgər orada deyilsinizsə):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
`git checkout` əmrini istifadə edərək bir Budaq (Branch) yaradın:
|
||||
```
|
||||
git checkout -b <sizin-yeni-budaq-adınız>
|
||||
```
|
||||
|
||||
Misal üçün:
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
## Lazımi dəyişiklikləri edin və bu dəyişiklikləri həyata keçirin
|
||||
|
||||
İndi `Contributors.md` faylını mətn redaktorunda açın, adınızı əlavə edin. Faylın əvvəlinə və ya sonuna əlavə etməyin. Arada bir yerə qoyun. İndi faylı yadda saxlayın.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Layihə qovluğuna gedib `git status` əmrini icra etsəniz, dəyişikliklərin olduğunu görəcəksiniz.
|
||||
|
||||
Bu dəyişiklikləri `git add` əmrindən istifadə edərək yaratdığınız Budağa əlavə edin:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
İndi `git commit` əmrindən istifadə edərək bu dəyişiklikləri edin:
|
||||
|
||||
adınızla `<your-name>` ilə əvəz olunsun.
|
||||
|
||||
## Dəyişiklikləri GitHub-a itələyin (push)
|
||||
|
||||
Dəyişikliklərinizi "git push" əmrindən istifadə edərək itələyin:
|
||||
|
||||
|
||||
```
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
|
||||
`<add-your-branch-name>` yerinə öz istifadəçi adınızı daxil edin.
|
||||
|
||||
## Dəyişikliklərinizi nəzərdən keçirmək üçün göndərin
|
||||
|
||||
GitHub-dakı deponuza daxil olsanız, bir `Compare & pull request` düyməsini görəcəksiniz. Bu düyməni vurun.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
İndi çəkmə tələbini (pull request) göndərin.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Tezliklə bütün dəyişikliklərinizi bu layihənin master filialına birləşdirəcəyəm. Dəyişikliklər birləşdirildikdən sonra bildiriş e-poçtu alacaqsınız.
|
||||
|
||||
## Bundan sonra nə edə bilərəm?
|
||||
|
||||
Təbriklər! Töhfə olaraq tez-tez qarşılaşacağınız standart _fork -> clone -> edit -> pull request_ tamamlamısınız!
|
||||
|
||||
Töhfənizi qeyd edin və [veb tətbiqə](https://firstcontributions.github.io/#social-share) girərək dostlarınız və izləyicilərinizlə bölüşün.
|
||||
|
||||
Daha çox təcrübə istəyirsinizsə, yoxlayın [kod töhfələri](https://github.com/roshanjossey/code-contributions).
|
||||
|
||||
İndi başqa layihələrə töhfə verməyə başlayaq. Başlaya biləcəyiniz asan məsələləri olan layihələrin siyahısını hazırladıq, [siyahıya baxın](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Əlavə Məlumat](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Digər alətlərin istifadəsi üçün təlimlər
|
||||
|
||||
| <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) |
|
||||
@@ -1,122 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
# Първи стъпки
|
||||
|
||||
Трудно е. Когато правиш нещо за пръв път винаги е трудно. Още повече, когато се работи съвместно с други хора. Затова решихме да опростим процеса на учене за новобранците в допринасянето към отворен софтуер.
|
||||
|
||||
Четенето на статии и гледането на видео уроци помага, но има ли по-добър учител от практиката в защитена среда? Целта на този проект е да напътства и опрости първите стъпки на новобранците в участието и приноса към отворен софтуер. Ако искате да направите първата си контрибуция и да станете част от обществото на отворен софтуер, следвайте стъпките по-долу.
|
||||
|
||||
#### *Ако не се чувствате комфортно използвайки command line (терминал), [ето и уроци за използването на програми с графичен интерфейс](#Уроци-за-иползването-на-други-приложения)*
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Ако нямате git на вашия компютър, [инсталирайте го]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Направете Разклонение (Fork) на това хранилище (repository)
|
||||
|
||||
Направете разклонение на хранилището като натиснете бутона "Fork" в горната част на тази страница.
|
||||
Това ще направи копие на това хранилище във вашия GitHub профил.
|
||||
|
||||
## Клонирайте това хранилище
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Сега клонирайте локално на вашия компютър разклоненото хранилище. Отидете във вашия GitHub профил, отворете разклоненото хранилище,
|
||||
кликнете на бутона 'Clone' и копирайте линка или натиснете иконката 'copy to clipboard' (копирай в клипборда).
|
||||
|
||||
Отворете терминал и въведете следната команда
|
||||
|
||||
```
|
||||
git clone "линка който току-що копирахте"
|
||||
```
|
||||
като на мястото на "URL-а който току-що копирахте" (без кавичките) поставете линка към това хранилище (Вашето Разклонение на този проект). Вижте
|
||||
предните стъпки за това как да се сдобиете с линка.
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Например:
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
Като на мястото на `this-is-you` се намира вашето потребителско име. В тази стъпка вие направихте копие на съдържанието на GitHub хванилището на 'first contributions' във вашия компютър.
|
||||
|
||||
## Създайте клон (branch)
|
||||
|
||||
Стигнете до местоположението във вашия компютър, където копирахте хранилището (ако вече не се намирате там):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Сега създайте клон използвайки командата `git switch -c`:
|
||||
```
|
||||
git switch -c <add-your-new-branch-name>
|
||||
```
|
||||
|
||||
Например:
|
||||
```
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
(Името на клона не е задължително да съдържа думата *add*, но е препоръчително, защото целта на този клон е да добавите името си към списък.)
|
||||
|
||||
## Направете нужните промени и ги commit-нете
|
||||
|
||||
Сега отворете файла `Contributors.md` в текстов редактор и добавете името си в него. Не го добавяйте в началото или края на файла. Поставете го някъде посредата. Сега запазете промените.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
|
||||
Ако навигирате през терминала до директорията на проекта и въведете командата `git status`, ще видите че има променени файлове.
|
||||
|
||||
|
||||
ДОбавете тези промени към клона, който създадохте, използвайки командата `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Сега commit-нете тези промени с командата `git commit`:
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
като смените `<your-name>` с вашето име.
|
||||
|
||||
## Качете (Push) промените в GitHub
|
||||
|
||||
Качете вашите промени като въведете командата `git push`:
|
||||
```
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
сменяйки `<add-your-branch-name>` с името на клона, който създадохте по-рано.
|
||||
|
||||
## Предайте вашите промени за рецензия
|
||||
|
||||
Ако отидете във вашето хранилище в GitHub, ще видите бутона `Compare & pull request`. Натиснете го.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Сега предайте вашите промени за рецензия.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Скоро аз ще слея (merge) всички ваши промени в главния клон (мастер branch) на този проект. Вие ще бъдете уведомени по електронната поща когато това се случи.
|
||||
|
||||
## От тук накъде?
|
||||
|
||||
Поздравления! Вие току що изпълнихте стандарните _fork -> clone -> edit -> PR_ операции, които ще срещнете като сътрудник!
|
||||
|
||||
Отпразнувайте вашия принос и го споделете с приятели и последователи като посетите [уеб приложението](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Ако бихте искали повече практика, разгледайте [код приноси](https://github.com/roshanjossey/code-contributions).
|
||||
|
||||
Време да започнете да допринасяте и към други приекти. Ние сме съставили списък с проекти съдържащи лесни проблеми, които са лесни за начало. Проверете [списъка от приекти в уеб приложението](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Допълнителни материали](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Уроци за иползването на други приложения
|
||||
|
||||
| <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) |
|
||||
@@ -1,124 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Prvi doprinosi
|
||||
|
||||
Ovaj projekat ima za cilj da pruži konkretne korake i olakša način na koji početnici prilažu svoje prve doprinose (eng. contributions). Ukoliko ste se prepoznali u tekstu iznad i zelite da probate i doprinesete ovome ili nekom drugom projektu, pratite slijedece korake.
|
||||
|
||||
#### _Ukoliko niste bas sigurni u vas rad sa komandnom linijom/terminalom (terminal -> za macOs), [mozete koristit ovaj link kroz GUI alate.](#Uputstva-za-druge-alate)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="Napravite fork repozitorijuma" />
|
||||
|
||||
Ukoliko nemate git instaliran na vašoj mašini, [instalirajte ga ovde](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Uradite fork repozitorijuma
|
||||
|
||||
Uradite račvanje (fork) tako što ćete kliknuti na dugme _fork_ na vrhu stranice. Ovako pravite kopiju repozitorijuma na vašoj github stranici.
|
||||
|
||||
## Klonirajte repozitorijum
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Slijedeće, klonirajte repozitorijum koji ste prethodno račvali (fork). Posjetite svoj GitHub profil, otvorite repozitorijum koji ste račvali, kliknite na _clone_ (kloniraj/kopiraj) dugme i kliknite na ikonicu _copy to clipboard_.
|
||||
|
||||
Otvorite terminal i upišite slijedece git komande:
|
||||
|
||||
```
|
||||
git clone "url koji ste prethodno kopirali sa vaseg github profila" (bez navodnika i razmaka)
|
||||
```
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Na primjer:
|
||||
|
||||
```
|
||||
git clone https://github.com/ovo-ste-vi/first-contributions.git
|
||||
```
|
||||
|
||||
Gdje je umjesto `ovo-ste-vi` upisano vaše _github_ korisničko ime. Ovim kopirate sadržaj repozitorijuma _first-contributions_ na vašu mašinu.
|
||||
|
||||
## Pravljenje grane _branch_
|
||||
|
||||
Prebacite se u radni direktorij na vašoj mašini:
|
||||
|
||||
```
|
||||
cd first-contributions (ili pratite gdje se tacno nalazi na vasoj masini)
|
||||
```
|
||||
|
||||
Pa zatim napravite novo grananje _branch_ koristeći `git checkout` comandu:
|
||||
|
||||
```
|
||||
git checkout -b <add-svoje-ime>
|
||||
```
|
||||
|
||||
Na primer:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
(Naziv grane ne mora da sadrži _add_ na početku ili vase _ime_, ali je zgodno uključiti ga jer je svrha ove grane da doda vaše ime na listu.
|
||||
|
||||
## Napravite potrebne izmjene i potvrdite promjene
|
||||
|
||||
Otvorite `Contributors.md` fajl u tekst editoru i dodajte vaše ime. Nemojte dodavati ime na sam početak ili kraj. Stavite ga negdje u sredinu. Potom sačuvajte fajl.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Ukoliko odete u radni direktorijum i izvršite komandu `git status`, primjetit ce te da postoje promjene.
|
||||
|
||||
Dodajte ove promjene u granu koju ste gore napravili koristeći `git add` komandu:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Sada potvrdite ove promjene koristeći `git commit` komandu:
|
||||
|
||||
```
|
||||
git commit -m "Add <tvoje-ime> to Contributors list"
|
||||
```
|
||||
|
||||
Gdje umjesto `<tvoje-ime>` upisujete svoje ime.
|
||||
|
||||
## Push changes to GitHub
|
||||
|
||||
Pošaljite izmjene u repozitorijum na GitHub nalogu `git push`:
|
||||
|
||||
```
|
||||
git push origin <dodaj-ime-svoje-grane>
|
||||
```
|
||||
|
||||
gdje umjesto `<dodaj-ime-svoje-grane>` stavljate ime vašeg grananja koje ste prethodno napravili.
|
||||
|
||||
## Pošaljite izmjene na reviziju
|
||||
|
||||
Ukoliko odete na repozitorijum na vašem GitHub profilu primetićete `Compare & pull request` Dugme. Kliknite na njega.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
a potom pošaljite zahtjev klikom na dugme _Create pull request_.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Nakon toga, admin će spojiti promjene koje ste napravili sa master granom projekta. Dobićete mejl potvrde kada se grane spoje.
|
||||
|
||||
## Šta dalje?
|
||||
|
||||
Čestitamo! Završili ste standardni _fork -> clone -> edit -> PR_ tok koji će vas pratiti kroz vaš čitav programerski život!
|
||||
|
||||
Proslavite tako što ćete podjeliti vaš doprinos sa prijateljima i pratiocima otvaranjem [stranice](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Pridružite se i našem Slack timu u slučaju da vam je potrebna ikakva pomoć ili imate bilo kakvih pitanja. [Slack tim](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
A sada, možemo početi sa doprinosima drugim projektima. Napravili smo spisak projekata sa jednostavnim problemima na kojima možete početi da radite. Posetite stranicu sa [the list of projects na našem sajtu](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Dodatni materijali](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Uputstva za druge alate
|
||||
|
||||
| <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) |
|
||||
@@ -1,134 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# প্রথম অবদানসমূহ
|
||||
|
||||
এই প্রকল্পের উদ্দেশ্য হলো নতুন ডেভেলপারদের তাদের প্রথম অবদানটি সহজ করা এবং নির্দেশনা দেওয়া। যদি আপনি আপনার প্রথম অবদান করতে চান, তবে নীচের ধাপগুলি অনুসরণ করুন।
|
||||
|
||||
প্রবন্ধ পড়ে এবং টিউটোরিয়াল দেখে অনেক কিছুই শেখা যায়, কিন্তু ব্যবহারিক পদ্ধতিতে কাজ করার চেয়ে উপযোগী কিছু হতে পারে না। এই প্রজেক্টের লক্ষ্য হচ্ছে নবীনদের দিকনির্দেশনা দেওয়া আর সেই সাথে তাদের প্রথম অবদান রাখার কাজটি সহজ করে তোলা। আপনি যদি ওপেন সোর্সে আপনার প্রথম অবদান রাখতে চান, তাহলে নিচের সহজ ধাপগুলো অনুসরণ করুন। কথা দিচ্ছি, এই প্রক্রিয়াটি অত্যন্ত মজার ও আনন্দদায়ক।
|
||||
|
||||
#### _যদি কমান্ড লাইনে সমস্যা হয়, [তবে নীচে একটি GUI টুল ব্যবহার করে টিউটোরিয়াল দেওয়া হয়েছে।](#অন্যান্য-টুল-ব্যবহারের-টিউটোরিয়াল)_
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
আপনার কম্পিউটারে গিট না থাকলে, [ ইনস্টল করুন ](https://help.github.com/articles/set-up-git/)।
|
||||
|
||||
## এই রিপোজিটরি ফর্ক করুন
|
||||
|
||||
এই রিপোজিটরি ফর্ক করতে 'ক্লিক এর মাধ্যমে' এই পৃষ্ঠার উপরে ফর্ক বাটনে ক্লিক করুন।
|
||||
এটি আপনার অ্যাকাউন্টে এই রিপোজিটরির একটি কপি তৈরি করবে।
|
||||
|
||||
## রিপোজিটরি ক্লোন করুন
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
এখন এই রিপোজিটরিটি আপনার কম্পিউটারে ক্লোন করুন। এজন্যে প্রথমে ক্লোন(Clone) বাটনে ক্লিক করুন। এরপর ক্লিক করুন _ক্লিপবোর্ডে কপি করুন(copy to clipboard)_ আইকনটিতে।
|
||||
|
||||
আপনার টার্মিনাল (উইন্ডোজের ক্ষেত্রে কমান্ড প্রম্পট (CMD)) চালু করুন এবং নিচের কমান্ড রান করুন :
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
যেখানে "url you just copied" (উদ্ধৃতি চিহ্ন ব্যতীত) হচ্ছে এই রিপোজিটরির ইউআরএল যা আপনি পূর্বের ধাপেই পেয়েছেন।
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
যেমন:
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
এখানে `this-is-you` হচ্ছে আপনার গিটহাব ইউজারনেম। এই কমান্ডটির মাধ্যমে আপনার কম্পিউটারে গিটহাবে অবস্থিত first-contributions রিপোজিটরির একটি কপি তৈরি হবে।
|
||||
|
||||
## একটি ব্রাঞ্চ তৈরি করুন
|
||||
|
||||
আপনার কম্পিউটারে রিপোজিটরির ডিরেক্টরিতে যান (যদি এখনো অন্য ডিরেক্টরিতে থাকেন) :
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
এখন `git switch` কমান্ডের মাধ্যমে একটি ব্রাঞ্চ তৈরি করুন :
|
||||
|
||||
```
|
||||
git switch -c <your-new-branch-name>
|
||||
```
|
||||
|
||||
যেমন :
|
||||
|
||||
```
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
(ব্রাঞ্চের নামে _add_ শব্দটি যুক্ত থাকা জরুরী নয়। তবে এই ব্রাঞ্চের উদ্দেশ্য যেহেতু আপনার নাম তালিকাভুক্ত করা, সেহেতু _add_ শব্দটি যুক্ত থাকাই কাম্য।)
|
||||
|
||||
## প্রয়োজনীয় পরিবর্তন করুন ও পরিবর্তনগুলো কমিট করুন
|
||||
|
||||
এখন যে কোন টেক্সট এডিটরে `Contributors.md` ফাইলটি খুলুন, এতে আপনার নাম যুক্ত করুন, অতঃপর ফাইলটি সেভ করুন। এবার প্রজেক্ট ডিরেক্টরি থেকে `git status` কমান্ড রান করলে আপনি পরিবর্তনগুলো দেখতে পাবেন। `git add` কমান্ড দ্বারা এই পরিবর্তনগুলো আপনার তৈরি ব্রাঞ্চে যুক্ত করুন :
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
এরপর `git commit` কমান্ড ব্যবহার করে এই পরিবর্তনগুলো কমিট করুন :
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
`<your-name>`-এর বদলে আপনার নাম লিখতে ভুলবেন না।
|
||||
|
||||
## পরিবর্তনগুলো গিটহাবে পুশ করা
|
||||
|
||||
`git push` কমান্ড ব্যবহার করে পরিবর্তনগুলো পুশ করুন :
|
||||
|
||||
```
|
||||
git push origin -u <your-new-branch-name>
|
||||
```
|
||||
|
||||
এক্ষেত্রে `<your-new-branch-name>`-এর বদলে পূর্বে আপনার তৈরি ব্রাঞ্চের নাম লিখুন।
|
||||
|
||||
<details>
|
||||
<summary> <strong>পুশ করতে সমস্যা হলে এখানে ক্লিক করুন:</strong> </summary>
|
||||
|
||||
- ### অথ্যানটিকেশনে সমস্যা
|
||||
<pre>remote: পাসওয়ার্ড অথ্যানটিকেশনের সাপোর্ট আগস্ট ১৩, ২০২১ থেকে আর নেই। Personal access token ব্যাবহার করুন।
|
||||
remote: https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ তে আরো তথ্য পাবেন।
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
[GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) এ আপনার একাউন্টে SSH key generation এবং configuration
|
||||
এর আরো তথ্য পাবেন।
|
||||
|
||||
</details>
|
||||
|
||||
|
||||
## রিভিউয়ের জন্য আপনার পরিবর্তনগুলো জমা দিন
|
||||
|
||||
আপনার গিটহাব রিপোজিটরিতে `Compare & pull request` বাটনে ক্লিক করুন।
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
এখন _পুল রিকোয়েস্ট_ সাবমিট করুন।
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
শীঘ্রই আমি এই প্রজেক্টের মাস্টার ব্রাঞ্চে আপনার সমস্ত পরিবর্তন গুলো মার্জ করব। পরিবর্তনগুলি একত্রিত হয়ে গেলে আপনি একটি নিশ্চিতকরণ ই-মেইল পাবেন৷
|
||||
|
||||
## এরপর কী করব?
|
||||
|
||||
আপনার অবদানের আনন্দ উপভোগ করুন এবং [ওয়েব অ্যাপ](https://firstcontributions.github.io/#social-share)-এর মাধ্যমে বন্ধু ও অনুসরণকারীদের সাথে শেয়ার করুন।
|
||||
|
||||
যদি আপনি আরও অনুশীলন করতে চান, তাহলে [কোড অবদানগুলি](https://github.com/roshanjossey/code-contributions) চেকআউট করুন।
|
||||
|
||||
এখন আপনি অন্যান্য প্রজেক্টগুলোতেও অবদান রাখতে পারেন। আপনার সুবিধার্থে আমরা সহজ সমস্যা সম্বলিত প্রজেক্টগুলোর একটি তালিকা তৈরি করেছি। ওয়েব অ্যাপে [প্রজেক্টগুলোর তালিকা](https://firstcontributions.github.io/#project-list) দেখুন।
|
||||
|
||||
### [ অতিরিক্ত উপাদানসমূহ ](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## অন্যান্য টুল ব্যবহারের টিউটোরিয়াল
|
||||
|
||||
| <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/Readme/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> |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [গিটহাব ডেস্কটপ](../gui-tool-tutorials/github-desktop-tutorial.md) | [ভিজুয়্যাল স্টুডিও ২০১৭](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [গিটক্র্যাকেন](../gui-tool-tutorials/gitkraken-tutorial.md) | [ভিজুয়্যাল স্টুডিও কোড](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [আটলাসিয়ান সোর্সট্রি](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [ইন্টেলিজ আইডিয়া](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |
|
||||
@@ -1,151 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Першы ўклад у праект
|
||||
|
||||
Складана. Заўсёды складана пачынаць нешта з самага пачатку. Даволі непрыемна рабіць памылкі, асабліва калі вы працуеце ў камандзе. Увесь open source складаецца з супрацоўніцтва і сумеснай працы. Мы хочам аблегчыць першыя крокі ў навучанні і супрацоўніцтве пачаткоўцам распрацоўнікам.
|
||||
|
||||
Чытанне артыкулаў і падручнікаў можа дапамагчы, але што можа быць лепш, чым сапраўдны практычны вопыт, без рызыкі што-небудзь сапсаваць. Мэта гэтага праекта - належным чынам накіраваць маладых навабранцаў, а таксама даць ім магчымасць зрабіць іх першы ўклад. Памятаеце: чым менш вы напружаныя, тым лепш вы вучыцеся. Калі вы шукаеце магчымасць ажыццявіць свой першы ўклад, проста прытрымлівайцеся простым крокам, размешчаным ніжэй. Абяцаем, будзе цікава.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
|
||||
Калі ў вас не ўсталяваны git на кампутары, [ ўсталюйце яго ]( https://help.github.com/articles/set-up-git/ )
|
||||
|
||||
## Стварыце асобную галінку
|
||||
|
||||
Стварыце асобную галінку, націснуўшы на кнопку `fork` зверху гэтай старонкі. Такім чынам вы створыце копію гэтага рэпазітара ў сваім запісе.
|
||||
|
||||
## Капіюйце рэпазітар
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Цяпер каб скапіяваць ваш рэпазітар на персанальны кампутар. Націсніце на кнопку `clone`, а затым на абразок `copy to clipboard`, каб скапіяваць спасылку.
|
||||
|
||||
Адкрыйце тэрмінал і запусціце наступную git каманду:
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
Дзе "url you just copied" (без двукоссяў) гэта спасылка на ваш рэпазітар. Паглядзіце папярэднія крокі, каб атрымаць гэтую спасылку.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Напрыклад:
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
Дзе `this-is-you` ваш лагін на github. Такім чынам вы капіруеце рэпазітар 'first-contributions' з GitHub на ваш персанальны кампутар.
|
||||
|
||||
## Стварыце галінку
|
||||
|
||||
Перайдзіце ў каталог рэпазітара на вашым кампутары, калі вы яшчэ не там.
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Цяпер стварыце галінку, з дапамогай `каманды git checkout`
|
||||
|
||||
```
|
||||
git checkout -b <add-your-name>
|
||||
```
|
||||
|
||||
Напрыклад:
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
(Сінтаксічную не патрабуецца, каб назва галіны ўтрымлівала слова * add *, але гэта апраўдана, паколькі падкрэслівае прызначэнне гэтай галіны - дадаць ваша імя ў спісы.)
|
||||
|
||||
## Занясіце неабходныя змены і стварыце commit
|
||||
|
||||
Цяпер адкрыйце файл `Contributors.md` ў вашым тэкставым рэдактары, запішыце ваша імя і захавайце файл. Калі вы пяройдзеце ў дырэкторыю праекта і выканайце `git status`, вы ўбачыце змены. Дадайце гэтыя змены з дапамогай каманды `git add`.
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Цяпер занясіце дадзеныя змены з дапамогай каманды `git commit`.
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
Зменіце `<your-name>` на ваша імя
|
||||
|
||||
## Занясіце дадзеныя змены на github
|
||||
|
||||
Занясіце вашыя змены з дапамогай каманды `git push`
|
||||
```
|
||||
git push origin <add-your-name>
|
||||
```
|
||||
Зменіце `<add-your-name>` на імя галіны, якую вы стварылі раней.
|
||||
|
||||
## Пацвердзіце змены для праверкі вашага кода
|
||||
|
||||
Калі вы зойдзеце ў свой рэпазітар на GitHub, вы ўбачыце кнопку `Compare & pull request`. Націсніце на яе.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Цяпер пацвердзіце pull-request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Хутка я ўчыню аб'яднанне ўсіх вашых змяненняў з асноўнай галіной гэтага праекта. Вы атрымаеце паведамленне па электроннай пошце, калі змены будуць прынятыя (ўнесены ў галоўную галіну).
|
||||
|
||||
Асноўная галіна вашага рэпазітара не будзе зменена. Для сінхранізацыі выканайце крокі, размешчаныя ніжэй.
|
||||
|
||||
## Сінхранізуецца ваша адгалінаванне з дадзеным рэпазітаром
|
||||
|
||||
Перш за ўсё перайдзіце ў асноўную галіну:
|
||||
```
|
||||
git checkout master
|
||||
```
|
||||
Затым дадайце url майго рэпазітара ў полі `upstream remote url`:
|
||||
```
|
||||
git remote add upstream https://github.com/Roshanjossey/first-contributions
|
||||
```
|
||||
Такім чынам мы паведамім git, што існуе іншая версія дадзенага праекта па пэўнай спасылцы, і мы яе лічым майстрам. Як толькі змены смержены, падгрузіць новую версію майго рэпазітара.
|
||||
```
|
||||
git fetch upstream
|
||||
```
|
||||
|
||||
Такім чынам мы забралі ўсе змены ў маім адгалінаванні (upstream remote). Пасля, вам трэба зліць новую версію майго рэпазітара з вашай майстар-галіной.
|
||||
```
|
||||
git rebase upstream/master
|
||||
```
|
||||
Так вы ўжываеце ўсе змены, якія вы падцягнулі да вашай майстар-галіны. Калі вы запушите зараз майстар-галіна, ваша адгалінаванне таксама будзе ўтрымліваць змены.
|
||||
```
|
||||
git push origin master
|
||||
```
|
||||
Звярніце ўвагу, што вы робіце push ў выдаленай рэпазітар origin.
|
||||
|
||||
На гэтым этапе я аб'яднаў вашу галіну `<add-your-name>` са сваёй майстар-галіной, а вы аб'ядналі сваю майстар-галіна з маёй. Ваша галіна больш не патрэбна, вы можаце выдаліць яе:
|
||||
```
|
||||
git branch -d <add-your-name>
|
||||
```
|
||||
Таксама можаце выдаліць яе версію ў аддаленым рэпазітары:
|
||||
```
|
||||
git push origin --delete <add-your-name>
|
||||
```
|
||||
Гэта зусім не абавязкова, але назва гэтай галіны адлюстроўвае яе даволі спецыфічнае прызначэнне. І працягласць яе жыцця можа быць адпаведна кароткай.
|
||||
|
||||
## Выкарыстанне іншых інструментаў
|
||||
|
||||
| <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) |
|
||||
|
||||
|
||||
## Што далей?
|
||||
|
||||
Ніжэй некалькі папулярных рэпазітароў, дзе вы можаце знайсці заданні для пачаткоўцаў. Наперад, перайдзіце ў рэпазітары, каб даведацца больш.
|
||||
|
||||
| [](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22) | [](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [<img width="100" src="https://cdn.worldvectorlogo.com/logos/react-2.svg">](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22) | [](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [<img width="100" src="https://camo.githubusercontent.com/0f302c808c8457f6460913e33aed3478124612c2/687474703a2f2f6c65696e696e67656e2e6f72672f696d672f6c65696e696e67656e2e6a7067">](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie) | [<img width="100" src="https://images.plot.ly/plotly-documentation/thumbnail/numpy-logo.jpg">](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22) | [](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22) |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [exercism](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22) | [Fun Retros](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [react](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22) | [habitat](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [scikit-learn](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [Leiningen](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie) | [numpy](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22) | [elasticsearch](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22) |
|
||||
| [](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) | [](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy) | [](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22) | [](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy) | [](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs) | [](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer) | [](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs) |
|
||||
| [homebrew](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) | [Rust](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy) | [vuejs](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22) | [Suave](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy) | [OpenRA](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [PowerShell](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs) | [coala](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer) | [moment](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs) |
|
||||
| [](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22) | [](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22) | [](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) | [](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level) | [](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [<img width="100" src="https://cdn.worldvectorlogo.com/logos/brackets-1.svg">](https://github.com/adobe/brackets/labels/Starter%20bug) |
|
||||
| [ava](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22) | [freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [webpack](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22) | [hoodie](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [pouchdb](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) | [neovim](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level) | [babel](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [brackets](https://github.com/adobe/brackets/labels/Starter%20bug) |
|
||||
| [](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | [<img width="100" src="https://github.com/Semantic-Org/Semantic-UI-React/raw/master/docs/public/logo.png">](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |
|
||||
| [Node.js](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | [Semantic-UI-React](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |
|
||||
@@ -1,121 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
# Primeres Contribucions
|
||||
|
||||
És difícil. Sempre es difícil fer una cosa per primera vegada. Sobretot quan es col·labora amb altres, ja que equivocar-se no és gens agradable. Volem simplificar la manera d'aprendre a contribuir i col·laborar en projectes de codi obert per primera vegada.
|
||||
|
||||
Llegir articles i mirar tutorials pot ser útil, però què millor que fer les coses en un entorn pràctic real? Aquest projecte és una guia per a principiants que vol simplificar la primera contribució a projectes de codi oberts. Si vols fer la teva primera contribució, segueix les instruccions que es mostren a continuació:
|
||||
|
||||
#### *Si no et sents còmode/a amb la línia d'ordres (*Command Line*), [aquí trobaràs tutorials utilitzant eines que tenen Interfície Gràfica (GUI)](#Tutorials-amb-Altres-Eines)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fer fork d'aquest repositori" />
|
||||
|
||||
Si no tens git al teu ordinador, l'hauràs d'[instal·lar]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Bifurca (*Fork*) aquest respositori
|
||||
|
||||
Fes una *fork* d'aquest repositori clicant al botó "*Fork*" a la part superior dreta d'aquesta pàgina.
|
||||
Això crearà una còpia d'aquest repositori al teu compte de GitHub.
|
||||
|
||||
## Clona (*Clone*) el repositori
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonar aquest repositori" />
|
||||
|
||||
Clona aquest repositori al teu ordinador: ves al teu compte de GitHub, fes clic al botó clonar "*clone or download*" del repositori, i després clica a la icona de *copiar al porta-retalls*.
|
||||
|
||||
Obre una terminal/línia d'ordre i executa el següent comandament de git:
|
||||
|
||||
```
|
||||
git clone "url que acabes de copiar"
|
||||
```
|
||||
on "url que acabeu de copiar" (sense cometes dobles) és la *url* per a aquest repositori (la vostra bifurcació o *fork* d'aquest projecte). Per obtenir la *url*, torna als passos anteriors.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copiar URL al porta-retalls" />
|
||||
|
||||
Per exemple:
|
||||
```
|
||||
git clone https://github.com/aquest-soc-jo/first-contributions.git
|
||||
```
|
||||
on `aquest-soc-jo` és el teu nom d'usuari de GitHub. En aquest pas, estàs copiant el contingut del repositori *first-contributions* de GitHub al teu ordinador.
|
||||
|
||||
## Crea una branca (*branch*)
|
||||
|
||||
Canvieu al directori del repositori del vostre ordinador (si no hi esteu allà ja):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Crea una nova branca (*branch*) utilitzant el comandament `git checkout`:
|
||||
```
|
||||
git checkout -b <afegiu-el-nom-de-la-nova-branca>
|
||||
```
|
||||
|
||||
Per exemple:
|
||||
```
|
||||
git checkout -b add-nom-cognom
|
||||
```
|
||||
(No fa falta que el nom de la branca contingui la paraula *add* però és recomanable, ja que l'objectiu d'aquesta branca és afegir el teu nom a la llista.)
|
||||
|
||||
## Fes els canvis necessaris i confirma (*commit*) els canvis
|
||||
|
||||
Obre l'arxiu `Contributors.md` en un editor de text i afegeix-hi el teu nom. No l'afegeixis ni al principi, ni al final de l'arxiu. Posa'l en qualsevol altre posició. Llavors desa l'arxiu.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
|
||||
Ara, si vas al directori del projecte i executes el comandament `git status`, veuràs els canvis.
|
||||
|
||||
|
||||
Afegeix aquests canvis a la branca que acabes de crear utilitzant el comandament `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Confirma (*commit*) els canvis utilitzant el comandament `git init`:
|
||||
```
|
||||
git commit -m "Add <el-meu-nom> to Contributors list"
|
||||
```
|
||||
reemplaçant `<el-meu-nom>` amb el teu nom.
|
||||
|
||||
## Empeny (*Push*) els canvis cap a GitHub
|
||||
|
||||
Envia els canvis utilitzant el comandament `git push`:
|
||||
```
|
||||
git push origin <afegiu-el-nom-de-la-branca>
|
||||
```
|
||||
reemplaçant `<afegiu-el-nom-de-la-branca>` amb el nom de la branca que has creat anteriorment.
|
||||
|
||||
## Envia (*Submit*) els canvis per tal que siguin revisats
|
||||
|
||||
Si ara vas al teu respositori a GitHub, veuràs un botó `Compare & pull request` (Compara i fes una solicitud d'incorporació). Fes clic en aquest botó.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="crear una pull request" />
|
||||
|
||||
Envia la solicitud d'incorporació (*pull request*).
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="envia la pull request" />
|
||||
|
||||
Quan un administrador vegi la solicitud, la revisarà i incorporarà els teus canvis a la branca principal (*main branch*) del projecte. Rebràs una notificació per correu electrònic quan els canvis s'hagin incorporat.
|
||||
|
||||
## I ara què?
|
||||
|
||||
Enhorabona! Acabes de completar el procés de treball principal que et trobaràs com a col·laborador de projectes de codi obert: *_fork -> clone -> edit -> PR_*.
|
||||
|
||||
Ara, celebra la teva contribució i comparteix-la amb els teus amics i seguidors anant a [la web](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Si vols contribuir al projecte, pots començar amb aquesta [guia per contribuir al codi](https://github.com/roshanjossey/code-contributions).
|
||||
|
||||
A continuació, et pots preparar per contribuir a altres projectes. Hem reunit una llista de projectes amb tasques (*issues*) pendents fàcils per tal de poder començar. Fes un cop d'ull a [la llista de projectes aquí](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Material extra](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Tutorials utilitzant altres eines
|
||||
|
||||
| <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/Readme/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](https://www.jetbrains.com/idea/download/#section=windows) |
|
||||
@@ -1,129 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Primeras Contribuciones
|
||||
|
||||
Uy, la cosa está complicada. La primera vez que uno le mete la ficha a algo nuevo es re difícil, ¿sí o qué? Más cuando toca camellar con otra gente, porque nadie quiere meter las patas y quedar como un guevón. Nosotros queremos es que los pipiolos que le quieren entrar al código abierto la tengan más suave para aprender y aportar su granito de arena.
|
||||
|
||||
Bacano leer artículos y ver tutoriales y toda esa vaina, pero nada como aprender haciendo, ¿o no? Este proyecto es una guía re chévere para que los novatos le cojan el tiro a esto de contribuir por primera vez. Si quieres estrenar tus pinitos en esto, sigue estos pasos al pie de la letra:
|
||||
|
||||
#### _Si no le has cogido el tiro a la consola,[acá tenés tutoriales con herramientas más amigables (GUI)](#Tutoriales-con-otras-herramientas)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork de este repositorio" />
|
||||
|
||||
Si no tenés git en tu aparato, podés encontrar cómo instalarlo en[este link](https://docs.github.com/es/get-started/quickstart/set-up-git).
|
||||
|
||||
## Hacele un (_Fork_) a este repositorio
|
||||
|
||||
Dale click al botón de "_Fork_" allá arriba a la derecha de esta página.
|
||||
Eso te va a crear una copia de este repositorio en tu cuenta, facilito.
|
||||
|
||||
## Clona (_Clone_) el repositorio Forkeado
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonar este repositorio" />
|
||||
|
||||
Ahora toca clonar este repositorio en tu compu. Andate a tu cuenta de GitHub, dale al botón de "_clone or download_" y después al iconito para _copiar al portapapeles_.
|
||||
|
||||
Abre tu consola o terminal y ejecuta el siguiente comando de git:
|
||||
|
||||
```
|
||||
git clone "url que acabas de copiar"
|
||||
```
|
||||
|
||||
Donde dice "url que acabas de copiar" (sin las comillas, ojo) es la _url_ de este repositorio (tu _fork_ del proyecto). Mira los pasos de antes para sacar la _url_.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copiar URL al portapapeles" />
|
||||
|
||||
Por ejemplo:
|
||||
|
||||
```
|
||||
git clone https://github.com/este-eres-tu/first-contributions.git
|
||||
```
|
||||
|
||||
Cambiá `este-eres-tu` por tu usuario de GitHub. Acá estás copiando todo el contenido del repositorio _first-contributions_ de GitHub a tu compu.
|
||||
|
||||
## Crea una rama (_Branch_)
|
||||
|
||||
Metete al directorio del repositorio en tu compu (si no estás ya ahí).
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Ahora crea una rama (_branch_) usando el comando `git checkout`:
|
||||
|
||||
```
|
||||
git checkout -b <añade tu nombre>
|
||||
```
|
||||
|
||||
Por ejemplo:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
(No es obligatorio que el nombre de la rama tenga la palabra add, pero tiene sentido ponerla porque la idea de esta rama es agregar tu nombre a la lista.)
|
||||
|
||||
## Hacé los cambios necesarios y confirmalos (_Commit_)
|
||||
|
||||
Abrí el archivo `Contributors.md` en un editor de texto y agregá tu nombre. No lo pongas ni al principio ni al final del archivo, metelo en cualquier otro lado. Guardá el archivo.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Si vas al directorio del proyecto y ejecutas el comando `git status`, verás que hay cambios.
|
||||
|
||||
Agrega esos cambios a la rama (_branch_) que creaste anteriormente usando el comando `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Ahora hacele un _commit_ a esos cambios ejecutando el comando `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Add <tu-nombre> to Contributors list"
|
||||
```
|
||||
|
||||
cambiando `<tu-nombre>` por tu nombre, obviamente.
|
||||
|
||||
## Subí (_Push_) tus cambios a GitHub
|
||||
|
||||
Mandale un _push_ de tus cambios usando el comando `git push`:
|
||||
|
||||
```
|
||||
git push origin <añade-el-nombre-de-la-rama>
|
||||
```
|
||||
|
||||
Reemplaza `<añade-el-nombre-de-la-rama>` con el nombre de la rama que creaste antes.
|
||||
|
||||
## Mandá (_Submit_) tus cambios para que los revisen
|
||||
|
||||
Si vas a tu repositorio en GitHub, verás un botón `Compare & pull request`. Dale click sobre este botón.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="crea una pull request" />
|
||||
|
||||
Ahora mandá la _pull request_.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="enviar la pull request" />
|
||||
|
||||
Dentro de poco voy a estar fusionando tus cambios (haciendo merge) con la rama master de este proyecto. Te va a llegar un correo cuando los cambios estén fusionados.
|
||||
|
||||
## ¿Y ahora qué sigue?
|
||||
|
||||
¡Felicitaciones parcero! ¡Le diste la vuelta completa al proceso _fork -> clone -> edit -> PR_ que vas a usar un montón como contribuidor!
|
||||
|
||||
Celebrá tu aporte y compartilo con tus amigos y seguidores en la.[web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
También te podés unir a nuestro equipo de Slack si necesitás una mano o tenés alguna pregunta.[Unite a nuestro Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Ahora dale, empezá a contribuir a otros proyectos. Armamos una lista de proyectos con issues fáciles para que arranques. Dale una mirada a la[lista de proyectos en la aplicación web](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Tutoriales con otras herramientas
|
||||
|
||||
| <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/2/2d/Visual_Studio_Code_1.18_icon.svg" 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) |
|
||||
@@ -1,126 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
# První příspěvek
|
||||
|
||||
Život je těžký. Obzvláště když něco děláte poprvé. V případě, že na něčem spolupracujete, není dělání chyb něco, co by vám dělalo radost. My bychom rádi zjednodušili cestu novým přispěvatelům do open-source při jejich učení se jak na to.
|
||||
|
||||
Čtení článků nebo zhlédnutí video návodů jsou také cesty, ale co je lepší než si danou věc přímo osahat na vlastní kůži v reálném prostředí? Tento projekt je zaměřen na poskytnutí pomoci začátečníkům s jejich prvním přispěním do open-source. Pokud jste jím právě vy, následujte kroky popsané níže.
|
||||
|
||||
#### *Pokud nemáte rádi příkazovou řádku, [zde najdete návody na použití nástrojů s GUI (grafické uživatelské rozhraní)](#Návod-za-použití-dalších-nástrojů)*
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="forkněte tento repozitář" />
|
||||
|
||||
Pokud namáte nainstalovaný git, [nainstalujte si jej]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Forkněte tento repozitář
|
||||
|
||||
Forkněte (vytvoření kopie z originálu, z anglického *fork* – *vidlička*, jako vytvoření nové odnože) tento repozitář kliknutím na tlačítko **Fork** nahoře na této stránce. Tím vytvoříte kopii tohoto repozitáře na svém vlastním GitHub účtu.
|
||||
|
||||
## Naklonujte repozitář
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="naklonujte tento repozitář" />
|
||||
|
||||
Nyní naklonujte (anglicky *clone*) forknutý repozitář na váš počítač, naklonování není nic jiného než stáhnutí obrazu repozitáře k vám na počítač. Na vašem GitHub účtu si otevřete forknutý repozitář, klikněte na tlačítko **Clone or download** a následně v okýnku, které se objeví, klikněte na tlačítko s ikonkou **copy to clipboard** vedle URL adresy, čímž si ji zkopírujete do schránky.
|
||||
|
||||
Teď otevřete terminál a spusťte následující příkaz:
|
||||
|
||||
```
|
||||
git clone "url které jste právě zkopírovali"
|
||||
|
||||
```
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="zkopírujte adresu do schránky" />
|
||||
|
||||
Například:
|
||||
|
||||
```
|
||||
git clone https://github.com/vase-username/first-contributions.git
|
||||
```
|
||||
|
||||
Tímto na svém počítači vytvoříte složku se soubory daného repozitáře.
|
||||
|
||||
## Vytvořte větev
|
||||
|
||||
V příkazové řádce se přepněte do složky s repozitářem (pokud v ní už nejste)
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Nyní vytvořte novou větev (anglicky *branch*) za použití příkazu `git checkout`:
|
||||
|
||||
```
|
||||
git checkout -b <jmeno-nove-vetve>
|
||||
```
|
||||
|
||||
Například:
|
||||
```
|
||||
git checkout -b pridani-meho-jmena
|
||||
```
|
||||
|
||||
Jméno větve by mělo vypovídat o tom, co kód nebo cokoliv jiného do ní přidané bude dělat/vykonávat, případně proč se daná věc děje.
|
||||
|
||||
## Udělejte změny a zaznamenejte je
|
||||
|
||||
Otevřete soubor `Contributors.md` v textovém editoru a přidejte do něj své jméno. Napiště jej někam doprostřed a soubor uložte.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme//git-status.png" alt="git status" />
|
||||
|
||||
Pokud teď v příkazové řádce spustíte příkaz `git status`, uvidíte jaké změny byly v repozitáři provedeny.
|
||||
|
||||
Tyto změny do dané větvě přidáte příkazem `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Zbývá už jen potvrdit (anglicky *commit*) změny příkazem `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Add <vase-jmeno> to Contributors list"
|
||||
```
|
||||
|
||||
Za přepínač `-m` se píše co dané změny představují, popis by měl být jednoduchý ale výstižný.
|
||||
|
||||
## Protlačte změny na GitHub
|
||||
|
||||
Nyní změny provedené lokálně na počítači protlačíme (anglicky *push*) na GitHub příkazem `git push`:
|
||||
|
||||
```
|
||||
git push origin <jmeno-vasi-vetve>
|
||||
```
|
||||
|
||||
## Předložte své změny k posouzení
|
||||
|
||||
Pokud se nyní podíváte do svého GitHub repozitáře, uvidíte tlačítko **Compare & pull request**. Klikněte na něj.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme//compare-and-pull.png" alt="vytvořte pull request" />
|
||||
|
||||
Teď vytvořte žádost o přetažení vaší větve do originálního repozitáře (anglicky *pull request*).
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme//submit-pull-request.png" alt="potvrďte pull request" />
|
||||
|
||||
Brzy budou správci provádět zapracování vašich změn do hlavní (anglicky *master*) větve tohoto projektu. Až se do ní vaše změny dostanou, dostanete e-mailové upozornění.
|
||||
|
||||
## Kam dále?
|
||||
|
||||
Blahopřejeme! Právě jste dokončili standardní _fork -> clone -> edit ->_ průběh práce (anglicky *workflow*), se kterým se jako přispěvatel do projektů setkáte dennodenně.
|
||||
|
||||
Oslavte svůj první příspěvek se svými přáteli a následovníky přes [webovou aplikaci](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Pokud byste chtěli více praxe, můžete zkusit [code contributions](https://github.com/roshanjossey/code-contributions).
|
||||
|
||||
Nyní vám už nic nebrání v příspívání do ostatních projektů. Připravili jsme pro vás seznam projektů, které mají jednoduché záležitosti k vyřešení/naprogramování, se kterými můžete začít. Podívejte se [zde](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Další materiály](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Návod za použití dalších nástrojů
|
||||
|
||||
| <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) |
|
||||
@@ -1,128 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Første bidrag
|
||||
|
||||
Det er svært. Det er altid svært når det er første gang. Specielt hvis man samarbejder er det ikke rart at begå fejl. Vi vil simplificere den store udfordring det er for nybegyndere at lære om open-source, og at lave deres første bidrag.
|
||||
|
||||
At læse artikler og se video guides hjælper, men hvad er bedre end at bruge det i praksis? Dette projekt håber at kunne tilbyde vejledning og gøre det overkommeligt for alle at lave deres første open-source bidrag.
|
||||
|
||||
#### _Hvis du ikke er komfortabel med command line, [her er vejledninger til GUI værktøjer](#Guides-med-andre-værktøjer)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Har du ikke Git på din maskine kan du [installere det](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Fork dette repository
|
||||
|
||||
Fork dette repo ved at klikke på "fork" knappen øverst på siden.
|
||||
Dette vil lave en kopi af projektet i din Github konto.
|
||||
|
||||
## Clone dette repository
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Næste trin er at "clone" dit nye repository til din maskine. Naviger til din Github account og åbn dit nye repository, derefter find "clone" øverst oppe og tryk på knappen. Tryk _copy to clipboard_ ikonet.
|
||||
|
||||
Åbn en terminal og kør den følgende git command:
|
||||
|
||||
```
|
||||
git clone "din url"
|
||||
```
|
||||
|
||||
hvor "din url" skal erstattes med den URL du kopieret i forrige trin.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Eksempel:
|
||||
|
||||
```
|
||||
git clone https://github.com/dit-brugernavn/first-contributions.git
|
||||
```
|
||||
|
||||
Erstat 'dit-brugernavn' med dit GitHub brugernavn. Her kopierer vi indholdet af first-contributions repositoriet fra din Github konto, til din lokale PC.
|
||||
|
||||
## Opret en branch
|
||||
|
||||
Åbn en konsol og cd til dit lokale repository (hvis ikke du allerede er der):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Derefter opretter du en branch med kommandoen `git checkout`:
|
||||
|
||||
```
|
||||
git checkout -b <add-your-change>
|
||||
```
|
||||
|
||||
Eksempel:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
(Navnet på din branch behøver ikke at indeholde ordet _add_, men det giver mening at inkludere det her da branchen er til for at tilføje dit navn til en liste med navne.)
|
||||
|
||||
## Lav dine ændringer og commit dem
|
||||
|
||||
Åben filen `Contributors.md` i en text editor og tilføj dit navn til listen. Undgå at tilføje dit navn øverst eller nederst på listen, men helst et sted i mellem. Når dette er gjort så gem filen.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Hvis du går til konsollen og kører kommandoen `git status`, vil du se dine ændringer.
|
||||
|
||||
Tilføj disse ændringer til din branch med kommandoen `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Derefter commit ændringerne med kommandoen `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Add <dit-navn> to Contributors list"
|
||||
```
|
||||
|
||||
Erstat `<dit-navn>` med dit Github brugernavn.
|
||||
|
||||
## Push ændringer til Github
|
||||
|
||||
Push dine ændringer til Github med kommandoen `git push`:
|
||||
|
||||
```
|
||||
git push origin <add-din-branch>
|
||||
```
|
||||
|
||||
Erstat `<add-din-branch>` med navnet på den branch du oprettede tidligere.
|
||||
|
||||
## Indgiv ændringer til inspektion
|
||||
|
||||
Hvis du går ind på dit repository på Github, så vil du se en `compare & pull request` knap. Klik på den.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Indgiv nu din pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Snart vil jeg merge dine ændringer ind i master branch'en af projektet. Du vil modtage en notifikation per email når dine ændringer er blevet merget.
|
||||
|
||||
## Hvor til nu?
|
||||
|
||||
Tillykke! Du har nu gennemført den udbredte _fork -> clone -> edit -> PR_ workflow som du vil støde oftest på som contributor!
|
||||
|
||||
Fejr dit bidrag og del det med dine venner og følgere ved at gå til [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Du kan også tilslutte dig vores code-contributions repo, hvis du er klar til at løse mere avancerede problemer. [Join code-contributions repo](https://github.com/firstcontributions/code-contributions).
|
||||
|
||||
Tillad os også at hjælpe dig i gang med dine næste bidrag. Vi har kompileret en liste af projekter med letty, overkommelige problemer du kan starte ud med. Check den ud her: [the list of projects in web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [ekstra materiale](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Guides med andre værktøjer
|
||||
|
||||
| <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) |
|
||||
@@ -1,249 +0,0 @@
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
#### _Read this in [other languages](../translations/Translations.md)._
|
||||
<kbd>[<img title="Shqip" alt="Shqip" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/al.svg" width="22">](../translations/README.al.md)</kbd>
|
||||
<kbd>[<img title="Armenian" alt="Armenian" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/am.svg" width="22">](../translations/README.arm.md)</kbd>
|
||||
<kbd>[<img title="Uzbek" alt="Uzbek language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/uz.svg" width="22">](../translations/README.uz.md)</kbd>
|
||||
<kbd>[<img title="Azərbaycan dili" alt="Azərbaycan dili" src="https://cdn.statically.io/flags/az.svg" width="22">](../translations/README.aze.md)</kbd>
|
||||
<kbd>[<img title="বাংলা" alt="বাংলা" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/bd.svg" width="22">](../translations/README.bn.md)</kbd>
|
||||
<kbd>[<img title="Bulgarian" alt="Bulgarian" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/bg.svg" width="22">](../translations/README.bg.md)</kbd>
|
||||
<kbd>[<img title="Português (Brasil)" alt="Português (Brasil)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/br.svg" width="22">](../translations/README.pt_br.md)</kbd>
|
||||
<kbd>[<img title="Català" alt="Català" src="https://firstcontributions.github.io/assets/Readme/catalan1.png" width="22">](../translations/README.ca.md)</kbd>
|
||||
<kbd>[<img title="中文 (Simplified)" alt="中文 (Simplified)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/cn.svg" width="22">](../translations/README.zh-cn.md)</kbd>
|
||||
<kbd>[<img title="Czech" alt="Czech" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/cz.svg" width="22">](../translations/README.cs.md)</kbd>
|
||||
<kbd>[<img title="Deutsch" alt="Deutsch" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/de.svg" width="22">](../translations/README.de.md)</kbd>
|
||||
<kbd>[<img title="Dansk" alt="Dansk" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/dk.svg" width="22">](../translations/README.da.md)</kbd>
|
||||
<kbd>[<img title="المصرية" alt="المصرية" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/eg.svg" width="22">](../translations/README.eg.md)</kbd>
|
||||
<kbd>[<img title="Dezéiriya" alt="Dezéiriya" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/dz.svg" width="22">](../translations/README.dz.md)</kbd>
|
||||
<kbd>[<img title="Español de España" alt="Español de España" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/es.svg" width="22">](../translations/README.es.md)</kbd>
|
||||
<kbd>[<img title="Française" alt="Française" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/fr.svg" width="22">](../translations/README.fr.md)</kbd>
|
||||
<kbd>[<img title="Gaeilge" alt="Gaeilge" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ie.svg" width="22">](../translations/README.ga.md)</kbd>
|
||||
<kbd>[<img title="Galego" alt="Galego" src="https://upload.wikimedia.org/wikipedia/commons/thumb/6/64/Flag_of_Galicia.svg/1200px-Flag_of_Galicia.svg.png" width="22">](../translations/README.gl.md)</kbd>
|
||||
<kbd>[<img title="Ελληνικά" alt="Ελληνικά" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/gr.svg" width="22">](../translations/README.gr.md)</kbd>
|
||||
<kbd>[<img title="ქართული" alt="ქართული" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ge.svg" width="22">](../translations/README.ge.md)</kbd>
|
||||
<kbd>[<img title="Magyar" alt="Magyar" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/hu.svg" width="22">](../translations/README.hu.md)</kbd>
|
||||
<kbd>[<img title="Bahasa Indonesia" alt="Bahasa Indonesia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/id.svg" width="22">](../translations/README.id.md)</kbd>
|
||||
<kbd>[<img title="עִברִית" alt="עִברִית" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/il.svg" width="22">](../translations/README.hb.md)</kbd>
|
||||
<kbd>[<img title="हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்" alt="हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/in.svg" width="22">](../translations/Translations.md)</kbd>
|
||||
<kbd>[<img title="தமிழ்" alt="தமிழ்" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lk.svg" width="22">](../translations/README.ta.md)</kbd>
|
||||
<kbd>[<img title="فارسی" alt="فارسی" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ir.svg" width="22">](../translations/README.fa.md)</kbd>
|
||||
<kbd>[<img title="Italiano" alt="Italiano" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/it.svg" width="22">](../translations/README.it.md)</kbd>
|
||||
<kbd>[<img title="日本語" alt="日本語" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/jp.svg" width="22">](../translations/README.ja.md)</kbd>
|
||||
<kbd>[<img title="සිංහල" alt="සිංහල" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lk.svg" width="22">](../translations/README.si.md)</kbd>
|
||||
<kbd>[<img title="Kiswahili (Kenya)" alt="Kiswahili (Kenya)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ke.svg" width="22">](../translations/README.kws.md)</kbd>
|
||||
<kbd>[<img title="한국어" alt="한국어" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kr.svg" width="22">](../translations/README.ko.md)</kbd>
|
||||
<kbd>[<img title="Lietuvių kalba" alt="Lietuvių kalba" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lt.svg" width="22">](../translations/README.lt.md)</kbd>
|
||||
<kbd>[<img title="Limba Română" alt="Limba Română" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/md.svg" width="22"> <img title="Limba Română" alt="Limba Română" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ro.svg" width="22">](../translations/README.ro.md)</kbd>
|
||||
<kbd>[<img title="မြန်မာ" alt="မြန်မာ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mm.svg" width="22">](../translations/README.mm_unicode.md)</kbd>
|
||||
<kbd>[<img title="Македонски" alt="Македонски" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mk.svg" width="22">](../translations/README.mk.md)</kbd>
|
||||
<kbd>[<img title="Español de México" alt="Español de México" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mx.svg" width="22">](../translations/README.mx.md)</kbd>
|
||||
<kbd>[<img title="Bahasa Melayu / بهاس ملايو / Malay" alt="Bahasa Melayu / بهاس ملايو / Malay" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/my.svg" width="22">](../translations/README.my.md)</kbd>
|
||||
<kbd>[<img title="Dutch" alt="Dutch" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/nl.svg" width="22">](../translations/README.nl.md)</kbd>
|
||||
<kbd>[<img title="Norsk" alt="Norsk" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/no.svg" width="22">](../translations/README.no.md)</kbd>
|
||||
<kbd>[<img title="नेपाली" alt="नेपाली" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/np.svg" width="15">](../translations/README.np.md)</kbd>
|
||||
<kbd>[<img title="Wikang Filipino" alt="Wikang Filipino" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ph.svg" width="22">](../translations/README.fil.md)</kbd>
|
||||
<kbd>[<img title="English (Pirate)" alt="English (Pirate)" src="https://firstcontributions.github.io/assets/Readme/pirate.png" width="22">](../translations/README.en-pirate.md)</kbd>
|
||||
<kbd>[<img title="اُاردو" alt="اردو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pk.svg" width="22">](../translations/README.ur.md)</kbd>
|
||||
<kbd>[<img title="Twi (Ghana)" alt="Twi (Ghana)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/gh.svg" width="22">](../translations/README.gh.md)</kbd>
|
||||
<kbd>[<img title="Polski" alt="Polski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pl.svg" width="22">](../translations/README.pl.md)</kbd>
|
||||
<kbd>[<img title="Português (Portugal)" alt="Português (Portugal)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pt.svg" width="22">](../translations/README.pt-pt.md)</kbd>
|
||||
<kbd>[<img title="Русский язык" alt="Русский язык" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ru.svg" width="22">](../translations/README.ru.md)</kbd>
|
||||
<kbd>[<img title="العربية" alt="العربية" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/sa.svg" width="22">](../translations/README.ar.md)</kbd>
|
||||
<kbd>[<img title="Svenska" alt="Svenska" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/se.svg" width="22">](../translations/README.se.md)</kbd>
|
||||
<kbd>[<img title="Slovenčina" alt="Slovenčina" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/sk.svg" width="22">](../translations/README.slk.md)</kbd>
|
||||
<kbd>[<img title="Slovenščina" alt="Slovenščina" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/si.svg" width="22">](../translations/README.sl.md)</kbd>
|
||||
<kbd>[<img title="ภาษาไทย" alt="ภาษาไทย" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/th.svg" width="22">](../translations/README.th.md)</kbd>
|
||||
<kbd>[<img title="Türkçe" alt="Türkçe" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tr.svg" width="22">](../translations/README.tr.md)</kbd>
|
||||
<kbd>[<img title="中文(Traditional)" alt="中文(Traditional)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tw.svg" width="22">](../translations/README.zh-tw.md)</kbd>
|
||||
<kbd>[<img title="Українська" alt="Українська" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ua.svg" width="22">](../translations/README.ua.md)</kbd>
|
||||
<kbd>[<img title="Tiếng Việt" alt="Tiếng Việt" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/vn.svg" width="22">](../translations/README.vn.md)</kbd>
|
||||
<kbd>[<img title="Tanzania" alt="Swahili language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tz.svg" width="22">](../translations/README.sw.md)</kbd>
|
||||
<kbd>[<img title="Zulu (South Africa)" alt="Zulu (South Africa)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/za.svg" width="22">](../translations/README.zul.md)</kbd>
|
||||
<kbd>[<img title="Afrikaans (South Africa)" alt="Afrikaans (South Africa)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/za.svg" width="22">](../translations/README.afk.md)</kbd>
|
||||
<kbd>[<img title="Igbo (Nigeria)" alt="Igbo (Nigeria)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ng.svg" width="22">](../translations/README.igb.md)</kbd>
|
||||
<kbd>[<img title="Bambara (Mali)" alt="Bambara (Mali)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ml.svg" width="22">](../translations/README.mli.md)</kbd>
|
||||
<kbd>[<img title="Hausa (Nigeria)" alt="Hausa (Nigeria)" src="https://upload.wikimedia.org/wikipedia/commons/thumb/5/5d/Flag_of_the_Hausa_people.svg/1280px-Flag_of_the_Hausa_people.svg.png" width="22">](../translations/README.hau.md)</kbd>
|
||||
<kbd>[<img title="Yoruba (Nigeria)" alt="Yoruba (Nigeria)" src="https://www.fotw.info/images/n/ng%7Deoyor.gif" width="22">](../translations/README.yor.md)</kbd>
|
||||
<kbd>[<img title="Latvia" alt="Latvia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lv.svg" width="22">](../translations/README.lv.md)</kbd>
|
||||
<kbd>[<img title="Suomeksi" alt="Suomeksi" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/fi.svg" width="22">](../translations/README.fi.md)</kbd>
|
||||
<kbd>[<img title="Беларуская мова" alt="Беларуская мова" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/by.svg" width="22">](../translations/README.by.md)</kbd>
|
||||
<kbd>[<img title="Српски" alt="Српски" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/rs.svg" width="22">](../translations/README.sr.md)</kbd>
|
||||
<kbd>[<img title="Қазақша" alt="Қазақша" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kz.svg" width="22">](../translations/README.kz.md)</kbd>
|
||||
<kbd>[<img title="Bosanski" alt="Bosanski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ba.svg" width="22">](../translations/README.bih.md)</kbd>
|
||||
<kbd>[<img title="Bosanski" alt="Bosanski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/et.svg" width="22">](../translations/README.bih.md)</kbd>
|
||||
<kbd>[<img title="Hrvatski" alt="Hrvatski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/hr.svg" width="22">](../translations/README.hr.md)</kbd>
|
||||
<kbd>[<img title="پښتو" alt="پښتو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/af.svg" width="22">](../translations/README.ps.md)</kbd>
|
||||
<kbd>[<img title="Af-soomaali" alt="Somalia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/so.svg" width="22">](../translations/README.so.md)</kbd>
|
||||
<kbd>[<img title="Español de Ecuador" alt="Ecuador" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ec.svg" width="22">](../translations/README.ec.md)</kbd>
|
||||
<kbd>[<img title="Luganda (Uganda)" alt="Luganda (Uganda)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ug.svg" width="22">](../translations/README.lug.md)</kbd>
|
||||
<kbd>[<img title="Turkmen" alt="Turkmen language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tm.svg" width="22">](../translations/README.tm.md)</kbd>
|
||||
<kbd>[<img title="Ewe (TOGO)" alt="Ewe (TOGO)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tg.svg" width="22">](../translations/README.ewe.md)</kbd>
|
||||
<kbd>[<img title="አማርኛ" alt="አማርኛ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/et.svg" width="22">](../translations/README.et.md)</kbd>
|
||||
<kbd>[<img title="Kurdî" alt="Kurdî" src="https://upload.wikimedia.org/wikipedia/commons/3/35/Flag_of_Kurdistan.svg" width="22">](../translations/README.kr.md)</kbd>
|
||||
<kbd>[<img title="Malagasy" alt="Malagasy" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mg.svg" width="22">](../translations/README.mg.md)</kbd>
|
||||
<kbd>[<img title="ភាសាខ្មែរ" alt="ភាសាខ្មែរ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kh.svg" width="22">](../translations/README.kh.md)</kbd>
|
||||
<kbd>[<img title="Morocco" alt="Moroccan Darija" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ma.svg" width="22">](../translations/README.ma.md)</kbd>
|
||||
|
||||
# First Contributions
|
||||
|
||||
Dieses Projekt zielt darauf ab, Anfängern den Einstieg zu erleichtern und sie bei ihrem ersten Beitrag zu unterstützen. Wenn du deinen ersten Beitrag leisten möchten, befolge die folgenden Schritte.
|
||||
|
||||
_Wenn du nicht weißt wie man das Terminal/CMD bedient, [hier findest du Anleitungen für GUI Tools.](#Anleitungen-für-andere-Tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="Forke dieses Repository" />
|
||||
|
||||
#### Wenn du Git nicht auf deinem System installiert hast, [installiere es](https://...github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## Forke dieses Repository
|
||||
|
||||
Forke dieses Repository indem du auf den Fork Button oben auf dieser Seite klickst.
|
||||
Dies wird eine Kopie dieses Repository's in deinem Account erstellen.
|
||||
|
||||
## Klone das Repository
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="Klone dieses Repository" />
|
||||
|
||||
Klone jetzt das geforkte Repository auf deinen Computer. Gehe zu deinem Github Account, öffne das geforkte Repository, drücke auf den Code Button, dann auf den SSH Tab und dann drücke auf das _copy url to clipboard_ icon.
|
||||
|
||||
Öffne ein Terminal Fenster und führe den folgenden Git Befehl aus:
|
||||
|
||||
```bash
|
||||
git clone "kopierte url"
|
||||
```
|
||||
|
||||
wobei "kopierte url" (ohne die Anführungszeichen) die url zu diesem Repository ist (deine Fork von diesem Projekt). Im vorherigen Schritt siehst du wie du diese erhälst .
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="URL in die Zwischenablage kopieren" />
|
||||
|
||||
Zum Beispiel:
|
||||
|
||||
```bash
|
||||
git clone git@github.com:das-bist-du/erster-Beitrag.git
|
||||
```
|
||||
|
||||
wobei `das-bist-du` dein Github Nutzername ist. Hier kopierst du den Inhalt des first-contributions Repository's auf Github auf deinen Computer.
|
||||
|
||||
## Erstelle einen Zweig
|
||||
|
||||
Wechsle zum Repository Ordner (wenn du nicht bereits dort bist):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Erstelle nun einen Zweig, indem du den `git switch` Befehl benutzst:
|
||||
|
||||
```bash
|
||||
git switch -c dein-neuer-zweig-name
|
||||
```
|
||||
|
||||
Zum Beispiel:
|
||||
|
||||
```bash
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary> <strong>Wenn du auf irgendeinen Fehler bei der Nutzung von git switch stößt, drücke hier:</strong> </summary>
|
||||
|
||||
Wenn die Fehlermeldung "Git: `switch` is not a git command. See `git –help`" erscheint, liegt dies wahrscheinlich daran das du eine veraltete Version von Git nutzt.
|
||||
|
||||
In diesem Fall versuche stattdessen `git checkout` zu nutzen:
|
||||
|
||||
```bash
|
||||
git checkout -b dein-neuer-zweig-name
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## Make necessary changes and commit those changes
|
||||
|
||||
Öffne nun die Datei `Contributors.md` in einem Texteditor und füge deinen Namen hinzu. Füge ihn nicht ganz am Anfang oder am Ende hinzu, sondern irgendwo dazwischen, mittendrin. Speichere jetzt die Datei.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Wenn du in den Projektordner gehst und den Befehl `git status`, ausführst werden dir die Änderungen angezeigt.
|
||||
|
||||
Füge diese Änderungen nun zu dem Zweig hinzu den du gerade erstellt hast, indem du den Befehl `git add` ausführst.
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Jetzt commite diese Änderungen mit dem `git commit` Befehl:
|
||||
|
||||
```bash
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
ersetze `your-name` mit deinem Namen.
|
||||
|
||||
## Änderungen auf Github pushen
|
||||
|
||||
Übertrage deine Änderungen mit `git push`:
|
||||
|
||||
```bash
|
||||
git push -u origin dein-zweig-name
|
||||
```
|
||||
|
||||
ersetze `dein-zweig-name` mit dem Namen des Zweiges den du vorhin erstellt hast.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Solltest du auf irgendwelche Fehler beim Pushen stoßen, drücke hier:</strong> </summary>
|
||||
|
||||
- ### Authentifizierungs Fehler
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Gehe zu [GitHub's tutorial](https://...github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) wie du einen ssh Key zu deinem Account hinzufügst und konfigurierst.
|
||||
Außerdem, kannst du 'git remote -v' ausführen um deine Remote Addresse anzuzeigen.
|
||||
|
||||
Wenn es so aussieht:
|
||||
<pre>origin https://github.com/your-username/your_repo.git (fetch)
|
||||
origin https://github.com/your-username/your_repo.git (push)</pre>
|
||||
|
||||
ändere es mit diesem Befehl:
|
||||
```bash
|
||||
git remote set-url origin git@github.com:dein-nutzername/dein_repo.git
|
||||
```
|
||||
Ansonsten wirst du noch immer aufgefordert Passwort und Benutzername einzugeben und bekommst einen Authentifizierungs Fehler.
|
||||
</details>
|
||||
|
||||
## Reiche deine Änderungen für ein Review ein
|
||||
|
||||
Wenn du jetzt zu deinem Repository auf Github gehts, wirst du einen `Compare & pull request` Knopf sehen. Drücke diesen Knopf.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="erstelle eine Pull-Request" />
|
||||
|
||||
Jetzt, reiche deine Pull-Request ein.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="Reiche deine Pull-Request ein" />
|
||||
|
||||
Bald werde ich alle deine Änderungen in den Haupt-Zweig dieses Projektes mergen. Du wirst eine Benachrichtigungs Email bekommen sobald die Änderungen gemerged wurden.
|
||||
|
||||
## Was nun?
|
||||
|
||||
Gratulation! Du hast gerade den Standard _Forken -> Klonen -> Bearbeiten -> Pull-Request_ Workflow durchgeführt, dem du als Beitragender oft begegnen wirst!
|
||||
|
||||
Feier deinen Beitrag und teile in mit deinen Freunden und Followern indem du hier drückst [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Wenn du gerne mehr Übung hättest, schau dir [code contributions](https://github.com/roshanjossey/code-contributions) an.
|
||||
|
||||
Jetzt los gehts, mit Beiträgen zu anderen Projekten. Wir haben eine Liste von Projekten mit leichten Fehlern für Einsteiger bereitgestellt. Schau dir [die Liste der Projekte in der Web-App an](https://firstcontributions.github.io/#project-list) an.
|
||||
|
||||
### [Zusätzliches Material](../additional-material)
|
||||
|
||||
## Anleitungen für andere Tools
|
||||
|
||||
| <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) |
|
||||
|
||||
<p>Dieses Projekt wird unterstützt von:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,143 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Awel mouchraka 🇩🇿
|
||||
|
||||
Dayemen kayen mochkile ki nebdaw hadja men el bidaya. El khawof ta3 edire khatae daymen machi melih, khousousan ki techarek fi el code. Bessah 3alem el tatbi9ate el hourine mawodjoud bache etcharek wo tekhdem fi madjemou3a. Tani, Rana habine nebesstou el ta3lime ta3 el moucharraka el djadidda fel tatbi9ate el hourra bi ta3lime kifache techarek lil merra el oulla.
|
||||
|
||||
Te9rra ma9alate wa les tutos te9derre te3awonek, bessah wache howa afdel mine tehawolle tessiyi bela ma eddire akhtae ? Hadda el machrou3 medyoure bache yaa3ti nassaihe wo y ssahel tari9ate kifache li maya3rfouche bache eydirrou el moucharaka el oulla ta3houme. Etfekare : 9edma tekoune alaise, 9edma tet3alem bezaf. Wolla rak hab etcharek lel merra el oulla, teba3 el khtouwate el djaya. Wallah, rah tekoune moussaliya.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="embrancher ce repertoire" />
|
||||
|
||||
Wolla ma3endekche git fel ordinateur ta3ek, [ tell3ou be rabet ]( https://help.github.com/articles/set-up-git/ ).
|
||||
|
||||
## Forker hadda el garage (ne3aytoulou tani Fork)
|
||||
|
||||
Forker el garage ki teklicker 3ala zire Fork el fow9e ta3 el safeha.
|
||||
Hada rah yecrée nousskha tabe9 el assel ta3 el garage fi github ta3ek.
|
||||
|
||||
## Enssoukhe el garage 3andek fel PC
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonez ce répertoire" />
|
||||
|
||||
Dourka, enssoukhe hada el garage 3ala el PC diyalek. Clické 3ala el zire enssoukhe menba3ede eclicker 3ala l'icone *copié fi presse papier ta3ek*.
|
||||
|
||||
Eftah la console ta3 les commandes (ida rak fi windows) wola el terminale (ida rak fi MacOS ou Linux) menba3de cheghale lé commandes git el taliya :
|
||||
|
||||
```
|
||||
git clone "l'url eli copietha dourk berk"
|
||||
```
|
||||
wine "l'url eli copietha dourk berk" (bela lé guillemets) hiya l'url ta3 el garage. chouf fi eli fate men 9abel bache tethassel 3ala l'url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copier l'URL dans le presse-papier" />
|
||||
|
||||
Mithale :
|
||||
```
|
||||
git clone https://github.com/issem-el-mousstakhdem-ta3ek/first-contributions.git
|
||||
```
|
||||
|
||||
wine `issem-el-mousstakhdem-ta3ek` howa issem el mousstakhdem ta3 el compte ta3ek github, hena rak tecopier ga3 el mouhtawa ta3 el garage `first-contributions` mine Github lel PC diyalek.
|
||||
|
||||
## Ecréyé far3e
|
||||
|
||||
Rouhe lel garage ta3 el projet eli créyitou djedide mousstenssakhe (edha marakeche déja fih)
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Dourka ecréyé far3e be la commande `git checkout` :
|
||||
|
||||
```
|
||||
git checkout -b <add-essem-diyalek>
|
||||
```
|
||||
|
||||
Mithale :
|
||||
```
|
||||
git checkout -b add-koffi-sani
|
||||
```
|
||||
(Esseme el far3e mayahtajeche yekoune fih kelmete *add*, mé hadja meliha loukane yekoune fih hadef lel fare3 wo tezide esseme diyalek lel lista.)
|
||||
|
||||
## Dire el taghyirate el mouhima é kemle fiha
|
||||
|
||||
Dourka, efteh el féchiyé `Contributors.md` fi un editeur de text, zid fih assmek, menba3de ahfedou, Idha fetehte le terminal ou derte la commande `git status`, rah etchouf beli kayen taghyérates. Zid hadouk al taghiyérates lel far3e eli créyeteho men 9bel be la commande `git add` :
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Dourka, kemel commité hadouk étaghyérates be la commande `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Add <essem-diyalek> to Contributors list"
|
||||
```
|
||||
Ghéyere `<essem-diyalek>` bel assem diyalek.
|
||||
|
||||
## Eb3athe el tagheyérates fi github
|
||||
|
||||
Ebe3athes el taghyérates diyalek be la commande `git push` :
|
||||
```
|
||||
git push origin <add-essem-diyalek>
|
||||
```
|
||||
Bedel `<add-essem-diyalek>` be esseme el far3e eli créyeteho men 9abel.
|
||||
|
||||
## Présenté el taghyérates ta3ek lel fahsse
|
||||
|
||||
Idha rahet lel garage diyalek 3ala github, rah etchouffe beli kayen zire `Compare & pull request`, éclické 3ala el zire hadek.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Dourka présenter el talebe diyalek lel fahsse.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Fi zamen saghire rah ene fuzioné el taghyérates ta3ek me3a el fare3 main ta3 el projet hada, Yewosselek rissala ta3 el taghyérates ghire ki tendare la fusion kamel.
|
||||
|
||||
El far3e main ta3ek marahe yessralou hata taghyiére lel ane. Bache main ta3ek yekoune moutwafek me3a ta3i, lazem tabe3 hadou lé el khoutouwates :
|
||||
|
||||
## Khelli el main ta3ek synchronisé me3a hada el garage
|
||||
|
||||
Bache tebda, rouhe lel fare3 main
|
||||
```
|
||||
git checkout main
|
||||
```
|
||||
|
||||
Zide l'url ta3 el garage ta3ek ki `upstream remote url` :
|
||||
```
|
||||
git remote add upstream https://github.com/Roshanjossey/first-contributions
|
||||
```
|
||||
|
||||
Hada rah tekoune tarika bache te9oule lel git beli kayen version wahdoukhera texister bi had el 3ounwane wo nettb9ou a3lihe `upstream`. Ghire el tagheyérates tet fuzionna, hawosse 3ala la version djedidda ta3 el garrage ta3i :
|
||||
```
|
||||
git fetch upstream
|
||||
```
|
||||
|
||||
Henya rana nehawossou 3ala teghyérates fel main ta3i (upstream remote). Dourka, rahe tefusioner el taghyére el djadid ta3 el garage ta3i me3a el far3e ta3ek main :
|
||||
```
|
||||
git rebase upstream/main
|
||||
```
|
||||
Henya rahe neteb9ou ga3 el taghyérates eli rak tehawosse a 3lihoume fel far3e main. Idha be3ate el far3e main dourka, el main ta3ek rahe yekoune howa tani fih taghéyérates :
|
||||
```
|
||||
git push origin main
|
||||
```
|
||||
Tahedire: Hadi el khetra, rah tebe3aye el garage el be3ide eli assmou origin.
|
||||
|
||||
Fi hade el marhala rani fusionite el far3e `<add-essem-diyalek>` me3a el far3e main, wo enta fusionite el far3e main ta3i me3a el far3e main ta3ek. el far3e `<add-essem-diyalek>` maraheche nahtajouhe, edane te9dere tessuprimihe :
|
||||
|
||||
```
|
||||
git branch -d <add-essem-diyalek>
|
||||
```
|
||||
wa aydan te9dere tenihi la version ta3ou fel far3e el be3ide tani :
|
||||
```
|
||||
git push origin --delete <add-essem-diyalek>
|
||||
```
|
||||
Wache cheft henaya machi darouri, bessah assem el far3e yewori beli el hadef rahe moukhassasse.
|
||||
|
||||
## Tuto besste3male adawates wahdoukhra
|
||||
|
||||
|
||||
| <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) |
|
||||
@@ -1,152 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Primeras Contribuciones
|
||||
|
||||
Este proyecto tiene como objetivo simplificar y guiar la forma en que los principiantes hacen su primera contribución. Si está buscando hacer su primera contribución, siga los pasos a continuación.
|
||||
|
||||
|
||||
#### *Si no estás familiarizado con la línea de comandos, [aquí hay tutoriales usando herramientas con Interfaz Gráfica (GUI)](#tutoriales-usando-otras-herramientas)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork de este repositorio" />
|
||||
|
||||
En caso de no tener instalado Git en tu equipo, te dejo una [guia]( https://git-scm.com/book/es/v2/Inicio---Sobre-el-Control-de-Versiones-Instalaci%C3%B3n-de-Git) para instalarlo.
|
||||
|
||||
## Has un "Fork" de este repositorio
|
||||
|
||||
Presiona el boton "fork" de este repositorio en la parte superior derecha de la página. Al hacer esto, se crea una copia de este repositorio en tu cuenta de GitHub.
|
||||
|
||||
## Has un "Clone" del repositorio copiado
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonar este repositorio" />
|
||||
|
||||
Ahora clona el repositorio al que le hiciste un fork previamente, el URL del repositorio deberia estar asi `https://github.com/<tu-usuario>/first-contributions`. Entra en tu cuenta de Github, y has click en el botón `Code` y luego en la pestaña SSH y luego haz clic en el icono de _copiar al portapapeles_.
|
||||
|
||||
Abre tu terminal y ejecuta el siguiente comando git:
|
||||
|
||||
```
|
||||
git clone "la url del repositorio que copiaste"
|
||||
```
|
||||
|
||||
Donde "la url del repositorio que copiaste" (sin las comillas dobles) es la *url* a este repositorio (tu *fork* a este proyecto), se veria algo asi `https://github.com/<tu-usuario>/first-contributions.git` .
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copiar URL al portapapeles" />
|
||||
|
||||
Por ejemplo:
|
||||
```
|
||||
git clone https://github.com/<tu-usuario>/first-contributions.git
|
||||
```
|
||||
Donde `<tu-usuario>` es tu nombre de usuario de GitHub. Con este comando estas copiando los contenidos del repositorio *first-contributions* de GitHub a tu equipo.
|
||||
|
||||
## Crea una rama (*Branch*)
|
||||
|
||||
Cambia al directorio del repositorio en tu equipo (si es que no estás ahí ya).
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Ahora crea una rama (*branch*) usando el comando `git checkout` o `git switch`:
|
||||
```
|
||||
git checkout -b <dale un nombre>
|
||||
git switch -c <dale un nombre>
|
||||
```
|
||||
|
||||
Por ejemplo:
|
||||
```
|
||||
git checkout -b add-julio-jaramillo
|
||||
git switch -c add-julio-jaramillo
|
||||
```
|
||||
<details>
|
||||
<summary> <strong>Si obtienes algún error usando git switch, haz clic aquí:</strong> </summary>
|
||||
|
||||
Si aparece el mensaje de error "Git: `switch` no es un comando git. Consulta `git –help`", es probable que estés usando una versión anterior de git.
|
||||
|
||||
En este caso, intenta usar git checkout en su lugar.
|
||||
</details>
|
||||
|
||||
## Haz los cambios necesarios y has un "Commit" de esos cambios
|
||||
|
||||
Abre el archivo `Contributors.md` en un editor de texto y añade tu nombre. No lo añadas ni al principio ni al final del archivo, hazlo en cualquier otro sitio. Ahora guarda el archivo.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Si vas al directorio del proyecto y ejecutas el comando `git status`, podrás ver los cambios ya reflejados.
|
||||
|
||||
Agrega esos cambios a la rama (*branch*) que creaste antes usando el comando `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Ahora puedes hacer un *commit* sobre estos cambios ejecutando el comando `git commit`:
|
||||
```
|
||||
git commit -m "Add <nombre> to Contributors list"
|
||||
```
|
||||
reemplazando `<nombre>` con tu nombre.
|
||||
|
||||
|
||||
## Haz un "Push" de tus cambios a GitHub
|
||||
|
||||
Envía tus cambios usando el comando `git push`:
|
||||
```
|
||||
git push -u origin <nombre-rama>
|
||||
```
|
||||
Reemplaza `<nombre-rama>` con el nombre de la rama que creaste anteriormente.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Si obtienes algún error al enviar (Push), haz clic aquí:</strong> </summary>
|
||||
|
||||
- ### Error de Autenticación
|
||||
<pre>remote: El soporte para la autenticación de contraseña se eliminó el 13 de agosto de 2021. Utiliza un token de acceso personal en su lugar.
|
||||
remote: Consulta [https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/](https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/) para obtener más información.
|
||||
fatal: Fallo en la autenticación para '[https://github.com/](https://github.com/)<tu-usuario>/first-contributions.git/'</pre>
|
||||
Ve al [tutorial de GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) sobre cómo generar y configurar una clave SSH en tu cuenta.
|
||||
|
||||
Además, es posible que desees ejecutar `git remote -v` para verificar tu dirección remota.
|
||||
|
||||
Si se ve algo como esto:
|
||||
<pre>origin [https://github.com/tu-usuario/tu_repo.git] (fetch)
|
||||
origin [https://github.com/tu-usuario/tu_repo.git] (push)</pre>
|
||||
|
||||
|
||||
cámbialo usando este comando:
|
||||
```bash
|
||||
git remote set-url origin git@github.com:tu-usuario/tu_repo.git
|
||||
```
|
||||
De lo contrario, aún se te pedirá un nombre de usuario y contraseña y obtendrás un error de autenticación.
|
||||
</details>
|
||||
|
||||
## Envía (*Submit*) tus cambios para ser revisados
|
||||
|
||||
Si vas a tu repositorio en GitHub, verás un botón `Compare & pull request`. Haz clic sobre este botón.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="crea una pull request" />
|
||||
|
||||
Ahora envía el *pull request*.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="enviar la pull request" />
|
||||
|
||||
Pronto estaré combinando tus cambios (haciendo *merge*) con la rama master de este proyecto. Recibirás una notificación por correo electrónico cuando los cambios hayan sido combinados.
|
||||
|
||||
## ¿Cuáles son los siguientes pasos?
|
||||
|
||||
¡Felicidades! ¡Has completado la línea de trabajo *_fork -> clone -> edit -> PR_* que encontrarás habitualmente como contribuidor!
|
||||
|
||||
Festeja tu contribución y compártela con tus amigos y seguidores yendo a la [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Si deseas más práctica, consulta [code contributions](https://github.com/roshanjossey/code-contributions).
|
||||
|
||||
Ahora empieza a contribuir a otros proyectos. Hemos reunido una lista de proyectos con *issues* sencillas para que puedas empezar. Échale un ojo a la [lista de proyectos en la web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Tutoriales usando otras herramientas
|
||||
|
||||
|<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/Readme/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)|
|
||||
@@ -1,179 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
# <div dir="rtl">مساهمتك الأولى</div>
|
||||
|
||||
<div dir="rtl">
|
||||
الصعوبة متوقعة لما تبدأ أي مشروع جديد، خصوصاً لو كان المشروع بيتضمن ناس تانية، ودة بيخلي الوقوع في الخطأ مزعج ومتعب.
|
||||
<br>
|
||||
لكن المساهمة في مشاريع مفتوحة المصدر اسسها العمل الجماعي والعطاء.
|
||||
<br>
|
||||
في المشروع دة هدفنا هو تبسيط الطريق لأول مساهمة ليك.
|
||||
</div>
|
||||
|
||||
<div dir="rtl">
|
||||
ممكن تقرأ وتتفرج على فيديوهات على الإنترنت عشان تعرف تبدأ فى المساهمة للمشاريع مفتوحة المصدر، لكن هتستفيد أكتر لو عرفت تساهم في مشروع دلوقتي من غير خوف لحسن تعمل حاجة غلط. المشروع اللى انت فاتحه حاليا بيركز انه يوفرلك التوجيهات الأولية اللي هتحتجها عشان تبدأ أول مساهمة ليك. مش مشكلة تغلط المهم انك تتعلم من الغلط ودة الهدف هنا. تابع الخطوات واحدة واحدة ونوعدك انك هتستمتع.
|
||||
</div>
|
||||
|
||||
|
||||
<div dir="rtl">
|
||||
لو ماكنش عندك git على جهازك <a href="https://help.github.com/articles/set-up-git/">حمله من هنا.</a>
|
||||
</div>
|
||||
|
||||
## <div dir="rtl"> أفصل المشروع دة - Fork this Repository </div>
|
||||
<img style="float: left;" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
<div dir="rtl">
|
||||
خد نسخة من المشروع دة (أو افصله) عن طريق انك تدوس على Fork في أعلى الصفحة.
|
||||
لو عملت كدة فأنت اخدت نسخة من الفولدر دة فى حسابك على github.
|
||||
</div>
|
||||
|
||||
## <div dir="rtl"> إنسخ المشروع دة - Clone the repository </div>
|
||||
|
||||
<img style="float: left;" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
<div dir="rtl">
|
||||
انسخ المشروع دة لجهازك.
|
||||
دوس على Clone بعدين دوس على أيقونة Copy to clipboard
|
||||
</div>
|
||||
<img style="float: left;" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
<div dir="rtl">
|
||||
إفتح التريمنال وأكتب الأمر دة:
|
||||
</div>
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
<div dir="rtl">بدل "url you just copied" حط الرابط اللي نسخته من الخطوة اللي فاتت، الرابط دة بتاع المشروع.</div>
|
||||
|
||||
<div dir="rtl">على سبيل المثال:</div>
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
<div dir="rtl">
|
||||
في المثال دة لاحظ ان 'this-is-you' هيكون إسم حسابك في موقع github، الأمر دة هينسخ محتويات المشروع لجهازك الخاص عشان تقدر تعدل عليه بحرية في أي وقت.
|
||||
</div>
|
||||
<br>
|
||||
|
||||
## <div dir="rtl"> إنشاء فرع - Create a branch </div>
|
||||
|
||||
|
||||
<div dir="rtl"> بما اننا عايزين نعمل تغيير فى الفايل اللى عملناله نسخة على الجهاز.. الأول ننتقل للفولدر اللي لسة نسخينه: </div>
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
<div dir="rtl"> قبل مانعمل التغيير هنعمل "فرع" وهنديله اسم زي كدة: </div>
|
||||
|
||||
```
|
||||
git checkout -b "add-your-name"
|
||||
```
|
||||
|
||||
<div dir="rtl">هتحط اسمك بدل your-name</div>
|
||||
|
||||
<div dir="rtl">مثلا:</div>
|
||||
|
||||
```
|
||||
git checkout -b "add-alonzo-church"
|
||||
```
|
||||
|
||||
<br>
|
||||
|
||||
## <div dir="rtl">غيّر التغيير اللي حابب تغيره:</div></h2>
|
||||
|
||||
<div dir="rtl">
|
||||
التغيير اللي هتغيره فى الحالة دي انك تحط اسمك فى نهاية قايمة الأسماء فى فايل. افتح فايل اسمه "Contributors.md" بالـ text editor المفضل ليك وحط إسمك و إحفظ الفايل.
|
||||
بعد كدة ارجع للترمينال وأكتب الأمر دة <code>git status</code> الأمر دة بيظهر لك أي تغيرات حصلت في المشروع.
|
||||
عشان تضيف التغيرات دي للفرع بتاعك هتستخدم الأمر دا <code>git add</code>.
|
||||
</div>
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
<div dir="rtl">حتى الأن انت عندك فرع فيه التغيير، عشان تبعت التغيير دة وتتمه هيتعمل على خطوتين: الأولى انك تعمل للتغيير دة اسم فهتستخدم الأمر <code>git commit</code>.</div>
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
<div dir="rtl"> إستبدل <code><your-name></code> بإسمك. </div>
|
||||
<br>
|
||||
|
||||
## <div dir="rtl"> بعدين ترفع التغييرات - Push changes to Github </div>
|
||||
|
||||
<div dir="rtl">هترفع التغييرات عن طريق الأمر <code>git push</code></div>
|
||||
|
||||
```
|
||||
git push origin "add-your-name"
|
||||
```
|
||||
|
||||
<div dir="rtl">إستبدل <code><add-your-name></code> بإسم الفرع اللي انت لسة عامله .</div>
|
||||
|
||||
<details dir="rtl">
|
||||
<summary> <strong>لو عندك مشكلة وانت بتعمل <bdi>push</bdi> غالبا هتكون <bdi>Authentication error</bdi></strong> </summary>
|
||||
|
||||
- ### Authentication Error
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
أسهل طريقة لحل المشكلة انك تعمل <bdi>ssh key</bdi> وتحطه علي <bdi>GitHub</bdi>
|
||||
[GitHub's Tutorial - Create an ssh key](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)
|
||||
[GitHub's tutorial - adding ssh key to your account](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)
|
||||
بكده هتكون <bdi>authenticated</bdi> و مش هيكون عندك مشكلة لما تعمل <bdi>push</bdi>
|
||||
|
||||
تقدر تتاكد انك بترفع علي الريبو الصح لما تكتب في ال
|
||||
```bash
|
||||
git remote -v
|
||||
```
|
||||
لو ظهرلك كده:
|
||||
<pre>origin https://github.com/your-username/your_repo.git (fetch)
|
||||
origin https://github.com/your-username/your_repo.git (push)</pre>
|
||||
يبقي معندكش مشكلة
|
||||
غير كده تقدر تغير ال <bdi>remote address</bdi> كده
|
||||
```bash
|
||||
git remote set-url origin git@github.com:your-username/your_repo.git
|
||||
```
|
||||
</details>
|
||||
|
||||
<br>
|
||||
<h2 id="سلم-تغيراتك-للمراجعة"><a name="سلم-تغيراتك-للمراجعة" href="#سلم-تغيراتك-للمراجعة"></a><div dir="rtl">سلم تغيراتك للمراجعة</div></h2>
|
||||
|
||||
|
||||
<div dir="rtl">في صفحة المشروع بتاعك على صفحتك الشخصية على github دوس على زرار <code>Compare & pull request</code>. هو ماكنش ظاهر قبل كدة.</div>
|
||||
|
||||
<img style="float: left;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
<div dir="rtl">دلوقتي هتسلم طلبك لصاحب المشروع الأساسي عشان يراجع عليه، في الحالة دي الطلب بتاعك هيوصلي. </div>
|
||||
|
||||
<img style="float: left;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
<div dir="rtl">بعد المراجعة هدمج تغيرراتك للفرع الرئيسي في المشروع. وهيتم تنبيهك عن طريق البريد الإلكتروني بدة.</div>
|
||||
|
||||
<div dir="rtl">لما يحصل وأقبل طلبك هتلاقي ان المشروع المنسوخ على حسابك مفيهوش التغيررات. فلازم تزامن المشروع الرئيسي باللي على حسابك بالخطوات دي:</div>
|
||||
|
||||
|
||||
## <div dir="rtl">طب اعمل ايه بعد كدة؟</div>
|
||||
|
||||
<div dir="rtl">
|
||||
احتفل بأول مساهمة ليك، أعمل شير مع صحابك ومتابعينك عن طريق زيارة <a href="https://firstcontributions.github.io/#social-share">الموقع دة. </a>
|
||||
</div>
|
||||
|
||||
<div dir="rtl">إذا كنت ترغب في المزيد من التدريب <a href="https://github.com/roshanjossey/code-contributions">مساهمات </a></div>
|
||||
|
||||
|
||||
<br>
|
||||
|
||||
<div dir="rtl">يلا نخليك تبدأ تساهم في مشاريع بجد؟ عملنا قائمة بمشاريع بمشاكل بسيطة ممكن تبدأ بيها النهاردة.</div>
|
||||
<div dir="rtl">شوف <a href="https://firstcontributions.github.io/#project-list">قائمة المشاريع على الموقع. </a> </div>
|
||||
|
||||
## <div dir="rtl"><a href="../additional-material/additional-material.md">حاجات وأدوات زيادة</a></div>
|
||||
|
||||
## <div dir="rtl">لو هتستخدم ادوات تانية ممكن تتعلم من هنا</div>
|
||||
|
||||
| <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) |
|
||||
@@ -1,127 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
# First Contributions
|
||||
|
||||
'tis hard. 'tis always hard th' first time ye do somethin'. Especially when ye be collaboratin', makin' mistakes ain't a comfortable thin'. We wanted t' simplify th' way new open-source contributors learn & contribute fer th' first time.
|
||||
|
||||
Readin' tales & watchin' tutorials can help, but wha''s better than actually doin' th' stuff in a practice environment? This project aims at providin' guidance & simplifyin' th' way beginners make thar first contribution. If ye be lookin' t' make yer first contribution, follow th' steps below.
|
||||
|
||||
#### *If ye're nah comfortable wit' command line, [here be tutorials usin' GUI tools.](#Tutorials-Usin'-Other-Tools)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
If ye don't 'ave git on yer machine, [install it](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Fork this repository
|
||||
|
||||
Fork this repo by skewerin' on th' fork button on th' top o' this page.
|
||||
This will create a copy o' this repository in yer account.
|
||||
|
||||
## Clone the repository
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Now clone this repo t' yer machine. Go t' yer GitHub account, skewer on th' clone button 'n then skewer th' *copy to clipboard* icon.
|
||||
|
||||
Open a terminal 'n run th' followin' git command:
|
||||
|
||||
```
|
||||
git clone "url ye jus' copied"
|
||||
```
|
||||
|
||||
where "url ye jus' copied" (without th' quote marks) be th' url t' this repository (yer fork o' this project). See th' previous steps t' obtain th' url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Fer example:
|
||||
|
||||
```
|
||||
git clone https://github.com/this-be-ye/first-contributions.git
|
||||
```
|
||||
|
||||
where `this-be-ye` be yer GitHub username. Here ye're copyin' th' contents o' th' first-contributions repository in GitHub t' yer 'puter.
|
||||
|
||||
## Create a branch
|
||||
|
||||
Change t' th' repository directory on yer 'puter (if ye be nah already thar):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Now create a branch usin' th' `git checkout` command:
|
||||
|
||||
```
|
||||
git checkout -b <add-your-new-branch-name>
|
||||
```
|
||||
|
||||
Fer example:
|
||||
|
||||
```
|
||||
git checkout -b add-luke-oliff
|
||||
```
|
||||
|
||||
(Th' name o' th' branch does nah needs t' 'ave th' word *add* in it, but 'tis a reasonable thin' t' include 'cause th' purpose o' this branch be t' add yer name t' a list.)
|
||||
|
||||
## Make necessary changes 'n commit those changes
|
||||
|
||||
Now open `Contributors.md` file in a text editor, add yer name t' it. Don't add it at th' beginnin' or end o' th' file. Put it anywhere in between. Now, save th' file.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
If ye go t' th' project directory 'n execute th' command `git status`, ye'll see thar are changes.
|
||||
|
||||
Add those changes t' th' branch ye jus' created usin' th' `git add` command:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Now commit those changes usin' th' `git commit` command:
|
||||
|
||||
```
|
||||
git commit -m "Add <yer-name> to Contributors list"
|
||||
```
|
||||
|
||||
replacing `<yer-name>` with your name.
|
||||
|
||||
## Push changes t' GitHub
|
||||
|
||||
Push yer changes usin' th' command `git push`:
|
||||
|
||||
```
|
||||
git push origin <add-yer-branch-name>
|
||||
```
|
||||
|
||||
replacin' `<add-yer-branch-name>` wit' th' name o' th' branch ye created earlier.
|
||||
|
||||
## Submit yer changes fer review
|
||||
|
||||
If ye go t' yer repository on GitHub, ye'll see a `Compare & pull request` button. Click on that button.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Now submit th' pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Soon I'll be mergin' all yer changes into th' master branch o' this project. Ye will get a notification email once th' changes 'ave been merged.
|
||||
|
||||
## Where t' go from here?
|
||||
|
||||
Well done! Ye jus' completed th' standard _fork -> clone -> edit -> PR_ workflow that ye'll encounter often as a contributor!
|
||||
|
||||
Celebrate yer contribution 'n share it wit' yer hearties 'n followers by goin' t' [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Now let's get ye started wit' contributin' t' other projects. We've compiled a list o' projects wit' easy issues ye can get started on. Check out [th' list o' projects in web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Additional material](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Tutorials Usin' Other Tools
|
||||
|
||||
| <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) |
|
||||
@@ -1,133 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Unuaj Kontribuoj
|
||||
|
||||
Estas malfacile. Iam estas malfacile la unua fojo kiam vi faras ion, speciale kiam vi kunlaboras kun aliaj, ĉar fari erarojn ne estas agrable. Nia celo estas simpligi la manieron en kiu novaj kontribuantoj de _malferma kodo_ lernas kaj kontribuas unue.
|
||||
|
||||
Legi artikolojn kaj rigardi tutoriaojn povas helpi, sed kio estas pli bona ol fari aferojn en praktika medio? Ĉi tiu projekto celas esti gvidilo kaj simpligi la manieron en kiu komencantoj faras sian unuan kontribuon. Se vi volas fari vian unuan kontribuon, sekvu la paŝojn kiuj estas montritaj sube.
|
||||
|
||||
#### *Se vi ne estas konata kun la komandlinio, [jen tutoriaj uzante ilojn kun Grafika Interfaco (GUI)](#Tutoriales-con-otras-herramientas)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork de este repositorio" />
|
||||
|
||||
Se vi ne havas git-on en via komputilo, vi povas trovi instrukciojn por instali ĝin [ĉi tie]( https://docs.github.com/es/get-started/quickstart/set-up-git ).
|
||||
|
||||
## Forku (*Fork*) ĉi tiun deponejon
|
||||
|
||||
Forku ĉi tiun deponejon klakante la butonon "*Fork*" en la supraj dekstra flanko de ĉi tiu paĝo.
|
||||
Tio kreos kopion de ĉi tiu deponejo en via konto.
|
||||
|
||||
## Klono (*Clone*) la forkan deponejon
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="kloni ĉi tiun deponejon" />
|
||||
|
||||
Nun klono ĉi tiun deponejon al via komputilo. Iru al via GitHub-konto, klaku sur la butono "*clone or download*" kaj poste klaku sur la ikono por *kopii al la poŝtelefono*.
|
||||
|
||||
Malfermu vian konsolon aŭ terminalon kaj rulu la jenan git-an komandon:
|
||||
|
||||
```bash
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
Kie estas "la URL kiun vi ĵus kopis" (sen la duobla cita signo) estas la *URL* de ĉi tiu deponejo (via fork de ĉi tiu projekto). Rigardu la antaŭajn paŝojn por akiri la *URL*-on.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="kopii la URL-on al la poŝtelefono" />
|
||||
|
||||
Ekzemple:
|
||||
|
||||
```bash
|
||||
git clone git@github.com:this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
La parto kun `este-eres-tu` estos anstataŭigita per via GitHub-uzantonomo. Ĉi tie vi kopias la enhavon de la deponejo *first-contributions* de GitHub al via komputilo.
|
||||
|
||||
## Krei branĉon (*Branch*)
|
||||
|
||||
Shanĝu al la dosierujo de la deponejo sur via komputilo (se vi ne jam estas tie):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Nun kredu branĉon (*branch*) uzante la komandon `git checkout`:
|
||||
|
||||
```bash
|
||||
git switch -c your-new-branch-name
|
||||
```
|
||||
|
||||
Ekzemple:
|
||||
|
||||
```bash
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
(La nomo de la branĉo ne devas enhavi la vorton *add*, sed estas racionebla ĉar la celo de tiu ĉi branĉo estas aldoni vian nomon al la listo.)
|
||||
|
||||
## Faru la necesajn ŝanĝojn kaj konfirmu (*Commit*) tiujn ŝanĝojn
|
||||
|
||||
Malfermu la dosieron `Contributors.md` en teksta redaktilo kaj aldonu vian nomon. Ne aldonu ĝin aŭ en la komenco aŭ en la fino de la dosiero, sed faru tion ie interne. Konservu la dosieron.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Se vi iras al la projekta dosierujo kaj ekzekutas la komandon `git status`, vi vidos ke estas ŝanĝoj.
|
||||
|
||||
Aldonu tiujn ŝanĝojn al la branĉo kiun vi kreis antaŭe uzante la komandon `git add`:
|
||||
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Nun konfirmu tiujn ŝanĝojn uzante la komandon `git commit`:
|
||||
|
||||
|
||||
```bash
|
||||
git commit -m "Aldonu <via-nomo> al la listo de Kontribuantoj"
|
||||
```
|
||||
|
||||
anstataŭigu `<via-nomo>` per via nomo.
|
||||
|
||||
## Puŝu (*Push*) viajn ŝanĝojn al GitHub
|
||||
|
||||
Puŝu viajn ŝanĝojn uzante la komandon `git push`:
|
||||
|
||||
|
||||
```bash
|
||||
git push -u origin your-branch-name
|
||||
```
|
||||
|
||||
|
||||
Anstataŭigu `<aldonu-la-nomon-de-la-branĉo>` per la nomo de la branĉo kiun vi kreis antaŭe.
|
||||
|
||||
## Submetu (*Submit*) viajn ŝanĝojn por revizio
|
||||
|
||||
Se vi iras al via deponejo en GitHub, vi vidos butonon `Compare & pull request`. Klaku sur tiu butono.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="krei pull request" />
|
||||
|
||||
Nun sendu la *pull request*.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="sendi pull request" />
|
||||
|
||||
Baldaŭ mi unuos viajn ŝanĝojn (faros *merge*) kun la ĉefa branĉo de tiu ĉi projekto. Vi ricevos retmesaĝon kiam la ŝanĝoj estos unuitaj.
|
||||
|
||||
## Kie iri de ĉi tie?
|
||||
|
||||
Gratulojn! Vi ĵus finis la regulan _fork -> clone -> redaktu -> pull request_ fluon kiun vi ofte renkontos kiel kontribuanto!
|
||||
|
||||
Festu vian kontribuon kaj dividiĝu kun viaj amikoj kaj sekvantoj irante al [rete apikaĵo](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Vi ankaŭ povas aliĝi al nia Slack-teamo se vi bezonas helpon aŭ havas demandojn. [Aliĝu al nia Slack-teamo](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Nun komencu kontribui al aliaj projektoj. Ni kolektis liston de projektoj kun facilaj problemoj, por ke vi povu ekhavi. Rigardu [la liston de projektoj en la rete apikaĵo](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Plia materialo](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Tutoriaj uzante aliajn ilojn
|
||||
|
||||
| <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/2/2d/Visual_Studio_Code_1.18_icon.svg" 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) |
|
||||
@@ -1,124 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Primeras Contribuciones
|
||||
|
||||
Es complicado. Resulta difícil la primera vez que haces algo, especialmente cuando colaboras con otros, pues cometer errores no es nada agradable. Nuestro objetivo es simplificar la forma en la que nuevos contribuidores de _código abierto_ aprenden y contribuyen por primera vez.
|
||||
|
||||
Leer artículos y ver tutoriales puede ayudar, pero, ¿Qué mejor manera de practicar que hacer las cosas en un entorno de prácticas? Este proyecto se enfoca en guiar a principiantes durante su primera contribución. Si quieres lograr tu primera contribución, sigue los pasos que se muestran a continuación.
|
||||
|
||||
#### *Si no estás familiarizado con la consola o terminal, [aquí hay tutoriales usando herramientas con Interfaz Gráfica (GUI)](#Tutoriales-con-otras-herramientas)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork de este repositorio" />
|
||||
|
||||
Si no tienes git en tu equipo, puedes encontrar instrucciones para instalarlo en [este enlace]( https://docs.github.com/es/get-started/quickstart/set-up-git ).
|
||||
|
||||
## Bifurca (*Fork*) este repositorio
|
||||
|
||||
Haz un *fork* de este repositorio haciendo click en el botón "*Fork*" en la parte superior derecha en esta página.
|
||||
Esto creará una copia de este repositorio en tu cuenta.
|
||||
|
||||
## Clona (*Clone*) el repositorio bifurcado
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonar este repositorio" />
|
||||
|
||||
Ahora clona este repositorio en tu equipo. Dirígete a tu cuenta de GitHub, haz click en el botón "*clone or download*" y luego haz click en el icono para *copiar al portapapeles*.
|
||||
|
||||
Abre tu consola o terminal y ejecuta el siguiente comando de git:
|
||||
|
||||
```
|
||||
git clone "url que acabas de copiar"
|
||||
```
|
||||
|
||||
Donde pone "url que acabas de copiar" (sin las comillas dobles) es la *url* a este repositorio (tu *fork* a este proyecto). Mira los pasos previos para obtener la *url*.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copiar URL al portapapeles" />
|
||||
|
||||
Por ejemplo:
|
||||
```
|
||||
git clone https://github.com/este-eres-tu/first-contributions.git
|
||||
```
|
||||
La parte de `este-eres-tu` la reemplazarás con tu usuario de GitHub. Aquí estás copiando los contenidos del repositorio *first-contributions* de GitHub a tu equipo.
|
||||
|
||||
## Crea una rama (*Branch*)
|
||||
|
||||
Cambia al directorio del repositorio en tu equipo (si es que no estás ahí ya).
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Ahora crea una rama (*branch*) usando el comando `git checkout` o `git switch`:
|
||||
```
|
||||
git checkout -b <añade tu nombre>
|
||||
|
||||
git switch -c <añade tu nombre>
|
||||
```
|
||||
|
||||
Por ejemplo:
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
(El nombre de la rama no tiene por qué contener la palabra *add*, pero es razonable que lo tenga porque el objetivo de esta rama es añadir tu nombre a la lista.)
|
||||
|
||||
## Haz los cambios necesarios y confirma (*Commit*) esos cambios
|
||||
|
||||
Abre el archivo `Contributors.md` en un editor de texto y añade tu nombre. No lo añadas ni al principio ni al final del archivo, hazlo en cualquier otro sitio. Guarda el archivo.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Si vas al directorio del proyecto y ejecutas el comando `git status`, verás que hay cambios.
|
||||
|
||||
Agrega esos cambios a la rama (*branch*) que creaste anteriormente usando el comando `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Ahora haz un *commit* sobre estos cambios ejecutando el comando `git commit`:
|
||||
```
|
||||
git commit -m "Add <tu-nombre> to Contributors list"
|
||||
```
|
||||
cambiando `<tu-nombre>` por tu nombre.
|
||||
|
||||
## Sube (*Push*) tus cambios a GitHub
|
||||
|
||||
Haz *push* de tus cambios usando el comando `git push`:
|
||||
```
|
||||
git push -u origin <añade-el-nombre-de-la-rama>
|
||||
```
|
||||
Reemplaza `<añade-el-nombre-de-la-rama>` con el nombre de la rama que creaste anteriormente.
|
||||
|
||||
## Envía (*Submit*) tus cambios para ser revisados
|
||||
|
||||
Si vas a tu repositorio en GitHub, verás un botón `Compare & pull request`. Haz click sobre el botón.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="crea una pull request" />
|
||||
|
||||
Ahora envía la *pull request*.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="enviar la pull request" />
|
||||
|
||||
Pronto estaré fusionando tus cambios (haciendo *merge*) con la rama master de este proyecto. Recibirás una notificación por correo electrónico cuando los cambios hayan sido fusionados.
|
||||
|
||||
## ¿Cuáles son los siguientes pasos?
|
||||
|
||||
¡Enhorabuena! ¡Has completado el flujo de trabajo *_fork -> clone -> edit -> PR_* que encontrarás habitualmente como contribuidor!
|
||||
|
||||
Celebra tu contribución y compártela con tus amigos y seguidores yendo a [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Si quieres más práctica, echa un vistazo a [contribuciones de código](https://github.com/roshanjossey/code-contributions).
|
||||
|
||||
Ahora empieza a contribuir en otros proyectos. Hemos reunido una lista de proyectos con *issues* sencillas para que puedas empezar. Échale un ojo a la [lista de proyectos en la aplicación web](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Tutoriales con otras herramientas
|
||||
|
||||
| <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) |
|
||||
@@ -1,131 +0,0 @@
|
||||
# የመጀመሪያ አስተዋጽዖዎች
|
||||
|
||||
ይህ ፕሮጀክት ጀማሪዎች የመጀመሪያ አስተዋፅዖቸውን እንዲያደርጉ መንገዱን ለማቅለል እና ለመምራት ያለመ ነው። የመጀመሪያውን አስተዋፅዖ ማድረግ ከፈለጉ ከታች ያሉትን ደረጃዎች ይከተሉ።
|
||||
|
||||
_በትእዛዝ መስመሩ ካልተመቻችሁ [የጂአይ መሳሪያዎችን በመጠቀም መማሪያ ይኸውና](#መማሪያዎች-ሌሎች-መሳሪያዎችን-በመጠቀም)_
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### በማሽንዎ ላይ git ከሌለዎት፣ [ጫን](https://docs.github.com/en/get-started/quickstart/set-up-git)።
|
||||
|
||||
## ይህንን ማከማቻ ሹካ ያድርጉ
|
||||
|
||||
በዚህ ገጽ ላይኛው ክፍል ላይ ያለውን የሹካ ቁልፍ ጠቅ በማድረግ ይህንን ማከማቻ ሹካ ያድርጉት።
|
||||
ይህ በአንተ መለያ ውስጥ የዚህን ማከማቻ ቅጂ ይፈጥራል።
|
||||
|
||||
## ማከማቻውን መዝጋት
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
አሁን የሹካውን መያዣ ወደ ማሽንዎ ያያይዙት. ወደ GitHub መለያዎ ይሂዱ፣ የሹካ ማከማቻውን ይክፈቱ፣ የኮድ አዝራሩን ጠቅ ያድርጉ እና ከዚያ _copy to clipboard_ አዶን ጠቅ ያድርጉ።
|
||||
|
||||
ተርሚናል ይክፈቱ እና የሚከተለውን የgit ትዕዛዝ ያሂዱ፡-
|
||||
|
||||
```
|
||||
git clone "ዩአርኤሉን አሁን ቀድተሃል።"
|
||||
```
|
||||
|
||||
"ዩአርኤል አሁን የገለበጡት" (ያለ ጥቅሶች) ወደዚህ ማከማቻ ዩአርኤል (የዚህ ፕሮጀክት ሹካ) የሆነበት። ዩአርኤሉን ለማግኘት የቀደመውን ደረጃዎች ይመልከቱ።
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="ዩአርኤልን ወደ ክሊፕቦርድ ቅዳ" />
|
||||
|
||||
ለምሳሌ:
|
||||
|
||||
```
|
||||
git clone https://github.com/ይህ አንተ ነህ።/first-contributions.git
|
||||
```
|
||||
|
||||
የ GitHub ተጠቃሚ ስምህ የት `ይህ አንተ ነህ።' እዚህ በ GitHub ላይ ያለውን የመጀመሪያ አስተዋፅዖ ማከማቻ ይዘቶችን ወደ ኮምፒውተርዎ እየገለበጡ ነው።
|
||||
|
||||
#ቅርንጫፍ ፍጠር
|
||||
|
||||
በኮምፒውተርዎ ላይ ወዳለው የማከማቻ ማውጫ ይቀይሩ (እዚያ ከሌለዎት)፡-
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
አሁን የ`git switch` ትዕዛዝን በመጠቀም ቅርንጫፍ ይፍጠሩ፡
|
||||
|
||||
```
|
||||
git switch -c የእርስዎ-አዲሱ-ቅርንጫፍ-ስም
|
||||
```
|
||||
|
||||
ለምሳሌ:
|
||||
|
||||
```
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
## አስፈላጊ ለውጦችን ያድርጉ እና ለውጦችን ያድርጉ
|
||||
|
||||
አሁን የ`Contributors.md` ፋይልን በጽሑፍ አርታኢ ውስጥ ይክፈቱ፣ ስምዎን በእሱ ላይ ያክሉ። በፋይሉ መጀመሪያ ወይም መጨረሻ ላይ አይጨምሩት። በመካከል የትኛውም ቦታ ላይ ያስቀምጡት. አሁን, ፋይሉን ያስቀምጡ.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
ወደ የፕሮጀክት ማውጫው ሄደው ትዕዛዙን `git status` ከፈጸሙ፣ ለውጦች እንዳሉ ያያሉ።
|
||||
|
||||
የ `git add` ትዕዛዙን በመጠቀም እነዚያን ለውጦች ወደ ፈጠሩት ቅርንጫፍ ያክሉ።
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
አሁን የ‹git› ትዕዛዙን በመጠቀም እነዚህን ለውጦች ያድርጉ፡
|
||||
|
||||
```
|
||||
git commit -m "ስሜን ወደ አስተዋጽዖ አበርካቾች ዝርዝር ጨምር"
|
||||
```
|
||||
|
||||
'ስሜን' በስምህ በመተካት።
|
||||
|
||||
## ለውጦችን ወደ GitHub ይግፉ
|
||||
|
||||
የ `git push` ትዕዛዝን በመጠቀም ለውጦችዎን ይግፉ፡-
|
||||
|
||||
```
|
||||
git push -u origin የእርስዎ-ቅርንጫፍ-ስም
|
||||
```
|
||||
|
||||
replacing `የእርስዎ-ቅርንጫፍ-ስም` with the name of the branch you created earlier.
|
||||
|
||||
<details>
|
||||
<summary> <strong> በመግፋት ላይ ማንኛውም ስህተት ካጋጠመህ እዚህ ጠቅ አድርግ፡- </strong> </summary>
|
||||
|
||||
- ### የማረጋገጫ ስህተት
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/የተጠቃሚ ስምህ/first-contributions.git/'</pre>
|
||||
ወደ [GitHub አጋዥ ስልጠና](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ይሂዱ የኤስኤስኤች ቁልፍን ወደ መለያዎ ማመንጨት እና ማዋቀር።
|
||||
|
||||
</details>
|
||||
|
||||
## ለውጦችዎን ለግምገማ ያስገቡ
|
||||
|
||||
በ GitHub ላይ ወደ ማከማቻዎ ከሄዱ፣ `Compare and Pull Request` የሚለውን ቁልፍ ያያሉ። በዚያ ቁልፍ ላይ ጠቅ ያድርጉ።
|
||||
|
||||
<img style="float: right;" src = "https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt = "የመጎተት ጥያቄ ፍጠር" />
|
||||
|
||||
አሁን የመሳብ ጥያቄውን ያስገቡ።
|
||||
|
||||
<img style="float: right;" src = "https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt = "ጥያቄን ጎትት" />
|
||||
|
||||
በቅርቡ ሁሉንም ለውጦችዎን ወደ የዚህ ፕሮጀክት ዋና ቅርንጫፍ አዋህዳለሁ። ለውጦቹ ከተዋሃዱ በኋላ የማሳወቂያ ኢሜይል ይደርስዎታል።
|
||||
|
||||
## ከዚህ ወዴት ልሂድ?
|
||||
|
||||
እንኳን ደስ ያለህ! ልክ እንደ አስተዋጽዖ አበርካች የሚያጋጥሙትን መደበኛ _fork -> clone -> አርትዕ -> የመሳብ ጥያቄ_ የስራ ፍሰትን አጠናቀዋል!
|
||||
|
||||
አስተዋፅኦዎን ያክብሩ እና ወደ [ድር መተግበሪያ](https://firstcontributions.github.io/#social-share) በመሄድ ለጓደኞችዎ እና ተከታዮችዎ ያካፍሉ።
|
||||
|
||||
ማንኛውም እርዳታ ከፈለጉ ወይም ማንኛውም ጥያቄ ካለዎት የእኛን ደካማ ቡድን መቀላቀል ይችላሉ. [የላላ ቡድንን ይቀላቀሉ](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)።
|
||||
|
||||
አሁን ለሌሎች ፕሮጀክቶች በማበርከት እንጀምር። እርስዎ ሊጀምሩባቸው የሚችሉ ቀላል ጉዳዮች ያላቸውን የፕሮጀክቶች ዝርዝር አዘጋጅተናል። ይመልከቱ [በድር መተግበሪያ ውስጥ ያሉ የፕሮጀክቶች ዝርዝር](https://firstcontributions.github.io/#project-list)።
|
||||
|
||||
### [ተጨማሪ ቁሳቁስ](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## መማሪያዎች ሌሎች-መሳሪያዎችን በመጠቀም
|
||||
|
||||
| <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) |
|
||||
@@ -1,141 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Kpekpeɖeŋu Gbãtɔ
|
||||
|
||||
Esesẽna ɣesiaɣi ne èwɔ nane zi gbãtɔ.Vɔvɔ̃ be yeawɔ vodadawo meɖea dzi ɖi kura o, vevietɔ ne èle nu wɔm aduadu.Gake kɔmpiutadziɖoɖo siwo wozãna faa ƒe xexeame ku ɖe nuwɔwɔ aduadu kple dɔwɔwɔ le ƒuƒoƒo me ŋu.Azɔ hã, míedi be míana wòanɔ bɔbɔe na kɔmpiutadziɖoɖo yeye siwo tsɔa nu faa femaxee la be woasrɔ̃ nu to alesi nàdzɔ nu zi gbãtɔ la fiafia wò me.
|
||||
|
||||
Nyatiwo kple nufiamewo xexlẽ ate ŋu akpe ɖe ŋuwò, gake nukae nyo wu be nàdze agbagba eye màte ŋu awɔ vodada o? Dɔ sia ƒe taɖodzinue nye be wòana mɔfiame eye wòana alesi dɔsrɔ̃viwo wɔa woƒe nudzɔdzɔ gbãtɔ nanɔ bɔbɔe.Ðo ŋku edzi be: zi alesi nèfa tu la, zi nenemae nèsrɔ̃a nu nyuie wu.Ne èdi vevie be yeadzɔ nu gbãtɔ la, ɖeko nàwɔ ɖe afɔɖeɖe siawo dzi.Medo ŋugbe be anye modzakaɖeɖe.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="ŋe asi ɖe nu sia ŋu" />
|
||||
|
||||
Ne git mele wò kɔmpiuta dzi o, [ tsɔe de wò kɔmpiuta dzi ]( https://help.github.com/articles/set-up-git/ ).
|
||||
|
||||
## Miɖe asi le agbalẽdzraɖoƒe sia (si woyɔna hã be Fork) .
|
||||
|
||||
Ne èdi be yeaʋu agbalẽvi sia la, zi dzi le aɖaka si nye "Fork" si le axa la ƒe tame.
|
||||
Esia ana be woaŋlɔ nyatakaka siwo le nyatakakadzraɖoƒea ɖe wò asitelefon dzi.
|
||||
|
||||
## Wɔ numekugbalẽvi sia ƒe kɔpi
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="Wɔ numekugbalẽvi sia ƒe kɔpi" />
|
||||
|
||||
Azɔ wɔ agbalẽdzraɖoƒe sia ƒe nɔnɔmetata ɖe wò kɔmpiuta dzi. Zi clone ƒe dzesi dzi emegbe nàzi dzesi la dzi</b> *kɔpi ɖe agbalẽƒomɔ̃ me*.
|
||||
|
||||
Ʋu kpovitɔ eye nàzã git se siwo gbɔna :
|
||||
|
||||
```
|
||||
git clone "url si nèwɔ kɔpi na fifia"
|
||||
```
|
||||
afisi "url si nèwɔ kɔpi teti koe nye ema" (si me nyayɔyɔawo mele o) nye url si le agbalẽdzraɖoƒea. Kpɔ akpa si do ŋgɔ be nàxɔ url la.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copier l'URL dans le presse-papier" />
|
||||
|
||||
Le kpɔɖeŋu me :
|
||||
```
|
||||
git clone https://github.com/wò-ŋkɔ-si-nèzãna/first-contributions.git
|
||||
```
|
||||
afisi `Wò ŋkɔ si nèzãna` nye wò GitHub zãla ƒe ŋkɔ. Afisiae nèle nusiwo le agbalẽdzraɖoƒea ƒe kɔpi wɔm le `first-contributions` tso GitHub dzi le wò kɔmpiuta dzi.
|
||||
|
||||
## Wɔ alɔdzedɔwɔƒe aɖe
|
||||
|
||||
Ʋu yi dɔwɔwɔ ƒe nɔnɔmetata yeye si wowɔ ƒe nɔnɔmetata me (ne mèle afima haɖe o):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Azɔ wɔ alɔdze aɖe kple sededea `git checkout` :
|
||||
```
|
||||
git checkout -b <wò-ŋkɔ>
|
||||
```
|
||||
|
||||
Le kpɔɖeŋu me :
|
||||
```
|
||||
git checkout -b add-abdou-raouf-atarmla
|
||||
```
|
||||
(Mehiã be nya *add* nanɔ alɔdzedɔwɔƒea ƒe ŋkɔ me o, gake esɔ be nàde eme elabena taɖodzinu si le alɔdze sia ŋue nye be wòatsɔ wò ŋkɔ akpe ɖe xexlẽdzesi aɖe ŋu.)
|
||||
|
||||
## Wɔ tɔtrɔ siwo hiã eye nàtsɔ wo ana
|
||||
|
||||
Azɔ ʋu nuŋlɔɖia `Contributors.md` de wò ŋkɔ ɖe etame eye nàŋlɔe ɖi. Ne èʋu sedede ƒe nyatakakadzraɖoƒea eye nèwɔ sededea `git status`, àkpɔe be tɔtrɔwo li. Tsɔ tɔtrɔ siawo kpe ɖe alɔdze si nèwɔ fifia kple sededea ŋu `git add` :
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Azɔ wɔ tɔtrɔ siawo kple sededea `git commit`:
|
||||
```
|
||||
git commit -m "Tsɔ <wò-ŋkɔ> kpe ɖe Nudzɔlawo ƒe xexlẽdzesi ŋu"
|
||||
```
|
||||
tsɔ wò ŋkɔ ɖɔli `<wò-ŋkɔ>`.
|
||||
|
||||
## Tu tɔtrɔwo ɖe GitHub dzi
|
||||
|
||||
Tu wò tɔtrɔwo kple sededea `git push` :
|
||||
```
|
||||
git push origin <wò-ŋkɔ>
|
||||
```
|
||||
tsɔ alɔdze si wowɔ va yi ƒe ŋkɔ ɖɔli `<wò-ŋkɔ>`.
|
||||
|
||||
## Miɖo miaƒe tɔtrɔwo ɖa be woalé ŋku ɖe wo ŋu
|
||||
|
||||
Ne èyi wò nudzraɖoƒe le Github la, àkpɔ `Compare & pull request` ƒe dzesi. Zi dzesi sia dzi.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Azɔ tsɔ hehe ƒe biabiaa ɖo ɖa.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Eteƒe madidi o, maƒo miaƒe tɔtrɔwo katã nu ƒu ɖe dɔ sia ƒe alɔdze vevitɔ me. Àxɔ nyatakaka to e-mail dzi ne wonya wu ƒoƒo ɖekae nu ko.
|
||||
|
||||
Womatrɔ asi le miaƒe alɔdzedɔwɔƒea ƒe alɔdzedɔwɔƒe gãtɔ ŋu le ɣeyiɣi sia me o. Be wò spur nawɔ ɖeka kple tɔnye la, wɔ ɖe afɔɖeɖe siawo dzi.
|
||||
|
||||
## Na wò alɔdzedɔwɔƒea nawɔ ɖeka kple nyatakakadzraɖoƒe sia
|
||||
|
||||
Gbã la, trɔ ɖe alɔdzedɔwɔƒe gã la ŋu (main)
|
||||
```
|
||||
git checkout main
|
||||
```
|
||||
|
||||
Eye nàtsɔ nye nyatakakadzraɖoƒe ƒe ka akpee be `upstream remote url` :
|
||||
```
|
||||
git remote add upstream https://github.com/Roshanjossey/first-contributions
|
||||
```
|
||||
Esia nye mɔ si dzi míetona gblɔna be nu bubu aɖe hã li si le míaƒe nyatakakadzraɖoƒea si míeyɔna be `upstream`. Ne tɔtrɔawo va wɔ ɖeka ko la, di nye numekuku ƒe akpa yeyea:
|
||||
```
|
||||
git fetch upstream
|
||||
```
|
||||
|
||||
Afisiae míele tɔtrɔwo katã dim le nye alɔdzedɔwɔƒe (upstream remote) me. Fifia ele be nàƒo tɔtrɔ yeye si tso nye agbalẽdzraɖoƒea nu ƒu ɖe wò alɔdze gã la me:
|
||||
```
|
||||
git rebase upstream/main
|
||||
```
|
||||
Le afisia la, míewɔa tɔtrɔ siwo katã dim nènɔ la ŋudɔ le alɔdzedɔwɔƒe gã la me. Ne ètu alɔdze gã la fifia la, tɔtrɔ siawo hã anɔ wò fɔkpaa ŋu:
|
||||
```
|
||||
git push origin main
|
||||
```
|
||||
Nuxlɔ̃ame: Fifia ya èle tutum ayi adzɔge ʋĩ ƒe nyatakakadzraɖoƒe si woyɔna be origin.
|
||||
|
||||
Le afisia la, metsɔ wò `<wò-ŋkɔ>` alɔdzedɔwɔƒea ƒo ƒu kple nye alɔdze gãtɔ, eye nètsɔ nye alɔdze gã la ƒo ƒu kple wò alɔdze gãtɔ. Wò `<wò-ŋkɔ>` alɔdze megahiã o, eyata àteŋu atutue:
|
||||
```
|
||||
git branch -d <wò-ŋkɔ>
|
||||
```
|
||||
eye àte ŋu atutu eƒe tɔtrɔ le adzɔge ʋĩ ƒe nyatakakadzraɖoƒe hã:
|
||||
```
|
||||
git push origin --delete <wò-ŋkɔ>
|
||||
```
|
||||
Esia mehiã o, gake alɔdzedɔwɔƒea ƒe ŋkɔ ɖee fia be eƒe taɖodzinua nye nu si le vevie. Eƒe agbenɔɣi ate ŋu anɔ kpuie.
|
||||
|
||||
## Nufiame siwo zãa dɔwɔnu bubuwo
|
||||
|
||||
|
||||
| <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) |
|
||||
|
||||
## Afikae míayi emegbe?
|
||||
|
||||
Àte ŋu awɔ ɖeka kple míaƒe ƒuƒoƒoa hã le Slack nenye be èhiã kpekpeɖeŋu alo nyabiase aɖewo le asiwò. [Wɔ ɖeka kple ƒuƒoƒoa le Slack dzi](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
@@ -1,130 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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)
|
||||
|
||||
<p align="right">
|
||||
|
||||
# اولین مشارکت
|
||||
|
||||
این پروژه قصد دارد تا مسیر مشارکت در پروژههای متنباز را برای تازهکارها آسان نماید. اگر شما نیز به دنبال راهی برای ثبت اولین مشارکت خود هستید، این اقدامات را دنبال کنید.
|
||||
|
||||
_اگر با محیط کامندی (CLI) احساس راحتی نمیکنید، [راهنمای استفاده از ابزارهای گرافیکی (GUI) را مشاهده کنید](#آموزش-انجام-مشارکت-در-دیگر-ابزارها)._
|
||||
|
||||
<img align="left" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### اگر نرمافزار git را آماده ندارید، [از اینجا نصب کنید](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## مخزن را فورک کنید
|
||||
|
||||
با کلیک کردن بر روی دکمه Fork، از مخزن مورد نظر یک انشعاب بگیرید. این عملیات یک نسخه کپی از مخزن را بر روی حساب کاربری شما ایجاد میکند.
|
||||
|
||||
## مخزن را کلون (شبیه) کنید
|
||||
|
||||
<img align="left" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
حال، از مخزن فورک شده، یک کلون روی سیستم کاربری خود ایجاد کنید. وارد حساب کاربری خود شده و مخزن فورک شده را باز کنید. دکمه Code را فشرده و نماد copy to clipboard را انتخاب کنید.
|
||||
|
||||
سپس یک ترمینال باز کنید و دستور گیت زیر را اجرا نمایید:
|
||||
|
||||
```bash
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
بطوری که در قسمت "url you just copied"، آدرس مخزن فورک شده بدون علامتهای کوتیشن (نقل قول) قرار گیرد.
|
||||
|
||||
<img align="left" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
بعنوان مثال:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
به طوری که عبارت `this-is-you` برابر با نام حساب کاربری گیتهاب شما باشد. با این اقدام، تمام محتوای مورد نیاز جهت مشارکت را بر روی سیستم خود آماده میسازید.
|
||||
|
||||
### یک شاخه ایجاد کنید
|
||||
|
||||
اگر در مسیر مخزن کلون شده قرار ندارید، با دستور زیر وارد مسیر مخزن شوید:
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
با استفاده از دستور `git checkout` یک شاخه جدید ایجاد کنید:
|
||||
|
||||
```bash
|
||||
git checkout -b your-new-branch-name
|
||||
```
|
||||
|
||||
بعنوان مثال:
|
||||
|
||||
```bash
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
(هیچ لزومی نیست که در نام شاخه از کلمه `add` استفاده کنید. چنانچه قرار است بعنوان مشارکت، نام خود را به یک لیست اضافه کنیم، استفاده از این کلمه بعنوان نام شاخه، امری عاقلانه میباشد.)
|
||||
|
||||
### تغییرات اساسی ایجاد کرده و کامیت کنید
|
||||
|
||||
در این قدم، ابتدا فایل `Contributors.md` را در یک محیط ویرایش متن باز کنید. نام خود را به این فایل اضافه کنید. توجه کنید که نام نه در ابتدا و نه در انتها قرار گیرد. نام را بین اسامی قرار دهید. فایل را ذخیره کنید.
|
||||
|
||||
<img align="left" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
چنانچه وارد مسیر مخزن شوید و دستور `git status` را اجرا نمایید، مشاهده خواهید کرد که تغییراتی بر روی مخزن اعمال شده.
|
||||
|
||||
با استفاده از دستور `git add`، تغییرات را به برنچ از پیش ساختهشده اضافه کنید:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
حال، تغییرات را با دستور `git commit` کامیت و ثبت نمایید:
|
||||
|
||||
```bash
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
توجه داشته باشید که نام خود را با عبارت `<your-name>` جایگزین کنید.
|
||||
|
||||
## تغییرات را ارسال (پوش) کنید
|
||||
|
||||
با استفاده از دستور `git push` تغییرات ثبت شده را ارسال کنید:
|
||||
|
||||
```bash
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
|
||||
نام برنچی که در مراحل قبل ایجاد کردید را با عبارت `<add-your-branch-name>` جایگزین کنید.
|
||||
|
||||
## تغییرات خود را برای بررسی، ثبت کنید
|
||||
|
||||
چنانچه وارد مخزن فورک شده در حساب کاربری خود شوید، گزینهای تحت عنوان `Compare & pull request` مشاهده خواهید کرد. آن گزینه را انتخاب کنید.
|
||||
|
||||
<img style="float: left;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
در این مرحله، درخواست (Pull request) خود را ثبت کنید.
|
||||
|
||||
<img style="float: left;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
نهایتا، من تغییرات شما را به برنچ master پروژه اضافه (merge) خواهم کرد. بلافاصله پس از مرج شدن درخواست شما، یک ایمیل مبنی بر همین موضوع برای شما ارسال خواهد شد.
|
||||
|
||||
## اقدامات بعدی
|
||||
|
||||
تبریک! شما مراحل فورک کردن، کلون کردن، ایجاد تغییرات و پول رکوئست را به خوبی پشت سر گذاشتید.
|
||||
|
||||
مشارکت خود روی این پروژه را [از اینجا](https://firstcontributions.github.io/#social-share) با دیگر دوستان و دنبالکنندگان خود جشن بگیرید.
|
||||
|
||||
همچنین شما میتوانید [از اینجا](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)، وارد تیم Slack ما شوید و سوالات خود را مطرح نمایید.
|
||||
|
||||
حال، شما میتوانید مشارکت خود را روی دیگر پروژهها آغاز نمایید. ما یک لیست از پروژهها با مشکلات ساده ایجاد کردیم که گزینه خوبی برای شروع میباشد. لیست پروژهها را [از این اینجا](https://firstcontributions.github.io/#project-list) دنبال کنید.
|
||||
|
||||
### [اطلاعات بیشتر](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## آموزش انجام مشارکت در دیگر ابزارها
|
||||
|
||||
| <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) |
|
||||
|
||||
</p>
|
||||
@@ -1,129 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Ensimmäiset kontribuutiot
|
||||
|
||||
Se on vaikeaa. Ensimmäiset kerrat ovat aina vaikeita. Etenkin tehdessä yhteistyötä, virheiden teko ei ole ollenkaan mukavaa. Me halusimme yksinkertaistaa tavan jolla avoimen lähdekoodin kontribuoijat oppivat sekä kontribuoivat ensimmäistä kertaa.
|
||||
|
||||
Artikkeleiden lukeminen sekä tutoriaalien katsominen voi auttaa, mutta mikä onkaan parempaa kuin käytännön harjoite harjoitusympäristössä? Tämä projekti tähtää avun tarjoamiseen sekä aloittelijoiden ensimmäisen kontribuution yksinkertaistamiseen. Jos olet aikeissa kontribuoida ensimmäistä kertaa, seuraa alla olevia ohjeita.
|
||||
|
||||
#### *Jos et osaa käyttää komentoriviä sulavasti, [täältä löytyy tutoriaaleja GUI-työkalujen käyttöön.](#Muiden-työkalujen-tutoriaaleja)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Jos sinulla ei ole git asennettuna koneellesi, [asenna se](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Forkkaa tämä repositorio
|
||||
|
||||
Forkkaa tämä repositorio klikkaamalla yläkulmassa näkyvää painiketta "Fork". Tämä luo kopion tästä repositoriosta käyttäjällesi.
|
||||
|
||||
## Kloonaa repositorio
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Seuraavaksi kloonaa juuri forkkaamasi repositorio koneellesi. Mene GitHub käyttäjäsivuillesi, avaa forkkaamasi repositorio sekä klikkaa "Clone or download"-painiketta jonka jälkeen kopioi osoite painamalla "Copy to clipboard"-ikonia.
|
||||
|
||||
Avaa komentorivi ja syötä seuraava git-komento:
|
||||
|
||||
```
|
||||
git clone "Juuri kopioimasi URL"
|
||||
```
|
||||
|
||||
"Juuri kopioimasi URL"-tekstin sijasta (ilman lainausmerkkejä) pastea repositorion URL äskeisestä vaiheesta.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Esimerkiksi:
|
||||
|
||||
```
|
||||
git clone https://github.com/nimesi/first-contributions.git
|
||||
```
|
||||
|
||||
Kirjoita GitHub-käyttäjänimesi 'nimesi' teksin sijaan. Tämä komento kopioi sisällön GitHubisi first contributions-repositorion koneellesi.
|
||||
|
||||
## Luo branch
|
||||
|
||||
Mene repositoriosi kansioon koneellasi (ellet jo ole siellä).
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Seuraavaksi luo branch komennolla `git checkout`:
|
||||
|
||||
```
|
||||
git checkout -b <lisaa-sinun-branchin-nimi>
|
||||
```
|
||||
|
||||
Esimerkiksi:
|
||||
|
||||
```
|
||||
git checkout -b add-matti-meikalainen
|
||||
```
|
||||
|
||||
(Branchin nimeen ei välttämättä tarvitse sisällyttää sanaa *add*, mutta tässä se käy järkeen sillä tämän branchin tarkoitus on lisätä nimesi listaan.)
|
||||
|
||||
## Tee tarvittavat muutokset sekä committoi ne
|
||||
|
||||
Seuraavaksi avaa `Contributors.md` tiedosto tekstieditorissa ja lisää nimesi tiedostoon. Älä lisää sitä tiedoston alkuun taikka loppuun vaan keskelle. Seuraaksi tallenna tiedosto.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Jos menet projektin kansioon ja syötät komennon `git status`, näet muutokset.
|
||||
|
||||
Lisää nuo muutokset branchiin `git add` komennolla:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Seuraavaksi committoi muutokset `git commit` komennolla:
|
||||
|
||||
```
|
||||
git commit -m "Add <sinun-nimesi> to Contributors list"
|
||||
```
|
||||
|
||||
Korvaamalla `<sinun-nimesi>` nimelläsi.
|
||||
|
||||
## Muutosten pushaaminen GitHubiin
|
||||
|
||||
Pushaa muutoksesi komennolla `git push`:
|
||||
|
||||
```
|
||||
git push origin <lisaa-branchisi-nimi>
|
||||
```
|
||||
|
||||
Korvaamalla `<lisaa-branchisi-nimi>` nimellä jonka annoit branchillesi aikaisemmin.
|
||||
|
||||
## Jätä muutoksesi arvosteltavaksi
|
||||
|
||||
Jos menet repositorioosi GitHubissa, näet `Compare & pull request` painikkeen. Paina tuota painiketta.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Seuraavaksi suorita pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Seuraavaksi mergeän muutoksesi tämän projektin master-branchiin. Tulet saamaan ilmoituksen sähköpostiisi kun muutokset ovat mergetty.
|
||||
|
||||
## Mihin seuraavaksi?
|
||||
|
||||
Onneksi olkoon! Olet juuri suorittanut tavanomaisen *Fork -> Clone -> Edit -> Pull Request* -työnkulun joka tulee vastaasi usein kontribuoijana!
|
||||
|
||||
Juhlista kontribuutiotasi ja jaa se ystävillesi ja followereillesi menemällä [Web Appiin](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Voit liittyä Slack tiimiimme jos sinulla on kysyttävää. [Liity Slack tiimiin](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Jos haluaisit kontribuoida muihin projekteihin, me olemme koonneet listan yksinkertaisista ensimmäisistä issueista työskenneltäväksesi. [Lista löytyy Web-Appistamme](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Lisämateriaaleja](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Muiden työkalujen tutoriaaleja
|
||||
|
||||
| <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) |
|
||||
@@ -1,136 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Mga Unang Kontribusyon
|
||||
|
||||
Nilalayon ng proyektong ito na gawing simple at gabayan ang paraan ng paggawa ng mga nagsisimula sa kanilang unang kontribusyon. Kung gusto mong gawin ang iyong unang kontribusyon, sundin ang mga hakbang sa ibaba.
|
||||
|
||||
_Kung hindi ka komportable sa command line, [narito ang mga tutorial gamit ang GUI tool.](#tutorials-using-other-tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### Kung wala kang git sa iyong makina, [i-install ito](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## I-fork ang repositoryong ito
|
||||
|
||||
I-fork ang repository na ito sa pamamagitan ng pag-click sa fork button sa tuktok ng page na ito.
|
||||
Gagawa ito ng kopya ng repositoryong ito sa iyong account.
|
||||
|
||||
## I-clone ang repositoryo
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Ngayon i-clone ang forked repository sa iyong makina. Pumunta sa iyong GitHub account, buksan ang forked repository, i-click ang code button at pagkatapos ay i-click ang _copy to clipboard_ icon.
|
||||
|
||||
Magbukas ng terminal at patakbuhin ang sumusunod na git command:
|
||||
|
||||
```
|
||||
git clone "url na kinopya mo lang"
|
||||
```
|
||||
|
||||
kung saan ang "url na kinopya mo lang" (nang walang mga panipi) ay ang url sa repositoryong ito (ang iyong tinidor ng proyektong ito). Tingnan ang mga nakaraang hakbang para makuha ang url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Halimbawa:
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
kung saan ang `this-is-you` ay ang iyong GitHub username. Dito mo kinokopya ang mga nilalaman ng repositoryo ng mga unang kontribusyon sa GitHub sa iyong computer.
|
||||
|
||||
## Gumawa ng sangay
|
||||
|
||||
Baguhin sa direktoryo ng repositoryo sa iyong computer (kung wala ka pa roon):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Ngayon lumikha ng isang sangay gamit ang utos na `git switch`:
|
||||
|
||||
```
|
||||
git switch -c your-new-branch-name
|
||||
```
|
||||
|
||||
Halimbawa:
|
||||
|
||||
```
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
## Gumawa ng mga kinakailangang pagbabago at gawin ang mga pagbabagong iyon
|
||||
|
||||
Ngayon buksan ang `Contributors.md` file sa isang text editor, idagdag ang iyong pangalan dito. Huwag idagdag ito sa simula o dulo ng file. Ilagay ito kahit saan sa pagitan. Ngayon, i-save ang file.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Kung pupunta ka sa direktoryo ng proyekto at isagawa ang command na `git status`, makikita mong may mga pagbabago.
|
||||
|
||||
Idagdag ang mga pagbabagong iyon sa sangay na nilikha mo lamang gamit ang utos na `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Ngayon gawin ang mga pagbabagong iyon gamit ang utos na `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
Ngayon gawin ang mga pagbabagong iyon gamit ang utos na `git commit`:
|
||||
|
||||
## I-push ang mga pagbabago sa GitHub
|
||||
|
||||
Itulak ang iyong mga pagbabago gamit ang command na `git push`:
|
||||
|
||||
```
|
||||
git push -u origin your-branch-name
|
||||
```
|
||||
|
||||
pinapalitan ang `your-branch-name` ng pangalan ng branch na ginawa mo kanina.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Kung nakakakuha ka ng anumang mga error habang nagtutulak, mag-click dito: </strong> </summary>
|
||||
|
||||
- ### Error sa Pagpapatunay
|
||||
<pre>remote: Inalis ang suporta para sa pagpapatotoo ng password noong Agosto 13, 2021. Mangyaring gumamit na lang ng personal na access token.
|
||||
remote: Pakitingnan ang https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ para sa karagdagang impormasyon.
|
||||
nakamamatay: Nabigo ang pagpapatotoo para sa 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Pumunta sa [tutorial ng GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) sa pagbuo at pag-configure ng SSH key sa iyong account.
|
||||
</details>
|
||||
|
||||
## Isumite ang iyong mga pagbabago para sa pagsusuri
|
||||
|
||||
Kung pupunta ka sa iyong repository sa GitHub, makakakita ka ng button na `Ihambing at hilahin ang kahilingan. I-click ang button na iyon.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Ngayon isumite ang kahilingan sa paghila.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Sa lalong madaling panahon, pagsasamahin ko ang lahat ng iyong mga pagbabago sa pangunahing sangay ng proyektong ito. Makakatanggap ka ng email ng notification kapag napagsama na ang mga pagbabago.
|
||||
|
||||
## Saan pupunta mula dito?
|
||||
|
||||
Congrats! Nakumpleto mo lang ang karaniwang _fork -> clone -> edit -> pull request_ workflow na madalas mong makaharap bilang isang contributor!
|
||||
|
||||
Ipagdiwang ang iyong kontribusyon at ibahagi ito sa iyong mga kaibigan at tagasubaybay sa pamamagitan ng pagpunta sa [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Maaari kang sumali sa aming slack team kung kailangan mo ng anumang tulong o may anumang mga katanungan. [Sumali sa slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Ngayon simulan na natin ang pag-aambag sa iba pang mga proyekto. Nag-compile kami ng isang listahan ng mga proyekto na may mga madaling isyu na maaari mong simulan. Tingnan ang [listahan ng mga proyekto sa web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Karagdagang materyal](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Mga Tutorial Gamit ang Iba Pang Mga Tool
|
||||
|
||||
| <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) |
|
||||
@@ -1,176 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Premières Contributions
|
||||
|
||||
C'est toujours compliqué la première fois que l'on fait quelque chose. La peur de faire des fautes n'est pas du tout confortable, spécialement quand vous collaborez. Mais le monde du logiciel libre est le fait de collaborer et de travailler en groupe. Aussi, nous voulons simplifier l'apprentissage des nouveaux contributeurs au logiciel libre en vous enseignant à contribuer pour la première fois.
|
||||
|
||||
Lire des articles et des tutoriels peut aider, mais qu'y a-t-il de mieux que d'essayer sans pouvoir faire d'erreurs ? Ce projet a pour ambition de fournir des conseils et simplifier la manière dont les apprentis font leur première contribution. Souvenez-vous : plus vous êtes serein, mieux vous apprenez. Si vous aspirez à faire votre première contribution, suivez tout simplement les étapes suivantes. Promis, ce sera amusant.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="forker ce repertoire" />
|
||||
|
||||
Si vous n'avez pas encore Git installé sur votre machine, [ installez-le ]( https://help.github.com/articles/set-up-git/ ).
|
||||
|
||||
## Faire un fork de ce dépôt
|
||||
|
||||
Forkez ce dépôt en cliquant sur le bouton *fork* en haut de cette page.
|
||||
Cela créera une copie de ce dépôt dans votre propre compte GitHub
|
||||
|
||||
## Clonez ce répertoire
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonez ce répertoire" />
|
||||
|
||||
Maintenant, clonez ce répertoire sur votre ordinateur. Allez sur votre compte GitHub, ouvrez le dépôt forké, cliquez sur le bouton *Code*, puis sur l’onglet *SSH* et enfin sur l’icône *copier dans le presse-papiers*.
|
||||
|
||||
Ouvrez une invite de commande (si vous êtes sous Windows) ou un terminal (si vous êtes sous MacOS ou Linux) et exécutez la commande git suivante :
|
||||
|
||||
```
|
||||
git clone "l'url que vous venez de copier"
|
||||
```
|
||||
où "l'url que vous venez de copier" (sans les guillemets) est l'url du dépôt forké. Revoir les étapes précédentes pour obtenir l’URL exacte.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copier l'URL dans le presse-papier" />
|
||||
|
||||
Par exemple :
|
||||
```
|
||||
git clone https://github.com/votre-nom-d-utilisateur/first-contributions.git
|
||||
```
|
||||
où `votre-nom-d-utilisateur` est votre nom d'utilisateur GitHub. Ici vous êtes en train de copier le contenu du dépôt `first-contributions` depuis GitHub sur votre ordinateur.
|
||||
|
||||
## Créez une branche
|
||||
|
||||
Déplacez-vous dans le répertoire du projet nouvellement cloné (si vous n'y êtes pas encore) :
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Maintenant créez une branche avec la commande `git checkout` :
|
||||
```
|
||||
git checkout -b <add-votre-nom>
|
||||
```
|
||||
|
||||
Par exemple :
|
||||
```
|
||||
git checkout -b add-koffi-sani
|
||||
```
|
||||
(Le nom de la branche n'a pas besoin de contenir le terme *add*, mais il est mieux de l'inclure car l'objectif de cette branche est d'ajouter votre nom à une liste.)
|
||||
|
||||
<details> <summary> <strong>Si vous rencontrez une erreur avec git switch, cliquez ici :</strong> </summary>
|
||||
Si le message "Git: switch is not a git command. See git –help" s’affiche, c’est probablement parce que vous utilisez une ancienne version de Git.
|
||||
|
||||
Dans ce cas, essayez plutôt :
|
||||
|
||||
```
|
||||
git checkout -b nom-de-ta-nouvelle-branche
|
||||
```
|
||||
</details>
|
||||
|
||||
## Effectuez les modifications nécessaires et enregistrez-les
|
||||
|
||||
Ouvrez le fichier `Contributors.md` dans un éditeur de texte, ajoutez-y votre nom, et enregistrez-le. Ne l’ajoutez pas au début ou à la fin du fichier, mais quelque part au milieu.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Si vous ouvrez l'invite de commande et que vous exécutez la commande `git status`, vous verrez qu'il y a des modifications. Ajoutez ces modifications à la branche que vous venez de créer avec la commande `git add` :
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Maintenant faites un commit de ces modifications avec la commande `git commit`:
|
||||
```
|
||||
git commit -m "Add <votre-nom> to Contributors list"
|
||||
```
|
||||
en remplaçant `<votre-nom>` par votre nom.
|
||||
|
||||
## Envoyez les modifications vers GitHub
|
||||
|
||||
Poussez vos modifications avec la commande `git push` :
|
||||
```
|
||||
git push -u origin <nom-de-votre-branche>
|
||||
```
|
||||
en remplaçant `<nom-de-votre-branche>` avec le nom de la branche précédemment créée.
|
||||
|
||||
<details> <summary> <strong>Si tu obtiens une erreur au moment de pousser, clique ici :</strong> </summary>
|
||||
|
||||
- ### Erreur d’authentification
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information. fatal: Authentication failed for 'https://github.com/<ton-nom-utilisateur>/first-contributions.git/'</pre>
|
||||
Suivez le tutoriel GitHub pour générer et configurer une clé SSH sur votre compte.
|
||||
|
||||
Vous pouvez également exécuter git remote -v pour vérifier votre adresse distante.
|
||||
|
||||
Si elle ressemble à ceci :
|
||||
|
||||
<pre>origin https://github.com/ton-nom-utilisateur/ton_repo.git (fetch) origin https://github.com/ton-nom-utilisateur/ton_repo.git (push)</pre>
|
||||
Modifiez-la avec cette commande :
|
||||
|
||||
```
|
||||
git remote set-url origin git@github.com:ton-nom-utilisateur/ton_repo.git
|
||||
```
|
||||
Sinon, vous continuerez de devoir entrer votre mot de passe et vous obtiendrez une erreur d’authentification.
|
||||
|
||||
</details>
|
||||
|
||||
## Soumettez votre contribution pour révision
|
||||
|
||||
Si vous vous rendez sur votre répertoire sur Github, vous verrez un bouton `Compare & pull request`. Cliquez dessus.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="créer une pull request" />
|
||||
|
||||
Soumettez ensuite la *pull request*.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="soumettre une pull request" />
|
||||
|
||||
Je fusionnerai bientôt vos modifications dans la branche principale du projet.
|
||||
Vous recevrez un e-mail de confirmation une fois que ce sera fait.
|
||||
|
||||
La branche main de votre dépôt forké ne subira pas de modification. Pour que votre dépôt soit synchronisé avec le mien, suivez les étapes suivantes.
|
||||
|
||||
## Gardez votre embranchement synchronisé avec ce répertoire
|
||||
|
||||
D'abord, basculez sur la branche main
|
||||
```
|
||||
git checkout main
|
||||
```
|
||||
|
||||
Et ajouter l'url de mon répertoire comme `upstream remote url` :
|
||||
```
|
||||
git remote add upstream https://github.com/Roshanjossey/first-contributions
|
||||
```
|
||||
Ceci est une manière de dire à git qu'une autre version de ce répertoire existe à l'adresse spécifiée et que nous l'appelons `upstream`. Une fois les modifications fusionnées, cherchez la nouvelle version de mon répertoire :
|
||||
```
|
||||
git fetch upstream
|
||||
```
|
||||
|
||||
Ici nous cherchons toutes les modifications dans mon embranchement (upstream remote). Maintenant, vous devez fusionner la nouvelle révision de mon répertoire avec votre branche main :
|
||||
```
|
||||
git rebase upstream/main
|
||||
```
|
||||
Ici nous appliquons toutes les modifications que vous avez récupéré à la branche main. Si vous poussez la branche main maintenant, votre embranchement aussi aura les modifications :
|
||||
```
|
||||
git push origin main
|
||||
```
|
||||
Avertissement: Cette fois, vous poussez les modifications au répertoire distant appelé origin.
|
||||
|
||||
A cet instant j'ai fusionné votre branche `<add-votre-nom>` avec ma branche main, et vous avez fusionné ma branche main avec votre branche main. Votre branche `<add-votre-nom>` n'est plus utile, donc vous pouvez la supprimer :
|
||||
```
|
||||
git branch -d <add-votre-nom>
|
||||
```
|
||||
et vous pouvez supprimer sa version dans le répertoire distant aussi :
|
||||
```
|
||||
git push origin --delete <add-votre-nom>
|
||||
```
|
||||
Ceci n'est pas nécessaire, mais le nom de la branche montre que son objectif est assez spécifique. Sa durée de vie peut être courte.
|
||||
|
||||
## Tutoriels en utilisant d'autres outils
|
||||
|
||||
|
||||
| <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) |
|
||||
|
||||
## Où aller ensuite ?
|
||||
|
||||
Vous pouvez aussi rejoindre notre équipe sur Slack au cas où vous auriez besoin d'aide ou auriez des questions. [Rejoindre l'équipe sur Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
@@ -1,152 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Tosaíonn Céad Cuireadh
|
||||
|
||||
Is é aidhm an tionscadail seo a bheith simplí agus treoraithe don tslí a ndéanann túsóirí a gcéad chuimsithe. Más mian leat do chéad chuimsiú a dhéanamh, lean na céimeanna thíos.
|
||||
|
||||
_Más rud é nach bhfuil tú compordach leis an líne smachta, [tá tutóirialanna anseo ag baint úsáide as uirlisí GUI](#tutorials-using-other-tools)_
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### Mura bhfuil git ar do mhaisín agat, [suiteáil é](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## Foirgneamh an repositry a shábháil
|
||||
|
||||
Foirgneamh an repositry seo trí ghrúpaigh air a dhéanamh. Cliceáil ar an gcnaipe foirgneamh atá ar bharr an leathanaigh seo. Cruthóidh sé cóip d'an repositry seo in do chuntas féin.
|
||||
|
||||
|
||||
## Clónaigh an repositry
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Anois, clónaigh an repositry ghrúpaithe chuig do mhaisín. Téigh go dtí do chuntas GitHub, oscail an repositry ghrúpaithe, cliceáil ar an gcnaipe cód agus ansin _cliceáil ar an íomhá ghlactha_ chuig an ghluais cóipchlibeaird.
|
||||
|
||||
|
||||
|
||||
Oscail tearma agus rith an t-ordú git seo a leanas:
|
||||
|
||||
```
|
||||
git clone "url a ghlac tú amach"
|
||||
```
|
||||
|
||||
Mar sin "url a ghlac tú amach" (gan na tréimhseanna quoitimh) is ea url chuig an repositry seo (do ghruapa den tionscadal seo). Féach ar na céimeanna roimhe sin chun an url a fháil.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Mar shampla:
|
||||
|
||||
```
|
||||
git clone git@github.com:this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
Ait a bhfuil `this-is-you` is t-ainm úsáideora GitHub. Anseo atá tú ag cóipeáil ábhar repositry first-contributions ar GitHub chuig do ríomhaire.
|
||||
|
||||
## Cruthaigh snáth
|
||||
|
||||
Athraigh go dtí comhad repositry ar do ríomhaire (mura bhfuil tú ansin cheana):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
nois cruthaigh snáth ag baint úsáide as an comhad `git switch`:
|
||||
|
||||
```
|
||||
git switch -c your-new-branch-name
|
||||
```
|
||||
|
||||
Mar shampla:
|
||||
|
||||
```
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
## Déan na hathruithe riachtanacha agus déan comhaireamh orthu
|
||||
|
||||
Anois, oscail `Contributors.md` i eagarthóir téacs, cuir do ainm leis. Ná cuir é ag tús ná ag deireadh an chomhad. Cuir é in aon áit ina lár. Ansin, sábháil an comhad.
|
||||
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Más téann tú go dtí comhaid tionscadail agus déanann tú an t-ordú `git status`, feicfidh tú go bhfuil athruithe ann.
|
||||
|
||||
Cuir na hathruithe sin leis an snáth a chruthaigh tú leis an gcnaipe `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Ansin déan comhaireamh orthu leis an gcnaipe `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
agus cuir in áit do ainm in ionad `your-name`.
|
||||
|
||||
## Seol athruithe chuig GitHub
|
||||
|
||||
Seol do chuid athruithe ag baint úsáide as an gcnaipe `git push`:
|
||||
|
||||
```
|
||||
git push -u origin your-branch-name
|
||||
```
|
||||
|
||||
|
||||
agus cuir `your-branch-name` do snátha a chruthaigh tú roimhe seo.
|
||||
<details>
|
||||
<summary> <strong>Má fhaigheann tú botúin ar bith le linn an athsheoladh, cliceáil anseo:</strong> </summary>
|
||||
|
||||
- ### Authentication Error
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Go to [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account.
|
||||
|
||||
</details>
|
||||
|
||||
## Cuimhnigh ort do chuid athruithe a chur chun athbhreithnithe
|
||||
|
||||
Má téann tú go dtí do repositry ar GitHub, feicfidh tú cnaipe `Compare & pull request`. Cliceáil ar an gcnaipe sin.
|
||||
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Ansin cuir isteach an iarratas athbhreithnithe.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Go luath beidh mé ag méascadh na hathruithe uile atá déanta agat isteach i mbranca príomh an tionscadail seo. Beidh ríomhphost fógra agat nuair a bheidh na hathruithe comhoiriúnaithe.
|
||||
|
||||
|
||||
## Cá háit a leantú as seo amach?
|
||||
|
||||
Comhghairdeas! Chríochnaigh tú an tslí ríthábhachtach _fork -> clone -> edit -> pull request_ iarratas ar athbhreithniú a bhíonn ag tionscalóirí go minic!
|
||||
|
||||
|
||||
Ceiliúraigh do chionta agus roinne é le do chairde agus le do leanúnaigh trí dul go dtí an aip ghréasáin. [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
D'fhéadfá dul inár bhfoireann Slack má tá cabhair uait nó ceisteanna agat. [Ghabh le foireann Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w).
|
||||
|
||||
Anois, lig dúinn tú a thosú ag tacú le tionscadail eile. Tá liosta againn de thionscadail le faidhéideanna éasca a d'fhéadfá tosú orthu. Féach ar liosta na dtionscadal san aip ghréasáin.
|
||||
|
||||
Anois, lig dúinn tú a thosú ag tacú le tionscadail eile. Tá liosta againn de thionscadail le faidhéideanna éasca a d'fhéadfá tosú orthu. Féach ar [liosta na dtionscadal san aip ghréasáin](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Ábhar Breise](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Tutóirialanna Ag Úsáid Uirlisí Eile
|
||||
|
||||
| <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) |
|
||||
|
||||
<p>Tugann tacaíocht don tionscadal seo::</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,123 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# პირველი კონტრიბუცია
|
||||
ახალი რამის პირველად, დამოუკიდებლად, გაკეთება შეიძლება საკმაოდ რთული აღმოჩნდეს. მითუმეტეს, თუ უცხოებთან თანამშრომლობ და შეცდომების დაშვება არცთუ ისე კარგი გრძნობაა. ჩვენ გვინდოდა დამწყები ოფენ სორს კონტრიბუტორებისთვის გაგვემარტივებინა საქმე და გვესწავლებინა თუ როგორ უნდა შეიტანონ წვლილი სხვა პროექტებში.
|
||||
|
||||
ეს პროექტი ეხმარება დამწყებ "დეველოპერებს" რათა გაუადვილდეთ პირველი კონტრიბუცია Github_ზე. თუ გინდა რომ პირველი შენი დაწერილი კოდი Github_ზე ათვირთო მაშინ მიყევი ქვემოთ მოცემულ ინსტრუქციას.
|
||||
|
||||
კი, სტატიების წაკითხვა და ვიდეოების ყურება კარგია, მაგრამ, პრაქტიკას არც ერთი შეედრება. ეს პროექტიც ზუსტად იმისთვისაა, რომ გაგიმარტივოს გზა პირველ კონტრიბუციამდე, რომელსაც ქვემოთ ჩამოთვლილი რამდენიმე ნაბიჯი გაშორებს.\
|
||||
|
||||
|
||||
#### *თუ ტერმინალთან დიდად არ მეგობრობ, [აქ ნახავ რამდენიმე პროგრამას, რომელიც ტერმინალის გამოყენებას აგარიდებს თავიდან]( #ტუტორიალები-სხვა-პროგრამების-გამოყენებით )*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
თუ კომპიუტერში გითი არ გაქვს ჩაწერილი, [მიჰყევი ლინკს]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## დაფორკე ეს რეპოზიტორია
|
||||
|
||||
რეპოზიტორიის დაფორკვისთვის, ამ გვერდის მარჯვენა ზედა კუთხეში დააჭირე "Fork" ღილაკს, რომელიც მის ასლს შეგიქმნის.
|
||||
|
||||
## რეპოზიტორიის დაკლონვა
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
ახლა, დაფორკილი რეპოზიტორია შენს კომპიუტერზე უნდა გადმოიტანო. ამისთვის შედი შენს გითჰაბის პროფილზე, გახსენი რეპოზიტორია და დააჭირე "Clone or download"-ს, შემდეგ კი *"copy to clipboard"*-ის სურათს.
|
||||
|
||||
ახლა გახსენი ტერმინალი და გაუშვი შემდეგი ბრძანება:
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
სადაც "url you just copied" (ბრჭყალების გარეშე) არის შენ მიერ დაკოპირებული რეპოზიტორიის ლინკი. (თუ ეს ლინკი არ გაქვს, წინა ნაბიჯი თავიდან გაიარე).
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
მაგალითად:
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
სადაც `this-is-you` ნაწილი, შენი გითჰაბის სახელია. ამითი რეპოზიტორიის ყველა ფაილი შენს კომპიუტერში გადმოვა.
|
||||
|
||||
## შექმენი ბრენჩი
|
||||
|
||||
შენი კომპიუტერით შედი რეპოზიტორიის ფოლდერში (თუ უკვე იქ არ ხარ):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
ახლა შექმენი ახალი ბრენჩი `git checkout` ბრძანების გამოყენებით:
|
||||
```
|
||||
git checkout -b <add-your-new-branch-name>
|
||||
```
|
||||
|
||||
მაგალითად:
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
(ბრენჩის სახელის დასაწყისში *add*-ის მიწერა სავალდებულო არაა, თუმცა მიზანშეწონილია, რადგანაც მისი მთავარი მიზანია თქვენი სახელი დაამატოს კონტრიბუტორთა სიაში.)
|
||||
|
||||
## საჭირო ფაილების შეცვლა და ატვირთვა
|
||||
|
||||
ახლა რომელიმე პროგრამით (სასურველია ტექსტ ედიტორით) გახსენი ფაილი, სახელად `Contributors.md` და დაამატე შენი სახელი. ოღონდ გაითვალისწინე, რომ ის სხვების სახელებს შორის უნდა ჩაწერო და არა ფაილის დასაწყისში, ან ბოლოში. შეინახე ცვლილებები.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
|
||||
თუ პროექტის ფოლდერში გადახვალ და გაუშვებ ბრძანება: `git status`. ტერმინალი გაჩვენებს რა ფაილებში მოხდა ცვლილებები.
|
||||
|
||||
|
||||
`git add`-ით დაამატე ცვლილებები შენ მიერ შექმნილ ახალ ბრენჩს:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
ახლა შეინახე ისინი `git commit`-ის გამოყენებით:
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
აქაც, `<your-name>` უნდა შეცვალო შენი პროფილის სახელით.
|
||||
|
||||
## ცვლილებების ატვირთვა გითჰაბზე
|
||||
|
||||
ატვირთე შენი ნამუშევარი `git push`-ის მეშვეობით:
|
||||
```
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
`<add-your-branch-name>` აქ შენ მიერ შექმნილი ბრენჩის სახელით უნდა ჩაანაცვლო.
|
||||
|
||||
## განხილვის მოთხოვნა
|
||||
|
||||
გითჰაბზე, შენს რეპოზიტორიაში როცა გადახვალ, დაინახავ `Compare & pull request` ღილაკს. დააჭირე.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
ახლა შენ მოითხოვ ცვლილებების განხილვას.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
და სულ მალე, შენი ნამუშევარი ამ პროექტის მთავარ ბრენჩზე გამოჩნდება. ამის შესახებ მეილსაც მიიღებ.
|
||||
|
||||
## აქედან საით?
|
||||
|
||||
გილოცავ! შენ შეასრულე სტანდარტული კონტრიბუციის პროცედურა, რომელსაც მომავალში ხშირად გამოიყენებ, როგორც კონტრიბუტორი!
|
||||
|
||||
აღნიშნე და გაუზიარე მეგობრებს შენი წარმატება [ამ ლინკზე გადასვლით](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
[შემოგვიერთდი slack-ზე](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
თუ კონტრიბუციების სხვაგან შეტანაც გინდა, ჩვენ შენთვის შედარებით მარტივად გასაგები პროექტები შევარჩიეთ, [რომლებსაც აქ ნახავ](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [დამატებითი მასალა](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## ტუტორიალები სხვა პროგრამების გამოყენებით
|
||||
|
||||
| <a href="../github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="../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="../gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/Readme/gk-icon.png" width="100"></a> | <a href="../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="../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="../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](../github-desktop-tutorial.md) | [Visual Studio 2017](../github-windows-vs2017-tutorial.md) | [GitKraken](../gitkraken-tutorial.md) | [Visual Studio Code](../github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../github-windows-intellij-tutorial.md) |
|
||||
@@ -1,142 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Ntoboa a Edi Kan
|
||||
|
||||
Bere a edi kan a wobɛyɛ biribi no yɛ nea ɛyɛ den bere nyinaa. Suro a wusuro sɛ wubedi mfomso no nyɛ nea ahotɔ wom koraa, titiriw bere a woreyɛ biako no. Nanso wiase a ɛwɔ open source no fa adwumayɛkuw ne adwuma a wɔbɛyɛ sɛ kuw ho. Enti, yɛpɛ sɛ yɛma ɔkwan a wɔfa so ma wɔn a wɔde mmoa foforo kɔ open source no yɛ mmerɛw denam sɛnea wobɛkyerɛkyerɛ wo sɛnea wode wo ntoboa a edi kan bɛma no so.
|
||||
|
||||
Nsɛm ne nkyerɛkyerɛ akenkan betumi aboa, nanso dɛn na eye sen sɛ wobɛbɔ mmɔden a wunsuro sɛ wubedi mfomso? Saa dwumadie yi botaeɛ ne sɛ ɛbɛma akwankyerɛ na ama sɛdeɛ wɔn a wɔrefi aseɛ no de wɔn ntoboa a ɛdi kan de ma no ayɛ mmerɛ. Kae:dodow a wo ho adwo wo no, dodow no ara na wusua ade yiye.Sɛ wopɛ sɛ wode wo ntoboa a edi kan ma a, di anammɔn a ɛwɔ ase ha no akyi kɛkɛ.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Sɛ wo nni Git wɔ wo kɔmputa so a, . [fa hyɛ wo kɔmputa so](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Fork Saa Adekorabea Yi
|
||||
|
||||
Fork saa adekorabea yi denam fork button a ɛwɔ kratafa no atifi a wobɛma so.
|
||||
Wei bɛma woanya akoraeɛ no bi wɔ wo akonta so.
|
||||
|
||||
## Clone Saa Adekorabea
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Afei clone saa akoraeɛ yi kɔ wo kɔmputa so. Klik clone button no so na afei klik *kɔpi kɔ clipboard so* icon no so.
|
||||
|
||||
Bue ahyɛdeɛ kwan (sɛ wowɔ Windows so) anaa terminal (sɛ wowɔ MacOS anaa Linux so) na yɛ git ahyɛdeɛ a ɛdidi soɔ yi:
|
||||
|
||||
```
|
||||
git clone "URL a woayɛ ho kɔpi nkyɛe no"
|
||||
```
|
||||
baabi a "URL a woayɛ ho kɔpi seesei ara" (a nsɛm a wɔafa aka no nka ho) yɛ akoraeɛ URL.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Nhwɛsoɔ:
|
||||
```
|
||||
git clone https://github.com/your-username/first-contributions.git
|
||||
```
|
||||
baabi a `wo-ɔdefoɔ din` yɛ wo GitHub dwumadie din. Ɛha na worekɔpi `ntoboa ahorow a edi kan` akoraeɛ no mu nsɛm afiri GitHub so akɔ wo kɔmputa so.
|
||||
|
||||
## Yɛ Baa Dwumadibea
|
||||
|
||||
Kɔ adwuma no ho kyerɛwtohɔ a wɔayɛ no foforo no so (sɛ woankɔ hɔ dedaw a):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Afei fa `git checkout` ahyɛdeɛ no yɛ baa dwumadibea:
|
||||
```
|
||||
git checkout -b <fa-wo-din ka ho>
|
||||
```
|
||||
|
||||
Nhwɛsoɔ:
|
||||
```
|
||||
git checkout -b add-quarjo-wusu
|
||||
```
|
||||
(Ɛnsɛ sɛ baa dwumadibea din no kura asɛmfua *add*, nanso ntease wom sɛ wode bɛka ho efisɛ baa dwumadibea yi atirimpɔw ne sɛ wode wo din bɛka list bi ho.)
|
||||
|
||||
## Yɛ Nsakrae a Ɛho Hia na Fa Hyɛ
|
||||
|
||||
Afei, bue `Contributors.md` fael no wɔ text editor mu, fa wo din ka ho, na sie fael no. Sɛ wobue ahyɛdeɛ no na wo tu `git status` ahyɛdeɛ no a, wobɛhunu sɛ nsakraeɛ bi wɔ hɔ. Fa nsakrae yi ka baa dwumadibea a woayɛ nkyɛe no ho denam `git add` ahyɛde no so:
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Afei fa `git commit` ahyɛdeɛ no yɛ nsakraeɛ yi:
|
||||
```
|
||||
git commit -m "Add <wo-din> kɔ Contributors list no so"
|
||||
```
|
||||
fa wo din si `<wo-din>` ananmu.
|
||||
|
||||
## Pia Nsakraeɛ kɔ GitHub
|
||||
|
||||
Fa `git push` ahyɛdeɛ no pia wo nsakraeɛ no:
|
||||
```
|
||||
git push origin <fa-wo-din ka ho>
|
||||
```
|
||||
fa baa dwumadibea a woadi kan abɔ no din si `<fa-wo-din ka ho>` ananmu.
|
||||
|
||||
## Fa Wo Nsakrae no Mena ma Wɔnhwɛ Mu
|
||||
|
||||
Sɛ wokɔ wo akoraeɛ wɔ GitHub so a, wobɛhunu `Fa toto ho.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Afei fa twetwe adesrɛ no kɔma.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Mebɛka mo nsakraeɛ nyinaa abom ayɛ adwuma yi baa dwumadibea titiriw no nnansa yi ara. Wo nsa bɛka amanneɛbɔ email bere a wɔawie nkabom no.
|
||||
|
||||
Wɔrensakra wo fork no nkorabata titiriw no wɔ saa bere yi mu. Sɛnea ɛbɛyɛ a wo fork no ne me de no bɛkɔ so ayɛ pɛ a, di anammɔn yi akyi.
|
||||
|
||||
## Ma Wo Fork no ne Saa Adekorabea Yi Nhyia
|
||||
|
||||
Nea edi kan no, dan kɔ baa dwumadibea titiriw no so:
|
||||
```
|
||||
git checkout main
|
||||
```
|
||||
|
||||
Na fa me akoraeɛ URL no ka ho sɛ `upstream akyirikyiri url`:
|
||||
```
|
||||
git remote add upstream https://github.com/Roshanjossey/first-contributions
|
||||
```
|
||||
Wei yɛ ɔkwan a yɛbɛfa so aka akyerɛ Git sɛ saa akoraeɛ yi nkyerɛaseɛ foforɔ wɔ hɔ wɔ address a wɔakyerɛ no so, na yɛfrɛ no `upstream`. Sɛ wɔka nsakraeɛ no bom wie a, hwehwɛ me akoraeɛ no foforɔ no:
|
||||
```
|
||||
git fetch upstream
|
||||
```
|
||||
|
||||
Ɛha na yɛrefa nsakraeɛ a ɛwɔ me baa dwumadibea a ɛwɔ soro no nyinaa aba.Afei ɛsɛ sɛ wode me akorae no mu nsakrae foforo no bom ne wo baa dwumadibea titiriw no:
|
||||
```
|
||||
git rebase upstream/main
|
||||
```
|
||||
Ɛha na yɛde nsakraeɛ a wode baa wo baa dwumadibea kɛseɛ no nyinaa redi dwuma.Sɛ wopia baa dwumadibea kɛse no mprempren a, wo kyɛnsee no nso benya nsakrae ahorow no:
|
||||
|
||||
```
|
||||
git push origin main
|
||||
```
|
||||
Kɔkɔbɔ: Saa bere yi de, worepia akɔ akyirikyiri adekorabea a wɔfrɛ no origin no so.
|
||||
|
||||
Saa bere yi, mede wo `<fa-wo-din ka ho>` baa dwumadibea no kaa me baa dwumadibea kɛse no ho, na wo nso wode me baa dwumadibea kɛse no kaa wo baa dwumadibea titiriw no ho. Wo `<fa-wo-din ka ho>` baa dwumadibea no ho nhia bio, enti wubetumi apopa:
|
||||
```
|
||||
git branch -d <add-your-name>
|
||||
```
|
||||
na wubetumi nso apopa ne akyirikyiri nkyerɛase no:
|
||||
```
|
||||
git push origin --delete <add-your-name>
|
||||
```
|
||||
Eyi ho nhia, nanso baa dwumadibea no din kyerɛ sɛ n’atirimpɔw yɛ pɔtee koraa. Ne nkwa nna betumi ayɛ tiaa.
|
||||
|
||||
## Nkyerɛkyerɛ a Wɔde Nnwinnade Afoforo Di Dwuma
|
||||
|
||||
| <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/2/2d/Visual_Studio_Code_1.18_icon.svg" 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) |
|
||||
|
||||
## Nea Ɛdi Akyi?
|
||||
|
||||
You can also join our team on Slack in case you need help or have any questions. [Join the team on Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
@@ -1,112 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Primeiras Contribucións
|
||||
|
||||
É difícil. Sempre é difícil a primeira vez que fas algo. Especialmente cando estás colaborando, equivocarse non é algo agradable. Pero no *open source* (o código aberto) todo trata de colaboración e de traballar xuntos. Quixemos simplificar a forma na que novos contribuidores *open-source* aprenden e contribúen por primeira vez.
|
||||
|
||||
Ler artículos e ver titoriais pode axudar, pero ¿que haberá mellor que facer as cousas nunha contorna pensada para practicar? Iste proxecto enfócase en prover unha guía e en simplificar o xeito no que os novatos fan a súa primeira contribución. Lembra que mentres máis relaxado esteas, mellor aprenderás. Se queres facer a túa primeira contribución só tés que seguir os sinxelos pasos que se amosan a continuación. E prometémosche que será entretido.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork de éste repositorio" />
|
||||
|
||||
Se aínda non tés git na túa máquina, [ instálao ]( https://help.github.com/articles/set-up-git/ )
|
||||
|
||||
## Bifurca(*Fork*) este repositorio
|
||||
|
||||
Fai un *fork* (bifurcación) deste repo facendo click no botón "Fork" que está na cima desta páxina.
|
||||
Isto creará unha copia deste repositorio na túa conta.
|
||||
|
||||
## Clona(*Clone*) o repositorio
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonar este repositorio" />
|
||||
|
||||
A continuación clona este repo no teu equipo. Fai click no botón "*Clone*" e despois na icona para copiar ó portapapeis (clipboard)
|
||||
|
||||
Abre a túa consola ou terminal e executa o seguinte comando de git:
|
||||
|
||||
```
|
||||
git clone "url que copiache"
|
||||
```
|
||||
Onde "url que copiache" (sen as comiñas) é a url deste repositorio. Mira os pasos previos para obter a url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copiar URL a clipboard" />
|
||||
|
||||
Por exemplo:
|
||||
```
|
||||
git clone https://github.com/o-teu-nome/first-contributions.git
|
||||
```
|
||||
Onde "o-teu-nome" é o teu usuario de GitHub. Aquí estarás copiando os contidos do repositorio first-contributions en GitHub para o teu computador.
|
||||
|
||||
## Crear unha póla(*Branch*)
|
||||
|
||||
Cambia ó directorio do repositorio no teu computador (se é que non estás xa nel).
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Agora crea unha branch (póla) usando o comando `git checkout`
|
||||
|
||||
```
|
||||
git checkout -b <engade-o-teu-nome>
|
||||
```
|
||||
|
||||
Por exemplo
|
||||
```
|
||||
git checkout -b engade-María-Soliña
|
||||
```
|
||||
|
||||
(O nome da branch non ten que incluir necesariamente a palabra 'engade', pero resulta razoable se consideramos que o propósito desta póla é engadir o teu nome a unha lista).
|
||||
|
||||
## Fai os cambios necesarios e efectúa(*Commit*) deses cambios
|
||||
|
||||
Agora abre o arquivo `Contributors.md` nun editor de texto, engade o teu nome e despois garda o arquivo. Se vas ó directorio do proxecto e executas `git status`, verás que hai modificacións.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Agrega eses cambios ou modificacións usando o comando `git add` tal como se amosa:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Agora podes facer commit sobre os cambios co comando `git commit`
|
||||
```
|
||||
git commit -m "Add <o-teu-nome> to Contributors list"
|
||||
```
|
||||
cambiando `<o-teu-nome>` polo teu nome.
|
||||
|
||||
## Envía (*Push*) os teus cambios a GitHub
|
||||
|
||||
Fai un *push* dos teus cambios usando o comando `git push`
|
||||
```
|
||||
git push origin <engade-o-teu-nome>
|
||||
```
|
||||
cambiando `<engade-o-teu-nome>` polo nome da branch que creaches antes.
|
||||
|
||||
## Envía os teus cambios para seren revisados
|
||||
|
||||
Se vas ó teu repositorio en GitHub, verás un botón `Compare & pull request`. Fai click nese botón:
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="crea unha pull request" />
|
||||
|
||||
Agora crea e envía a pull request:
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="sube a pull request" />
|
||||
|
||||
Axiña mesturarei os teus cambios (facendo *merge*) na master branch deste proxecto. Recibirás unha notificación por correo cando os cambios xa estean mesturados.
|
||||
|
||||
### [ Material adicional ](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Titoriais con outras ferramentas
|
||||
|
||||
|
||||
| <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) |
|
||||
|
||||
## Onde ir dende aquí?
|
||||
|
||||
Tamén poderías unirte á nosa *equipa* en Slack no caso de que necesites axuda ou teñas algunha pregunta. [Únete ó noso Slack](https://firstcontributors.slack.com/join/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY)
|
||||
@@ -1,139 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Πρώτες Συνεισφορές
|
||||
|
||||
Αυτό το έργο έχει σκοπό να απλοποιήσει και να καθοδηγήσει τον τρόπο με τον οποίο οι αρχάριοι κάνουν την πρώτη τους συνεισφορά. Αν σκοπεύετε να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε τα παρακάτω βήματα.
|
||||
|
||||
Αν δεν είστε εξοικειωμένοι με τη γραμμή εντολών, [εδώ υπάρχουν σεμινάρια που χρησιμοποιούν γραφικά εργαλεία](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Εάν δεν έχετε εγκατεστημένο το git στον υπολογιστή σας, [εγκαταστήστε το](https://help.github.com/articles/set-up-git/)
|
||||
|
||||
## Αντιγράψτε το αποθετήριο (fork)
|
||||
|
||||
Αντιγράψτε το αποθετήριο πατώντας το κουμπί με τίτλο `Fork` στην κορυφή αυτής της σελίδας. Με αυτό τον τρόπο ένα ακριβές αντίγραφο του αποθετηρίου θα δημιουργηθεί στο λογαριασμό σας.
|
||||
|
||||
## Αποθηκεύστε τοπικά το αποθετήριο (clone)
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Τώρα αντιγράψτε το αποθετήριο στον υπολογιστή σας. Κάντε κλικ στο κουμπί `Clone or download` και μετά στο εικονίδιο δεξιά από το σύνδεσμο για αντιγραφή στο πρόχειρο.
|
||||
|
||||
Ανοίξτε ένα παράθυρο τερματικού και τρέξτε την ακόλουθη git εντολή:
|
||||
|
||||
```
|
||||
git clone "σύνδεσμος που μόλις αντιγράψατε"
|
||||
```
|
||||
|
||||
Όπου "σύνδεσμος αποθετηρίου" (χωρίς τα εισαγωγικά) είναι ο σύνδεσμος για αυτό το αποθετήριο. Ανατρέξτε στα προηγούμενα βήματα για να βρείτε αυτόν τον σύνδεσμο.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Για παράδειγμα:
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
Όπου 'this-is-you' είναι το όνομα χρήστη που έχετε στο github. Από εδώ αντιγράφετε τα περιεχόμενα του αποθετηρίου `first-contributions` απο το github στον υπολογιστή σας.
|
||||
|
||||
## Δημιουργήστε ένα νέο παρακλάδι (branch)
|
||||
|
||||
Πηγαίνετε στο φάκελο του αποθετηρίου στον υπολογιστή σας εάν δεν είστε ήδη εκεί.
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Τώρα δημιουργήστε ένα νέο παρακλάδι χρησιμοποιώντας την εντολή `git switch` :
|
||||
|
||||
```
|
||||
git switch -c your-new-branch-name
|
||||
```
|
||||
|
||||
Για παράδειγμα:
|
||||
|
||||
```
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
(Το όνομα του παρακλαδιού δεν χρειάζεται να περιέχει την λέξη _add_ αλλά είναι λογικό να την συμπεριλάβουμε μιας και ο σκοπός του παρακλαδιού είναι να προσθέσουμε το όνομα μας σε μια λίστα.)
|
||||
|
||||
## Πραγματοποιήστε τις αλλαγές και αποθηκεύστε τες (add & commit)
|
||||
|
||||
Τώρα ανοίξτε το αρχείο `Contributors.md` με έναν επεξεργαστή κειμένου. Χρειάζεται να είστε εξοικειωμένοι με την Markdown, μια ελαφριά γλώσσα σήμανσης. Δείτε στο [cheat sheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) για το πως να χρησιμοποιήσετε την Markdown.
|
||||
|
||||
Σε αυτήν την περίπτωση προσθέστε την παρακάτω σειρά στο τέλος του αρχείου `Contributors.md:`
|
||||
|
||||
```
|
||||
- [Το-όνομα-σας](https://github.com/Your-username)
|
||||
```
|
||||
|
||||
Για παράδειγμα:
|
||||
|
||||
```
|
||||
- [John Doe](https://github.com/johndoe)
|
||||
```
|
||||
|
||||
Σιγουρευτείτε ότι δεν υπάρχει κενό ανάμεσα στα `](` . Αποθηκεύστε το αρχείο και κλείστε το.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Εάν πάτε στο φάκελο του αποθετηρίου και γράψετε την εντολή `git status`, θα δείτε ότι υπάρχουν κάποιες αλλαγές. Προσθέστε αυτές τις αλλαγές χρησιμοποιώντας την εντολή `git add`.
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Τώρα σώστε αυτές τις αλλαγές χρησιμοποιώντας την παρακάτω `git commit` εντολή.
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
όπου `<your-name>` αντικαταστήστε με το όνομα σας
|
||||
|
||||
## Αποθηκεύστε τις αλλαγές σας στο github (push)
|
||||
|
||||
Αποθηκεύστε τις αλλαγές σας χρησιμοποιώντας την εντολή `git push`
|
||||
|
||||
```
|
||||
git push origin <add-your-name>
|
||||
```
|
||||
|
||||
όπου `<add-your-name>` αντικαταστήστε με το όνομα του παρακλαδιού(branch) που δημιουργήσατε προηγουμένως
|
||||
|
||||
## Υποβάλετε τις αλλαγές σας για έλεγχο
|
||||
|
||||
Εάν πάτε στο αποθετήριο (repository) στο github θα δείτε ένα κουμπί με τίτλο `Compare & pull request`. Κάντε κλικ σε αυτό το κουμπί.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Τώρα υποβάλετε το pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Σύντομα θα ενσωματώσω όλες τις αλλαγές σας στο master branch του προγράμματος. Θα ειδοποιηθείτε με email όταν οι αλλαγές που κάνατε ενσωματωθούν.
|
||||
|
||||
## Τι να κάνετε τώρα;
|
||||
|
||||
Συγχαρητήρια! Μόλις ολοκληρώσατε την τυπική ροή εργασιών _fork -> clone -> edit -> pull request_ που θα συναντήσετε συχνά ως συνεργάτης!
|
||||
|
||||
Γιορτάστε και μοιραστείτε την συνεισφορά σας με τους φίλους και τους ακόλουθους σας πηγαίνοντας στο [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Μπορείτε να συμμετέχετε στην ομάδα μας στο slack σε περίπτωση που θέλετε κάποια βοήθεια ή έχετε κάποια ερώτηση.
|
||||
[Η ομάδα μας στο slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Τώρα μπορείτε να ξεκινήσετε να συνεισφέρετε και σε άλλα project. Έχουμε φτιάξει μια λίστα από project με εύκολα προβλήματα για να ξεκινήσετε. Δείτε εδώ [τη λίστα με τα project](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Επιπρόσθετο υλικό](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Εκπαιδευτικό Υλικό Χρήσης Άλλων Εργαλείων
|
||||
|
||||
| <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) |
|
||||
@@ -1,124 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# પ્રથમ યોગદાન
|
||||
|
||||
પ્રથમ વખત કંઈક કરવું થોડું મુશ્કેલ છે. ખાસ કરીને જ્યારે તમે જુથ સાથે મળીને કામ કરી રહ્યા હોવ, ત્યારે ભૂલો કરવી એ સારી વાત નથી. પરંતુ એકબીજા સાથે મળીને અને એક જ સાથે કામ કરવું એ જ તો ઓપેન સોર્સ છે. અમે તમારું પ્રથમ ઓપન સોર્સ કોન્ટ્રિબ્યુશન / યોગદાન સરળ બનાવાનો પ્રયત્ન કરીશુ.
|
||||
|
||||
ઓનલાઇન આર્ટિકલ્સ વાંચન અને ઓનલાઇન ટ્યુટોરિયલ્સ મદદ કરી શકે છે, પરંતુ પોતે જ તે કામ કરવાથી સારું શું હોઇ શકે? આ પ્રોજેક્ટ તમને તમારી પ્રથમ કોન્ટ્રિબ્યુશન માટે દિશા નિર્દેશ આપશે. જો તમે તમારું પ્રથમ કોન્ટ્રીબ્યુશન કરવા માંગો છો તો આગળ આપેલા પગલાઓ અનુસરો.
|
||||
|
||||
જો તમે કમાન્ડ લાઇન સાથે આરામદાયક ન હોવ, તો અહીં [ GUI ટૂલ્સનો ઉપયોગ કરવાના ટ્યુટોરિયલ્સ ](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) આપેલ છે.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
જો તમારા કમ્પ્યુટર પર Git ઇન્સ્ટોલ નથી, [ તો Git ઈન્સ્ટોલ કરો](https://help.github.com/articles/set-up-git/)
|
||||
|
||||
## રિપોઝીટરીને ફોર્ક કરો
|
||||
|
||||
ફોર્ક(કાંટા) બટન પર ક્લિક કરવાથી આ રિપોઝીટરી ફોર્ક થાય છે, આ તમારા GitHub એકાઉન્ટમાં આ રિપોઝીટરીની એક નકલ (કોપી) બનાવશે.
|
||||
|
||||
## રિપોઝીટરી ક્લોન કરો
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
હવે તમે આ રેપો તમારા કમ્પ્યુટરમાં ક્લોન કરો (અર્થાત ડાઉનલોડ કરો). તમારા GitHub એકાઉન્ટ પર જાવ, કોડ બટન પર ક્લિક કરો અને પછી `copy to clipboard` આઇકોન પર ક્લિક કરો. આનાથી એ રેપોજીટરીનો યુઆરએલ કોપી થશે.
|
||||
|
||||
તમારા કમ્પ્યુટર પર એક ટર્મિનલ / કમાંડ પ્રોમ્પ્ટ ખોલો અને નીચે દર્શાવ્યા મુજબ git આદેશ ચલાવો:
|
||||
|
||||
```
|
||||
git clone "યુઆરએલ જે તમે હમણાં જ નકલ(ક્લોન) કરી"
|
||||
```
|
||||
|
||||
જ્યાં "યુઆરએલ જે તમે હમણાં જ કોપી કર્યું છે" (અવતરણ ચિહ્નો સિવાય) એ આ રિપોઝીટરી(આ પ્રોજેક્ટનો તમારો ફૉર્ક) ની URL ના સંગ્રહ માટે છે. તેની URL ને મેળવવા માટે પાછલા પગલાં જુઓ. તેમને કોપી કરેલ યુઆરએલ સાથે બદલી કાઢો.
|
||||
|
||||
ઉદાહરણ તરીકે:
|
||||
|
||||
```
|
||||
git clone https://github.com/આ-તમે-છો/first-contributions.git
|
||||
```
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
'આ-તમે-છો' તમારા GitHub એકાઉન્ટનું `username` છે. અહીં તમે તમારા કમ્પ્યુટરમાં GitHub થી first-contributions રિપોને કોપી કરી રહ્યા છો અથવા તેના એક સ્થાનિક / લોકલ કોપી બનાવી રહ્યા છે.
|
||||
|
||||
## એક બ્રાંચ બનાવો
|
||||
|
||||
તમારા કમ્પ્યુટર પર બનાવેલ રિપોઝીટરીની કોપીનાં ફોલ્ડર / ડિરેક્ટરીમાં જાવ (જો હજુ સુધી તમે ત્યાં ન હોવ તો નીચે આપેલ Command(આદેશ) ચલાવો)
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
હવે 'git checkout' command(આદેશ) નો ઉપયોગ કરીને એક નવી શાખા(Branch) બનાવો. નવી શાખા(Branch) બનાવવા માટે -b વિકલ્પનો ઉપયોગ થાય છે.
|
||||
|
||||
```
|
||||
git checkout -b <તમારી-શાખા-નામ-ઉમેરો>
|
||||
```
|
||||
|
||||
ઉદાહરણ તરીકે:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
(શાખા(Branch)ના નામમાં 'add' ઉમેરવાની જરૂર નથી, પરંતુ તેમાં શામેલ કરવું યોગ્ય છે કારણ કે શાખા(Branch)નો હેતુ એક નામ છે, જે નામ ઉમેરવાનું છે.)
|
||||
|
||||
## આવશ્યક ફેરફારો કરો અને તે ફેરફારોને કમીટ કરો-
|
||||
|
||||
હવે 'Contributors.md` ફાઇલને એક ટેક્સ્ટ એડિટરમાં ખોલો અને તેમા તમારુ નામ લખો. ફાઇલની શરૂઆત અથવા અંતે ઉમેરવાને બદલે, તેને મધ્યમાં ગમે ત્યાં રાખો. હવે, ફાઇલને સેવ કરો.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
જો તમે પ્રોજેક્ટની ડાઈરેક્ટરીમા જશો અને કમાન્ડ પ્રોમ્પ્ટમાં `git status` નિર્દેશ ચલાવશો, તો તમે કરેલા પરિવર્તન જોઈ શક્શો. તે પરિવર્તન બનાવવામાં આવેલ શાખા(Branch)માં ઉમેરવા માટે 'git add` કમાન્ડ વાપરો.
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
હવે તમારા પોતાના ફેરફારોને 'git commit' આદેશનો ઉપયોગ કરી કમીટ કરો.
|
||||
|
||||
```
|
||||
git commit -m "Add <તમારુ-નામ> to Contributors list"
|
||||
```
|
||||
|
||||
<તમારુ નામ> ની જગ્યાએ તમારું નામ દાખલ કરો
|
||||
|
||||
##
|
||||
|
||||
તમારા ફેરફારો ને Github માં પુશ કરો (ધકેલો).
|
||||
|
||||
`git push` ઉપયોગ કરીને તમારા પરિવર્તન ને પુશ કરો
|
||||
|
||||
```
|
||||
git push origin <તમારી-શાખા-નામ-ઉમેરો>
|
||||
```
|
||||
|
||||
`<તમારી-શાખા-નામ-ઉમેરો>` ની જગ્યાએ તમારી શાખા(Branch)નુ નામ ઉમેરો.
|
||||
|
||||
## તમારા ફેરફારોના રીવ્યુ માટે સબમિટ કરો
|
||||
|
||||
જો તમે તમારા github એકાઉન્ટ પર તમારી રિપો માં જાવ તો Compare & pull request નો ઓપ્શન હશે. તેને દબાવો.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
હવે તમારી pull request સબમિટ કરો.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
ટૂંક સમયમાં હું તમારા ફેરફારો માટે આ પ્રોજેક્ટની માસ્ટર શાખામાં મર્જ ક્રી દઇશ. તમને એક મેલ આવશે જ્યારે તમારા ફેરફારો મર્જ થશે.
|
||||
|
||||
## હવે, અહીંથી ક્યાં જવું ?
|
||||
|
||||
અભિનંદન!:tada: તમે હમણાં જ સ્ટાન્ડર્ડ `fork -> clone -> edit -> pull request` વર્કફ્લો પૂર્ણ કર્યો છે. જેનો તમે વારંવાર સહયોગકર્તા (contributor) તરીકે સામનો કરશો!
|
||||
|
||||
તમારા પ્રથમ યોગદાનની ઉજવણી કરો અને [વેબ એપ્લિકેશન](https://firstcontributions.github.io/#social-share) પર જઈને તમારા મિત્રો અને ફોલોઅર્સ સાથે શેર કરો.
|
||||
|
||||
જો તમને વધુ પ્રેક્ટિસ જોઈતી હોય, તો [કોડ યોગદાન ચેકઆઉટ](https://github.com/roshanjossey/code-contributions) કરો.
|
||||
|
||||
ચાલો, હવે તમને અન્ય પ્રોજેક્ટ્સમાં કંટ્ર્રીબ્યુટ કરવામા મદદ કરુ. અમે તમારા માટે એક યાદી બનાવી છે જેમા ખૂબ સરળ issues(મુદ્દાઓ) છે વેબ એપમા પ્રોજેક્ટ્સ ની સૂચિ જુઓ.](https://firstcontributions.github.io/#project-list)
|
||||
|
||||
## અન્ય સાધનોનો ઉપયોગ કરીને ટ્યુટોરીયલ્સ
|
||||
|
||||
| <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) |
|
||||
@@ -1,133 +0,0 @@
|
||||
[](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/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Kyauta ta Farko
|
||||
|
||||
Yana da wahala. Yana da wahala lokacin da kuka fara yin wani abu. Musamman lokacin da kuke mu'amala, yin kuskure ba abu ne mai kyau ba. Muna son ƙirƙirar buɗaɗɗen hanya don sababbin mutane don koyo kuma su shiga a karon farko.
|
||||
|
||||
Karatun labarai da koyawa kan layi na iya taimaka muku, amma menene ya fi yin ainihin abin? Manufar wannan aikin shine don ba da jagora & ba da damar mutane su fara ba da gudummawa. Idan kuna neman ba da gudummawarku ta farko, bi matakan da ke ƙasa.
|
||||
|
||||
#### *Idan ba kwa son alamomin doka, [Anan akwai koyawa ta amfani da kayan aikin GUI.](#Koyo-don-amfani-wasu)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Idan ba ku da inji a kan injin ku, [shigar da shi]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
|
||||
## Cire wannan babban fayil ɗin
|
||||
|
||||
Cire wannan repo ta danna maɓallin thumbnail a saman wannan shafin. Wannan zai haifar da ajiyar tsaro guda ɗaya a cikin asusunku.
|
||||
|
||||
## Yana rufe wurin ajiya
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Yanzu maye gurbin repo akan injin ku. Je zuwa asusun GitHub ɗin ku, buɗe repo don dannawa, danna maɓallin clone sannan danna gunkin alamar.
|
||||
|
||||
Bude tasha kuma gudanar da umarni mai zuwa:
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
inda "url ɗin da kuka kwafi" (ba tare da alamar magana ba) shine url don ajiya anan (ƙarshen wannan aikin). Duba matakan da suka gabata don samun url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Misali:
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
inda `this-is-you` shine sunan mai amfani na GitHub. Anan, kuna kwafin abun ciki na ainihin gudummawar GitHub akan kwamfutarka.
|
||||
|
||||
## Ƙirƙiri reshe
|
||||
|
||||
Canja zuwa tsarin shugabanci akan kwamfutarka (idan ba ku da shi a can):
|
||||
|
||||
```
|
||||
cd na farko-gudunmawar
|
||||
```
|
||||
|
||||
Yanzu, ƙirƙiri reshe ta amfani da umarnin 'git checkout':
|
||||
|
||||
```
|
||||
git checkout -b <ƙara-sabon-reshe-name>
|
||||
```
|
||||
|
||||
Misali:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
(Sunan reshen ba lallai ba ne a saka kalmar a cikinsa, amma yana da mahimmanci ku haɗa shi saboda manufar wannan reshen shine ƙara sunan ku a cikin jerin sunayen).
|
||||
|
||||
## Yi canje-canjen da suka dace kuma ku canza waɗannan canje-canje
|
||||
|
||||
|
||||
Yanzu buɗe fayil ɗin `Contributors.md` a editan rubutu, ƙara sunan ku gare shi. Ana haɗe shi zuwa farkon ko ƙarshen fayil ɗin. Saka shi wani wuri a tsakanin. Yanzu ajiye fayil ɗin.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Idan ka je kundin kundin kamfani kuma ka aiwatar da umurnin 'git status', za ka ga cewa akwai canje-canje.
|
||||
|
||||
|
||||
Ƙara waɗannan canje-canje zuwa reshen da kuka ƙirƙira ta amfani da umarnin 'git add':
|
||||
|
||||
```
|
||||
git ƙara Masu ba da gudummawa.md
|
||||
```
|
||||
|
||||
Yanzu aiwatar da canje-canje ta amfani da umarnin 'git Committee':
|
||||
|
||||
```
|
||||
git commit -m "Ƙara <sunan ku> zuwa lissafin Masu ba da gudummawa"
|
||||
```
|
||||
Sauya `<sunan ku>' da sunan ku.
|
||||
|
||||
## Tura duk waɗannan canje-canje zuwa GitHub
|
||||
|
||||
|
||||
Yi canje-canjen ku ta amfani da umarnin 'git push':
|
||||
|
||||
```
|
||||
git tura asalin <ƙara-sunan-reshen ku>
|
||||
```
|
||||
|
||||
Sauya `<add-your-reshen-name>` da sunan reshe da kuka ƙirƙira a baya.
|
||||
|
||||
## Ƙaddamar da canje-canjenku don dubawa
|
||||
|
||||
|
||||
Idan kun je wurin ajiyar ku akan GitHub, zaku ga maɓallin 'Compare & ja buƙatar'. Danna maɓallin.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Yanzu, yi buƙatar.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Nan ba da jimawa ba zan magance duk canje-canjenku a wannan reshe. Za ku karɓi saƙon sanarwa a duk lokacin da aka yi canji.
|
||||
|
||||
## Ina zan je daga nan?
|
||||
|
||||
Taya murna! Ka kawai karanta uwar garken -> kwafin fitarwa -> gyara -> Zazzage sabis na PR wanda koyaushe za ku hadu a matsayin mai ba da ku!
|
||||
|
||||
Duba gudunmawar ku kuma ku raba ta tare da abokanku da mabiyanku ta ziyartar [app app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Kuna iya shiga cikin ma'aikatan mu na abokantaka idan kuna buƙatar kowane taimako ko kuna da tambayoyi. [Haɗa ƙungiyar slack](https://join.slack.com/t/firstcontr🏴ibutors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWYZm
|
||||
|
||||
Yanzu, bari mu fara da ba da gudummawa don wasu ayyuka. Mun tattara jerin ayyuka masu sauƙi da tattaunawa da za ku iya farawa. Duba [jerin ayyuka da aikace-aikacen yanar gizo](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
|
||||
### [Ƙarin Material](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Ilimi da amfani da sauran kayan
|
||||
|
||||
| <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) |
|
||||
@@ -1,276 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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-2vqegkew0-ZuzGM1LO33C6Ts4nZyat1Q)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
#### _קרא [בשפות אחרות](Translations.md)._
|
||||
|
||||
<kbd>[<img title="Shqip" alt="Shqip" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/al.svg" width="22">](README.al.md)</kbd>
|
||||
<kbd>[<img title="Armenian" alt="Armenian" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/am.svg" width="22">](README.arm.md)</kbd>
|
||||
<kbd>[<img title="Uzbek" alt="Uzbek language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/uz.svg" width="22">](README.uz.md)</kbd>
|
||||
<kbd>[<img title="Azərbaycan dili" alt="Azərbaycan dili" src="https://cdn.statically.io/flags/az.svg" width="22">](README.aze.md)</kbd>
|
||||
<kbd>[<img title="বাংলা" alt="বাংলা" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/bd.svg" width="22">](README.bn.md)</kbd>
|
||||
<kbd>[<img title="Bulgarian" alt="Bulgarian" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/bg.svg" width="22">](README.bg.md)</kbd>
|
||||
<kbd>[<img title="Português (Brasil)" alt="Português (Brasil)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/br.svg" width="22">](README.pt_br.md)</kbd>
|
||||
<kbd>[<img title="Català" alt="Català" src="https://firstcontributions.github.io/assets/Readme/catalan1.png" width="22">](README.ca.md)</kbd>
|
||||
<kbd>[<img title="中文 (Simplified)" alt="中文 (Simplified)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/cn.svg" width="22">](README.zh-cn.md)</kbd>
|
||||
<kbd>[<img title="Czech" alt="Czech" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/cz.svg" width="22">](README.cs.md)</kbd>
|
||||
<kbd>[<img title="Deutsch" alt="Deutsch" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/de.svg" width="22">](README.de.md)</kbd>
|
||||
<kbd>[<img title="Dansk" alt="Dansk" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/dk.svg" width="22">](README.da.md)</kbd>
|
||||
<kbd>[<img title="العربية" alt="العربية" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/eg.svg" width="22">](README.eg.md)</kbd>
|
||||
<kbd>[<img title="Dezéiriya" alt="Dezéiriya" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/dz.svg" width="22">](README.dz.md)</kbd>
|
||||
<kbd>[<img title="Española" alt="Española" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/es.svg" width="22">](README.es.md)</kbd>
|
||||
<kbd>[<img title="Française" alt="Française" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/fr.svg" width="22">](README.fr.md)</kbd>
|
||||
<kbd>[<img title="Gaeilge" alt="Gaeilge" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ie.svg" width="22">](README.ga.md)</kbd>
|
||||
<kbd>[<img title="Galego" alt="Galego" src="https://upload.wikimedia.org/wikipedia/commons/thumb/6/64/Flag_of_Galicia.svg/1200px-Flag_of_Galicia.svg.png" width="22">](README.gl.md)</kbd>
|
||||
<kbd>[<img title="Ελληνικά" alt="Ελληνικά" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/gr.svg" width="22">](README.gr.md)</kbd>
|
||||
<kbd>[<img title="ქართული" alt="ქართული" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ge.svg" width="22">](README.ge.md)</kbd>
|
||||
<kbd>[<img title="Magyar" alt="Magyar" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/hu.svg" width="22">](README.hu.md)</kbd>
|
||||
<kbd>[<img title="Bahasa Indonesia" alt="Bahasa Indonesia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/id.svg" width="22">](README.id.md)</kbd>
|
||||
<kbd>[<img title="हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்" alt="हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/in.svg" width="22">](Translations.md)</kbd>
|
||||
<kbd>[<img title="தமிழ்" alt="தமிழ்" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lk.svg" width="22">](README.ta.md)</kbd>
|
||||
<kbd>[<img title="فارسی" alt="فارسی" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ir.svg" width="22">](README.fa.md)</kbd>
|
||||
<kbd>[<img title="پښتو" alt="پښتو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/af.svg" width="22">](README.pus.md)</kbd>
|
||||
<kbd>[<img title="Italiano" alt="Italiano" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/it.svg" width="22">](README.it.md)</kbd>
|
||||
<kbd>[<img title="日本語" alt="日本語" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/jp.svg" width="22">](README.ja.md)</kbd>
|
||||
<kbd>[<img title="සිංහල" alt="සිංහල" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lk.svg" width="22">](README.si.md)</kbd>
|
||||
<kbd>[<img title="Kiswahili (Kenya)" alt="Kiswahili (Kenya)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ke.svg" width="22">](README.kws.md)</kbd>
|
||||
<kbd>[<img title="한국어" alt="한국어" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kr.svg" width="22">](README.ko.md)</kbd>
|
||||
<kbd>[<img title="Lietuvių kalba" alt="Lietuvių kalba" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lt.svg" width="22">](README.lt.md)</kbd>
|
||||
<kbd>[<img title="Limba Română" alt="Limba Română" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/md.svg" width="22"> <img title="Limba Română" alt="Limba Română" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ro.svg" width="22">](README.ro.md)</kbd>
|
||||
<kbd>[<img title="မြန်မာ" alt="မြန်မာ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mm.svg" width="22">](README.mm_unicode.md)</kbd>
|
||||
<kbd>[<img title="Македонски" alt="Македонски" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mk.svg" width="22">](README.mk.md)</kbd>
|
||||
<kbd>[<img title="Español de México" alt="Español de México" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mx.svg" width="22">](README.mx.md)</kbd>
|
||||
<kbd>[<img title="Bahasa Melayu / بهاس ملايو / Malay" alt="Bahasa Melayu / بهاس ملايو / Malay" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/my.svg" width="22">](README.my.md)</kbd>
|
||||
<kbd>[<img title="Dutch" alt="Dutch" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/nl.svg" width="22">](README.nl.md)</kbd>
|
||||
<kbd>[<img title="Norsk" alt="Norsk" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/no.svg" width="22">](README.no.md)</kbd>
|
||||
<kbd>[<img title="नेपाली" alt="नेपाली" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/np.svg" width="15">](README.np.md)</kbd>
|
||||
<kbd>[<img title="Wikang Filipino" alt="Wikang Filipino" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ph.svg" width="22">](README.fil.md)</kbd>
|
||||
<kbd>[<img title="English (Pirate)" alt="English (Pirate)" src="https://firstcontributions.github.io/assets/Readme/pirate.png" width="22">](README.en-pirate.md)</kbd>
|
||||
<kbd>[<img title="اُاردو" alt="اردو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pk.svg" width="22">](README.ur.md)</kbd>
|
||||
<kbd>[<img title="Twi (Ghana)" alt="Twi (Ghana)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/gh.svg" width="22">](README.gh.md)</kbd>
|
||||
<kbd>[<img title="Polski" alt="Polski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pl.svg" width="22">](README.pl.md)</kbd>
|
||||
<kbd>[<img title="Português (Portugal)" alt="Português (Portugal)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pt.svg" width="22">](README.pt-pt.md)</kbd>
|
||||
<kbd>[<img title="Русский язык" alt="Русский язык" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ru.svg" width="22">](README.ru.md)</kbd>
|
||||
<kbd>[<img title="عربى" alt="عربى" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/sa.svg" width="22">](README.ar.md)</kbd>
|
||||
<kbd>[<img title="Svenska" alt="Svenska" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/se.svg" width="22">](README.se.md)</kbd>
|
||||
<kbd>[<img title="Slovenčina" alt="Slovenčina" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/sk.svg" width="22">](README.slk.md)</kbd>
|
||||
<kbd>[<img title="Slovenščina" alt="Slovenščina" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/si.svg" width="22">](README.sl.md)</kbd>
|
||||
<kbd>[<img title="ภาษาไทย" alt="ภาษาไทย" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/th.svg" width="22">](README.th.md)</kbd>
|
||||
<kbd>[<img title="Türkçe" alt="Türkçe" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tr.svg" width="22">](README.tr.md)</kbd>
|
||||
<kbd>[<img title="中文(Traditional)" alt="中文(Traditional)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tw.svg" width="22">](README.zh-tw.md)</kbd>
|
||||
<kbd>[<img title="Українська" alt="Українська" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ua.svg" width="22">](README.ua.md)</kbd>
|
||||
<kbd>[<img title="Tiếng Việt" alt="Tiếng Việt" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/vn.svg" width="22">](README.vn.md)</kbd>
|
||||
<kbd>[<img title="Tanzania" alt="Swahili language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tz.svg" width="22">](README.sw.md)</kbd>
|
||||
<kbd>[<img title="Zulu (South Africa)" alt="Zulu (South Africa)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/za.svg" width="22">](README.zul.md)</kbd>
|
||||
<kbd>[<img title="Afrikaans (South Africa)" alt="Afrikaans (South Africa)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/za.svg" width="22">](README.afk.md)</kbd>
|
||||
<kbd>[<img title="Igbo (Nigeria)" alt="Igbo (Nigeria)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ng.svg" width="22">](README.igb.md)</kbd>
|
||||
<kbd>[<img title="Bambara (Mali)" alt="Bambara (Mali)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ml.svg" width="22">](README.mli.md)</kbd>
|
||||
<kbd>[<img title="Hausa (Nigeria)" alt="Hausa (Nigeria)" src="https://upload.wikimedia.org/wikipedia/commons/thumb/5/5d/Flag_of_the_Hausa_people.svg/1280px-Flag_of_the_Hausa_people.svg.png" width="22">](README.hau.md)</kbd>
|
||||
<kbd>[<img title="Yoruba (Nigeria)" alt="Yoruba (Nigeria)" src="https://www.fotw.info/images/n/ng%7Deoyor.gif" width="22">](README.yor.md)</kbd>
|
||||
<kbd>[<img title="Latvia" alt="Latvia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lv.svg" width="22">](README.lv.md)</kbd>
|
||||
<kbd>[<img title="Suomeksi" alt="Suomeksi" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/fi.svg" width="22">](README.fi.md)</kbd>
|
||||
<kbd>[<img title="Беларуская мова" alt="Беларуская мова" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/by.svg" width="22">](README.by.md)</kbd>
|
||||
<kbd>[<img title="Српски" alt="Српски" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/rs.svg" width="22">](README.sr.md)</kbd>
|
||||
<kbd>[<img title="Қазақша" alt="Қазақша" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kz.svg" width="22">](README.kz.md)</kbd>
|
||||
<kbd>[<img title="Bosanski" alt="Bosanski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ba.svg" width="22">](README.bih.md)</kbd>
|
||||
<kbd>[<img title="Bosanski" alt="Bosanski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/et.svg" width="22">](README.bih.md)</kbd>
|
||||
<kbd>[<img title="Hrvatski" alt="Hrvatski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/hr.svg" width="22">](README.hr.md)</kbd>
|
||||
<kbd>[<img title="پښتو" alt="پښتو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/af.svg" width="22">](README.ps.md)</kbd>
|
||||
<kbd>[<img title="Af-soomaali" alt="Somalia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/so.svg" width="22">](README.so.md)</kbd>
|
||||
<kbd>[<img title="Español de Ecuador" alt="Ecuador" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ec.svg" width="22">](README.ec.md)</kbd>
|
||||
<kbd>[<img title="Luganda (Uganda)" alt="Luganda (Uganda)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ug.svg" width="22">](README.lug.md)</kbd>
|
||||
<kbd>[<img title="Turkmen" alt="Turkmen language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tm.svg" width="22">](README.tm.md)</kbd>
|
||||
<kbd>[<img title="Ewe (TOGO)" alt="Ewe (TOGO)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tg.svg" width="22">](README.ewe.md)</kbd>
|
||||
<kbd>[<img title="አማርኛ" alt="አማርኛ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/et.svg" width="22">](README.et.md)</kbd>
|
||||
<kbd>[<img title="Kurdî" alt="Kurdî" src="https://upload.wikimedia.org/wikipedia/commons/3/35/Flag_of_Kurdistan.svg" width="22">](README.kr.md)</kbd>
|
||||
<kbd>[<img title="Malagasy" alt="Malagasy" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mg.svg" width="22">](README.mg.md)</kbd>
|
||||
<kbd>[<img title="ភាសាខ្មែរ" alt="ភាសាខ្មែរ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kh.svg" width="22">](README.kh.md)</kbd>
|
||||
<kbd>[<img title="Morocco" alt="Moroccan Darija" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ma.svg" width="22">](README.ma.md)</kbd>
|
||||
|
||||
# תרומות ראשונות
|
||||
|
||||
מטרת פרויקט זה היא לפשט ולהדריך מתחילים בדרכם אל תרומתם הראשונה לקוד פתוח. אם אתם מחפשים דרך לבצע תרומה ראשונית, עקבו אחר ההוראות הבאות.
|
||||
|
||||
_אם אינכם חשים בנוח להשתמש בשורת פקודה, [כאן תוכלו למצוא מדריכים לשימוש בכלים גרפיים](#הדרכות-בשימוש-כלים-אחרים)._
|
||||
|
||||
<img align="left" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="ביצוע Fork למאגר" />
|
||||
|
||||
#### אם עוד לא התקנתם GIT, [התקינו כעת](https://help.github.com/articles/set-up-git).
|
||||
|
||||
## בצעו FORK למאגר זה
|
||||
|
||||
כדי לבצע FORK למאגר זה, ניתן ללחוץ על כפתור ה – FORK בתחילת העמוד.
|
||||
פעולה זה תיצור עותק של מאגר זה בחשבון שלכם.
|
||||
|
||||
## שכפול המאגר
|
||||
|
||||
<img align="left" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="שכפול מאגר" />
|
||||
|
||||
כעת, שכפלו את המאגר הזה למחשב שלכם. לכו לדף ה-GitHub שלכם, לחצו על כפתור השכפול ואז לחצו על הצלמית `copy to clipboard`.
|
||||
|
||||
פתחו טרמינל והריצו את הפקודה הבאה:
|
||||
|
||||
```bash
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
|
||||
כאשר הביטוי `"url you just copied"` (ללא סימני הגרשיים) הוא הקישור למאגר זה שביצעתם עליו FORK קודם לכן. ראו את הצעדים הקודמים כדי להשיג את הקישור.
|
||||
|
||||
<img align="left" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
לדוגמא:
|
||||
|
||||
```bash
|
||||
git clone git@github.com:this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
|
||||
כאשר `this-is-you` הוא שם המשתמש שלכם ב-GitHub. לכאן אתם מעתיקים את התוכן של מאגר first-contributions ב-GitHub לתוך המחשב שלכם.
|
||||
|
||||
## יצירת ענף
|
||||
|
||||
החליפו לתיקיית המאגר בתוך המחשב שלכם (באם טרם נכנסתם לתיקייה זו):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
|
||||
כעת, צרו ענף (branch) בשימוש הפעולה `git switch`:
|
||||
|
||||
```bash
|
||||
git switch -c your-new-branch-name
|
||||
```
|
||||
|
||||
לדוגמא:
|
||||
|
||||
```bash
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
<div dir="rtl">
|
||||
<details>
|
||||
<summary><strong>אם אתה מקבל שגיאות בעת השימוש ב-git switch, לחץ כאן:</strong></summary>
|
||||
<p dir="rtl">אם מופיעה הודעת השגיאה <strong>"Git: <code>switch</code> is not a git command. See <code>git –help</code>"</strong>,
|
||||
זה כנראה בגלל שאתה משתמש בגרסה ישנה של Git.</p>
|
||||
|
||||
<p>במקרה כזה, נסה להשתמש במקום זאת בפקודה <code>git checkout</code>:</p>
|
||||
|
||||
```bash
|
||||
git checkout -b your-new-branch-name
|
||||
```
|
||||
|
||||
</details>
|
||||
</div>
|
||||
|
||||
## ערכו שינויים הכרחיים ובצעו להם commit
|
||||
|
||||
|
||||
כעת פתחו את הקובץ `Contributors.md` בתוכנת עריכת טקסט והוסיפו את השם שלכם אליו. אל תוסיפו את השם בתחילת הקובץ או בסופו. הוסיפו אותו באמצע. לאחר שסיימתם, שמרו את הקובץ.
|
||||
|
||||
<img align="left" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
אם תנווטו לתיקיית הפרויקט ותבצעו את הפעולה `git status`, תוכלו לראות את השינויים שביצעתם שם.
|
||||
|
||||
הוסיפו את השינויים האלו לענף שיצרתם תוך שימוש בפקודה `git add`:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
|
||||
עכשיו, בצעו commit לשינויים הללו תוך שימוש בפקודת `git commit`:
|
||||
|
||||
```bash
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
|
||||
החליפו את הביטוי `your-name` עם השם שלכם.
|
||||
|
||||
## לדחוף את השינויים ל-GitHub
|
||||
|
||||
|
||||
דחפו את השינויים תוך שימוש בפקודה `git push`:
|
||||
|
||||
```bash
|
||||
git push origin add-your-branch-name
|
||||
```
|
||||
|
||||
|
||||
החליפו את `add-your-branch-name` עם השם של הענף שיצרתם מוקדם יותר.
|
||||
|
||||
<div dir="rtl">
|
||||
<details>
|
||||
<summary><strong>במידה ומתקבלות שגיאות במהלך הדחיפה, לחץ כאן</strong></summary>
|
||||
|
||||
<ul dir="rtl">
|
||||
<li>
|
||||
<h3>שגיאת אימות</h3>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
```bash
|
||||
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'
|
||||
```
|
||||
|
||||
עברו אל [המדריך של GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) על יצירה והגדרה של מפתח SSH לחשבון שלך.
|
||||
|
||||
כמו כן, ייתכן שתרצה להריץ את הפקודה 'git remote -v' כדי לבדוק את הכתובת המרוחקת שלך.
|
||||
|
||||
אם זה דומה לזה:
|
||||
```bash
|
||||
origin https://github.com/your-username/your_repo.git (fetch)
|
||||
origin https://github.com/your-username/your_repo.git (push)
|
||||
```
|
||||
|
||||
תחליף את זה בעזרת הפקודה:
|
||||
```bash
|
||||
git remote set-url origin git@github.com:your-username/your_repo.git
|
||||
```
|
||||
אחרת, עדיין תתבקש לספק שם משתמש וסיסמה ותקבל שגיאת אימות.
|
||||
</details>
|
||||
</div>
|
||||
|
||||
## הגישו את השינויים שלכם לסקירה
|
||||
|
||||
|
||||
אם תלכו למאגר שלכם ב-GitHub, תוכלו לראות כפתור עם הכיתוב `Compare & pull request`. לחצו על כפתור זה.
|
||||
|
||||
<img style="float: left;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
כעת, הגישו את בקשת הדחיפה (pull request):
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
בקרוב, אצרף את כל השינויים לתוך הענף הראשי של פרויקט זה. אתם תקבלו עדכון במייל ברגע שהשינויים ימוזגו.
|
||||
|
||||
## מה לעשות מכאן?
|
||||
|
||||
כל הכבוד! כרגע סיימתם את מעגל הזרימה הסטנדרטי של _fork -> clone -> edit -> pull request_ שאתם תפגשו באופן שכיח כתורמים!
|
||||
|
||||
תחגגו את התרומתכם ושתפו אותה עם החברים והעוקבים שלכם בכך שתלכו ל-[web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
אתם יכולים להצטרף לצוות הסלאק שלנו אם אתם צריכים עזרה או אם יש לכם שאלות. [הצטרפות לצוות בסלאק](https://join.slack.com/t/firstcontributors/shared_invite/zt-2vqegkew0-ZuzGM1LO33C6Ts4nZyat1Q).
|
||||
|
||||
עכשיו אפשר להתחיל לתרום לפרוייקטים אחרים. הכנו רשימה של פרוייקטים על נושאים קלים שאתם יכולים להתחיל לעבוד עליהם. [רשימה של פרוייקטים ב- web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [חומר נוסף](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## הדרכות בשימוש כלים אחרים
|
||||
|
||||
| <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) |
|
||||
|
||||
<p>פרוייקט זה נתמך על ידי:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,125 +0,0 @@
|
||||
[](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)
|
||||
# प्रथम योगदान
|
||||
|
||||
इस परियोजना का उद्देश्य शुरुआती लोगों द्वारा अपना पहला योगदान करने की प्रक्रिया को सरल और मार्गदर्शित करना है। यदि आप योगदान देना चाहते हैं, तो नीचे दिए गए चरणों का पालन करें।
|
||||
|
||||
आर्टिकल्स पढ़ना और ऑनलाइन ट्यूटोरियल्स देखना मददगार साबित हो सकते हैं, लेकिन बिना कुछ गलती करके खुद काम करने से अच्छा हो सकता है। इस प्रोजेक्ट आपको अपने पहले योगदान के लिए दिशा निर्देशित करेगा। याद रखें - जितने तनाव मुक्त होकर आप सीखेंगे, उतना ही बेहतर सीख पाएंगे। नीचे दिए गए निर्देशों का पालन करें।
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
यदि आपके कंप्यूटर पर Git नहीं है तो, [इसे स्थापित करें](https://help.github.com/articles/set-up-git/) ।
|
||||
|
||||
_यदि आप कमांड लाइन के साथ सहज नहीं हैं, [तो यहाँ ग्राफिकल इंटरफेस (GUI) टूल्स का उपयोग करने वाले ट्यूटोरियल हैं] (#अन्य-टूल-का-उपयोग-करके-ट्यूटोरियल) ।_
|
||||
|
||||
## रिपॉज़िटरी को फोर्क करना
|
||||
|
||||
काँटा (फोर्क) बटन पर क्लिक करके इस रिपॉज़िटरी को फोर्क कर सकते हैं। यह आपके GitHub खाते (अकाउंट) में इस रिपॉज़िटरी की एक प्रति (कॉपी) बना देगा जो केवल आपके लिए उपलब्ध होगी।
|
||||
|
||||
## रिपॉज़िटरी को क्लोन करना
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
अब इस रिपॉज़िटरी को अपने कंप्यूटर पर क्लोन (यानी डाउनलोड) करें। अपने GitHub अकाउंट पर जाएँ, फोर्क की गई रिपॉज़िटरी खोलें, 'Code/कोड' बटन पर क्लिक करें, और फिर 'Copy to Clipboard' आइकॉन पर क्लिक करें।
|
||||
|
||||
अपने कंप्यूटर पर एक टर्मिनल/कमांड प्रांप्ट खोलें और निम्न git आदेश (कमांड) चलाएँ:
|
||||
|
||||
```
|
||||
git clone "यूआरएल जिसे आपने अभी कॉपी किया"
|
||||
```
|
||||
|
||||
जहाँ "यूआरएल जिसे आपने अभी कॉपी किया" (उद्धरण चिह्नों के बिना) इस रिपॉज़िटरी के लिए यूआरएल है (इस परियोजना का आपका फोर्क) । यूआरएल प्राप्त करने के लिए पिछले निर्देश देखें ।
|
||||
|
||||
उदाहरण के लिए:
|
||||
|
||||
```
|
||||
git clone https://github.com/यह-आप-हैं/first-contributions.git
|
||||
```
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
`यह-आप-हैं` आपके GitHub अकाउंट का नाम है। यहाँ आप अपने कंप्यूटर में GitHub से first-contributions रिपॉज़िटरी को कॉपी कर रहे हैं अथवा उसकी एक लोकल/स्थानीय कॉपी बना रहे हैं ।
|
||||
|
||||
## एक शाखा (ब्राँच) बनाएँ
|
||||
|
||||
अपने कंप्यूटर पर बनाई गई रिपॉज़िटरी की कॉपी के फोल्डर/डायरेक्टरी में जाएँ (यदि अभी तक नहीं की है तो निम्न आदेश चलाएँ)
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
अब एक नई शाखा बनाएँ `git switch` कमांड का उपयोग करके ।
|
||||
नई शाखा बनाने के लिए -c ऑप्शन का उपयोग होता है ।
|
||||
|
||||
```
|
||||
git switch -c <अपनी-शाखा-का-नाम-जोड़ें>
|
||||
```
|
||||
|
||||
उदाहरण के लिए:
|
||||
|
||||
```
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
( शाखा के नाम में `add` जोड़ने की आवश्यकता नहीं है, लेकिन इसमें शामिल होना जरूरी है क्योंकि इस शाखा का उद्देश्य एक सूची में अपना नाम जोड़ना है। )
|
||||
|
||||
## आवश्यक परिवर्तन करें और उन परिवर्तनों को कमिट करें-
|
||||
|
||||
अब `Contributors.md` फ़ाइल को एक टेक्स्ट एडिटर में खोलकर इसमें अपना नाम जोड़ दें। फ़ाइल की शुरुआत या अंत में इसे न जोड़ें। इसे बीच में कहीं भी रखें ।
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
|
||||
आप यदि `git status` कमांड चलाएंगे , तो आपको अपने द्वारा किये गए परिवर्तन देखेंगे।
|
||||
|
||||
उन परिवर्तनों को बनाई गई शाखा में जोड़ने के लिए `git add` कमांड का उपयोग करें ।
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
अब अपने किये गए बदलावों को `git commit` कमांड का उपयोग करके कमिट करें ।
|
||||
|
||||
```
|
||||
git commit -m "Add <आपका-नाम> to Contributors list"
|
||||
```
|
||||
|
||||
<आपका-नाम> की जगह अपना नाम लिखें ।
|
||||
|
||||
## अपने बदलावों को Github में पुश करें ।
|
||||
|
||||
`git push` का उपयोग कर अपने परिवर्तन को पुश करें ।
|
||||
|
||||
```
|
||||
git push origin <अपनी-शाखा-का-नाम-जोड़ें>
|
||||
```
|
||||
|
||||
`<अपनी-शाखा-का-नाम-जोड़ें>` की जगह अपनी शाखा का नाम लिखें ।
|
||||
|
||||
## अपने बदलावों को रिव्यु के लिए सबमिट करें ।
|
||||
|
||||
यदि आप अपने GitHub प्रोफ़ाइल पर अपनी रिपॉज़िटरी खोलते हैं, तो आपको 'Compare & pull request' का विकल्प दिखाई देगा। उस पर क्लिक करें।
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
अब अपनी pull request सबमिट करें ।
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
|
||||
अब आप अन्य प्रोजेक्ट्स पर योगदान कर सकते हैं, तो चलिए शुरू करते हैं! हमने आपके लिए एक प्रोजेक्ट्स की सूचि तैयार की है जहाँ सरल इश्यूज हैं । आप चाहें तो वहाँ से आरम्भ कर सकते हैं । [प्रोजेक्ट्स कि लिस्ट](https://firstcontributions.github.io/#project-list)
|
||||
|
||||
## शिक्षण अन्य साधनो का उपयोग करने के लिए
|
||||
|
||||
|<a href="../github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a>|<a href="../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="../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="../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="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>|
|
||||
|---|---|---|---|---|
|
||||
|[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)|
|
||||
@@ -1,123 +0,0 @@
|
||||
[](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)
|
||||
# प्रथम योगदान
|
||||
|
||||
पहली बार कुछू करे बर कठिन होथे| ख़ास तौर पर जब आपमन मिलकर काम करथव तब गलतियां करना बने बात नहीं आय | मगर आपस म मिलना अउ एक जुट होकर काम करे ल ही त ओपन सोर्स कइथे| हमन आप मन के पहला ओपन सोर्स कॉन्ट्रिब्यूशन/योगदान आसान बनाए बर आपमन की मदद करबो |
|
||||
|
||||
आर्टिकल्स पढ़े अउ ऑनलाइन ट्यूटोरियल देखके मदद मिल सकत हे मगर बिना कुछू गलत करे अउ खुद वो काम करे ले बने अउ का हो सकत हे ? यह प्रोजेक्ट आपमन के पहले कॉन्ट्रिब्यूशन बर दिशा निर्देशन करे बर बने मदद करहि | याद रखौ - जतका तनाव मुक्त होकर आप मन सिखहु ततका आपमन बने सीख पाबौ | अगर आप मन अपन पहली कॉन्ट्रिब्यूशन करना चाहत हो त आगे दिए तरीका ल बने फॉलो करौ |
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
आपमन के कंप्यूटर म Git नहीं हे त, [एला स्थापित करौ](https://help.github.com/articles/set-up-git/)
|
||||
|
||||
## रिपॉज़िटरी ल फॉर्क करे बर
|
||||
|
||||
कांटा (फॉर्क) बटन म क्लिक करके ए रिपॉज़िटरी ल फॉर्क कर सकत हो| ए ह आपमन के GitHub खाते म इही रिपॉज़िटरी के एकठन प्रति (कॉपी) बना दिहि।
|
||||
|
||||
## रिपोजिटरी क्लोन
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
अब आपमन ए रेपो ल अपन कंप्यूटर म क्लोन (डाउनलोड) करव| अपन GitHub खाते म जाकर क्लोन बटन म क्लिक करव अउ फिर कॉपी टू क्लिपबोर्ड आइकॉन म क्लिक करव |
|
||||
|
||||
अपन कंप्यूटर म एक ठन टर्मिनल/कमांड प्रांप्ट खोलव अउ निम्न git आदेश चलावव:
|
||||
|
||||
```
|
||||
git clone "यूआरएल जैला आपमन कॉपी करे हावव "
|
||||
```
|
||||
|
||||
जेती "यूआरएल जैला आपमन कॉपी करे हावव" (उद्धरण चिह्नों के बिना) ए भंडार बर यूआरएल हे । यूआरएल प्राप्त करे बर पिछला चरण देखव ।
|
||||
|
||||
उदाहरण बर:
|
||||
|
||||
```
|
||||
git clone https://github.com/यह-तै-हावस/first-contributions.git
|
||||
```
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
यह-तै-हावस आपमन के GitHub अकाउंट के नाम हावै। एती आपमन अपन कंप्यूटर न GitHub ले फर्स्ट-कंट्रिब्यूशंज़ रेपो ल कॉपी करथव अउ ओखर एक लोकल/स्थानीय कॉपी बनावथस|
|
||||
|
||||
## एक ब्राँच बनाए बर
|
||||
|
||||
अपन कंप्यूटर म बनाये गए रिपॉजिटरी के कॉपी के फोल्डर/डायरेक्टरी म जावव (अगर अब तक नहीं करे हावस त निम्न आदेश चलावव)
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
अब एक ठी नवा शाखा बनवाव `git checkout` कमांड के उपयोग करके |
|
||||
नवा शाखा बनाए बर -b ऑप्शन के उपयोग होथे।
|
||||
|
||||
```
|
||||
git checkout -b <अपन-शाखा-के-नाम-जोड़ें>
|
||||
```
|
||||
|
||||
उदाहरण बर:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
( शाखा के नाम म `add` जोड़ने के आवश्यकता नहीं हावए, लेकिन एमा जोड़ना चल जाहि काबर की ए शाखा के उद्देश्य एक सूची म अपन नाम ल जोड़े बर हे। )
|
||||
|
||||
## आवश्यक परिवर्तन करे बर अउ उन परिवर्तनों ल कमिट करे बर-
|
||||
|
||||
अब `Contributors.md` फ़ाइल ल एक टेक्स्ट एडिटर म खोलकर एमा अपन नाम लिखव। फ़ाइल के शुरुआत या अंत म एला झन जोड़बे। एला बीच म कही तिरिया देहु आपमन |
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
|
||||
आपमन अगर `git status` निर्देश चलाहु , त आपमन ल किये गए परिवर्तन दिखहि।
|
||||
|
||||
उन परिवर्तनों ल बनाए गए शाखा म जोड़े बर `git add` कमान्ड के उपयोग करव |
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
अब अपन करे गए बदलाव ल कमिट करे बर `git commit` आदेश के उपयोग करव |
|
||||
|
||||
```
|
||||
git commit -m "Add <अपन-नाम> to Contributors list"
|
||||
```
|
||||
|
||||
<अपन-नाम> के जगह अपन नाम डालव|
|
||||
|
||||
## अपन करे बदलाव ल Github म पुश करव|
|
||||
|
||||
`git push` के उपयोग कर अपन परिवर्तन ल पुश करव|
|
||||
|
||||
```
|
||||
git push origin <अपन-शाखा-के-नाम-जोड़व>
|
||||
```
|
||||
|
||||
`<अपन-शाखा-के-नाम-जोड़व>` के जगह अपन शाखा के नाम डालव|
|
||||
|
||||
## अपन बदलाव ल रिव्यु करे बर सबमिट करव|
|
||||
|
||||
आपमन अपन github प्रोफाइल म अपन रेपो म जाबा अउ Compare & pull request ल दबवाव|
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
आप मन के pull request सबमिट करव|
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/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)
|
||||
|
||||
अब आपमन अउ प्रोजेक्ट्स म कंट्रीब्यूट करे बर शुरू कर सकत हव | हमन एक लिस्ट बनाए हन जेन म अड़बड़ सरल मुद्दे हवएं| [प्रोजेक्ट्स के लिस्ट](https://firstcontributions.github.io/#project-list)
|
||||
|
||||
## अन्य टूल के उपयोग करके ट्यूटोरियल
|
||||
|
||||
| <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) |
|
||||
@@ -1,124 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Prvi doprinosi
|
||||
|
||||
Cilj ovog projekta je da pruži jednostavne korake za početnike da naprave svoje prve doprinose. Ukoliko želite napraviti prvi doprinos pratite sljedeće korake ispod.
|
||||
|
||||
#### _Ukoliko niste baš sigurni u svoj rad s komandnom linijom/terminalom, [ovdje možete pronaći tutorijale za GUI alate.](#Upute-za-druge-alate)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="Napravite fork repozitorijuma" />
|
||||
|
||||
Ukoliko nemate git instaliran na Vašem računalu, [instalirajte ga ovdje](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Napravite fork repozitorija
|
||||
|
||||
Forkajte ovaj repozitorij tako da kliknete na dugme _fork_ na vrhu stranice. Ovako pravite kopiju repozitorija na vašoj github stranici.
|
||||
|
||||
## Klonirajte repozitorij
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Sada klonirajte repozitorij koji ste prethodno forkali. Posjetite svoj GitHub profil, otvorite repozitorij koji ste forkali, kliknite na _clone_ (kloniraj) dugme i kliknite na ikonicu _copy to clipboard_.
|
||||
|
||||
Otvorite terminal i upišite slijedeće git naredbe:
|
||||
|
||||
```
|
||||
git clone "url koji ste sada kopirali"
|
||||
```
|
||||
|
||||
gdje je "url koji ste sada kopirali" (bez navodnika) url na ovaj repozitorij (vaš fork ovog projekta). Pogledajte prethodne korake kako dohvatiti url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Na primjer:
|
||||
|
||||
```
|
||||
git clone https://github.com/ovo-ste-Vi/first-contributions.git
|
||||
```
|
||||
|
||||
Gdje je umjesto `ovo-ste-Vi` upisano vaše _github_ korisničko ime. Ovime kopirate sadržaj repozitorija _first-contributions_ na vaše računalo.
|
||||
|
||||
## Stvaranje grane _branch_
|
||||
|
||||
Prebacite se u radni direktorij na Vašem računalu (ukoliko već niste tamo):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Pa zatim napravite novu granu _branch_ koristeći `git switch` comandu:
|
||||
|
||||
```
|
||||
git switch -c dodaj-svoje-ime
|
||||
```
|
||||
|
||||
Na primjer:
|
||||
|
||||
```
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
## Napravite potrebne izmjene i potvrdite promjene
|
||||
|
||||
Otvorite `Contributors.md` datoteku u tekst editoru i dodajte Vaše ime. Nemojte dodavati ime na sam početak ili kraj. Stavite ga negdje u sredinu. Potom spremite datoteku.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Ukoliko odete u radni direktorij i izvršite naredbu `git status`, primijetit ćete da postoje promjene.
|
||||
|
||||
Dodajte ove promjene u granu koju ste gore napravili koristeći `git add` naredbu:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Sada potvrdite ove promjene koristeći `git commit` naredbu:
|
||||
|
||||
```
|
||||
git commit -m "Add svoje-ime to Contributors list"
|
||||
```
|
||||
|
||||
Gdje umjesto `svoje-ime` upisujete svoje ime.
|
||||
|
||||
## Pushajte promjene na GitHub
|
||||
|
||||
Pošaljite promjene u repozitorij na GitHub-u koristeći naredbu `git push`:
|
||||
|
||||
```
|
||||
git push origin -u ime-Vaše-grane
|
||||
```
|
||||
|
||||
gdje umjesto `ime-Vaše-grane` stavljate ime vaše grane koje ste prethodno napravili.
|
||||
|
||||
## Pošaljite izmjene na pregled
|
||||
|
||||
Ukoliko odete na repozitorij na Vašem GitHub profilu primijetit ćete `Compare & pull request` Dugme. Kliknite na njega.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
a zatim pošaljite zahtjev klikom na dugme _Create pull request_.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Nakon toga, vlasnik će spojiti promjene koje ste napravili sa master granom projekta. Dobit ćete mail potvrde kada se grane spoje.
|
||||
|
||||
## Što dalje?
|
||||
|
||||
Čestitamo! Završili ste standardni _fork -> clone -> edit -> PR_ tok koji će vas pratiti kroz Vaš čitav programerski život!
|
||||
|
||||
Proslavite tako što ćete podjeliti svoj doprinos sa prijateljima i pratiocima otvaranjem [stranice](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Pridružite se i našem Slack timu u slučaju da vam je potrebna ikakva pomoć ili imate bilo kakvih pitanja. [Slack tim](https://join.slack.com/t/firstcontributors/shared_invite/zt-2vqegkew0-ZuzGM1LO33C6Ts4nZyat1Q).
|
||||
|
||||
Sada možemo početi sa doprinosima drugim projektima. Napravili smo popis projekata sa jednostavnim problemima na kojima možete početi raditi. Posjetite [listu projekata na naštoj stranici](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Dodatni materijali](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Upute za druge alate
|
||||
|
||||
| <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) |
|
||||
@@ -1,124 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Első közreműködés nyílt forráskódú projektben
|
||||
|
||||
Minden kezdet nehéz, ezért szeretnénk segíteni számodra az első lépésekben ahhoz, hogy bátran kódolj kooperatívan nyílt forráskódú projekteket. Senki sem szeret hibázni, de szerencsére itt most nyugodtan megteheted. A lényeg, hogy gyakorolj!
|
||||
|
||||
A projekt célja, hogy útmutatást nyújtson, egyszerűsítse és segítse a kezdők első lépéseit nyílt forráskódú szoftverek közös programozásában. Ha te is most készülsz először ilyet csinálni, segítünk neked, kövesd az alábbi lépéseket.
|
||||
|
||||
#### *Ha a parancssor kényelmetlen, [itt egy tutorial a GUI felület használatához.](#Oktatóanyagok-más-eszközök-használatával)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="forkold ezt a repót" />
|
||||
|
||||
Ha nincs a gépeden git, [telepítsd fel]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Ágaztasd ezt a repót (fork)
|
||||
|
||||
A Fork gomb kattintásával ágaztasd el ezt a repót.
|
||||
Ezzel készítettél egy másolatot erről a reporól a te saját git fiókodba.
|
||||
|
||||
## Klónozd a repót (clone)
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="klónozd ezt a repót" />
|
||||
|
||||
Most klónozd az elágaztatott repót a gépedre. Menj a GitHub fiókodra, nyisd meg a forkolt repositoryt, kattints a clone gombra, majd kattints a *copy to clipboard* ikonra.
|
||||
|
||||
Nyiss egy terminált és futtasd a következő parancsot:
|
||||
|
||||
```
|
||||
git clone "url-amit-most-masoltal-le"
|
||||
```
|
||||
A "url-amit-most-masoltal-le" kifejezést, cseréld ki (idézőjelek nélkül) a vágólapra helyezett repository url címére (ami ebből a projektől ágazik). Az ágaztatás folyamatát lásd az előző lépésben.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="másold az URL címet a vágólapra" />
|
||||
|
||||
Például:
|
||||
```
|
||||
git clone https://github.com/a-te-git-neved/first-contributions.git
|
||||
```
|
||||
A `a-te-git-neved` lesz a GitHub felhasználóneved. Ezzel letöltöd a first-contributions repositoryt GitHub-ról a saját számítógépedre.
|
||||
|
||||
## Készíts egy ágat (branch)
|
||||
|
||||
Navigálj a repository könytárába (ha nem ott vagy jelenleg):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Most készítsünk egy ágat `git checkout` parancs használatával:
|
||||
|
||||
```
|
||||
git switch -c <az-uj-branch-neve>
|
||||
```
|
||||
|
||||
Például:
|
||||
```
|
||||
git switch -c add-gabor-takacs
|
||||
```
|
||||
(A branch nevében nem kötelező, hogy benne legyen az *add* szó, de észszerű belefoglalni, mert ennek az ágnak az a célja, hogy hozzáadja a nevünket egy listához.)
|
||||
|
||||
## Végezd el a szükséges változtatásokat és rögzítsd azokat (commit)
|
||||
|
||||
Nyisd meg a `Contributors.md` fájlt egy szövegszerkesztőben, majd add hozzá a neved. Ne a fájl elejére vagy végére helyezd, hanem a kettő közé. A kettő között bárhová teheted. Mentsd el a fájlt.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
|
||||
Ha a project könyvtárába navigálsz és futtatod a `git status` parancsot, akkor a következő módosításokat fogod látni:
|
||||
|
||||
|
||||
Ezeket a módosításokat add hozzá a branchez a `git add` paranccsal:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Commitoljuk a módosításokat a `git commit` paranccsal:
|
||||
```
|
||||
git commit -m "Add <a-te-neved> to Contributors list"
|
||||
```
|
||||
Helyettesítsd `<a-te-neved>` kifejezést a saját neveddel.
|
||||
|
||||
## Töltsd fel az elkészült változtatásokat a GitHub-ra (push)
|
||||
|
||||
Töltsd fel a változtatásokat a `git push` paranccsal:
|
||||
```
|
||||
git push origin <a-branch-neve>
|
||||
```
|
||||
Helyettesítsd az `<a-branch-neve>` kifejezést annak a branchnek a nevével, amit korábban létrehoztál.
|
||||
|
||||
## Küldd be a módosításaidat ellenőrzésre (pull request)
|
||||
|
||||
Ha a saját repódba navigálsz GitHub-on, látnod kell a `Compare & pull request` gombot. Kattints rá!
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="pull request készítése" />
|
||||
|
||||
Sikeresen elküldted a pull requested.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="pull request beküldése" />
|
||||
|
||||
Kis idő elteltével összevonja a változásokat a project fő ágában. Értesítést fogsz kapni emailben, ha a változások összefűzésre kerültek.
|
||||
|
||||
## Hogyan tovább?
|
||||
|
||||
Gratulálunk! Sikeresen teljesítetted az alapvető _fork -> clone -> edit -> PR_ folyamatot, melyet gyakran kell majd csinálnod közreműködőként!
|
||||
|
||||
Ünnepeld meg az első kooperációdat és oszd meg barátaiddal és követőiddel ennek a [web app](https://firstcontributions.github.io/#social-share)-nak a segítségével.
|
||||
|
||||
Bármilyen kérdésed van vagy segítségre lenne szükséged, csatlakozz slack csapatunkhoz. [Csatlakozz a slack csapathoz.](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Itt az idő egy másik projektben is közreműködni. Összeállítottunk egy listát azokról a projektekről, melyek könnyebb feladatokat tartalmaznak az induláshoz. Nézd meg a [projektek listáját](https://firstcontributions.github.io/#project-list) a webalkalmazásban.
|
||||
|
||||
### [Kiegészítő anyag](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Oktatóanyagok más eszközök használatával
|
||||
|
||||
| <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) |
|
||||
@@ -1,135 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Առաջին ներդրումները(contributions)
|
||||
|
||||
Այս նախագիծը նպատակ ունի պարզեցնել և առաջնորդել սկսնակներին իրենց առաջին ներդրման ճանապարհին: Եթե ցանկանում եք կատարել ձեր առաջին ներդրումը, հետևեք ստորև նշված քայլերին:
|
||||
|
||||
_Եթե հրամանի պատուհանը (command line) ձեզ հարմար չէ, [ահա ուղեցույցներ գրաֆիկական ինտերֆեյսի (GUI) կիրառմամբ.](#Ուղեցույցներ-այլ-գործիքների-կիրառմամբ)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### Եթե դուք չունեք git ձեր մեքենայի վրա, [տեղադրեք այն](https://help.github.com/articles/set-up-git/)
|
||||
|
||||
## Ճյուղավորեք (fork) այս պահոցը (repository)
|
||||
|
||||
Ստեղծեք ձեր սեփական պատճենը՝ սեղմելով այս էջի վերևում գտնվող `fork` կոճակը:
|
||||
Դա կստեղծի այս պահոցի պատճենը ձեր պրոֆիլում:
|
||||
|
||||
## Կլոնավորեք պահոցը
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Հիմա կլոնավորեք պահոցը ձեր համակարգչում: Հղումը պատճենելու համար սեղմեք `clone` կոճակը, այնուհետև `copy to clipboard` կոճակը:
|
||||
|
||||
Բացեք տերմինալը և գործարկեք հետևյալ git հրամանը.
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
Որտեղ "url you just copied"-ը (առանց չակերտների) ձեր պահոցի հղումն է (այս նախագծի ձեր ճյուղավորումը). Հետևեք քայլերին, որպեսզի ստանաք հղումը.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Օրինակ՝
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
Որտեղ `this-is-you`-ն github-ի ձեր մուտքանունն է. Այսպիսով դուք պատճենում եք first-contributions պահոցը՝ GitHub-ից, ձեր համակարգչի վրա:
|
||||
|
||||
## Ստեղծեք ճյուղ
|
||||
|
||||
Մուտք գործեք ձեր համակարգչում գտնվող պահոցը, եթե արդեն այնտեղ չեք։
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Հիմա ստեղծեք նոր ճյուղ՝ օգտագործելով `git checkout` հրամանը․
|
||||
|
||||
```
|
||||
git checkout -b <add-your-name>
|
||||
```
|
||||
|
||||
Օրինակ՝
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
## Կատարեք անհրաժեշտ փոփոխությունները և կատարեք ձեր ներդրումը (commit)
|
||||
|
||||
Հիմա բացեք `Contributors.md` ֆայլը ձեր տեքստային խմբագրիչում, գրեք ձեր անունը և պահպանեք ֆայլը։ Մի ավելացրեք այն ֆայլի սկզբում կամ վերջում: Տեղադրեք այն որևէ տեղ մեջտեղում: Այժմ պահպանեք ֆայլը:
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Եթե գնաք նախագծի պանակ և կատարեք `git status` հրամանը, կտեսնեք, որ փոփոխություններ կան:
|
||||
|
||||
Ավելացրեք այդ փոփոխությունները այն ճյուղին, որը հենց նոր ստեղծեցիք՝ օգտագործելով `git add` հրամանը.
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Այժմ գործադրեք այս փոփոխությունները `git commit` հրամանով.
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
Փոփոքեք `<your-name>`-ը ձեր անունով
|
||||
|
||||
## Push արեք փոփոխությունները github
|
||||
|
||||
Push արեք ձեր փոփոխությունները `git push` հրամանով․
|
||||
|
||||
```
|
||||
git push origin <add-your-name>
|
||||
```
|
||||
|
||||
Փոփոխոք `<add-your-name>`-ը ավելի վաղ ստեղծած ճյուղի անունով:
|
||||
|
||||
<details>
|
||||
<summary> <strong>Եթե push անելիս առաջանում են սխալներ, սեղմեք այստեղ՝</strong> </summary>
|
||||
|
||||
- ### Authentication Error
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Go to [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account.
|
||||
|
||||
</details>
|
||||
|
||||
## Հաստատեք փոփոխությունները վերանայման համար
|
||||
|
||||
Եթե այցելեք ձեր GitHub պահոցը, կտեսնեք `Compare & pull request` կոճակը։ Սեղմեք այդ կոճակը։
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Ապա հաստատեք pull հարցումը:
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Շուտով ես կմիավորեմ ձեր բոլոր փոփոխությունները այս նախագծի գլխավոր մասնաճյուղի մեջ: Փոփոխությունները միաձուլվելուց հետո դուք կստանաք ծանուցող նամակ:
|
||||
|
||||
## Ու՞ր գնալ այստեղից
|
||||
|
||||
Շնորհավորանքնե՛րս, դուք հենց նոր ավարտեցիք ստանդարտ _fork -> clone -> edit -> pull request_ աշխատակարգը, որը հաճախ կհանդիպեք որպես ներդրող:
|
||||
|
||||
Նշեք ձեր ներդրումը և կիսվեք այն ձեր ընկերների և հետևորդների հետ՝ այցելելով [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Դուք կարող եք միանալ մեր Slack թիմին, եթե որևէ հարց կամ օգնության կարիք ունեք։ [Միանալ slack թիմին](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Հիմա կարող եք ձեր ներդրումն ունենալ այլ նախագծերում։ Մենք կազմել ենք հեշտ խնդիրներ ունեցող նախագծերի ցանկ, որոնցից կարող եք սկսել: Համեցեք [վեբ հավելվածի նախագծերի ցանկը](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Լրացուցիչ նյութեր](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Ուղեցույցներ այլ գործիքների կիրառմամբ
|
||||
|
||||
| <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) |
|
||||
@@ -1,166 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Kontribusi Pertama
|
||||
|
||||
Proyek ini bertujuan untuk menyederhanakan dan membimbing perjalanan seorang pemula berkontribusi di Github untuk pertama kali. Pertahatikan langkah - langkah berikut untuk memulai:
|
||||
|
||||
#### _Jika Anda tidak terbiasa dengan baris perintah(command line), [di sini ada tutorial untuk menggunakan GUI(antarmuka bergrafis).](#Tutorial-Menggunakan-Alat-Lain)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Apabila Anda belum menginstall git di komputer Anda, [install segera](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## _Fork_ Repositori Ini
|
||||
|
||||
Fork repositori ini dengan cara klik tombol _Fork_ yang ada di bagian atas kanan pada halaman ini. Hal Ini akan membuat sebuah salinan repositori di akun Anda.
|
||||
|
||||
## _Clone_ (Kloning) Repositori
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Sekarang kloning repositori yang sudah Anda _fork_ ke komputer Anda. Pergi ke akun GitHub Anda, buka repositori yang sudah Anda _fork_, klik tombol _Code_ dan kemudian klik ikon salin ke papan klip.
|
||||
|
||||
Buka sebuah terminal dan jalankan perintah git berikut:
|
||||
|
||||
```
|
||||
git clone "url yang telah Anda disalin"
|
||||
```
|
||||
|
||||
bagian "url yang telah Anda disalin" (tanpa tanda petik) adalah url ke repositori ini (proyek yang telah Anda _fork_ ini). Lihat langkah sebelumnya untuk mendapatkan url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Contohnya:
|
||||
|
||||
```
|
||||
git clone git@github.com:ini-adalah-anda/first-contributions.git
|
||||
```
|
||||
|
||||
bagian `ini-adalah-anda` adalah nama pengguna GitHub Anda. Di sini Anda menyalin konten dari repositori first-contributions di GitHub ke komputer Anda.
|
||||
|
||||
## Membuat Sebuah _Branch_ (Cabang)
|
||||
|
||||
Pindah ke direktori repositori yang terdapat pada komputer Anda (jika Anda belum berada di sana):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Sekarang buatlah sebuah _branch_ menggunakan perintah `git checkout`:
|
||||
|
||||
```
|
||||
git checkout -b <tambahkan-nama-branch-baru>
|
||||
```
|
||||
|
||||
Contohnya:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary> <strong>Jika kamu mendapatkan beberapa kesalahan menggunakan <i>git switch</i>, klik disini:</strong> </summary>
|
||||
|
||||
Jika pesan error: "Git: `switch` is not a git command. See `git –help`" muncul, kemungkinan besar Anda menggunakan versi git yang lama.
|
||||
|
||||
Dalam kasus ini, coba gunakan `git checkout` sebagai gantinya:
|
||||
|
||||
```bash
|
||||
git checkout -b your-new-branch-name
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## Buat Perubahan Yang Diperlukan Lalu _Commit_ (Simpan) Perubahan Tersebut
|
||||
|
||||
Sekarang buka berkas `Contributors.md` menggunakan teks editor, tambahkan nama Anda ke dalamnya. Jangan menambahkan pada awal atau akhir dari berkas. Simpan dimana saja di antaranya. Sekarang simpan berkasnya.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Jika Anda pergi ke direktori proyek dan mengeksekusi perintah `git status`, Anda akan melihat ada sebuah perubahan.
|
||||
|
||||
Tambahkan perubahan tersebut ke _branch_ yang baru saja Anda buat menggunakan perintah `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Sekarang simpan perubahan tersebut menggunakan perintah `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Add <nama-anda> to Contributors list"
|
||||
```
|
||||
|
||||
Ubah bagian `<nama-anda>` dengan nama Anda.
|
||||
|
||||
## Dorong (Push) Perubahan Ke GitHub
|
||||
|
||||
_Push_ perubahan menggunakan perintah `git push`:
|
||||
|
||||
```
|
||||
git push origin <tambahkan-nama-cabang-baru>
|
||||
```
|
||||
|
||||
ganti bagian `<tambahkan-nama-cabang-baru>` dengan nama cabang yang sebelumnya Anda buat.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Jika Anda mendapatkan kesalahan saat melakukan <i>push</i>, klik disini:</strong> </summary>
|
||||
|
||||
- ### Kesalahan Autentikasi
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Buka [tutorial GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) untuk menghasilkan dan mengkonfigurasi sebuah kunci SSH ke akun Anda.
|
||||
|
||||
Jika kelihatannya seperti ini:
|
||||
|
||||
<pre>origin https://github.com/your-username/your_repo.git (fetch)
|
||||
origin https://github.com/your-username/your_repo.git (push)</pre>
|
||||
|
||||
Buat perubahan dengan perintah:
|
||||
|
||||
<pre>git remote set-url origin git@github.com:your-username/your_repo.git</pre>
|
||||
|
||||
Jika tidak, Anda akan tetap dimintai nama pengguna dan kata sandi serta mendapatkan kesalahan autentikasi.
|
||||
</details>
|
||||
|
||||
|
||||
## Kirim Perubahan Untuk Diperiksa
|
||||
|
||||
Jika Anda membuka repositori Anda di GitHub, Anda akan melihat sebuah tombol `Compare & pull request`. Tekan tombol tersebut.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Sekarang kirimkan _Pull Request_
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Saya (pengelola) akan segera menggabungkan semua perubahan Anda ke cabang utama (_main branch_) dari proyek ini. Anda akan mendapatkan email pemberitahuan setelah perubahan digabungkan.
|
||||
|
||||
## Ke Mana Lagi Setelah Dari Sini?
|
||||
|
||||
Selamat! Anda baru saja menyelesaikan standar _fork_ -> _clone_ -> _edit_ -> _pull request_ sebuah alur kerja yang akan sering Anda temui sebagai seorang kontributor!
|
||||
|
||||
Rayakan kontribusi Anda dan bagikan dengan teman-teman dan pengikut Anda dengan membuka [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Anda dapat bergabung dengan tim Slack kami jika Anda membutuhkan bantuan atau memiliki pertanyaan. [Bergabung dengan tim Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Sekarang mari kita mulai dengan berkontribusi di proyek lain. Kami sudah menyusun daftar proyek dengan isu yang mudah dikerjakan sehingga Anda dapat segera memulai. Cek di [daftar proyek web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
## [Materi tambahan](../additional-material/translations/additional-material.id.md)
|
||||
|
||||
## Tutorial Menggunakan Alat (tools) Lain
|
||||
|
||||
| <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) |
|
||||
|
||||
<p>Proyek ini didukung oleh:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,128 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Onyinye Mbụ
|
||||
|
||||
O siri ike. Ọ na-esiri gị ike mgbe mbụ i mere ihe. Karịsịa mgbe ị na-emekọ ihe, imehie ihe abụghị ihe dị mma. Anyị chọrọ ime ka ụzọ ndị ọhụrụ na-emeghe emeghe na-amụta ma tinye aka maka oge mbụ.
|
||||
|
||||
Ịgụ isiokwu & nkuzi ntanetị nwere ike inyere gị aka, ma gịnị dị mma karịa ime ihe ahụ na-eme ihe omume? Ihe oru a bu iji nye nduzi & mee ka ndi mmadu bidoro ibu onyinye mbu. Ọ bụrụ na ị na-achọ ime onyinye mbụ gị, gbasoo nzọụkwụ dị n'okpuru.
|
||||
|
||||
#### _Ọ bụrụ na ị naghị enwe mmasị na akara iwu, [ebe a bụ nkuzi na-eji ngwaọrụ GUI.](#Nkuzi-na-iji-ihe-ndi-ozo)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Ọ bụrụ na ịnweghị igwe na igwe gị, [wụnye ya](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Wepu ebe nchekwa a
|
||||
|
||||
Wepu a repo site na ịpị bọtịnụ mkpịsị aka n'elu nke ibe a. Nke a ga-emepụta otu ntinye nchekwa a na akaụntụ gị.
|
||||
|
||||
## Na-ekpuchi ebe nchekwa
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Ugbu a, dochie ya repo na igwe gị. Gaa na akaụntụ GitHub gị, meghee repo ahụ maka pịa, pịa bọtịnụ clone ma pịazie ya na akara ngosi akara ngosi.
|
||||
|
||||
Mepee ọnụ ma jikwa iwu na-esonụ:
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
ebe "url na ị depụtaghachiri" (na-enweghị ntinye ọnụ) bụ url maka nchekwa ebe a (mgbịrịgwụ nke ọrụ a). Hụ nzọụkwụ ndị gara aga iji nweta url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Ọmụmaatụ:
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
ebe `this-is-you` ka aha njirimara GitHub gị. Lee, ị na-edegharị ọdịnaya nke onyinye ntinye mbụ na GitHub na kọmputa gị.
|
||||
|
||||
## Mepụta alaka
|
||||
|
||||
Gbanwee na nhazi ndekọ na kọmputa gị (ọ bụrụ na ịnweghị ebe ahụ):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Ugbu a, mepụta alaka ụlọ ọrụ site na iji `git checkout` iwu:
|
||||
|
||||
```
|
||||
git checkout -b <add-your-new-branch-name>
|
||||
```
|
||||
|
||||
Ọmụmaatụ:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
(Aha alaka ahụ adịghị mkpa iji tinye okwu ahụ n'ime ya, ma ọ bụ ihe dị mkpa ị gụnyere n'ihi na ebumnuche nke alaka a bụ ịgbakwunye aha gị na ndepụta.)
|
||||
|
||||
## Mee mgbanwe ndị dị mkpa ma mee mgbanwe ndị ahụ
|
||||
|
||||
Ugbu a mepee `Contributors.md` faịlụ na nchịkọta ederede, tinye aha gị na ya. Adakwunye ya na mmalite ma ọ bụ njedebe nke faịlụ ahụ. Tinye ya n'ebe ọ bụla n'etiti. Ugbu a, chekwaa faịlụ ahụ.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Ọ bụrụ na ịga na ndekọ ụlọ ọrụ ma mebie iwu ahụ `git status`, ị ga-ahụ na e nwere mgbanwe.
|
||||
|
||||
Tinye mgbanwe ndị a n'alaka ụlọ ọrụ ị mepụtara site na iji `git add` iwu ahụ:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Ugbu a mee mgbanwe ndị ahụ site na iji `git commit` iwu ahụ:
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
jiri aha gị dochie `<your-name>`.
|
||||
|
||||
## Kwanye mgbanwe nile a n'ime GitHub
|
||||
|
||||
Mee mgbanwe gị site na iji iwu `git push`:
|
||||
|
||||
```
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
|
||||
dochie `<add-your-branch-name>` aha alaka ụlọ ọrụ ị mepụtara n'oge gara aga.
|
||||
|
||||
## Nyefee mgbanwe gị maka nyocha
|
||||
|
||||
Ọ bụrụ na ị gaa ebe nchekwa gị na GitHub, ị ga-ahụ `Compare & pull request` bọtịnụ. Pịa bọtịnụ ahụ.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Ugbu a, rịọ arịrịọ ahụ.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
N'oge na-adịghị anya, m ga-emeri mgbanwe gị niile n'ime ngalaba alaka ụlọ ọrụ a. Ị ga-enweta ozi ngosi mgbe ọ bụla emetụtara mgbanwe.
|
||||
|
||||
## Ebee ka esi aga ebe a?
|
||||
|
||||
Ekele! Naanị ị gụchara ihe nkesa -> mmepụta oyiri -> dezie -> Bọpụ ọrụ PR nke ị ga-ezute mgbe niile dị ka onye na-enye gị!
|
||||
|
||||
Nalee onyinye gị ma soro ndị enyi gị na ụmụazụ gị kerịta ya site na ịga na [ngwa weebụ](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Ị nwere ike isonyere ndị ọrụ anyị na-adịghị mma na ikpe ịchọrọ enyemaka ọ bụla ma ọ bụ nwee ajụjụ ọ bụla. [Jikọọ slack otu](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Ugbu a, ka anyị malite site na inye onyinye maka ọrụ ndị ọzọ. Anyị ejikọtawo ndepụta nke oru na okwu dị mfe ị nwere ike ịmalite. Lelee [ndepụta nke oru na ngwa weebụ ](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Ihe ndi ozo](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Nkuzi na iji ihe ndi ozo
|
||||
|
||||
| <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) |
|
||||
@@ -1,128 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Il primo contributo
|
||||
|
||||
È dura. È sempre difficile fare qualcosa per la prima volta. Specialmente quando si sta collaborando, sbagliare ci mette a disagio. Ma l'open source si basa sulla collaborazione e sul lavorare insieme. Pertanto volevamo semplificare il modo in cui i nuovi collaboratori imparano e contribuiscono per la prima volta a progetti open-source.
|
||||
|
||||
Leggere articoli e guardare tutorial può essere utile, ma cosa c'è di meglio che provare a fare effettivamente le cose sul campo? Questo progetto punta ad essere una guida per i meno esperti. Ricorda: più sei rilassato, meglio imparerai. Se vuoi contribuire per la prima volta, segui i semplici passi elencati qui sotto. Ti promettiamo che sarà divertente.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Se non hai git sul tuo computer, [installalo]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Fai il fork di questa repository
|
||||
|
||||
Fai il *fork* di questa *repo* (abbreviazione di *repository*, ossia un archivio) cliccando sul bottone ***fork*** in cima alla pagina.
|
||||
Questo creerà una copia di questa repository nel tuo account.
|
||||
|
||||
## Scarica la repository
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Ora scarica (*clone*) questa repo nel tuo computer. Clicca sul pulsante per scaricare e poi copia l'url.
|
||||
|
||||
Apri il terminale e lancia il seguente comando:
|
||||
|
||||
```bash
|
||||
git clone "url appena copiato"
|
||||
```
|
||||
|
||||
dove "url appena copiato" (senza le virgolette) è l'url di questa repository. Leggi i passaggi precedenti per ottenere l'url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Per esempio:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/questo-sei-tu/first-contributions.git
|
||||
```
|
||||
|
||||
dove `questo-sei-tu` è il tuo username GitHub. Qui stai copiando il contenuto della repository da GitHub al tuo computer.
|
||||
|
||||
## Crea un ramo (*Branch*)
|
||||
|
||||
Entra nella directory della repository (se non lo hai già fatto):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Ora crea un ramo (*branch*) usando il comando `git checkout -b`:
|
||||
|
||||
```bash
|
||||
git checkout -b <aggiungi-il-tuo-nome>
|
||||
```
|
||||
|
||||
Ad esempio:
|
||||
|
||||
```bash
|
||||
git checkout -b aggiungi-alonzo-church
|
||||
```
|
||||
|
||||
(Non è necessario inserire la parola *aggiungi* nel nome del branch, ma in questo caso è ragionevole includerlo poiché lo scopo di questo branch è aggiungere il tuo nome alla lista.
|
||||
Lo scopo di nominare un branch è descrivere le modifiche che andremo ad effettuare, il nome deve essere quindi descrittivo e non generale per facilitare il team con cui si collabora.)
|
||||
|
||||
## Fai le modifiche necessarie e crea un commit
|
||||
|
||||
Ora apri il file `Contributors.md` in un editor, inserisci il tuo nome. Non aggiungerlo all'inizio o alla fine del file ma in un qualsiasi punto nel mezzo. Ora salva il file. Se vai nella directory del progetto ed esegui il comando `git status`, vedrai quali sono i cambiamenti. Aggiungi le modifiche al branch appena creato usando il comando `git add`:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Crea ora una commit che includa le modifiche da te fatte, usando `git commit`:
|
||||
|
||||
```bash
|
||||
git commit -m "Add <il-tuo-nome> to Contributors list"
|
||||
```
|
||||
|
||||
cambiando `<il-tuo-nome>` con il tuo nome.
|
||||
|
||||
## Invia (*Push*) le modifiche a GitHub
|
||||
|
||||
Invia (*push*) le tue modifiche con il comando `git push`:
|
||||
|
||||
```bash
|
||||
git push origin <aggiungi-il-tuo-nome>
|
||||
```
|
||||
|
||||
sostituendo `<aggiungi-il-tuo-nome>` con il nome del branch creato prima.
|
||||
|
||||
## Invia i tuoi cambiamenti per una revisione
|
||||
|
||||
Se vai nella tua repository su GitHub, vedrai il pusante `Compare & pull request`. Cliccalo.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Ora invia la pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Presto avrò incorporato (*merge*) tutti i tuoi cambiamenti nel master branch di questo progetto. Ti arriverà una mail di notifica una volta che le modifiche saranno state accettate.
|
||||
|
||||
### [ Prossimi passi ](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Tutorial usando altri tool
|
||||
|
||||
| <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) |
|
||||
|
||||
## E ora?
|
||||
|
||||
Unisciti alla nostra squadra su slack in caso tu abbia bisogno di aiuto o abbia qualche domanda. Proveremo ad aiutarti! [Unisciti alla squadra Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Qui sotto puoi trovare delle repo popolari dove cercare problemi semplici da cui partire. Continua nelle repo per imparare di più
|
||||
|
||||
|[](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[<img width="100" src="https://cdn.worldvectorlogo.com/logos/react-2.svg">](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[<img width="100" src="https://camo.githubusercontent.com/0f302c808c8457f6460913e33aed3478124612c2/687474703a2f2f6c65696e696e67656e2e6f72672f696d672f6c65696e696e67656e2e6a7067">](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[<img width="100" src="https://images.plot.ly/plotly-documentation/thumbnail/numpy-logo.jpg">](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)|
|
||||
|---|---|---|---|---|---|---|---|
|
||||
|[exercism](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[Fun Retros](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[react](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[habitat](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[scikit-learn](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[Leiningen](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[numpy](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[elasticsearch](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)|
|
||||
|[](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)|
|
||||
|[homebrew](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[Rust](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[vuejs](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[Suave](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[OpenRA](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[PowerShell](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[coala](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[moment](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)|
|
||||
|[](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level)|[](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) |[<img width="100" src="https://cdn.worldvectorlogo.com/logos/brackets-1.svg">](https://github.com/adobe/brackets/labels/Starter%20bug)|
|
||||
|[ava](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[webpack](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[hoodie](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[pouchdb](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[neovim](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level)|[babel](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) |[brackets](https://github.com/adobe/brackets/labels/Starter%20bug)|
|
||||
| [](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22)|[<img width="100" src="https://raw.githubusercontent.com/Semantic-Org/Semantic-UI-React/master/docs/public/logo.png">](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22)|
|
||||
| [Node.js](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |[Semantic-UI-React](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |
|
||||
@@ -1,115 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# First Contributions
|
||||
|
||||
初めてのことは何でも大変なものです。特に他人と協力する時に、間違うのは気持ちの良いことではありません。しかし、オープンソースにおける活動では協力することが全てです。私たちは初めてオープンソースに貢献する人たちが、簡単に貢献できる方法を学べるようにしたいと考えています。
|
||||
|
||||
記事を読んだりチュートリアルをやってみることはためになりますが、実際にやってみる方が良いでしょう。このプロジェクトはそのガイダンスを行い、初心者が最初のオープンソースへの貢献を簡単に行えるようにするためのものです。<br>
|
||||
初めてのオープンソースへの貢献を行いたい場合、以下の簡単なステップに従ってください。
|
||||
|
||||
#### *コマンドラインでの操作に慣れていない場合、[グラフィカルなツールでもチュートリアルを行えます。]( #その他のツールを使用したチュートリアル )*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
まだGitをインストールしていない場合は、[ここ](https://help.github.com/articles/set-up-git/)からインストールしてください
|
||||
|
||||
## リポジトリをフォーク
|
||||
|
||||
Forkボタンをクリックしてこのリポジトリをフォークしてください。
|
||||
この作業であなたのアカウントにはこのリポジトリのコピーが作られます。
|
||||
|
||||
## リポジトリをクローン
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
次にフォークしたリポジトリをクローンします。あなたのリポジトリに移動してフォークしたリポジトリを開き*Code*ボタンをクリックした後に*Copy to clipboard*アイコンをクリックしてください。
|
||||
|
||||
ターミナルを開いて以下のgitコマンドを実行してください：
|
||||
|
||||
```
|
||||
git clone "コピーしたURL"
|
||||
```
|
||||
"コピーしたURL" (ダブルクオーテーションは除いてください) は先ほどコピーしたリポジトリのURLと置き換えてください。
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
例：
|
||||
```
|
||||
git clone https://github.com/＜あなたのユーザー名＞/first-contributions.git
|
||||
```
|
||||
`あなたのユーザー名` はご自身のGitHubユーザー名に置き換えてください。この作業でGitHub のリポジトリの内容はあなたのコンピュータに保存されました。
|
||||
|
||||
## ブランチを作成
|
||||
|
||||
もしリポジトリのディレクトリにいなければそこまで移動してください。
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
`git switch` コマンドを使用してブランチを作成します：
|
||||
```
|
||||
git switch -c <add-your-name>
|
||||
```
|
||||
|
||||
例:
|
||||
```
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
(ブランチの名前には必ずしも*add*が含まれていなければならないわけではありませんが、このブランチの目的があなたの名前をリストに加えることであることを考慮すれば含むのが適切です。)
|
||||
|
||||
## コードを変更してその変更をコミット
|
||||
|
||||
テキストエディタで`Contributors.md`ファイルを開いてあなたの名前を追加してください。ただし、ファイルの先頭または最後に追加しないようにしましょう。名前リストの間のどこか好きな場所に、あなたの名前を追加するようにしてください。あなたの名前をファイルに加えたら、ファイルを保存します。
|
||||
|
||||
<img align="float: right;" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
プロジェクトディレクトリに移動して`git status`を実行すると、変更がなされたことが確認できると思います。`git add`コマンドを使ってそれらの変更を適用してください。
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
次に`git commit`コマンドを使ってこれらの変更をコミットします。
|
||||
```
|
||||
git commit -m "Add <あなたの名前> to Contributors list"
|
||||
```
|
||||
`<あなたの名前>`をご自身の名前に置き換えてください。
|
||||
|
||||
## GitHubに変更をpushする
|
||||
|
||||
`git push`コマンドを使って変更をpushしてください。
|
||||
```
|
||||
git push origin <ブランチ名>
|
||||
```
|
||||
`<ブランチ名>`には先ほど作成したブランチ名を入れてください。
|
||||
|
||||
## レビューのためにプルリクエストを送る
|
||||
|
||||
GitHub上であなたのリポジトリに行くと、`Compare & pull request`ボタンが表示されます。そのボタンをクリックしてください。
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
プルリクエストを作ってください。
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
すぐに変更がこのプロジェクトのmainブランチにマージされます。マージが終了した際にはその旨のメールが送られます。
|
||||
|
||||
## 次に何をするべきか
|
||||
|
||||
おめでとうございます！ コントリビューターとして重要な _フォーク -> クローン -> 編集 -> プルリクエスト_ の基本的なワークフローが完了しました。
|
||||
|
||||
初めてのオープンソースへの貢献を祝って友達やフォロワーに[このウェブアプリ](https://firstcontributions.github.io/#social-share)を使ってシェアしましょう。
|
||||
|
||||
もし何かしら質問があるようでしたら[私たちのSlack team](https://firstcontributors.slack.com/join/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY)に入ってください。
|
||||
|
||||
他のプロジェクトへの貢献を始めましょう。簡単なイシューが立てられているプロジェクトのリストを作りました。ウェブアプリで[プロジェクトリスト](https://firstcontributions.github.io/#project-list)を確認してみてください。
|
||||
|
||||
### [追加リソース](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## その他のツールを使用したチュートリアル
|
||||
| <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) |
|
||||
@@ -1,89 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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)
|
||||
|
||||
|
||||
# ಮೊದಲ ಕೊಡುಗೆಗಳು
|
||||
|
||||
ಈ ಯೋಜನೆಯು ಆರಂಭಿಕರು ತಮ್ಮ ಮೊದಲ ಕೊಡುಗೆಯನ್ನು ನೀಡುವ ವಿಧಾನವನ್ನು ಸರಳಗೊಳಿಸುವ ಮತ್ತು ಮಾರ್ಗದರ್ಶನ ಮಾಡುವ ಗುರಿಯನ್ನು ಹೊಂದಿದೆ. ನಿಮ್ಮ ಮೊದಲ ಕೊಡುಗೆಯನ್ನು ನೀಡಲು ನೀವು ಬಯಸಿದರೆ, ಕೆಳಗಿನ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ.
|
||||
|
||||
_ನೀವು ಆಜ್ಞಾ ಸಾಲಿನೊಂದಿಗೆ ಆರಾಮದಾಯಕವಲ್ಲದಿದ್ದರೆ,[GUI ಉಪಕರಣಗಳನ್ನು ಬಳಸುವ ಟ್ಯುಟೋರಿಯಲ್ಗಳು ಇಲ್ಲಿವೆ.](#tutorials-using-other-tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
ನಿಮ್ಮ ಯಂತ್ರದಲ್ಲಿ ನೀವು ಜಿಟ್ ಹೊಂದಿಲ್ಲದಿದ್ದರೆ,[ಅದನ್ನು ಸ್ಥಾಪಿಸಿ](https://help.github.com/articles/set-up-git/)
|
||||
|
||||
## ಈ ರೀಪಾಜ಼ಟೊರೀ ಫೋರ್ಕ್ ಮಾಡಿ
|
||||
|
||||
ಈ ಪುಟದ ಮೇಲ್ಭಾಗದಲ್ಲಿರುವ ಫೋರ್ಕ್ ಬಟನ್ ಅನ್ನು ಕ್ಲಿಕ್ ಮಾಡುವ ಮೂಲಕ ಈ ರೆಪೊಸಿಟರಿಯನ್ನು ಫೋರ್ಕ್ ಮಾಡಿ.
|
||||
ಇದು ನಿಮ್ಮ ಖಾತೆಯಲ್ಲಿ ಈ ರೆಪೊಸಿಟರಿಯ ನಕಲನ್ನು ರಚಿಸುತ್ತದೆ.
|
||||
|
||||
## ರೆಪೊಸಿಟರಿ ಕ್ಲೋನ್
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
ಈಗ ನಿಮ್ಮ ಯಂತ್ರಕ್ಕೆ ಫೋರ್ಕ್ಡ್ ರೆಪೊಸಿಟರಿಯನ್ನು ಕ್ಲೋನ್ ಮಾಡಿ. ನಿಮ್ಮ GitHub ಖಾತೆಗೆ ಹೋಗಿ, ಫೋರ್ಕ್ ಮಾಡಿದ ರೆಪೊಸಿಟರಿಯನ್ನು ತೆರೆಯಿರಿ, ಕೋಡ್ ಬಟನ್ ಅನ್ನು ಕ್ಲಿಕ್ ಮಾಡಿ ಮತ್ತು ನಂತರ _copy to clipboard_ ಐಕಾನ್ ಅನ್ನು ಕ್ಲಿಕ್ ಮಾಡಿ.
|
||||
|
||||
ಟರ್ಮಿನಲ್ ತೆರೆಯಿರಿ ಮತ್ತು ಕೆಳಗಿನ git ಆಜ್ಞೆಯನ್ನು ಚಲಾಯಿಸಿ:
|
||||
|
||||
```
|
||||
git clone "url ನೀವು ಇದೀಗ ನಕಲಿಸಿದ್ದೀರಿ"
|
||||
```
|
||||
ಎಲ್ಲಿ "url ನೀವು ಇದೀಗ ನಕಲಿಸಿದ್ದೀರಿ" (ಉದ್ಧರಣ ಚಿಹ್ನೆಗಳಿಲ್ಲದೆ) ಈ ಭಂಡಾರಕ್ಕೆ url ಆಗಿದೆ (ಈ ಯೋಜನೆಯ ನಿಮ್ಮ ಫೋರ್ಕ್). Url ಪಡೆಯಲು ಹಿಂದಿನ ಹಂತಗಳನ್ನು ನೋಡಿ.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
ಉದಾಹರಣೆಗೆ:
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
ಅಲ್ಲಿ `ಇದು-ನೀವು 'ನಿಮ್ಮ ಗಿಟ್ಹಬ್ ಬಳಕೆದಾರಹೆಸರು. ಇಲ್ಲಿ ನೀವು ನಿಮ್ಮ ಕಂಪ್ಯೂಟರ್ಗೆ ಗಿಟ್ಹಬ್ನಲ್ಲಿನ ಮೊದಲ ಕೊಡುಗೆಗಳ ಭಂಡಾರದ ವಿಷಯಗಳನ್ನು ನಕಲಿಸುತ್ತಿದ್ದೀರಿ.
|
||||
## ಒಂದು ಶಾಖೆಯನ್ನು ರಚಿಸಿ
|
||||
ನಿಮ್ಮ ಕಂಪ್ಯೂಟರ್ನಲ್ಲಿ ರೆಪೊಸಿಟರಿ ಡೈರೆಕ್ಟರಿಗೆ ಬದಲಾಯಿಸಿ (ನೀವು ಈಗಾಗಲೇ ಇಲ್ಲದಿದ್ದರೆ):
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
ಈಗ `git checkout` ಆಜ್ಞೆಯನ್ನು ಬಳಸಿಕೊಂಡು ಒಂದು ಶಾಖೆಯನ್ನು ರಚಿಸಿ:
|
||||
```
|
||||
git checkout -b <ನಿಮ್ಮ ಹೊಸ-ಶಾಖೆ-ಹೆಸರನ್ನು ಸೇರಿಸಿ>
|
||||
```
|
||||
ಉದಾಹರಣೆಗೆ:
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
(ಶಾಖೆಯ ಹೆಸರಿನಲ್ಲಿ `add` ಎಂಬ ಪದವನ್ನು ಹೊಂದುವ ಅಗತ್ಯವಿಲ್ಲ, ಆದರೆ ಇದನ್ನು ಸೇರಿಸುವುದು ಸಮಂಜಸವಾದ ವಿಷಯ ಏಕೆಂದರೆ ಈ ಶಾಖೆಯ ಉದ್ದೇಶವು ನಿಮ್ಮ ಹೆಸರನ್ನು ಪಟ್ಟಿಗೆ ಸೇರಿಸುವುದು.)
|
||||
## ಅಗತ್ಯ ಬದಲಾವಣೆಗಳನ್ನು ಮಾಡಿ ಮತ್ತು ಆ ಬದಲಾವಣೆಗಳನ್ನು ಮಾಡಿ
|
||||
ಈಗ ಪಠ್ಯ ಸಂಪಾದಕದಲ್ಲಿ `Contributor.md` ಫೈಲ್ ಅನ್ನು ತೆರೆಯಿರಿ, ಅದಕ್ಕೆ ನಿಮ್ಮ ಹೆಸರನ್ನು ಸೇರಿಸಿ. ಅದನ್ನು ಫೈಲ್ನ ಪ್ರಾರಂಭ ಅಥವಾ ಕೊನೆಯಲ್ಲಿ ಸೇರಿಸಬೇಡಿ. ನಡುವೆ ಎಲ್ಲಿಯಾದರೂ ಇರಿಸಿ. ಈಗ, ಫೈಲ್ ಅನ್ನು ಉಳಿಸಿ.
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
ನೀವು ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗೆ ಹೋಗಿ `git status` ಆಜ್ಞೆಯನ್ನು ಕಾರ್ಯಗತಗೊಳಿಸಿದರೆ, ಬದಲಾವಣೆಗಳಿವೆ ಎಂದು ನೀವು ನೋಡುತ್ತೀರಿ.
|
||||
Add those changes to the branch you just created using the `git add` command:
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
ಈಗ `git commit` ಆಜ್ಞೆಯನ್ನು ಬಳಸಿಕೊಂಡು ಆ ಬದಲಾವಣೆಗಳನ್ನು ಮಾಡಿ:
|
||||
```
|
||||
git commit -m "ಕೊಡುಗೆದಾರರ ಪಟ್ಟಿಗೆ <ನಿಮ್ಮ- ಹೆಸರು> ಸೇರಿಸಿ"
|
||||
```
|
||||
ನಿಮ್ಮ ಹೆಸರಿನೊಂದಿಗೆ `<ನಿಮ್ಮ- ಹೆಸರು>` ಅನ್ನು ಬದಲಾಯಿಸುತ್ತದೆ.
|
||||
## ಬದಲಾವಣೆಗಳನ್ನು ಗಿಟ್ಹಬ್ಗೆ ಪುಶ್ ಮಾಡಿ
|
||||
`Git push` ಆಜ್ಞೆಯನ್ನು ಬಳಸಿಕೊಂಡು ನಿಮ್ಮ ಬದಲಾವಣೆಗಳನ್ನು ಒತ್ತಿರಿ:
|
||||
```
|
||||
git push origin <ನಿಮ್ಮ ಶಾಖೆಯ ಹೆಸರನ್ನು ಸೇರಿಸಿ>
|
||||
```
|
||||
`<add-your-branch-name>` ಅನ್ನು ನೀವು ಮೊದಲು ರಚಿಸಿದ ಶಾಖೆಯ ಹೆಸರಿನೊಂದಿಗೆ ಬದಲಾಯಿಸುತ್ತದೆ.
|
||||
## ನಿಮ್ಮ ಬದಲಾವಣೆಗಳನ್ನು ವಿಮರ್ಶೆಗಾಗಿ ಸಲ್ಲಿಸಿ
|
||||
ನೀವು ಗಿಟ್ಹಬ್ನಲ್ಲಿರುವ ನಿಮ್ಮ ಭಂಡಾರಕ್ಕೆ ಹೋದರೆ, ನೀವು `Compare & pull request` ಬಟನ್ ನೋಡುತ್ತೀರಿ. ಆ ಗುಂಡಿಯನ್ನು ಕ್ಲಿಕ್ ಮಾಡಿ.
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
ಈಗ ಪುಲ್ ವಿನಂತಿಯನ್ನು ಸಲ್ಲಿಸಿ.
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
ಶೀಘ್ರದಲ್ಲೇ ನಾನು ನಿಮ್ಮ ಎಲ್ಲಾ ಬದಲಾವಣೆಗಳನ್ನು ಈ ಯೋಜನೆಯ ಮಾಸ್ಟರ್ ಶಾಖೆಯಲ್ಲಿ ವಿಲೀನಗೊಳಿಸುತ್ತೇನೆ. ಬದಲಾವಣೆಗಳನ್ನು ವಿಲೀನಗೊಳಿಸಿದ ನಂತರ ನೀವು ಅಧಿಸೂಚನೆ ಇಮೇಲ್ ಅನ್ನು ಪಡೆಯುತ್ತೀರಿ.
|
||||
## ಇಂದಿನಿಂದ ಏನು?
|
||||
ಅಭಿನಂದನೆಗಳು! ನೀವು ಕೊಡುಗೆದಾರರಾಗಿ ಆಗಾಗ್ಗೆ ಎದುರಾಗುವ ಪ್ರಮಾಣಿತ _fork -> clone -> edit -> PR_ ವರ್ಕ್ಫ್ಲೋ ಅನ್ನು ನೀವು ಇದೀಗ ಪೂರ್ಣಗೊಳಿಸಿದ್ದೀರಿ!
|
||||
ನಿಮ್ಮ ಕೊಡುಗೆಯನ್ನು ಆಚರಿಸಿ ಮತ್ತು ಅದನ್ನು ನಿಮ್ಮ ಸ್ನೇಹಿತರು ಮತ್ತು ಅನುಯಾಯಿಗಳೊಂದಿಗೆ ಹಂಚಿಕೊಳ್ಳಿ [ವೆಬ್ ಅಪ್ಲಿಕೇಶನ್](https://firstcontributions.github.io/#social-share).
|
||||
ನೀವು ಹೆಚ್ಚಿನ ಅಭ್ಯಾಸವನ್ನು ಬಯಸಿದರೆ, ಪರಿಶೀಲಿಸಿ [ಕೋಡ್ ಕೊಡುಗೆಗಳು](https://github.com/roshanjossey/code-contributions).
|
||||
ಈಗ ನೀವು ಹೆಚ್ಚಿನ ಯೋಜನೆಗಳಿಗೆ ಕೊಡುಗೆ ನೀಡಲು ಪ್ರಾರಂಭಿಸಬಹುದು. ನಾವು ನಿಮಗಾಗಿ ಒಂದು ಪಟ್ಟಿಯನ್ನು ತಯಾರಿಸಿದ್ದೇವೆ ಅದು ಬಹಳ ಸುಲಭವಾದ ಸಮಸ್ಯೆಗಳು. [ಯೋಜನೆಗಳ ಪಟ್ಟಿ](https://firstcontributions.github.io/#project-list)
|
||||
## ಇತರ ಪರಿಕರಗಳನ್ನು ಬಳಸುವ ಟ್ಯುಟೋರಿಯಲ್
|
||||
| <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) |
|
||||
@@ -1,222 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
#### _អានឯកសារនេះជា [ភាសាផ្សេង](translations/Translations.md)._
|
||||
|
||||
<kbd>[<img title="Shqip" alt="Shqip" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/al.svg" width="22">](translations/README.al.md)</kbd>
|
||||
<kbd>[<img title="Armenian" alt="Armenian" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/am.svg" width="22">](translations/README.arm.md)</kbd>
|
||||
<kbd>[<img title="Uzbek" alt="Uzbek language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/uz.svg" width="22">](translations/README.uz.md)</kbd>
|
||||
<kbd>[<img title="Azərbaycan dili" alt="Azərbaycan dili" src="https://cdn.statically.io/flags/az.svg" width="22">](translations/README.aze.md)</kbd>
|
||||
<kbd>[<img title="বাংলা" alt="বাংলা" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/bd.svg" width="22">](translations/README.bn.md)</kbd>
|
||||
<kbd>[<img title="Bulgarian" alt="Bulgarian" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/bg.svg" width="22">](translations/README.bg.md)</kbd>
|
||||
<kbd>[<img title="Português (Brasil)" alt="Português (Brasil)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/br.svg" width="22">](translations/README.pt_br.md)</kbd>
|
||||
<kbd>[<img title="Català" alt="Català" src="https://firstcontributions.github.io/assets/Readme/catalan1.png" width="22">](translations/README.ca.md)</kbd>
|
||||
<kbd>[<img title="中文 (Simplified)" alt="中文 (Simplified)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/cn.svg" width="22">](translations/README.zh-cn.md)</kbd>
|
||||
<kbd>[<img title="Czech" alt="Czech" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/cz.svg" width="22">](translations/README.cs.md)</kbd>
|
||||
<kbd>[<img title="Deutsch" alt="Deutsch" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/de.svg" width="22">](translations/README.de.md)</kbd>
|
||||
<kbd>[<img title="Dansk" alt="Dansk" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/dk.svg" width="22">](translations/README.da.md)</kbd>
|
||||
<kbd>[<img title="العربية" alt="العربية" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/eg.svg" width="22">](translations/README.eg.md)</kbd>
|
||||
<kbd>[<img title="Dezéiriya" alt="Dezéiriya" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/dz.svg" width="22">](translations/README.dz.md)</kbd>
|
||||
<kbd>[<img title="Española" alt="Española" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/es.svg" width="22">](translations/README.es.md)</kbd>
|
||||
<kbd>[<img title="Française" alt="Française" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/fr.svg" width="22">](translations/README.fr.md)</kbd>
|
||||
<kbd>[<img title="Gaeilge" alt="Gaeilge" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ie.svg" width="22">](translations/README.ga.md)</kbd>
|
||||
<kbd>[<img title="Galego" alt="Galego" src="https://upload.wikimedia.org/wikipedia/commons/thumb/6/64/Flag_of_Galicia.svg/1200px-Flag_of_Galicia.svg.png" width="22">](translations/README.gl.md)</kbd>
|
||||
<kbd>[<img title="Ελληνικά" alt="Ελληνικά" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/gr.svg" width="22">](translations/README.gr.md)</kbd>
|
||||
<kbd>[<img title="ქართული" alt="ქართული" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ge.svg" width="22">](translations/README.ge.md)</kbd>
|
||||
<kbd>[<img title="Magyar" alt="Magyar" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/hu.svg" width="22">](translations/README.hu.md)</kbd>
|
||||
<kbd>[<img title="Bahasa Indonesia" alt="Bahasa Indonesia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/id.svg" width="22">](translations/README.id.md)</kbd>
|
||||
<kbd>[<img title="עִברִית" alt="עִברִית" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/il.svg" width="22">](translations/README.hb.md)</kbd>
|
||||
<kbd>[<img title="हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்" alt="हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/in.svg" width="22">](translations/Translations.md)</kbd>
|
||||
<kbd>[<img title="தமிழ்" alt="தமிழ்" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lk.svg" width="22">](translations/README.ta.md)</kbd>
|
||||
<kbd>[<img title="فارسی" alt="فارسی" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ir.svg" width="22">](translations/README.fa.md)</kbd>
|
||||
<kbd>[<img title="پښتو" alt="پښتو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/af.svg" width="22">](translations/README.pus.md)</kbd>
|
||||
<kbd>[<img title="Italiano" alt="Italiano" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/it.svg" width="22">](translations/README.it.md)</kbd>
|
||||
<kbd>[<img title="日本語" alt="日本語" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/jp.svg" width="22">](translations/README.ja.md)</kbd>
|
||||
<kbd>[<img title="සිංහල" alt="සිංහල" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lk.svg" width="22">](translations/README.si.md)</kbd>
|
||||
<kbd>[<img title="Kiswahili (Kenya)" alt="Kiswahili (Kenya)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ke.svg" width="22">](translations/README.kws.md)</kbd>
|
||||
<kbd>[<img title="한국어" alt="한국어" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kr.svg" width="22">](translations/README.ko.md)</kbd>
|
||||
<kbd>[<img title="Lietuvių kalba" alt="Lietuvių kalba" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lt.svg" width="22">](translations/README.lt.md)</kbd>
|
||||
<kbd>[<img title="Limba Română" alt="Limba Română" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/md.svg" width="22"> <img title="Limba Română" alt="Limba Română" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ro.svg" width="22">](translations/README.ro.md)</kbd>
|
||||
<kbd>[<img title="မြန်မာ" alt="မြန်မာ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mm.svg" width="22">](translations/README.mm_unicode.md)</kbd>
|
||||
<kbd>[<img title="Македонски" alt="Македонски" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mk.svg" width="22">](translations/README.mk.md)</kbd>
|
||||
<kbd>[<img title="Español de México" alt="Español de México" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mx.svg" width="22">](translations/README.mx.md)</kbd>
|
||||
<kbd>[<img title="Bahasa Melayu / بهاس ملايو / Malay" alt="Bahasa Melayu / بهاس ملايو / Malay" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/my.svg" width="22">](translations/README.my.md)</kbd>
|
||||
<kbd>[<img title="Dutch" alt="Dutch" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/nl.svg" width="22">](translations/README.nl.md)</kbd>
|
||||
<kbd>[<img title="Norsk" alt="Norsk" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/no.svg" width="22">](translations/README.no.md)</kbd>
|
||||
<kbd>[<img title="नेपाली" alt="नेपाली" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/np.svg" width="15">](translations/README.np.md)</kbd>
|
||||
<kbd>[<img title="Wikang Filipino" alt="Wikang Filipino" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ph.svg" width="22">](translations/README.tl.md)</kbd>
|
||||
<kbd>[<img title="English (Pirate)" alt="English (Pirate)" src="https://firstcontributions.github.io/assets/Readme/pirate.png" width="22">](translations/README.en-pirate.md)</kbd>
|
||||
<kbd>[<img title="اُاردو" alt="اردو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pk.svg" width="22">](translations/README.ur.md)</kbd>
|
||||
<kbd>[<img title="Polski" alt="Polski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pl.svg" width="22">](translations/README.pl.md)</kbd>
|
||||
<kbd>[<img title="Português (Portugal)" alt="Português (Portugal)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pt.svg" width="22">](translations/README.pt-pt.md)</kbd>
|
||||
<kbd>[<img title="Русский язык" alt="Русский язык" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ru.svg" width="22">](translations/README.ru.md)</kbd>
|
||||
<kbd>[<img title="عربى" alt="عربى" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/sa.svg" width="22">](translations/README.ar.md)</kbd>
|
||||
<kbd>[<img title="Svenska" alt="Svenska" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/se.svg" width="22">](translations/README.se.md)</kbd>
|
||||
<kbd>[<img title="Slovenčina" alt="Slovenčina" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/sk.svg" width="22">](translations/README.slk.md)</kbd>
|
||||
<kbd>[<img title="Slovenščina" alt="Slovenščina" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/si.svg" width="22">](translations/README.sl.md)</kbd>
|
||||
<kbd>[<img title="ภาษาไทย" alt="ภาษาไทย" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/th.svg" width="22">](translations/README.th.md)</kbd>
|
||||
<kbd>[<img title="Türkçe" alt="Türkçe" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tr.svg" width="22">](translations/README.tr.md)</kbd>
|
||||
<kbd>[<img title="中文(Traditional)" alt="中文(Traditional)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tw.svg" width="22">](translations/README.zh-tw.md)</kbd>
|
||||
<kbd>[<img title="Українська" alt="Українська" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ua.svg" width="22">](translations/README.ua.md)</kbd>
|
||||
<kbd>[<img title="Tiếng Việt" alt="Tiếng Việt" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/vn.svg" width="22">](translations/README.vn.md)</kbd>
|
||||
<kbd>[<img title="Tanzania" alt="Swahili language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tz.svg" width="22">](translations/README.sw.md)</kbd>
|
||||
<kbd>[<img title="Zulu (South Africa)" alt="Zulu (South Africa)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/za.svg" width="22">](translations/README.zul.md)</kbd>
|
||||
<kbd>[<img title="Afrikaans (South Africa)" alt="Afrikaans (South Africa)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/za.svg" width="22">](translations/README.afk.md)</kbd>
|
||||
<kbd>[<img title="Igbo (Nigeria)" alt="Igbo (Nigeria)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ng.svg" width="22">](translations/README.igb.md)</kbd>
|
||||
<kbd>[<img title="Yoruba (Nigeria)" alt="Yoruba (Nigeria)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ng.svg" width="22">](translations/README.yor.md)</kbd>
|
||||
<kbd>[<img title="Hausa (Nigeria)" alt="Hausa (Nigeria)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ng.svg" width="22">](translations/README.hau.md)</kbd>
|
||||
<kbd>[<img title="Latvia" alt="Latvia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lv.svg" width="22">](translations/README.lv.md)</kbd>
|
||||
<kbd>[<img title="Suomeksi" alt="Suomeksi" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/fi.svg" width="22">](translations/README.fi.md)</kbd>
|
||||
<kbd>[<img title="Беларуская мова" alt="Беларуская мова" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/by.svg" width="22">](translations/README.by.md)</kbd>
|
||||
<kbd>[<img title="Српски" alt="Српски" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/rs.svg" width="22">](translations/README.sr.md)</kbd>
|
||||
<kbd>[<img title="Қазақша" alt="Қазақша" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kz.svg" width="22">](translations/README.kz.md)</kbd>
|
||||
<kbd>[<img title="Bosanski" alt="Bosanski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ba.svg" width="22">](translations/README.bih.md)</kbd>
|
||||
<kbd>[<img title="Bosanski" alt="Bosanski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/et.svg" width="22">](translations/README.bih.md)</kbd>
|
||||
<kbd>[<img title="Hrvatski" alt="Hrvatski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/hr.svg" width="22">](translations/README.hr.md)</kbd>
|
||||
<kbd>[<img title="پښتو" alt="پښتو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/af.svg" width="22">](translations/README.ps.md)</kbd>
|
||||
<kbd>[<img title="Af-soomaali" alt="Somalia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/so.svg" width="22">](translations/README.so.md)</kbd>
|
||||
<kbd>[<img title="Español de Ecuador" alt="Ecuador" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ec.svg" width="22">](translations/README.ec.md)</kbd>
|
||||
<kbd>[<img title="Turkmen" alt="Turkmen language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tm.svg" width="22">](translations/README.tm.md)</kbd>
|
||||
<kbd>[<img title="Ewe (TOGO)" alt="Ewe (TOGO)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tg.svg" width="22">](translations/README.ewe.md)</kbd>
|
||||
<kbd>[<img title="አማርኛ" alt="አማርኛ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/et.svg" width="22">](translations/README.et.md)</kbd>
|
||||
<kbd>[<img title="ភាសាខ្មែរ" alt="ភាសាខ្មែរ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kh.svg" width="22">](translations/README.kh.md)</kbd>
|
||||
|
||||
# ការរួមចំណែកជាលើកដំបូង
|
||||
|
||||
គម្រោងនេះមានគោលបំណងធ្វើឱ្យសាមញ្ញ និងណែនាំពីរបៀបដែលអ្នកចាប់ផ្តើមធ្វើការរួមចំណែកដំបូងរបស់ពួកគេ។ ប្រសិនបើអ្នកកំពុងស្វែងរកការរួមចំណែកដំបូងរបស់អ្នក សូមអនុវត្តតាមជំហានខាងក្រោម។
|
||||
|
||||
_ប្រសិនបើអ្នកមិនសូវស្រួលជាមួយបន្ទាត់ពាក្យបញ្ជាទេ [នេះគឺជាការបង្រៀនដោយប្រើឧបករណ៍ GUI ។](#tutorials-using-other-tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### ប្រសិនបើអ្នកមិនមាន git នៅលើម៉ាស៊ីនរបស់អ្នក [សូមដំឡើង](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## ស៊ាំសាខានេះ (Fork this repository)
|
||||
|
||||
សូមស៊ាំសាខានេះដោយចុចលើប៊ូតុង Fork ដែលនៅផ្នែកខាងលើនៃទំព័រនេះ។
|
||||
វានឹងបង្កើតច្បាប់ចម្លងនៃសាខានេះក្នុងគណនីរបស់អ្នក។
|
||||
|
||||
## ចម្លងសាខានេះ (Clone the repository)
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
ឥឡូវនេះ ចម្លងសាខាដែលអ្នកបានស៊ាំទៅកាន់កុំព្យូទ័ររបស់អ្នក។ ចូលទៅគណនី GitHub របស់អ្នក បើកសាខាដែលបានស៊ាំ ចុចលើប៊ូតុង Code ហើយចុចលើរូបតំណាង _copy to clipboard_។
|
||||
|
||||
បើក terminal ហើយដំណើរការពាក្យបញ្ជា git ខាងក្រោម៖
|
||||
|
||||
```bash
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
កន្លែងដែល "url ដែលអ្នកទើបតែចម្លង" (ដោយគ្មានសញ្ញាសម្រង់) គឺជា url ទៅកាន់ឃ្លាំងនេះ (ចំនុចប្រសព្វរបស់អ្នកនៃគម្រោងនេះ)។ សូមមើលជំហានមុនដើម្បីទទួលបាន url ។
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
ឧទាហរណ៍៖
|
||||
|
||||
```bash
|
||||
git clone git@github.com:this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
កន្លែងដែល `this-is-you` គឺជាឈ្មោះអ្នកប្រើប្រាស់ GitHub របស់អ្នក។ នៅទីនេះអ្នកកំពុងចម្លងមាតិកានៃឃ្លាំងការរួមចំណែកដំបូងនៅលើ GitHub ទៅកាន់កុំព្យូទ័ររបស់អ្នក។
|
||||
|
||||
## បង្កើតសាខាថ្មី (Create a branch)
|
||||
|
||||
ផ្លាស់ប្តូរទៅថតឃ្លាំងនៅលើកុំព្យូទ័ររបស់អ្នក (ប្រសិនបើអ្នកមិនទាន់នៅទីនោះ)៖
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
ឥឡូវបង្កើតសាខាមួយដោយប្រើពាក្យបញ្ជា 'git switch'៖
|
||||
|
||||
```bash
|
||||
git switch -c your-new-branch-name
|
||||
```
|
||||
|
||||
ឧទាហរណ៍៖
|
||||
|
||||
```bash
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
## កែប្រែលើកែលម្អដែលចាំបាច់ និងធ្វើការប្តិត (commit) ប្រែប្រួលទាំងនោះ
|
||||
|
||||
ឥឡូវនេះបើកឯកសារ 'Contributors.md' នៅក្នុងកម្មវិធីនិពន្ធអត្ថបទ បន្ថែមឈ្មោះរបស់អ្នកទៅវា។ កុំបន្ថែមវានៅដើម ឬចុងបញ្ចប់នៃឯកសារ។ ដាក់វានៅកន្លែងណាមួយនៅចន្លោះ។ ឥឡូវនេះរក្សាទុកឯកសារ។
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
ប្រសិនបើអ្នកចូលទៅកាន់ថតគម្រោង ហើយប្រតិបត្តិពាក្យបញ្ជា 'git status' អ្នកនឹងឃើញមានការផ្លាស់ប្តូរ។
|
||||
|
||||
បន្ថែមការផ្លាស់ប្តូរទាំងនោះទៅសាខាដែលអ្នកទើបតែបង្កើតដោយប្រើពាក្យបញ្ជា `git add`៖
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
ឥឡូវនេះធ្វើការផ្លាស់ប្តូរទាំងនោះដោយប្រើពាក្យបញ្ជា 'git commit'៖
|
||||
|
||||
```bash
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
ជំនួស 'ឈ្មោះរបស់អ្នក' ជាមួយឈ្មោះរបស់អ្នក។
|
||||
|
||||
## ផ្តួលប្រែប្រួលទៅ GitHub (Push changes to GitHub)
|
||||
|
||||
រុញការផ្លាស់ប្តូររបស់អ្នកដោយប្រើពាក្យបញ្ជា 'git push':
|
||||
|
||||
```bash
|
||||
git push -u origin your-branch-name
|
||||
```
|
||||
|
||||
ជំនួស `your-branch-name` ជាមួយនឹងឈ្មោះសាខាដែលអ្នកបានបង្កើតមុន។
|
||||
|
||||
<details>
|
||||
<summary> <strong>ប្រសិនបើអ្នកទទួលបានកំហុសណាមួយនៅពេលរុញ សូមចុចទីនេះ៖</strong> </summary>
|
||||
|
||||
- ### កំហុសនៅក្នុងការ Authentication (Authentication Error)
|
||||
<pre>remote: ការគាំទ្រសម្រាប់ការបញ្ចូលពាក្យសម្ងាត់ត្រូវបានដកហូតនៅថ្ងៃទី 13 ខែសីហា ឆ្នាំ 2021។ សូមប្រើ **Personal Access Token** ជំនួស។
|
||||
remote: សូមមើល https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ សម្រាប់ព័ត៌មានបន្ថែម។
|
||||
fatal: ការ Authenticate បរាជ័យសម្រាប់ 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
សូមចូលទៅកាន់ [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ដើម្បីបង្កើត និងកំណត់រចនាសម្ព័ន្ធ SSH Key ទៅក្នុងគណនី GitHub របស់អ្នក។
|
||||
</details>
|
||||
|
||||
## ដាក់បញ្ជូនការផ្លាស់ប្តូររបស់អ្នកសម្រាប់ការពិនិត្យ
|
||||
|
||||
ប្រសិនបើអ្នកចូលទៅកាន់ឃ្លាំងរបស់អ្នកនៅលើ GitHub អ្នកនឹងឃើញប៊ូតុង 'Compare & pull request' ។ ចុចលើប៊ូតុងនោះ។
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
ឥឡូវនេះដាក់សំណើទាញ។
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
ឆាប់ៗនេះ ខ្ញុំនឹងបញ្ចូលការផ្លាស់ប្តូររបស់អ្នកទាំងអស់ទៅក្នុងសាខាចម្បងនៃគម្រោងនេះ។ អ្នកនឹងទទួលបានអ៊ីមែលជូនដំណឹង នៅពេលដែលការផ្លាស់ប្តូរត្រូវបានបញ្ចូលគ្នា។
|
||||
|
||||
## តើត្រូវទៅណាពីទីនេះ?
|
||||
|
||||
អបអរសាទរ! អ្នកទើបតែបានបញ្ចប់ស្តង់ដារ _fork -> clone -> edit -> pull request_ workflow ដែលអ្នកនឹងជួបប្រទះជាញឹកញាប់ក្នុងនាមជាអ្នករួមចំណែក!
|
||||
|
||||
អបអរសាទរការរួមចំណែករបស់អ្នក ហើយចែករំលែកវាជាមួយមិត្តភក្តិ និងអ្នកដើរតាមរបស់អ្នកដោយចូលទៅកាន់ [កម្មវិធីគេហទំព័រ](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
អ្នកអាចចូលរួមជាមួយក្រុម slack របស់យើង ប្រសិនបើអ្នកត្រូវការជំនួយ ឬមានសំណួរណាមួយ។ [ចូលរួមក្រុម slack](https://firstcontributors.slack.com/join/shared_invite/zt-29qhyr9lt-Bi7WLbgGIFqV7aCEG_grvg#/shared-invite/email).
|
||||
|
||||
ឥឡូវនេះ ចូរអ្នកចាប់ផ្តើមជាមួយនឹងការរួមចំណែកដល់គម្រោងផ្សេងទៀត។ យើងបានចងក្រងបញ្ជីគម្រោងដែលមានបញ្ហាងាយស្រួលដែលអ្នកអាចចាប់ផ្តើមបាន។ ពិនិត្យមើល [បញ្ជីគម្រោងក្នុងកម្មវិធីបណ្ដាញ](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [សម្ភារៈបន្ថែម](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## ការបង្រៀនដោយប្រើឧបករណ៍ផ្សេងទៀត
|
||||
|
||||
| <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/2/2d/Visual_Studio_Code_1.18_icon.svg" 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) |
|
||||
|
||||
<p>គម្រោងនេះត្រូវបានគាំទ្រដោយ៖</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,141 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# 첫 기여
|
||||
|
||||
이 프로젝트는 초보자가 처음으로 오픈소스에 기여할 수 있도록 쉽게 안내하는 것을 목표로 합니다. 첫 번째 기여를 하고 싶다면, 아래의 설명을 따라주세요.
|
||||
|
||||
_만약 명령어 인터페이스에 익숙하지 않다면, [여기에서 GUI 도구 튜토리얼을 참고하세요.](#다른-도구들을-사용한-튜토리얼)._
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="이 저장소 포크하기" />
|
||||
|
||||
#### 만약, git이 설치되어있지 않다면 [설치하세요](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## 저장소 포크하기
|
||||
|
||||
이 저장소 페이지의 상단에 있는 Fork 버튼을 클릭해서 저장소를 포크하세요. 그러면 본인의 깃허브 계정에 이 저장소의 복사본이 생성됩니다.
|
||||
|
||||
## 저장소 클론하기
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="이 저장소 복제하기" />
|
||||
|
||||
이제 fork한 저장소를 자신의 기기에 클론하세요. 깃허브 계정의 fork한 저장소에 들어가서, Code 버튼을 클릭하고, _클립보드로 url 복사_ 아이콘을 클릭합니다.
|
||||
|
||||
터미널을 열고 다음 git 명령을 실행합니다:
|
||||
|
||||
```bash
|
||||
git clone "방금 복사한 URL"
|
||||
```
|
||||
|
||||
위에 (따옴표를 제외한) "방금 복사한 URL"은 이 저장소의 URL입니다. URL은 이전 단계에서 찾을 수 있습니다.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="URL을 클립보드로 복사" />
|
||||
|
||||
예시:
|
||||
|
||||
```bash
|
||||
git clone git@github.com:this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
`this-is-you`에 해당하는 부분을 본인의 깃허브 계정명으로 바꾸어주세요. 이 명령어는 깃허브의 first-contributions 저장소를 자신의 컴퓨터로 복사합니다.
|
||||
|
||||
## 브랜치 생성하기
|
||||
|
||||
(아직 저장소 디렉토리가 아니라면) 아래의 명령어를 입력해서 조금 전에 컴퓨터에 복사한 저장소 디렉토리로 이동합니다.
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
그리고 `git switch` 명령어를 입력해서 브랜치를 생성합니다.
|
||||
|
||||
```bash
|
||||
git switch -c your-new-branch-name
|
||||
```
|
||||
|
||||
예시:
|
||||
|
||||
```bash
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
## 필요한 부분을 변경하고 변경사항을 커밋하기
|
||||
|
||||
이제 텍스트 편집기에서 `Contributors.md` 파일을 열고 본인의 이름을 아래와 같이 추가해주세요. 파일의 시작 부분이나 마지막 부분에 추가해서는 안됩니다. 중간 부분의 마음에 드는 곳에 추가하면 됩니다. 그리고 파일을 저장하세요.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
프로젝트 디렉토리로 이동해서 `git status` 명령어를 실행하면 변경사항이 존재하는 것을 볼 수 있습니다.
|
||||
|
||||
변경사항을 `git add` 명령어를 사용해서 조금 전에 생성한 브랜치에 추가합니다.
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
이제 `git commit` 명령어를 사용해서 변경사항을 커밋합니다.
|
||||
|
||||
```bash
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
`your-name`을 본인 이름으로 변경하세요.
|
||||
|
||||
## 변경사항을 깃허브에 푸시하기
|
||||
|
||||
`git push` 명령어로 변경사항을 푸시합니다.
|
||||
|
||||
```bash
|
||||
git push -u origin your-branch-name
|
||||
```
|
||||
|
||||
`your-branch-name` 부분을 조금 전에 생성한 브랜치 이름으로 변경하세요.
|
||||
|
||||
<details>
|
||||
<summary> <strong>푸시하는 중에 에러가 발생했다면, 여기를 클릭하세요:</strong> </summary>
|
||||
|
||||
- ### Authentication Error
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
[깃허브 튜토리얼](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)로 이동해서 본인의 계정에 SSH key 생성 및 설정에 대한 정보를 얻을 수 있습니다.
|
||||
|
||||
</details>
|
||||
|
||||
## 검토를 위해 변경사항을 제출하기
|
||||
|
||||
이제 본인의 깃허브 저장소로 이동하면 `Compare & pull request` 버튼을 볼 수 있습니다. 버튼을 클릭하세요.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="풀 요청
|
||||
생성하기" />
|
||||
|
||||
이제 풀 요청(Pull Request)을 제출합니다.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="풀 요청 제출하기"
|
||||
/>
|
||||
|
||||
이제 여러분의 변경사항을 담당자가 확인한 후에 main 브랜치에 병합 하게 되면 알림 메일을 받을 수 있습니다.
|
||||
|
||||
## 첫 기여, 그리고 그 후
|
||||
|
||||
축하합니다! 앞으로 기여자로서 자주 사용하게될 기본 워크플로우인 _포크(fork) -> 클론(clone) -> 수정(edit) -> 풀 요청(pull request)_, 를 완료했습니다!
|
||||
|
||||
첫 기여에 대한 소식을 친구들 및 팔로워에게 [웹 앱](https://firstcontributions.github.io/#social-share)을 통해 공유해보세요.
|
||||
|
||||
이제 다른 프로젝트에도 기여해보세요! 지금 바로 시작할 수 있는 난이도가 낮은 이슈들로 가득찬 목록이 있습니다. [웹앱의 프로젝트 목록](https://firstcontributions.github.io/#project-list)에서 확인해보세요.
|
||||
|
||||
### [추가 자료](../additional-material/translations/Korean/additional-material.ko.md)
|
||||
|
||||
## 다른 도구들을 사용한 튜토리얼
|
||||
|
||||
| <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/2/2d/Visual_Studio_Code_1.18_icon.svg" 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) |
|
||||
|
||||
<p>This project is supported by:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,222 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
#### _Read this in [other languages](translations/Translations.md)._
|
||||
|
||||
<kbd>[<img title="Shqip" alt="Shqip" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/al.svg" width="22">](translations/README.al.md)</kbd>
|
||||
<kbd>[<img title="Armenian" alt="Armenian" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/am.svg" width="22">](translations/README.arm.md)</kbd>
|
||||
<kbd>[<img title="Uzbek" alt="Uzbek language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/uz.svg" width="22">](translations/README.uz.md)</kbd>
|
||||
<kbd>[<img title="Azərbaycan dili" alt="Azərbaycan dili" src="https://cdn.statically.io/flags/az.svg" width="22">](translations/README.aze.md)</kbd>
|
||||
<kbd>[<img title="বাংলা" alt="বাংলা" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/bd.svg" width="22">](translations/README.bn.md)</kbd>
|
||||
<kbd>[<img title="Bulgarian" alt="Bulgarian" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/bg.svg" width="22">](translations/README.bg.md)</kbd>
|
||||
<kbd>[<img title="Português (Brasil)" alt="Português (Brasil)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/br.svg" width="22">](translations/README.pt_br.md)</kbd>
|
||||
<kbd>[<img title="Català" alt="Català" src="https://firstcontributions.github.io/assets/Readme/catalan1.png" width="22">](translations/README.ca.md)</kbd>
|
||||
<kbd>[<img title="中文 (Simplified)" alt="中文 (Simplified)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/cn.svg" width="22">](translations/README.zh-cn.md)</kbd>
|
||||
<kbd>[<img title="Czech" alt="Czech" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/cz.svg" width="22">](translations/README.cs.md)</kbd>
|
||||
<kbd>[<img title="Deutsch" alt="Deutsch" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/de.svg" width="22">](translations/README.de.md)</kbd>
|
||||
<kbd>[<img title="Dansk" alt="Dansk" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/dk.svg" width="22">](translations/README.da.md)</kbd>
|
||||
<kbd>[<img title="العربية" alt="العربية" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/eg.svg" width="22">](translations/README.eg.md)</kbd>
|
||||
<kbd>[<img title="Dezéiriya" alt="Dezéiriya" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/dz.svg" width="22">](translations/README.dz.md)</kbd>
|
||||
<kbd>[<img title="Española" alt="Española" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/es.svg" width="22">](translations/README.es.md)</kbd>
|
||||
<kbd>[<img title="Française" alt="Française" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/fr.svg" width="22">](translations/README.fr.md)</kbd>
|
||||
<kbd>[<img title="Gaeilge" alt="Gaeilge" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ie.svg" width="22">](translations/README.ga.md)</kbd>
|
||||
<kbd>[<img title="Galego" alt="Galego" src="https://upload.wikimedia.org/wikipedia/commons/thumb/6/64/Flag_of_Galicia.svg/1200px-Flag_of_Galicia.svg.png" width="22">](translations/README.gl.md)</kbd>
|
||||
<kbd>[<img title="Ελληνικά" alt="Ελληνικά" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/gr.svg" width="22">](translations/README.gr.md)</kbd>
|
||||
<kbd>[<img title="ქართული" alt="ქართული" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ge.svg" width="22">](translations/README.ge.md)</kbd>
|
||||
<kbd>[<img title="Magyar" alt="Magyar" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/hu.svg" width="22">](translations/README.hu.md)</kbd>
|
||||
<kbd>[<img title="Bahasa Indonesia" alt="Bahasa Indonesia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/id.svg" width="22">](translations/README.id.md)</kbd>
|
||||
<kbd>[<img title="עִברִית" alt="עִברִית" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/il.svg" width="22">](translations/README.hb.md)</kbd>
|
||||
<kbd>[<img title="हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்" alt="हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/in.svg" width="22">](translations/Translations.md)</kbd>
|
||||
<kbd>[<img title="தமிழ்" alt="தமிழ்" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lk.svg" width="22">](translations/README.ta.md)</kbd>
|
||||
<kbd>[<img title="فارسی" alt="فارسی" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ir.svg" width="22">](translations/README.fa.md)</kbd>
|
||||
<kbd>[<img title="پښتو" alt="پښتو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/af.svg" width="22">](translations/README.pus.md)</kbd>
|
||||
<kbd>[<img title="Italiano" alt="Italiano" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/it.svg" width="22">](translations/README.it.md)</kbd>
|
||||
<kbd>[<img title="日本語" alt="日本語" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/jp.svg" width="22">](translations/README.ja.md)</kbd>
|
||||
<kbd>[<img title="සිංහල" alt="සිංහල" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lk.svg" width="22">](translations/README.si.md)</kbd>
|
||||
<kbd>[<img title="Kiswahili (Kenya)" alt="Kiswahili (Kenya)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ke.svg" width="22">](translations/README.kws.md)</kbd>
|
||||
<kbd>[<img title="한국어" alt="한국어" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kr.svg" width="22">](translations/README.ko.md)</kbd>
|
||||
<kbd>[<img title="Lietuvių kalba" alt="Lietuvių kalba" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lt.svg" width="22">](translations/README.lt.md)</kbd>
|
||||
<kbd>[<img title="Limba Română" alt="Limba Română" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/md.svg" width="22"> <img title="Limba Română" alt="Limba Română" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ro.svg" width="22">](translations/README.ro.md)</kbd>
|
||||
<kbd>[<img title="မြန်မာ" alt="မြန်မာ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mm.svg" width="22">](translations/README.mm_unicode.md)</kbd>
|
||||
<kbd>[<img title="Македонски" alt="Македонски" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mk.svg" width="22">](translations/README.mk.md)</kbd>
|
||||
<kbd>[<img title="Español de México" alt="Español de México" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mx.svg" width="22">](translations/README.mx.md)</kbd>
|
||||
<kbd>[<img title="Bahasa Melayu / بهاس ملايو / Malay" alt="Bahasa Melayu / بهاس ملايو / Malay" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/my.svg" width="22">](translations/README.my.md)</kbd>
|
||||
<kbd>[<img title="Dutch" alt="Dutch" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/nl.svg" width="22">](translations/README.nl.md)</kbd>
|
||||
<kbd>[<img title="Norsk" alt="Norsk" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/no.svg" width="22">](translations/README.no.md)</kbd>
|
||||
<kbd>[<img title="नेपाली" alt="नेपाली" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/np.svg" width="15">](translations/README.np.md)</kbd>
|
||||
<kbd>[<img title="Wikang Filipino" alt="Wikang Filipino" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ph.svg" width="22">](translations/README.tl.md)</kbd>
|
||||
<kbd>[<img title="English (Pirate)" alt="English (Pirate)" src="https://firstcontributions.github.io/assets/Readme/pirate.png" width="22">](translations/README.en-pirate.md)</kbd>
|
||||
<kbd>[<img title="اُاردو" alt="اردو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pk.svg" width="22">](translations/README.ur.md)</kbd>
|
||||
<kbd>[<img title="Polski" alt="Polski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pl.svg" width="22">](translations/README.pl.md)</kbd>
|
||||
<kbd>[<img title="Português (Portugal)" alt="Português (Portugal)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pt.svg" width="22">](translations/README.pt-pt.md)</kbd>
|
||||
<kbd>[<img title="Русский язык" alt="Русский язык" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ru.svg" width="22">](translations/README.ru.md)</kbd>
|
||||
<kbd>[<img title="عربى" alt="عربى" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/sa.svg" width="22">](translations/README.ar.md)</kbd>
|
||||
<kbd>[<img title="Svenska" alt="Svenska" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/se.svg" width="22">](translations/README.se.md)</kbd>
|
||||
<kbd>[<img title="Slovenčina" alt="Slovenčina" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/sk.svg" width="22">](translations/README.slk.md)</kbd>
|
||||
<kbd>[<img title="Slovenščina" alt="Slovenščina" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/si.svg" width="22">](translations/README.sl.md)</kbd>
|
||||
<kbd>[<img title="ภาษาไทย" alt="ภาษาไทย" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/th.svg" width="22">](translations/README.th.md)</kbd>
|
||||
<kbd>[<img title="Türkçe" alt="Türkçe" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tr.svg" width="22">](translations/README.tr.md)</kbd>
|
||||
<kbd>[<img title="中文(Traditional)" alt="中文(Traditional)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tw.svg" width="22">](translations/README.zh-tw.md)</kbd>
|
||||
<kbd>[<img title="Українська" alt="Українська" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ua.svg" width="22">](translations/README.ua.md)</kbd>
|
||||
<kbd>[<img title="Tiếng Việt" alt="Tiếng Việt" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/vn.svg" width="22">](translations/README.vn.md)</kbd>
|
||||
<kbd>[<img title="Tanzania" alt="Swahili language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tz.svg" width="22">](translations/README.sw.md)</kbd>
|
||||
<kbd>[<img title="Zulu (South Africa)" alt="Zulu (South Africa)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/za.svg" width="22">](translations/README.zul.md)</kbd>
|
||||
<kbd>[<img title="Afrikaans (South Africa)" alt="Afrikaans (South Africa)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/za.svg" width="22">](translations/README.afk.md)</kbd>
|
||||
<kbd>[<img title="Igbo (Nigeria)" alt="Igbo (Nigeria)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ng.svg" width="22">](translations/README.igb.md)</kbd>
|
||||
<kbd>[<img title="Yoruba (Nigeria)" alt="Yoruba (Nigeria)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ng.svg" width="22">](translations/README.yor.md)</kbd>
|
||||
<kbd>[<img title="Hausa (Nigeria)" alt="Hausa (Nigeria)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ng.svg" width="22">](translations/README.hau.md)</kbd>
|
||||
<kbd>[<img title="Latvia" alt="Latvia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lv.svg" width="22">](translations/README.lv.md)</kbd>
|
||||
<kbd>[<img title="Suomeksi" alt="Suomeksi" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/fi.svg" width="22">](translations/README.fi.md)</kbd>
|
||||
<kbd>[<img title="Беларуская мова" alt="Беларуская мова" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/by.svg" width="22">](translations/README.by.md)</kbd>
|
||||
<kbd>[<img title="Српски" alt="Српски" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/rs.svg" width="22">](translations/README.sr.md)</kbd>
|
||||
<kbd>[<img title="Қазақша" alt="Қазақша" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kz.svg" width="22">](translations/README.kz.md)</kbd>
|
||||
<kbd>[<img title="Bosanski" alt="Bosanski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ba.svg" width="22">](translations/README.bih.md)</kbd>
|
||||
<kbd>[<img title="Bosanski" alt="Bosanski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/et.svg" width="22">](translations/README.bih.md)</kbd>
|
||||
<kbd>[<img title="Hrvatski" alt="Hrvatski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/hr.svg" width="22">](translations/README.hr.md)</kbd>
|
||||
<kbd>[<img title="پښتو" alt="پښتو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/af.svg" width="22">](translations/README.ps.md)</kbd>
|
||||
<kbd>[<img title="Af-soomaali" alt="Somalia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/so.svg" width="22">](translations/README.so.md)</kbd>
|
||||
<kbd>[<img title="Español de Ecuador" alt="Ecuador" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ec.svg" width="22">](translations/README.ec.md)</kbd>
|
||||
<kbd>[<img title="Turkmen" alt="Turkmen language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tm.svg" width="22">](translations/README.tm.md)</kbd>
|
||||
<kbd>[<img title="Ewe (TOGO)" alt="Ewe (TOGO)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tg.svg" width="22">](translations/README.ewe.md)</kbd>
|
||||
<kbd>[<img title="አማርኛ" alt="አማርኛ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/et.svg" width="22">](translations/README.et.md)</kbd>
|
||||
<kbd><img title="Kurdî" alt="Kurdî" src="https://upload.wikimedia.org/wikipedia/commons/3/35/Flag_of_Kurdistan.svg" width="22"></kbd>
|
||||
|
||||
# Beşdariyên Yekem
|
||||
|
||||
Ev proje armanc dike ku rêya destpêkkeran ji bo beşdariya wan a yekem hêsan û rêber bike. Heke hûn li beşdariya xwe ya yekem digerin, van gavan bişopînin.
|
||||
|
||||
_Heke hûn bi xeta fermanê ne rehet in, [li vir perwerdeyên ku amûrên GUI bikar tînin hene.](#perwerdeyên-ku-amûrên-din-bikar-tînin)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="vê depoyê fork bikin" />
|
||||
|
||||
#### Heke git li ser makîneya we tune, [wê saz bikin](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## Vê depoyê fork bikin
|
||||
|
||||
Vê depoyê bi tikandina bişkoka fork li jora vê rûpelê fork bikin.
|
||||
Ev ê kopiyeke vê depoyê di hesabê we de çêke.
|
||||
|
||||
## Depoyê clone bikin
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="vê depoyê clone bikin" />
|
||||
|
||||
Niha depoya forkkirî li makîneya xwe clone bikin. Herin hesabê xwe yê GitHub, depoya forkkirî vekin, li ser bişkoka code bitikînin û paşê li ser îkona _copy to clipboard_ bitikînin.
|
||||
|
||||
Termînalek vekin û ev fermana git bimeşînin:
|
||||
|
||||
```bash
|
||||
git clone "url'a ku we naha kopî kir"
|
||||
```
|
||||
|
||||
li cihê ku "url'a ku we naha kopî kir" (bêyî nîşanên jêgirtinê) url'a vê depoyê ye (forka we ya vê projeyê). Ji bo bidestxistina url'ê li gavên berê binêrin.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="URL'ê kopî bikin" />
|
||||
|
||||
Bo nimûne:
|
||||
|
||||
```bash
|
||||
git clone git@github.com:ev-hûn-in/first-contributions.git
|
||||
```
|
||||
|
||||
li ku derê `ev-hûn-in` navê we yê bikarhêneriya GitHub e. Li vir hûn naveroka depoya first-contributions li ser GitHub'ê li kompûtera xwe kopî dikin.
|
||||
|
||||
## Şaxekê çêbikin
|
||||
|
||||
Derbasi pelrêça depoyê li ser komputera xwe bibin (heke hûn ne li wir in):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Niha bi bikaranîna fermana `git switch` şaxekê çêbikin:
|
||||
|
||||
```bash
|
||||
git switch -c navê-şaxa-we-ya-nû
|
||||
```
|
||||
|
||||
Bo nimûne:
|
||||
|
||||
```bash
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
## Guherandinên pêwist çêbikin û wan guherandinan commit bikin
|
||||
|
||||
Niha pelê `Contributors.md` di edîtorekî nivîsê de vekin, navê xwe lê zêde bikin. Wê li destpêk an dawiya pelê zêde nekin. Li cihekî navbera wan de deynin. Niha, pelê tomarbikin.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Heke hûn herin pelrêça projeyê û fermana `git status` bimeşînin, hûn ê bibînin ku guherandin hene.
|
||||
|
||||
Van guhertinan li şaxa ku we nû çêkiriye bi bikaranîna fermana `git add` zêde bikin:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Niha van guhertinan bi bikaranîna fermana `git commit` commit bikin:
|
||||
|
||||
```bash
|
||||
git commit -m "Add navê-we to Contributors list"
|
||||
```
|
||||
|
||||
`navê-we` bi navê xwe re biguherin.
|
||||
|
||||
## Guhertinan bişînin GitHub
|
||||
|
||||
Guherandinên xwe bi fermana `git push` bişînin:
|
||||
|
||||
```bash
|
||||
git push -u origin navê-şaxa-we
|
||||
```
|
||||
|
||||
`navê-şaxa-we` bi navê şaxa ku we berê çêkiribû re biguherin.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Heke hûn di dema push kirinê de bi xeletiyekê re rû bi rû bimînin, li vir bitikînin:</strong> </summary>
|
||||
|
||||
- ### Xeletiya Rastkirinê
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Herin [perwerdehiya GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) li ser çêkirin û veavakirina mifteya SSH ji bo hesabê xwe.
|
||||
|
||||
</details>
|
||||
|
||||
## Guherandinên xwe ji bo nirxandinê pêşkêş bikin
|
||||
|
||||
Heke hûn herin depoya xwe li ser GitHub, hûn ê bişkokek `Compare & pull request` bibînin. Li ser wê bişkokê bitikînin.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="daxwaza kişandinê çêbikin" />
|
||||
|
||||
Niha daxwaza kişandinê pêşkêş bikin.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="daxwaza kişandinê pêşkêş bikin" />
|
||||
|
||||
Di demek nêzîk de, ez ê hemû guherandinên we di şaxa sereke ya vê projeyê de tevlihev bikim. Dema ku guherandin hatin tevlihevkirin, hûn ê e-nameyek agahdariyê bistînin.
|
||||
|
||||
## Ji vir ve ku derê?
|
||||
|
||||
Pîroz be! We çerxa _fork -> clone -> edit -> pull request_ a standard ku hûn ê gelek caran wek beşdarvan pêrgî wê werin temam kir!
|
||||
|
||||
Beşdariya xwe pîroz bikin û bi hevalên xwe û şopînerên xwe re parve bikin bi çûyîna [sepana webê](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Heke we hewceyî alîkariyê heye an jî pirsên we hene hûn dikarin beşdarî tîma me ya slack bibin. [Beşdarî tîma slack bibin](https://firstcontributors.slack.com/join/shared_invite/zt-29qhyr9lt-Bi7WLbgGIFqV7aCEG_grvg#/shared-invite/email).
|
||||
|
||||
Niha em dest bi beşdariya we di projeyên din de bikin. Me lîsteyek ji projeyan bi mijarên hêsan amade kiriye ku hûn dikarin pê dest pê bikin. [Lîsteya projeyan di sepana webê de kontrol bikin](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Materyalên zêde](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Perwerdeyên Ku Amûrên Din Bikar Tînin
|
||||
|
||||
| <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/2/2d/Visual_Studio_Code_1.18_icon.svg" 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)
|
||||
<p>This project is supported by:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p> |
|
||||
@@ -1,134 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
|
||||
# Mchango wa Kwanza
|
||||
|
||||
|
||||
Ni vigumu. Ni vigumu daima mara ya kwanza unafanya kitu. Hasa wakati unashirikiana, kufanya makosa sio jambo la kushangaza. Tulitaka kurahisisha njia mpya ya wafadhili wa kujifunza na kuchangia kwa mara ya kwanza.
|
||||
|
||||
Kusoma makala na mafunzo ya kutazama yanaweza kusaidia, lakini ni nini bora zaidi kuliko kufanya mambo halisi katika mazingira ya mazoezi? Mradi huu unalenga kutoa mwongozo na kurahisisha wasanidi wa njia kufanya mchango wao wa kwanza. Ikiwa unatafuta kufanya mchango wako wa kwanza, fuata hatua zifuatazo.
|
||||
|
||||
#### *Ikiwa huna urahisi na mstari wa amri, [hapa ni mafunzo kwa kutumia zana za GUI.](#Mafundisho-Kutumia-Zana-Zingine)*
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
|
||||
## Vuta hifadhi hii
|
||||
|
||||
Vuta repo hii kwa kubonyeza kifungo cha fakia juu ya ukurasa huu. Hii itaunda nakala ya hifadhi hii katika akaunti yako.
|
||||
|
||||
## Weka chumba
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Sasa nakala repo iliyovutwa kwa mashine yako. Nenda kwenye akaunti yako ya GitHub, fungua repo iliyovutwa, bonyeza kitufe cha kamba na kisha bofya nakala kwenye clipboard.
|
||||
|
||||
|
||||
Fungua terminal na uendesha amri yafuatayo:
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
ambapo "url ulikosa tu" (bila alama za kupiga kura) ni url kwenye hifadhi hii (fomu yako ya mradi huu). Angalia hatua za awali ili kupata url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Kwa mfano:
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
hapo `this-is-you`tumia jina lako la mtumiaji GitHub. Hapa unakili nakala ya maudhui ya kwanza ya michango kwenye GitHub kwenye kompyuta yako.
|
||||
|
||||
## Unda tawi
|
||||
|
||||
Badilisha kwenye saraka ya uhifadhi kwenye kompyuta yako (ikiwa huko tayari):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Sasa unda tawi kwa kutumia git `checkout` amri:
|
||||
|
||||
|
||||
```
|
||||
git checkout -b <add-your-new-branch-name>
|
||||
```
|
||||
|
||||
Kwa mfano:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
(Jina la tawi haina haja ya kuwa neno liongeze ndani yake, lakini ni jambo la kuzingatia kwa sababu lengo la tawi hili ni kuongeza jina lako kwenye orodha.)
|
||||
|
||||
## Fanya mabadiliko muhimu na ufanyie mabadiliko hayo
|
||||
|
||||
Sasa fungua `Contributors.md` faili katika mhariri wa maandishi, uongeze jina lako. Usiongeze kwenye mwanzo au mwisho wa faili. Weka mahali popote katikati. Sasa, sahau faili.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Ikiwa unakwenda kwenye saraka ya mradi na kutekeleza amri `git status`, utaona kuna mabadiliko.
|
||||
|
||||
|
||||
Ongeza mabadiliko hayo kwenye tawi ulilojenga kwa kutumia `git add` amri:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Sasa fanya mabadiliko hayo kwa kutumia amri `git commit`:
|
||||
|
||||
```
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
|
||||
kubadilisha `<your-name>` jina lako.
|
||||
|
||||
## Skuma mabadiliko kwenye GitHub
|
||||
|
||||
Skuma mabadiliko yako kwa kutumia amri `git push`:
|
||||
|
||||
```
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
|
||||
kubadilisha `<add-your-branch-name>` na jina la tawi uliloumba hapo awali.
|
||||
|
||||
## Tuma mabadiliko yako kwa ukaguzi
|
||||
|
||||
Ikiwa unaenda kwenye hifadhi yako kwenye GitHub, utaona `Compare & pull request` kifungo. Bofya kwenye kifungo hicho.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Sasa weka ombi la kuvuta.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Hivi karibuni nitaunganisha mabadiliko yako yote kwenye tawi la mradi huu. Utapata barua pepe ya arifa mara mabadiliko yameunganishwa.
|
||||
|
||||
## Wapi kutoka hapa?
|
||||
|
||||
Hongera! Wewe umekamilisha fomu ya kawaida *fork -> clone -> hariri -> pull request* ambayo unakutana mara nyingi kama mchangiaji!
|
||||
|
||||
Sherehekea mchango wako na marafiki na wafuasi wako kwa kuenda kwenye [programu ya wavuti](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Unaweza kujiunga na timu yetu ya slack ikiwa unahitaji msaada wowote au una maswali yoyote. [Jiunge na timu ya slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Sasa hebu tuanze uanze na kuchangia kwenye miradi mingine. Tumeandika orodha ya miradi na masuala rahisi unaweza kuanza. Angalia [orodha ya miradi katika programu ya wavuti](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Nyenzo za ziada](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Mafundisho Kutumia Zana Zingine
|
||||
|
||||
| <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) |
|
||||
@@ -1,108 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Жобаға алғаш рет үлес қосу
|
||||
|
||||
Оңай іс емес, жалпы кез-келген істе алғашқы қадам қиын келеді. Қателіктер жасау өте жағымсыз, әсіресе топтық жұмыс істесеңіз. Барлық open source проекттер ынтымақтастық пен бірегей жұмыстан тұрады. Біз бастаушы әзірлеушілер үшін үлес қосу және бірлесіп жұмыс істеудегі алғашқы қадамдарды жеңілдеткіміз келеді.
|
||||
|
||||
Егер сіз өзіңіздің алғашқы үлесіңізді жасау мүмкіндігін іздесеңіз, төмендегі қарапайым қадамдарды орындаңыз.
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
|
||||
Егерде сіздің компьютеріңізде git қосылмаған болса, [ оны қосыңыз ]( https://help.github.com/articles/set-up-git/ )
|
||||
|
||||
## Тармақты (fork) жасаңыз
|
||||
|
||||
Өзіңіздің тармағыңызды жасау үшін, беттің үстіңгі жағындағы `fork` түймесін басыңыз. Осылай сіз осы репозиторийдің өзіңіздің аккаутыңызда копиясын жасайсыз.
|
||||
|
||||
## Репозиторийді клондаңыз
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Енді бұл репозиторийді өз дербес компьютеріңізге клодаңыз. Сілтемені көшіру үшін `clone` батырмасын басыңыз, содан кейін `copy to clipboard` белгішесіне басыңыз.
|
||||
|
||||
Терминалды ашып, келесі git пәрмендіні іске қосыңыз:
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
Бұл жерде "url you just copied" (тырнақшасыз) сіздің репозиторийңізге сілтеме. Бұл сілтемені алу үшін алдыңғы қадамдарды қараңыз.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Мысалы:
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
Бұл жерде `this-is-you` сіздің github-тағы логин. Осылайша GitHub-тан сіздің компьютеріңізге 'first-contributions' репозиторийін көшіресіз.
|
||||
|
||||
## Тармақ жасаңыз
|
||||
|
||||
Терминалда репозиторий папкасына кіріңіз (егер әлі кірмеген болсаңыз):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Енді `git switch` команданың көмегімен тармақты құрыңыз.
|
||||
|
||||
```
|
||||
git switch -c your-new-branch-name
|
||||
```
|
||||
|
||||
Мысалы:
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
> Тармақтың аты шешіп жатқан мәселе немесе енгізетін өзгерістеріңізге сәйкес болғаны дұрысырақ, бірақ міндетті емес.
|
||||
|
||||
## Керек өзгерістерді еңгізіп, коммит жасаңыз
|
||||
|
||||
Енді мәтіндік редакторда `Contributors.md` файлын ашыңыз, атыңызды енгізіңіз және файлды сақтаңыз. Егер сіз жобалық каталогқа барып, `git status` орындасаңыз, өзгертулерді көресіз. Бұл өзгертулерді `git add` командасымен қосыңыз.
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Енді бұл өзгерістерды `git commit` командасымен коммиттаңыз.
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
`<your-name>` өзіңіздің атыңызға ауыстырыңыз
|
||||
|
||||
## Өзгерістерді Github'қа жіберіңіз
|
||||
|
||||
Өзгерістерді `git push` командасымен жіберіңіз
|
||||
```
|
||||
git push origin your-new-branch-name
|
||||
```
|
||||
`your-new-branch-name` дегенді алдында құрған тармақ атына өзгертіңіз.
|
||||
|
||||
## Өзгерістерді ревью үшін растаңыз
|
||||
|
||||
Егер сіз GitHub-тағы репозиторийге кірсеңіз, `Compare & pull request` батырмасын көресіз. Оны басыңыз.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Енді пулл-реквестті растаңыз.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Көп ұзамай мен осы жобаның негізгі бөлімімен барлық өзгерістерді біріктіремін. Өзгерістер қабылданған кезде (мердж жасалғанда) электрондық хат аласыз.
|
||||
|
||||
## Ары қарай не?
|
||||
|
||||
Төменде сіз жаңадан келген тапсырмаларды таба алатын бірнеше танымал репозиторийлер бар. Қосымша ақпарат алу үшін репозиторийге барыңыз.
|
||||
|
||||
| [](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22) | [](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [<img width="100" src="https://cdn.worldvectorlogo.com/logos/react-2.svg">](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22) | [](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [<img width="100" src="https://camo.githubusercontent.com/0f302c808c8457f6460913e33aed3478124612c2/687474703a2f2f6c65696e696e67656e2e6f72672f696d672f6c65696e696e67656e2e6a7067">](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie) | [<img width="100" src="https://images.plot.ly/plotly-documentation/thumbnail/numpy-logo.jpg">](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22) | [](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22) |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [exercism](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22) | [Fun Retros](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [react](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22) | [habitat](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [scikit-learn](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [Leiningen](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie) | [numpy](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22) | [elasticsearch](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22) |
|
||||
| [](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) | [](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy) | [](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22) | [](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy) | [](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs) | [](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer) | [](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs) |
|
||||
| [homebrew](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) | [Rust](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy) | [vuejs](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22) | [Suave](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy) | [OpenRA](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [PowerShell](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs) | [coala](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer) | [moment](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs) |
|
||||
| [](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22) | [](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22) | [](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) | [](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level) | [](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [<img width="100" src="https://cdn.worldvectorlogo.com/logos/brackets-1.svg">](https://github.com/adobe/brackets/labels/Starter%20bug) |
|
||||
| [ava](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22) | [freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [webpack](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22) | [hoodie](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [pouchdb](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) | [neovim](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level) | [babel](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [brackets](https://github.com/adobe/brackets/labels/Starter%20bug) |
|
||||
| [](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | [<img width="100" src="https://github.com/Semantic-Org/Semantic-UI-React/raw/master/docs/public/logo.png">](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |
|
||||
| [Node.js](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | [Semantic-UI-React](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |
|
||||
|
||||
@@ -1,119 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# "Contribute" ຜົນງານໃນ GitHub ຮ່ວມກັບຄົນອື່ນເປັນຄັ້ງທຳອິດແມ່ນບໍ່?
|
||||
|
||||
ມັນເປັນເລື່ອງທີ່ຂ້ອງຂ້າງຍາກໜ້ອຍໜຶ່ງ, ແຕ່ກ້າວທຳອິດໃນການເລີ່ມຕົ້ນເຮັດຫຍັງບາງຢ່າງມັນກໍ່ຈະຍາກແບບນີ້ສະເໝີ ໂດຍສະເພາະເວລາທີ່ຕ້ອງຮ່ວມງານກັບຄົນອື່ນ ເພາະເມື່ອເຮົາໄດ້ເຮັດຫຍັງຜິດພາດມັນກໍ່ມັກຈະເຮັດໃຫ້ເຮົາບໍ່ສະບາຍໃຈ, ແຕ່ວ່າໃນໂລກຂອງໂອເພັນຊອສ (open source) ຄືໂລກທີ່ເຮົາຕ້ອງໄດ້ເຮັດວຽກຮ່ວມກັນ! ເຮົາຈຶ່ງຢາກໃຫ້ຜູ້ທີ່ເຂົ້າມາໃໝ່ໄດ້ຮຽນຮູ້ວິທີການ "ຄອນທຣິບິ້ວ" ຜົນງານຮ່ວມກັບຄົນອື່ນໃນ GitHub ແບບງ່າຍໆ.
|
||||
|
||||
ການອ່ານບົດຄວາມ ແລະ ການທີ່ໄດ້ທົດລອງເຮັດຕົວຢ່າງຕ່າງໆກໍ່ອາດຈະຊ່ວຍໄດ້, ແຕ່ເຖິງຢ່າງໃດກໍ່ຕາມ ຄົງຈະບໍ່ມີສິ່ງໃດເໜືອໄປກວ່າການທີ່ເຮົາໄດ້ລົງມືເຮັດດ້ວຍຕົນເອງ!. ໃນໂປຣເຈັກນີ້ຈະສອນໃຫ້ມືໃໝ່ຮູ້ຈັກການສົ່ງ "contribution" ທຳອິດໄດ້ຢ່າງງ່າຍໆ.
|
||||
|
||||
ໃຫ້ຈື່ໄວ້ວ່າ: ຄວາມພະຍາຍາມຢູ່ທີ່ໃດ ຄວາມພະຍາຍາມກໍ່ຢູ່ທີ່ນັ້ນເຊັ່ນກັນ!
|
||||
|
||||
ຖ້າພ້ອມແລ້ວເຮົາມາລອງສົ່ງ contibution ທຳອິດກັນໄດ້ພຽງບໍ່ເທົ່າໃດຂັ້ນຕອນດ້ານລຸ່ມໄປພ້ອມໆກັນເລີຍ, ບອກເລີຍວ່າງ່າຍກວ່າປອກກ້ວຍ.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
ຫາກໃຜຍັງບໍ່ໄດ້ຕິດຕັ້ງ git ລົງໃນເຄື່ອງ, ທ່ານສາມາດກົດລິ້ງ[ຕິດຕັ້ງໄດ້ທີ່ນີ້]( https://help.github.com/articles/set-up-git/ )
|
||||
|
||||
## ກົດ "Fork" ໂປຣເຈັກນີ້
|
||||
|
||||
ໂປຣເຈັກຫຼັກນີ້ມັກຈະເອີ້ນວ່າ ໂປຣເຈັກຕົ້ນນ້ຳ, ທ່ານສາມາດ fork ໂປຣເຈັກຕົ້ນນ້ຳນີ້ໄປຍັງ repo ຂອງ account ຂອງທ່ານເອງໄດ້ໂດຍການກົດປຸ່ມ "Fork" ທີ່ດ້ານເທິງຂອງໜ້ານີ້.
|
||||
|
||||
ແລ້ວໂປຣເຈັກນີ້ກໍ່ຈະຖືກຄັດລອກໄປທີ່ account ຂອງທ່ານ.
|
||||
|
||||
## ກົດປຸ່ມ "Clone" ໂປຣເຈັກນີ້
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
ມາຮອດຂັ້ນຕອນນີ້ເຮົາກໍ່ Clone ໂປຣເຈັກລົງມາທີ່ຄອມພິວເຕີຂອງເຮົາໂດຍການກົດທີ່ປຸ່ມ "Clone" ແລ້ວເລືອກ *Copy to clipboard* (ຄຳສັ່ງຄັດລອກ)
|
||||
|
||||
ເປີດ terminal ຂຶ້ນມາ (ຕົວຢ່າງ Terminal ໃນ MacOS ຫຼື cmd ໃນ Windows) ແລ້ວພິມຄຳສັ່ງ git ຕໍ່ໄປນີ້:
|
||||
|
||||
```
|
||||
git clone "url ທີ່ຄັດລອກໄວ້"
|
||||
```
|
||||
"url ທີ່ຄັດລອກໄວ້" (ບໍ່ຕ້ອງໃສ່ " ") ຄື url ຂອງໂປຣເຈັກຂອງທ່ານ ທ່ານສາມາດກັບໄປເບິ່ງວິທີການຄັດລອກ url ໄດ້ຈາກຫົວຂໍ້ກ່ອນໜ້ານີ້
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
ຕົວຢ່າງ:
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
`this-is-you` ຄືຊື່ username ຂອງທ່ານຢູ່ເທິງ GitHub, ມາຮອດບ່ອນນີ້ທ່ານໄດ້ "Clone" ໂປຣເຈັກ first-contributions ໄປໄວ້ທີ່ຄອມພິວເຕີຂອງທ່ານແລ້ວ.
|
||||
|
||||
## ສ້າງ branch
|
||||
|
||||
ໃນ terminal ປ່ຽນ directory ໄປບ່ອນທີ່ທ່ານ Clone ໂປຣເຈັກໄວ້:
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
ບ່ອນນີ້ໃຫ້ສ້າງ branch (ແຕກສາຂາອອກມາໃໝ່) ດ້ວຍຄຳສັ່ງ `git checkout`:
|
||||
```
|
||||
git checkout -b <ຊື່ branch>
|
||||
```
|
||||
|
||||
ຕົວຢ່າງ:
|
||||
```
|
||||
git checkout -b add-phongphat-khamphiew
|
||||
```
|
||||
(ປົກກະຕິຊື່ຂອງ branch ບໍ່ຈຳເປັນຕ້ອງມີຄຳວ່າ *add* ແຕ່ໃນໂປຣເຈັກນີ້ຢາກໃຫ້ໃຊ້ add-ຊື່-ຂອງ-ທ່ານ ເພາະຊື່ຂອງທ່ານຈະໄປສະແດງຢູ່ທີ່ລາຍການ Contributors (ຜູ້ເຂົ້າຮ່ວມ) ຂອງໂປຣເຈັກນີ້
|
||||
|
||||
## ເພີ່ມຫຼືແກ້ໄຂ code ໄດ້ເລີຍ, ແຕ່ຢ່າລືມ "Commit" ບອກວ່າທ່ານໄດ້ເຮັດຫຍັງລົງໄປແລ້ວແນ່
|
||||
|
||||
ຕອນນີ້ໃຫ້ເປີດໄຟລ໌ `Contributors.md` ໃນໂປຣແກຣມ text editor ເພີ່ມຊື່ຂອງທ່ານລົງໄປ ຈາກນັ້ນບັນທຶກໄຟລ໌
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
ໃນ terminal ຖ້າທ່ານຢູ່ທີ່ directory ຂອງໂປຣເຈັກ ໃຫ້ລອງພິມຄຳສັ່ງ `git status` ຈະເຫັນວ່າທ່ານໄດ້ປ່ຽນແປງໄຟລ໌ໃດແນ່ແລ້ວ.
|
||||
|
||||
ເພີ່ມການປ່ຽນແປງນັ້ນໆເຂົ້າໄປ branch ທີ່ຫາກໍ່ສ້າງດ້ວຍຄຳສັ່ງ `git add`:
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
ຕອນນີ້ "Commit" ການປ່ຽນແປງດັ່ງກ່າວດ້ວຍຄຳສັ່ງ `git commit`:
|
||||
```
|
||||
git commit -m "Add <ຊື່ຂອງທ່ານ> to Contributors list"
|
||||
```
|
||||
ແທນບ່ອນ `<ຊື່ຂອງທ່ານ>` ດ້ວຍຊື່ແທ້ຂອງທ່ານ.
|
||||
|
||||
## "Push" code ທີ່ປ່ຽນແປງຂຶ້ນ GitHub
|
||||
|
||||
"Push" ຜົນງານທີ່ທ່ານໄດ້ເຮັດໃນຂັ້ນຕອນກ່ອນໜ້ານີ້ຂຶ້ນ GitHub ດ້ວຍຄຳສັ່ງ `git push`:
|
||||
```
|
||||
git push origin <ຊື່ branch ຂອງທ່ານ>
|
||||
```
|
||||
ແທນບ່ອນ `<ຊື່ branch ຂອງທ່ານ>` ດ້ວຍຊື່ຂອງ branch ທີ່ທ່ານໄດ້ສ້າງໄວ້ໃນຫົວຂໍ້ກ່ອນໜ້ານີ້ (add-ຊື່-ຂອງ-ທ່ານ)
|
||||
|
||||
## ສົ່ງຜົນງານ ແລະ ລໍຖ້າຣີວິວຈາກເຈົ້າຂອງໂປຣເຈັກ
|
||||
|
||||
ໄປທີ່ repository ຂອງທ່ານເທິງ GitHub ກົດທີ່ `Compare & pull request`
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
ຕອນນີ້ກໍ່ສົ່ງ Pull Request ໄປທີ່ໂປຣເຈັກຫຼັກ ຫຼື ໂປຣເຈັກຕົ້ນນ້ຳໄດ້ເລີຍ
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
ເຮົາຈະທຳການ "Merge" ຫຼື ລວມຜົນງານທີ່ທ່ານໄດ້ປ່ຽນແປງ code ມາທີ່ master branch ຂອງໂປຣເຈັກນີ້, ທ່ານຈະໄດ້ຮັບອີເມວເມື່ອເຮົາໄດ້ທຳການ Merge ຜົນງານຂອງທ່ານສຳເລັດແລ້ວ.
|
||||
|
||||
## ຈະເຮັດຫຍັງຕໍ່ຫຼັງຈາກນີ້?
|
||||
ຍິນດີນຳ, ທ່ານໄດ້ປະຕິບັດຂັ້ນຕອນຂອງການເຮັດ contribute ຄື fork -> clone -> edit -> pull request ເຊິ່ງຂັ້ນຕອນຕ່າງໆເຫຼົ່ານີ້ເປັນສິ່ງທີ່ທ່ານຕອງໄດ້ພົບເມື່ອທ່ານເປັນ contributor
|
||||
ສະເຫຼີມສະຫຼອງໃຫ້ແກ່ການມີສ່ວນຮ່ວມຂອງທ່ານ, ຢ່າລືມແບ່ງປະສົບການທີ່ທ່ານໄດ້ຮັບໃຫ້ແກ່ໝູ່ເພື່ອນຂອງທ່ານ ໂດຍໄປທີ່ [ເວັບໄຊນີ້](https://firstcontributions.github.io/#social-share)
|
||||
|
||||
ຫຼືຈະມີສ່ວນຮ່ວມກັບເຮົາຜ່ານ Slack ໃນກໍລະນີທີ່ທ່ານຕ້ອງການຄວາມຊ່ວຍເຫຼືອ ຫຼື ມີຂໍ້ສົງໄສໃດໆ [ເຂົ້າຮ່ວມ slack ກັບພວກເຮົາ](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
|
||||
ຈາກນີ້ທ່ານສາມາດ contribute ໃຫ້ໂປຣເຈັກອື່ນໆໄດ້, ໂດຍທາງເຮົາໄດ້ເຮັດລາຍການໂປຣເຈັກທີ່ງ່າຍຕໍ່ການເລີ່ມຕົ້ນບາງສ່ວນໄວ້ໃຫ້ [ລາຍຊື່ໂປຣເຈັກທີ່ໜ້າສົນໃຈ](https://firstcontributions.github.io/#project-list)
|
||||
|
||||
### [ຂໍ້ມູນອື່ນໆເພີ່ມເຕີມ](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## ເຝິກການ contribute ໂດຍໃຊ້ເຄື່ອງມືອື່ນໆ
|
||||
|
||||
|<a href="../github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a>|<a href="../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="../gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/Readme/gk-icon.png" width="100"></a>|
|
||||
|---|---|---|
|
||||
|[GitHub Desktop](../github-desktop-tutorial.md)|[Visual Studio 2017](../github-windows-vs2017-tutorial.md)|[GitKraken](../gitkraken-tutorial.md)|
|
||||
|
||||
@@ -1,145 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
# Pirmieji įnašai
|
||||
|
||||
Sunku. Visada sunku ką nors padaryti pirmą kartą. Ypač bendradarbiaujant, klaidų darymas nėra malonus dalykas. Tačiau atviras kodas - tai bendravimas ir bendradarbiavimas. Mes norime paprasčiau paaiškinti naujiesiems atvirojo kodo kūrėjams, kaip jie gali prisidėti pirmą kartą.
|
||||
|
||||
Galite pradėti skaityti straipsnius ir žiūrėti vadovus, bet kas gali būti geriau nei mokymasis darant be klaidų pirmą kartą? Šio projekto tikslas - suteikti patarimus ir supaprastinti tai, kaip naujokai atlieka savo pirmąjį indėlį. Prisiminkite: kuo labiau atsipalaidavę esate, tuo geriau mokotės. Jei norite atlikti pirmąjį indėlį, atlikite toliau pateiktus paprastus veiksmus. Mes pažadame, tai bus smagu.
|
||||
|
||||
_Jei nesate pratę dirbti su komandine eilute, [čia rasite vadovą, naudojantį GUI įrankius.](#tutorials-using-other-tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### Jei neturite instaliuoto git, [instaliuokite čia](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Kopijuokite (fork) šią saugyklą
|
||||
|
||||
Kopijuokite saugyklą paspausdami šaknies simbolio mygtuką šio puslapio viršuje.
|
||||
Tai sukurs šios saugyklos kopiją jūsų GitHub paskyroje.
|
||||
|
||||
## Klonuokite saugyklą
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Dabar klonuokite šią saugyklą į savo kompiuterį. Spustelėkite klonavimo mygtuką ir tada spustelėkite *copy to clipboard* piktogramą.
|
||||
|
||||
Atidarykite terminalą ir paleiskite šią git komandą:
|
||||
|
||||
```
|
||||
git clone "kątik nukopijuota nuoroda"
|
||||
```
|
||||
kur "kątik nukopijuota nuoroda" (be citatos ženklų) yra url nuoroda jūsų saugyklai (jūsų projekto kopijai). Peržiūrėkite ankstesnius veiksmus, kad gautumėte url nuorodą.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Pavyzdžiui:
|
||||
```
|
||||
git clone https://github.com/tai-jus/first-contributions.git
|
||||
```
|
||||
kur `tai-jus` yra jūsų GitHub paskyros vartotojo vardas. Čia jūs kopijuojate first-contributions saugyklos turinį į "GitHub" aplanką savo kompiuteryje.
|
||||
|
||||
## Sukurkite šaką (branch)
|
||||
|
||||
Pakeiskite kompiuterio saugyklos katalogą (jei dar to nepadarėte anksčiau):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Dabar sukurkite šaką naudodami komandą `git branch`:
|
||||
```
|
||||
git branch -c <tavo-sakos-vardas>
|
||||
```
|
||||
|
||||
Pavyzdžiui:
|
||||
```
|
||||
git branch -c add-vardenis-pavardenis
|
||||
```
|
||||
(Saugyklos pavadinime neprivalo būti žodžio *add*, bet mes jį naudojame, kadangi šios šakos (branch) paskirtis yra įtraukti savo vardą į sąrašą.)
|
||||
|
||||
<details>
|
||||
<summary> <strong>Jei gavote klaidos pranešimą naudodami git switch, spauskite čia:</strong> </summary>
|
||||
|
||||
Jei klaidos pranešimas yra "Git: `switch` is not a git command. See `git –help`", tikėtinai naudojate seną git versiją.
|
||||
|
||||
Tokiu atveju bandykite `git checkout`:
|
||||
|
||||
```bash
|
||||
git checkout -b add-vardenis-pavardenis
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## Atlikite reikiamus pakeitimus ir pridėkite (commit) šiuos pakeitimus
|
||||
|
||||
Dabar atidarykite failą `Contributors.md` teksto redaktoriuje ir pridėkite prie jo savo vardą. Nedėkite jo į failo pradžią ar pabaigą - įrašykite jį bet kur kitur faile. Galiausiai, išsaugokite failą.
|
||||
|
||||
Jei eisite į projekto katalogą ir paleisite komandą `git status`, pamatysite, kad yra pakeitimų. Pridėkite šiuos pakeitimus į ką tik sukurtą šaką (branch) komandos `git add` pagalba:
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Dabar atlikite šiuos pakeitimus naudodami komandą `git commit`:
|
||||
```
|
||||
git commit -m "Add <tavo-vardas> to Contributors list"
|
||||
```
|
||||
pakeisdami `<tavo-vardas>` savo vardu.
|
||||
|
||||
## Išsiųskite pakeitimus į GitHub
|
||||
|
||||
Išsiųskite pakeitimus komanda `git push`:
|
||||
```
|
||||
git push origin <tavo-sakos-vardas>
|
||||
```
|
||||
pakeisdami `<tavo-sakos-vardas>` anskčiau sukurtos šakos (branch) vardu.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Jei gaunate klaidos pranešimą išsaugodami pakeitimus, spauskite čia:</strong> </summary>
|
||||
|
||||
- ### Autentifikacijos klaida
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
[GitHub vadovas](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) padės jums sugeneruoti ir sukonfiguruoti SSH raktą savo paskyroje.
|
||||
|
||||
Taip pat, galbūt norėsite pabandyti 'git remote -v', skirtą patikrintite savo nuotolinį adresą (remote address).
|
||||
|
||||
Jei jis atrodo taip ar panašiai:
|
||||
<pre>origin https://github.com/your-username/your_repo.git (fetch)
|
||||
origin https://github.com/your-username/your_repo.git (push)</pre>
|
||||
|
||||
pakeiskite jį, naudodami komandą:
|
||||
```bash
|
||||
git remote set-url origin git@github.com:your-username/your_repo.git
|
||||
```
|
||||
Kitu atveju jūsų vis tiek sulauksite klausimo apie savo vartotojo vardą ir slaptažodį ir sulauksite autentifikacijos klaidos.
|
||||
</details>
|
||||
|
||||
## Pateikite pakeitimus peržiūrai
|
||||
|
||||
Eikite į savo saugyklą GitHub. Pamatysite mygtuką `Compare & pull request` (palyginti ir įtraukti užklausą). Spustelėkite šį mygtuką.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Dabar pateikite įtraukimo į pradinę saugyklą (pull) užklausą.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Netrukus projekto autorius sujungs visus jūsų šakos pakeitimus su šio projekto pagrindine šaka. Kai pakeitimai bus sujungti, gausite tai patvirtinantį el. laišką.
|
||||
|
||||
## Kas toliau?
|
||||
|
||||
Džiaukitės ir atkreipkite dėmesį į savo įnašą pasidalindami šia žinia su draugais [interneto aplikacijoje](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Pradėkite tobulinti kitus projektus. Mes sukūrėme projektų sąrašą, kuriuose yra lengvai išsprendžiamų problemų. Peržiūrėkite [projektų sąrašą interneto aplikacijoje](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [ Papildoma medžiaga ](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Pamokos naudojant kitus įrankius
|
||||
|
||||
| <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) |
|
||||
@@ -1,125 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Okwongezaako Eby'okusooka
|
||||
|
||||
Ekigendererwa ky'enteekateeka eno kwe kusobozesa n'okuyamba abayizi mu kuteekawo ebyabwe eby'okubiri. Bw'oba oyagala okukola eky'osooka okuyongeraako, goberera emboozi ez'ekiddako wansi.
|
||||
|
||||
_Bw'oba tokkiriziganya na command line, [wano waliyo ebiranga ebikozesa ebikozesebwa ebiwa GUI.](#tutorials-using-other-tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### Bw'oba tolina git ku kompyuta yo, [teeka git](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## Gabaako repo eno
|
||||
|
||||
Gabaako repo eno nga okozesa ekirungo ekiri waggulu ku lupapula luno. Kino kijja kutonda kopi ya repo eno mu akaawunti yo.
|
||||
|
||||
## Koppa repo
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Kati koppa repo eyogabiddwa ku kompyuta yo. Genda ku akaawunti yo ku GitHub, fungula repo eyogabiddwa, koona ku kaakano akaliko code n'oluvannyuma koona ku kirungo _copy to clipboard_.
|
||||
|
||||
Fungula terminal n'okozesa ekiragiro ekiddako ku git:
|
||||
|
||||
```bash
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
"URL gy'okoze koppa" (nga tekirina obubonero obuli mu kkiwandiiko) kye URL eri ku repo eno (okugaba kwo ku kawefube ono). Laba ku bigambo ebyo ebiri waggulu okugenda ku URL.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Ekikokyo:
|
||||
|
||||
```bash
|
||||
git clone git@github.com:this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
awa `this-is-you` ye erinya lyo ku GitHub. Wano okopeera ebiri mu repo ey'okusooka okuyongeraako ku GitHub ku kompyuta yo.
|
||||
|
||||
## Tonda branch
|
||||
|
||||
Kyusa mu nnannyini repo ku kompyuta yo (bw'oba toliyo dda):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Kati tonda branch ng'oyita mu kiragiro kya `git switch`:
|
||||
|
||||
```bash
|
||||
git switch -c your-new-branch-name
|
||||
```
|
||||
|
||||
Ekikokyo:
|
||||
|
||||
```bash
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
## Kola enkyukakyuka eziyetaagisa n'okikakasa ezo enkyukakyuka
|
||||
|
||||
Kati gulawo fayiro ya `Contributors.md` mu kikozesebwa ky'okuwandiika, yongeramu erinnya lyo mu fayiro eno. Togyongeramu ku ntandikwa oba ku nkomerero ya fayiro. Tta gy'ali wakati wa fayiro. Kati, giyita fayiro eno.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Bw'ogenda mu kisenge ky'enteekateeka n'okola ekiragiro `git status`, ojja kulaba nga waliyo enkyukakyuka.
|
||||
|
||||
Yongeza ezo enkyukakyuka ku branch gye watondawo nga okozesa ekiragiro kya `git add`:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Kati okakasa ezo enkyukakyuka nga okozesa ekiragiro kya `git commit`:
|
||||
|
||||
```bash
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
oweerereza erinnya lyo ku `your-name`.
|
||||
|
||||
## Sindikiza enkyukakyuka ku GitHub
|
||||
|
||||
Sindikiza enkyukakyuka nga okozesa ekiragiro kya `git push`:
|
||||
|
||||
```bash
|
||||
git push -u origin your-branch-name
|
||||
```
|
||||
|
||||
oweerereza erinnya lyo ku `your-branch-name`.
|
||||
|
||||
## Weereza enkyukakyuka zo okuzuulibwa
|
||||
|
||||
Bw'ogenda ku repo yo ku GitHub, ojja kulaba akapipati ka `Compare & pull request`. Koona ku kapipati ako.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Kati weereza pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Olwatuuka kunsonga y'okukakasa enkyukakyuka zo, ojja kufuna email ya kunnyonnyola enkyukakyuka zomaze okukakasa.
|
||||
|
||||
Oluvannyuma lw'okwo
|
||||
|
||||
Ki ekirungi! Onoowuziza ku ttendekero lya _fork -> clone -> edit -> pull request_ workflow gwe oyinza okufuna ng'omukozi!
|
||||
|
||||
Jaguza ekyo ky'oyongeddeko era ogikwase mikwano gyo n'abagoberera nga oyita ku [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Osobola okuyingira ku team ya slack bw'oba oyagala obuyambi obulala oba olina ebibuuzo. [Yingira team ya slack.](https://firstcontributors.slack.com/join/shared_invite/zt-29qhyr9lt-Bi7WLbgGIFqV7aCEG_grvg#/shared-invite/email).
|
||||
|
||||
Kati ka tutandikire okukola ku kintu ekirala. Tundese olukalala lwa project ezirina ebizibu ebitalina y'oyinza okutandika n'okukola. Kebera [olukalala lwa project mu web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Ebirala ebisobola okukuyamba](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Ebitendekebwa Ebikozesa Ebikozesebwa Ebirala
|
||||
|
||||
| <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/2/2d/Visual_Studio_Code_1.18_icon.svg" 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) |
|
||||
|
||||
@@ -1,123 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Pirmais devums
|
||||
|
||||
Kaut ko paveikt pirmo reizi vienmēr ir grūti. Turklāt pieļaut kļūdas, jo īpaši līdzdarbojoties ar citiem, nav patīkami. Mēs vēlamies vienkāršot veidu, kā jauni atvērtā koda līdzautori mācās un pievieno savu devumu pirmo reizi.
|
||||
|
||||
Rakstu lasīšana un pamācību skatīšanās var palīdzēt, tomēr nekas nav labāks par īstu darbību mācību vidē. Šī projekta mērķis ir sniegt norādījumus un vienkāršot veidu, kā iesācēji pievieno savu pirmo devumu. Ja tu vēlies līdzdarboties, seko turpmāk norādītajiem soļiem.
|
||||
|
||||
#### *Ja tu nejūties ērti ar komandrindu, [izmanto GUI rīku pamācības.]( #pamācības-citiem-rīkiem )*
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Ja tavā datorā nav git, [uzinstalē to]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Izveido repozitorija atzarojumu
|
||||
|
||||
Izveido savu repozitorija atzarojumu, nospiežot *fork* pogu šīs lapas augšpusē.
|
||||
Tādējādi tavā profilā tiks izveidota šī repozitorija kopija.
|
||||
|
||||
## Klonē repozitoriju
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Tagad klonē nokopēto repozitoriju savā datorā. Ej uz savu GitHub profilu, atver nokopēto repozitoriju, nospied *clone* pogu un tad nospied uz *copy to clipboard* ikonas.
|
||||
|
||||
Atver termināli un palaid šo git komandu:
|
||||
|
||||
```
|
||||
git clone "tikko nokopētā saite"
|
||||
```
|
||||
kur "tikko nokopētā saite" (bez pēdiņām) ir url uz šo repozitoriju (tavs projekta atzarojums). Apskaties iepriekšējos soļos, kā dabūt url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Piemēram:
|
||||
```
|
||||
git clone https://github.com/tavs-vārds/first-contributions.git
|
||||
```
|
||||
kur `tavs-vārds` ir tavs GitHub lietotājvārds. Šādi tu kopē GitHub repozitorija *first-contributions* saturu savā datorā.
|
||||
|
||||
## Izveido zaru
|
||||
|
||||
Savā datorā nomaini repozitorija direktoriju (ja tu vēl neatrodies tajā):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Tagad izveido zaru ar `git checkout` komandu:
|
||||
```
|
||||
git checkout -b <ieliec-jaunā-zara-nosaukumu>
|
||||
```
|
||||
|
||||
Piemēram:
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
(Zara nosaukumā nav obligāti jābūt vārdam *add*, bet būtu lietderīgi to iekļaut, jo šī zara mērķis ir tava vārda pievienošana sarakstam.)
|
||||
|
||||
## Veic nepieciešamās izmaiņas un iesūti tās
|
||||
|
||||
Tagad atver `Contributors.md` failu teksta redaktorā un pievieno tam savu vārdu. Nepievieno to faila sākumā vai beigās, bet ievieto to kaut kur pa vidu. Pēc tam saglabā failu.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
|
||||
Ja tu dosies uz projekta direktoriju un izpildīsi komandu `git status`, tu redzēsi, ka tajā ir izmaiņas.
|
||||
|
||||
|
||||
Pievieno šīs izmaiņas zaram, kuru tu tikko izveidoji, ar `git add` komandu:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Tagad iesūti šīs izmaiņas ar `git commit` komandu:
|
||||
```
|
||||
git commit -m "Add <tavs-vārds> to Contributors list"
|
||||
```
|
||||
aizvietojot `<tavs-vārds>` ar savu vārdu.
|
||||
|
||||
## Pievieno izmaiņas GitHub
|
||||
|
||||
Pievieno savas izmaiņas ar komandu `git push`:
|
||||
```
|
||||
git push origin <ievieto-zara-nosaukumu>
|
||||
```
|
||||
aizvietojot `<ievieto-zara-nosaukumu>` ar zara, kuru tu iepriekš izveidoji, nosaukumu.
|
||||
|
||||
## Iesniedz izmaiņas pārskatīšanai
|
||||
|
||||
Ja tu dosies uz savu GitHub repozitoriju, tu redzēsi `Compare & pull request` pogu. Nospied to.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Tagad iesniedz pievienotās izmaiņas.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Jau pavisam drīz es pievienošu visas tavas izmaiņas šī projekta galvenajam (master) zaram. Tu saņemsi paziņojumu e-pastā, tiklīdz izmaiņas būs pievienotas.
|
||||
|
||||
## Un ko tagad?
|
||||
|
||||
Apsveicam! Tu tikko pabeidzi standarta _fork -> clone -> edit -> PR_ darbplūsmu, ar kuru turpmāk bieži nāksies sastapties kā līdzautoram.
|
||||
|
||||
Pastāsti par savu devumu saviem draugiem un sekotājiem, izmantojot [mūsu vietni](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Tu vari pievienoties arī mūsu slack komandai, ja tev nepieciešama palīdzība vai ir kādi jautājumi. [Pievienojies slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Tagad tu vari līdzdarboties arī citos projektos. Mēs esam sastādījuši sarakstu ar projektiem, kuros ir vienkāršas problēmas, ar kurām tu varētu sākt. Izpēti [projektu sarakstu mūsu vietnē](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Papildu materiāli](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Pamācības citiem rīkiem
|
||||
|
||||
| <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) |
|
||||
@@ -1,141 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Awel Moucharaka
|
||||
|
||||
Fo9ma katbghi tbda chi 7aja jdida katkoun m39da flewl. Dik lkhouf anak tghlet ki3ssbek,5ossosan fach katkoun 5dam m3a nass o5rin. Walakin lblan dl open source w anak t5dm m3a nass f fra9i . Bghina , nsshlou 3likoum bach t3lmou tcharkou fchi projet open source b7al hada l awel mra .
|
||||
|
||||
Rah blan tb9a t9ra kifach dir wla tchouf des tutoriels , walakin wach machi 7ssen nwriwk ki der bla matghlet ? Had lprojet l hadaf dyalou howa y3tek nassa2i7 w 5lik 3a9l : koulma knti mheden , ghat3lem 7ssen. Ila knti 3wal der awel i3ana , tbe3 had l5otowat w ra atsde9lk . Kanwa3dk , ghay3jbek l7al.
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="connecter had repo" />
|
||||
|
||||
Ila makanch 3ndk git f pc dyalk, [ Telechargeh ]( https://help.github.com/articles/set-up-git/ )mn had site.
|
||||
|
||||
## Jbed had repo l3endek (kismiwha hna Fork)
|
||||
|
||||
Brek 3la dik FORK kima kaybanlk f tswira bach twli 3ndek b7al version dyal repo f compte dyalk .
|
||||
|
||||
## Telecharger 3ndk repo (Kismiwha clone )
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="Clone d repo" />
|
||||
|
||||
Daba ,cloner repo dyalk l pc 3ndk. Brek 3la bottona d Clone w copier dik lien (HTTPS houwa sahel) ra kayna bottona 7da lien katcopiehlk nichan .
|
||||
|
||||
7el daba cmd (ila knti f windows) wla terminal (ila kan 3ndk mac wla 5dam b linux) w copier had les commandes li ghanwrik :
|
||||
|
||||
```
|
||||
git clone "dik lien li 3ad copieti"
|
||||
```
|
||||
3andak t5liha hakak hhh "dik lien li 3ad copieti" (bla douk "") kteb tma lien li copieti fhemni .
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copier l'URL dans le presse-papier" />
|
||||
|
||||
Atkoun b7al had chkel :
|
||||
```
|
||||
git clone https://github.com/smytk_dyal_github/first-contributions.git
|
||||
```
|
||||
rah `smytk_dyal_github` hia smya li nta dayr.
|
||||
Daba nta fhad l5twa ghatelecharger ga3 had repo 3ndk f pc bach tbda tbeddel fiha.
|
||||
|
||||
## Swb branche jdida dyalk
|
||||
|
||||
Daba f cmd nit wla terminal , d5l l dik lmilf li 3ad telechargeti (kteb had l3iba la ma3rftich d5l manuellement ) :
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Daba ha kifach ghatswb branch dyalk `git checkout` :
|
||||
```
|
||||
git checkout -b "smya_dlbranch"
|
||||
```
|
||||
|
||||
Par exemple :
|
||||
```
|
||||
git checkout -b add-brahim
|
||||
```
|
||||
(Machi darori tder f smya add , walakin gha bach nfhmo 3lach zdtiha)
|
||||
|
||||
## Bdl fl file d Contributors
|
||||
|
||||
Daba d5el l fichier dyal `Contributors.md` fchi editeur , zid smytk w chi lien ila bghiti (3andak der chi7aja 5ayba). Ila ktbti daba f dik cmd/terminal `git status`, aybanulk l3ibat li bdlti. Daba zidhoum l branch dyalk add-brahim bhad l3iba dyal `git add` :
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Sauvegardeha b `git commit`:
|
||||
```
|
||||
git commit -m "Add <smytk> to Contributors list"
|
||||
```
|
||||
der fblasst `<smytk>` smytk dbss7 (brahim matalan).
|
||||
|
||||
## PUSHIIII
|
||||
|
||||
Daba ghatpushi had lmodofication li derti l github b `git push` :
|
||||
```
|
||||
git push origin <smya_dlbranch>
|
||||
```
|
||||
ana knt mssmiha add-brahim , nta bdlha bachma knti dayr .
|
||||
|
||||
## 7et les modifications bach ytchafo
|
||||
|
||||
Ila rj3ti l github atl9a dik l3iba dyal `Compare & pull request`
|
||||
brek 3liha a5ay.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Sf brek 3liha bach tle3 lnass li mss2oulin 3la hadchi.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Chwia mbe3d matjm3 dik lmodifications li derti . Aywslk mail ki9ololk fih ra safi dkchi dyalk nadi.
|
||||
|
||||
branche main dyalk maghaytbdel fiha walou daba . Ila bghiti ta main dyalk ykoun msynchroniser tbe3 had les étapes.
|
||||
|
||||
## 5li main dyalk synchronisé m3a contributors
|
||||
|
||||
B3da rje3 lmain matb9ach fdik add-brahim
|
||||
```
|
||||
git checkout main
|
||||
```
|
||||
|
||||
zid lien d repo as `upstream remote url` :
|
||||
```
|
||||
git remote add upstream https://github.com/smytk_d_github/first-contributions
|
||||
```
|
||||
Ghi dik changes ydaro , 5ssk moraha tjbd version jdida dyal repo dyalk:
|
||||
```
|
||||
git fetch upstream
|
||||
```
|
||||
|
||||
Hna kan9lbo 3la ga3 tghyirat li kaynin f lfork dyalk nta (upstream remote). Daba 3ad 5ssk tjm3 had jdida m3a repo dyalk (main) :
|
||||
```
|
||||
git rebase upstream/main
|
||||
```
|
||||
Daba ga3 tghyirat kaynin fl main. ila pushiti modifications aydaro ta f fork dyalk :
|
||||
```
|
||||
git push origin main
|
||||
```
|
||||
|
||||
Daba ra jm3na branch dyal `<add-brahim>` m3a l main dyalna , w jm3na lmain dyalna m3a main dyalhom (yarbi tkoun fhmtini hh).Daba dik li drti flwl dyal `<add-votre-nom>` mab9atch 3ndha fa2ida , ila bghiti t7ydha :
|
||||
```
|
||||
git branch -d <add-brahim>
|
||||
```
|
||||
w ymklk t7yda ta mn repo li b3ida :
|
||||
```
|
||||
git push origin --delete <add-votre-nom>
|
||||
```
|
||||
Machi darori t7yd lbranch walakin raha salat 5smtha ma3ndha lach tb9a tma .
|
||||
|
||||
## Tutoriels bchi twichyat o5rin
|
||||
|
||||
|
||||
| <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/2/2d/Visual_Studio_Code_1.18_icon.svg" 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) |
|
||||
|
||||
## Fin nmchi daba ?
|
||||
|
||||
Ymklkoum tjiw l slack fin kayna lfr9a d hadchi kaml , n9do n3awnokom w njawbo 3la chi ass2ila [Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
|
||||
@@ -1,129 +0,0 @@
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
[<img align="right" width="150" src="assets/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)
|
||||
|
||||
# Prvi doprinos
|
||||
|
||||
Ovaj projekat ima za cilj da pojednostavi i vodi početnike do njihovog prvog doprinosa. Ako želite da napravite vaš prvi doprinos, pratite korake ispod.
|
||||
|
||||
_Ako nijeste navikli da koristite komandnu liniju, [evo tutorijala koji koristi GUI alatke.](#Tutorijali-koji-koriste-druge-alatke)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="napravite kopiju repozitorijuma" />
|
||||
|
||||
#### Ako nemate git na svojoj mašini, [instalirajte ga ovdje](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Napravite kopiju repozitorijuma
|
||||
|
||||
Napravite kopiju _(fork)_ ovog repozitorijuma tako što ćete kliknuti na dugme **fork** na vrhu stranice.
|
||||
|
||||
Ovo će kreirati kopiju ovog repozitorijuma na vašem nalogu.
|
||||
|
||||
## Klonirajte repozitorijum
|
||||
|
||||
<img align="right" width="300" src="assets/clone.png" alt="Klonirajte repozitorijum" />
|
||||
|
||||
Sada klonirajte repozitorijum na vašu mašinu. Idite na vaš GitHub profil, otvorite kopiju repozitorijuma, kliknite na dugme **code** i kliknite ikonicu *copy to clipboard*.
|
||||
|
||||
Otvorite terminal i unesite sledeću git komandu:
|
||||
|
||||
```
|
||||
git clone "url koji ste upravo kopirali"
|
||||
```
|
||||
|
||||
Umjesto "url koji ste upravo kopirali" (bez znaka navoda) unesite url repozitorijuma koji ste kopirali u prethodnom koraku.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="Kopirajte URL" />
|
||||
|
||||
Na primjer:
|
||||
|
||||
```
|
||||
git clone https://github.com/korisnicko-ime/first-contributions.git
|
||||
```
|
||||
|
||||
Umjesto `korisnicko-ime` napišite korisničko ime za vaš GitHub nalog. Na ovaj način kopirate sadržaj repozitorijuma na vašu mašinu.
|
||||
|
||||
## Kreiranje grane _(branch)_
|
||||
|
||||
Prebacite se u radni direktorijum na vašem računaru (ukoliko već nijeste tu):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Sada kreirajte granu koristeći komadu `git checkout`:
|
||||
|
||||
```
|
||||
git checkout -b ime-vase-grane
|
||||
|
||||
```
|
||||
|
||||
Na primjer:
|
||||
|
||||
```
|
||||
git checkout -b add-nikola-popovic
|
||||
```
|
||||
|
||||
(Ime grane ne mora sadržati riječ _add_, ali je to preporučljivo jer je poenta ove grane da se doda vaše ime na listu kontributora.)
|
||||
|
||||
## Napravite potrebne promjene i potvrdite ih
|
||||
|
||||
Sada otvorite fajl `Contributors.md` u tekst editoru i dodajte vaše ime. Nemojte dodati svoje ime na početku ili na kraju fajla. Stavite ga bilo gdje između. Sada, sačuvajte fajl.
|
||||
|
||||
<img align="right" width="450" src="assets/git-status.png" alt="git status" />
|
||||
|
||||
Ako se vratite na radni direktorijum i izvršite komandu `git status`, vidjećete da su prisutne promjene.
|
||||
|
||||
Dodajte te promjene u granu koju ste kreirali u prethodnim koracima koristeći komandu `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Sada potvrdite te izmjene koristeći komandu `git commit` :
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
Umjesto `<your-name>` napišite vaše ime.
|
||||
|
||||
## Pošaljite izmjene u repozitorijum
|
||||
|
||||
Pošaljite izmjene koje ste napravili u repozitorijum na GitHub-u koristeći komandu `git push`:
|
||||
|
||||
```
|
||||
git push origin <add-ime-vase-grane>
|
||||
```
|
||||
|
||||
Umjesto `<add-ime-vase-grane>` napišite ime grane koju ste kreirali ranije.
|
||||
|
||||
## Pošaljite vaše izmjene na provjeru
|
||||
|
||||
Ako odete na repozitorijum na GitHub-u, vidjećete dugme **Compare / Pull Request**. Kliknite to dugme.
|
||||
|
||||
<img style="float: right;" src="assets/compare-and-pull.png" alt="Kreirajte pull request" />
|
||||
|
||||
Sada pošaljite vaš pull request.
|
||||
|
||||
<img style="float: right;" src="assets/submit-pull-request.png" alt="Pošaljite pull request" />
|
||||
|
||||
Uskoro, ja ću spojiti promjene koje ste napravili sa master granom repozitorijuma. Dobićete mejl potvrde kada se grane spoje.
|
||||
|
||||
## Šta dalje?
|
||||
|
||||
Čestitamo! Upravo ste izvršili standradni _fork -> clone -> edit -> pull request_ proces koji ćete često gledati dok doprinosite kodu.
|
||||
|
||||
Proslavite vaš doprinos i podijelite ga sa prijateljima i pratiocima kroz [stranicu](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Ukoliko vam je potrebna pomoć ili imate neka pitanja, možete da se priključite našem [Slack timu](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Sada možete početi da doprinosite i drugim projektima. Sastavili smo listu projekata sa jednostavim problemima na kojima možete početi da radite. Pogledajte [listu projekata na stranici](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Dodatni materijali](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Tutorijali koji koriste druge alatke
|
||||
|
||||
| <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) |
|
||||
@@ -1,145 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Fandraisana anjara voalohany
|
||||
|
||||
Manahirana antsika foana indraindray ny manomboka zavatra amin'ny voalohany. Tsy mampahazo aina ny manao diso, indrindra moa fa rehefa mifampizara asa sy rehefa miara-miasa aman'olona. Ny tontolo eo amin'ny rindrakajy malalaka anefa dia miompana tanteraka eo amin'ny fiaraha-miasa miaraka amin'ireo olona efa mati-hanina. Izany indrindra ny antom-pisian'ito loharano misokatra ito mba hanamora ny fianaran'ireo vaovao izay handray anjara voalohany eo amin'ny fifampizarana eo amin'ny tontolon'ny rindrakajy malalaka.
|
||||
|
||||
Tadidio fa tsy hahay mihitsy ianao raha tsy manandrana ary ny fahadisoana azo no hahazoanao traikefa. Raha te hahay ny fomba fandraisana anjara amin'ny fifampizarana ary dia araho ireto dingana manaraka ireto:
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="Mampifandraiso ity takelaka ity" />
|
||||
|
||||
Raha mbola tsy misy git ny solosainao, [ ampidiro izy ]( https://help.github.com/articles/set-up-git/ ).
|
||||
|
||||
## Hampifandraiso ity takelaka ity (izay antsoina koa hoe "Fork")
|
||||
|
||||
Raha te hampifandray an'ity takelaka ity amin'ny kaontinao ianao dia tsindrio ilay bokotra "fork" etsy ambony. Lasa misy dika mitovy amin'ity takelaka ity ao amin'ny kaontinao avy eo.
|
||||
|
||||
## Dikao mitovy ity takelaka ity ao amin'ny solosainao
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="Dikao mitovy ity takelaka ity" />
|
||||
|
||||
Raha te hanao dika mitovy an'ity takelaka ity ianao, dia mankanesa ao amin'ny kaontinao "Github" ary sokafy ilay takelaka nampifandraisinao. Tsindrio ilay bokotra misy soratra hoe "Code" etsy ambony, tsindrio ilay sary fahamantarana manao kopia.
|
||||
|
||||
Sokafy avy eo fandefasana kaomandy, ary alefaso ity kaomandy ity:
|
||||
|
||||
```
|
||||
git clone "Rohy izay natao kopia"
|
||||
```
|
||||
|
||||
Ilay "Rohy izay natao kopia" (tsy misy faingo) dia ny rohy misy ilay takelaka ao amin'ny kaontinao. Jereo eo ambony ny fomba hahazoana ilay rohy.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="Ataovy kopia ny rohy" />
|
||||
|
||||
Ohatra:
|
||||
```
|
||||
git clone https://github.com/ny-anaranao/first-contributions.git
|
||||
```
|
||||
Ilay `ny-anaranao` dia ny anaran'ny kaontinao "Github". Eto dia manao dika mitovy ny takelaka avy lavitra ho ao amin'ny solosainao.
|
||||
|
||||
## Mamorona sampana
|
||||
|
||||
Midira ao amin'ny toerana misy ilay tetikasa izay nataonao kopia (raha mbola tsy ao):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Mamorona sampana vaovao ka alefaso ny kaomandy `git checkout` :
|
||||
```
|
||||
git checkout -b <add-votre-nom>
|
||||
```
|
||||
|
||||
Ohatra:
|
||||
```
|
||||
git checkout -b add-crystel-ratsimbazafy
|
||||
```
|
||||
|
||||
## Ataovy ny fanovana ilaina rehetra
|
||||
|
||||
Sokafy ny rakitra `Contributors.md` ao amin'ny fanoratanao ny soratra, dia hampidiro ao ny anaranao, dia tehirizo.Raha sokafanao ny fandefasana kaomandy ka alefanao ny `git status`, dia ho hitanao fa misy ny zavatra niova. Hampidiro anaty lisitra mba ho afaka hiditra ao amin'ny sampana zay noforoninao ny fanovana amin'ny alalan'ny kaomandy `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Hampidiro ao amin'ny sampana amin'izay ny fanovana nataonao amin'ny alalan'ny `git commit`:
|
||||
```
|
||||
git commit -m "Add <ny-anaranao> to Contributors list"
|
||||
```
|
||||
Soloy ny anaranao ilay `<ny-anaranao>`.
|
||||
|
||||
## Alefaso any amin'ilay takelaka ao amin'ny Github ny fanovanao
|
||||
|
||||
Raha te hanao an'izay dia alefaso ny kaomandy `git push` :
|
||||
```
|
||||
git push origin <sampana>
|
||||
```
|
||||
Soloy ilay sampana izay noforoninao ilay hoe `<sampana>`.
|
||||
|
||||
## Alefaso ny fangatahano mba hojerena
|
||||
|
||||
Raha mitsidika ny takelakao ao amin'ny Github ianao dia mahita bokotra `Compare & pull request`. Tsindrio io bokotra io.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="Mamorona fangatahana" />
|
||||
|
||||
Alefaso ny fangatahana avy eo.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="Mandefa ny fangatahana" />
|
||||
|
||||
Ho hakambako ao amin'ny sampana fiaingan'ny tetikasa ny zavatra nataonao avy eo. Mahazo mailaka ianao avy eo mba hahafantaranao fa vita ny fanakambanana.
|
||||
|
||||
Ny sampana fiaingan'ny tetikasa anao dia tsy maharay ilay fanovanao fa mila raisinao manokana izay fanovana farany ao amin'ny sampana fiaingan'ny tetikasa. Araho ireto dingana manaraka ireto.
|
||||
|
||||
## Tazomy tsy ho lany andro ny takelaka nampifandraisinao tamin'ny tena izy.
|
||||
|
||||
Mankanesa ao amin'ny sampana fiaingana.
|
||||
```
|
||||
git checkout main
|
||||
```
|
||||
|
||||
Dia hampidiro ny rohy misy ny takelak'ilay tetik'asa naotaonao fampifandraisana `upstream remote url`:
|
||||
|
||||
```
|
||||
git remote add upstream https://github.com/Roshanjossey/first-contributions
|
||||
```
|
||||
|
||||
Fomba iray atao mba hahahafantaran'i git fa misy zavatra vaovao ao amin'io takelaka io izay antsoina hoe `upstream`. Rehefa vita izay dia alaivo ny fanovana vaovao rehetra ao amin'ilay takelaka nampifandraisina:
|
||||
|
||||
```
|
||||
git fetch upstream
|
||||
```
|
||||
Alefaso ao amin'ny sampana fiaingana misy ny takelakao anaty solosainao ny zavatra vaovao rehetra:
|
||||
|
||||
```
|
||||
git rebase upstream/main
|
||||
```
|
||||
|
||||
Alefaso any amin'ny takelaka ao amin'ny github anao ny fanovana azonao rehetra:
|
||||
|
||||
```
|
||||
git push origin main
|
||||
```
|
||||
|
||||
Afaka fafana amin'izay ny sampana izay noforoninao rehefa vita izay:
|
||||
```
|
||||
git branch -d <ny-anaran-ny-sampana>
|
||||
```
|
||||
Afaka fafana ihany koa ny sampana avy lavitra:
|
||||
```
|
||||
git push origin --delete <add-votre-nom>
|
||||
```
|
||||
|
||||
## Fanoroana hafa izay mampiasa fitaovana hafa
|
||||
|
||||
|
||||
| <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/2/2d/Visual_Studio_Code_1.18_icon.svg" 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) |
|
||||
|
||||
## Ny atao manaraka ?
|
||||
|
||||
Afaka miditra ho mpikambana ao amin'ny ekipanay ao amin'ny Slack ianao raha mila fanontaniana na fanampiana. [Hiditra ho mpikambana ao amin'ny Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
|
||||
@@ -1,123 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
# Први чекори
|
||||
|
||||
Тешко е. Секогаш е тешко кога нешто се прави за прв пат. Кога соработуваме со други луѓе, правењето грешки е непријатно. Затоа сакавме да го поедноставиме начинот на кој новите соработници на отворен код учат и допринесуваат за прв пат.
|
||||
|
||||
Читањето на статии и гледањето на видеа помага до некаде, но нема подобар начин за учење од вежбањето. Целта на овој проект е да се обезбеди вежба и да се поедностави начинот по кој почетниците допринесуваат отворен код. Ако сакате да го направите својот прв придонес, тогаш следете ги долунаведените чекори.
|
||||
|
||||
#### *Ако не сакате да користите command line (терминал), [овде имате упатства за GUI](#Вежби-за-користење-на-други-програми)*
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Ако немате git на вашиот компјутер, [инсталирајте го]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Направете Разгранување (Fork) на ова складиште (repository)
|
||||
|
||||
Направете разгранување на складиштето со притискање на копчето "Fork" кое се наоѓа на горниот дел на оваа страница.
|
||||
Вака ќе направите копија на складиштето во вашиот GitHub профил.
|
||||
|
||||
## Клонирајте го овоа складиште
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Сега треба да го клонирате складиштето во вашиот компјутер. Отидете во вашиот GitHub профил, отворете го разгранетото складиште,
|
||||
кликнете на копчето "Clone" и копирајте го линкот. Исто така може да притиснете на иконата за копирање (Copy to clipboard)
|
||||
|
||||
Отворете го терминалот и воведете ја следната команда:
|
||||
|
||||
```
|
||||
git clone "линкот кој го копиравте"
|
||||
```
|
||||
На местото на "линкот кој го копиравте" (без наводници) поставете го линкот на складиштето (Вашето Разгранување на овој проект). Погледнете ги претходните чекори за да видете како да го добиете линкот.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
На пример:
|
||||
```
|
||||
git clone https://github.com/vashiot-username/first-contributions.git
|
||||
```
|
||||
со преименување на `vashiot-username` во вашето корисничко име. Во овој чекор правите копија на складиштето first-contributions од GitHub кон вашиот компјутер.
|
||||
|
||||
## Создавање на гранка (branch)
|
||||
|
||||
Променете ја локацијата на складиштето во вашиот компјутер (Ако сеуште не сте ја промениле):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Сега создајте гранка со помош на командата `git checkout`:
|
||||
```
|
||||
git checkout -b <vnesete-ime-na-vashata-granka>
|
||||
```
|
||||
|
||||
На пример:
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
(Името на гранката не мора да го содржи зборот *add*, но се препорачува, затоа што целта на оваа гранка е да го додадете вашето име во списокот.)
|
||||
|
||||
## Направете ги потребните промени и извршете (commit) ги
|
||||
|
||||
Сега отворете го фајлот `Contributors.md` во уредник за текст и додадете го вашето име. Не додавајте го на почетокот или крајот на фајлот. Поставете го некаде на средината. Зачувајте ги промените.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
|
||||
Ако ја извршете командата `git status` во директоријата на складиштето, ќе забележите дека има промени.
|
||||
|
||||
|
||||
Зачувајте ги промените на создадената гранката со помош на командата `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Сега извршете ги промените со командата `git commit`:
|
||||
```
|
||||
git commit -m "Add <vasheto-ime> to Contributors list"
|
||||
```
|
||||
со промена на `<vasheto-ime>` со вашето име.
|
||||
|
||||
## Поставете (Push) ги промените во GitHub
|
||||
|
||||
Поставете ги вашите промени со командата `git push`:
|
||||
```
|
||||
git push origin <vnesete-ime-na-vashata-granka>
|
||||
```
|
||||
со промена на `<vnesete-ime-na-vashata-granka>` во името на вашата гранка, која ја создадовте претходно.
|
||||
|
||||
## Поднесете ги вашите промени за преглед.
|
||||
|
||||
Ако отидете во вашето складиште во GitHub, ќе го забележите копчето `Compare & pull request`. Притиснете го.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Сега поднесете ги вашите промени за преглед.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Наскоро ќе ги спојам (merge) сите ваши промени во главната гранка (мастер branch) на овој проект. Ќе бидете известени по пат на електронска пошта за спојот на вашите промени.
|
||||
|
||||
## Што е следно?
|
||||
|
||||
Честитки! Само што ги завршивте _fork -> clone -> edit -> PR_ операции, со кои ќе се соочувате често како соработник!
|
||||
|
||||
Прославете ги вашите придонеси и споделете ги со пријатели и следители со посета на [веб-апликацијата](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Можете да станете дел од нашиот slack team ако ви треба помош или имате прашања [Стани дел](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Сега е време да започнете да допринесувате кон други проекти. Ние имаме создадено список со лесни проекти за да започнете. [Види ја листата](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Дополнителен материал](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Вежби за користење на други програми
|
||||
|
||||
| <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) |
|
||||
@@ -1,137 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# ആദ്യ സംഭാവനകൾ (First Contributions)
|
||||
|
||||
ആദ്യമായി ഒരു കാര്യം ചെയ്യുക എന്നുള്ളത് വളരെ ബുദ്ധിമുട്ടാണ്. പ്രത്യേകിച്ച്, മറ്റു പലരുടെയും ഒപ്പം ജോലി ചെയ്യുമ്പോൾ തെറ്റ് വരുന്നത് അത്ര സുഖകരമായ കാര്യം അല്ല. സ്വതന്ത്ര സോഫ്റ്റ്വെയറിലേക്ക് ആദ്യമായി സംഭാവന ചെയ്യുന്നവർക്ക് അതിനെ പറ്റി പഠിക്കാനും പങ്കാളി ആകുവാനും വേണ്ടി കുറച്ച് കൂടെ എളുപ്പമായ എന്തെങ്കിലും ഉണ്ടാക്കണമെന്നായിരുന്നു ഞങ്ങളുടെ ആഗ്രഹം.
|
||||
ലേഖനങ്ങൾ വായിക്കുന്നതും വീഡിയോ കാണുന്നതും ഒക്കെ സഹായകരമാണ്. പക്ഷേ ചെയ്ത് തന്നെ പഠിക്കുന്നതാണ് ഏറ്റവും നല്ലത്.
|
||||
|
||||
|
||||
ഈ പ്രൊജക്റ്റ് ഇതിനെ പറ്റി പരിചയം ഇല്ലാത്ത ഒരാൾക്ക് ആദ്യത്തെ സംഭാവന നല്കാൻ ഉള്ള ഒരു വഴികാട്ടി ആണ്.
|
||||
|
||||
|
||||
നിങ്ങളും നിങ്ങളുടെ ആദ്യ സംഭാവന നൽകാൻ ആഗ്രഹിക്കുന്നു എങ്കിൽ താഴെ പറയുന്നത് പോലെ ചെയ്യുക.
|
||||
|
||||
|
||||
#### *താങ്കൾക്ക് കമാൻഡ് ലൈൻ ഉപയോഗിച്ച് പരിചയം ഇല്ലെങ്കിൽ, [GUI ഉപയോഗിച്ച് ചെയ്യാൻ ഉള്ള നിർദേശങ്ങൾ ഇവിടെ ലഭ്യമാണ്](#മറ്റു-ഉപകരണങ്ങൾ-ഉപയോഗിച്ച്-ചെയ്യുന്നതിനെ-പറ്റിയുള്ള-ലേഖനങ്ങൾ)*.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
താങ്കളുടെ കമ്പ്യൂട്ടറിൽ ഗിറ്റ് (git) ഇല്ലെങ്കിൽ, [ഇൻസ്റ്റാൾ ചെയ്യുക](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## ഈ റെപ്പോസിറ്ററി ഫോർക്ക് (fork) ചെയ്യുക
|
||||
|
||||
ഈ പേജിന്റെ ഏറ്റവും മുകളിൽ ഉള്ള ഫോർക്ക് ബട്ടൺ ഉപയോഗിച്ച് ഈ റെപ്പോസിറ്ററി ഫോർക്ക് ചെയ്യുക. ഇങ്ങനെ ചെയ്യുമ്പോൾ നിങ്ങളുടെ അക്കൗണ്ടിൽ ഈ റെപ്പോസിറ്ററിയുടെ ഒരു പകർപ്പ് സൃഷ്ടിക്കപ്പെടുന്നു.
|
||||
|
||||
## ഈ റെപ്പോസിറ്ററി ക്ലോൺ (clone) ചെയ്യുക
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
ഇനി ഫോർക്ക് ചെയ്ത റെപ്പോസിറ്ററി നിങ്ങളുടെ കമ്പ്യൂട്ടറിലേക്ക് ക്ലോൺ ചെയ്യുക. നിങ്ങളുടെ ഗിറ്റ്ഹബ് (GitHub) അക്കൗണ്ട് എടുത്ത് അതിൽ ഫോർക്ക് ചെയ്ത റെപ്പോസിറ്ററി തുറക്കുക. എന്നിട്ട് മുകളിൽ ക്ലോൺ ബട്ടണിലെ *കോപ്പി ടു ക്ലിപ്പ് ബോർഡ് (Copy to clipboard)* എന്ന ഐക്കൺ ക്ലിക്ക് ചെയ്യുക.
|
||||
|
||||
എന്നിട്ട് ഒരു ടെർമിനൽ എടുത്ത് താഴെ പറയുന്ന ഗിറ്റ് കമാൻഡ് റൺ ചെയ്യുക:
|
||||
|
||||
```
|
||||
git clone <നിങ്ങളുടെ-ലിങ്ക്>
|
||||
```
|
||||
|
||||
ഇതിൽ `<നിങ്ങളുടെ-ലിങ്ക്>` എന്ന് പറയുന്നത് താങ്കളുടെ (ഫോർക്ക് ചെയ്ത) റെപ്പോസിറ്ററി ലിങ്ക് ആണ്. ലിങ്ക് എങ്ങനെ കോപ്പി ചെയ്യാം എന്നറിയാൻ ഇതിനു മുൻപ് ഉള്ള നിർദേശം നോക്കുക.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
ഉദാഹരണം:
|
||||
|
||||
```
|
||||
git clone https://github.com/<താങ്കൾ>/first-contributions.git
|
||||
```
|
||||
|
||||
ഇതിൽ `<താങ്കൾ>` എന്നതിന് പകരം നിങ്ങളുടെ ഗിറ്റ്ഹബ് യൂസർനെയിം കൊടുക്കുക. ഇപ്പോൾ നിങ്ങൾ ചെയ്യുന്നത് നിങ്ങളുടെ ഗിറ്റ്ഹബിലെ ഫസ്റ്റ്-കോണ്ട്രിബൂഷൻസ് (first-contributions) റെപ്പോസിറ്ററിയിൽ ഉള്ളവ നിങ്ങളുടെ കമ്പ്യൂട്ടറിലേക്ക് കോപ്പി ചെയ്യുകയാണ്.
|
||||
|
||||
## ഒരു ശാഖ (ബ്രാഞ്ച്, Branch) ഉണ്ടാക്കുക
|
||||
|
||||
നിങ്ങളുടെ റെപ്പോസിറ്ററിയിലേക്ക് കടക്കുക:
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
എന്നിട്ട് `git checkout` എന്ന കമാൻഡ് ഉപയോഗിച്ച് ഒരു ബ്രാഞ്ച് ഉണ്ടാക്കുക:
|
||||
|
||||
```
|
||||
git switch -c <നിങ്ങളുടെ-പുതിയ-ബ്രാഞ്ചിന്റെ-പേര്>
|
||||
```
|
||||
|
||||
ഉദാഹരണം:
|
||||
|
||||
```
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
(ബ്രാഞ്ചിന്റെ പേരിൽ add എന്ന് ഉണ്ടാകണം എന്ന് നിർബന്ധം ഇല്ല. പക്ഷെ നിങ്ങളുടെ ഉദ്ദേശം നിങ്ങളുടെ പേര് ഇതിൽ ഉൾപ്പെടുത്തണം എന്നത് ആണെന്നതിനാൽ അത് കൊടുക്കുന്നതാണ് നല്ലത്.)
|
||||
|
||||
## ആവശ്യത്തിനുള്ള വ്യത്യാസങ്ങൾ വരുത്തി അവ കമ്മിറ്റ് (commit) ചെയ്യുക
|
||||
|
||||
ഇനി `Contributors.md` എന്ന ഫയൽ ഒരു എഡിറ്റർ ഉപയോഗിച്ച് തുറന്നതിനു ശേഷം താങ്കളുടെ പേര് അതിൽ ഉൾപ്പെടുത്തുക. അങ്ങനെ ചെയ്യുമ്പോൾ തുടക്കത്തിലോ അവസാനത്തിലോ അല്ലാതെ ഇടയിൽ എവിടെയെങ്കിലും ഉൾപെടുത്തുക. എന്നിട്ട് ആ ഫയൽ സേവ് ചെയ്യുക.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
താങ്കളുടെ പ്രൊജക്റ്റ് ഡയറക്ടറിയിൽ ചെന്ന് `git status` എന്ന കമാൻഡ് അടിച്ചു നോക്കിയാൽ താങ്കൾ വരുത്തിയ വ്യത്യാസങ്ങൾ കാണാൻ സാധിക്കും.
|
||||
|
||||
ഈ വ്യത്യാസങ്ങൾ `git add` കമാൻഡ് ഉപയോഗിച്ച് നിങ്ങളുടെ ബ്രാഞ്ചിലേക്ക് ചേർക്കുക:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
ഇനി നിങ്ങൾ ഉണ്ടാക്കിയ വ്യത്യാസങ്ങൾ `git commit` കമാൻഡ് ഉപയോഗിച്ച് കമ്മിറ്റ് ചെയ്യുക:
|
||||
|
||||
```
|
||||
git commit -m "Add <താങ്കളുടെ-പേര്> to Contributors list"
|
||||
```
|
||||
|
||||
ഇതിൽ `<താങ്കളുടെ-പേര്>` എന്ന സ്ഥാനത്ത് താങ്കളുടെ ശരിയായ പേര് കൊടുക്കുക.
|
||||
|
||||
## വ്യത്യാസങ്ങൾ ഗിറ്റ്ഹബിലേക്ക് ചേർക്കുക (push)
|
||||
|
||||
`git push` കമാൻഡ് ഉപയോഗിച്ച് വ്യത്യാസങ്ങൾ ഗിറ്റ്ഹബിലേക്ക് പുഷ് ചെയ്യുക:
|
||||
|
||||
|
||||
```
|
||||
git push origin <താങ്കളുടെ-ബ്രാഞ്ചിന്റെ-പേര്>
|
||||
```
|
||||
|
||||
ഇതിൽ <താങ്കളുടെ-ബ്രാഞ്ചിന്റെ-പേര്> എന്നതിന് പകരം താങ്കൾ നേരത്തെ ഉണ്ടാക്കിയ ബ്രാഞ്ചിന്റെ പേര് കൊടുക്കുക.
|
||||
|
||||
## നിങ്ങളുടെ വ്യത്യാസങ്ങൾ പരിശോധനക്കായി (review) സമർപ്പിക്കുക
|
||||
|
||||
നിങ്ങൾ ഇപ്പോൾ നിങ്ങളുടെ ഗിറ്റ്ഹബ് റെപ്പോസിറ്ററിയിൽ പോയി നോക്കിയാൽ അവിടെ `Compare & pull request` എന്ന ഒരു ബട്ടൺ കാണാം. അതിൽ അമർത്തുക.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
ഇനി പുൾ റിക്വസ്റ്റ് (pull request) കൊടുക്കുക.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
വൈകാതെ തന്നെ ഞാൻ താങ്കളുടെ വ്യത്യാസങ്ങൾ പ്രധാന ബ്രാഞ്ചിലേക്ക് ചേർക്കുന്നതായിരിക്കും. അപ്പോൾ താങ്കൾക്ക് ഒരു ഇമെയിൽ അറിയിപ്പ് ലഭിക്കും.
|
||||
|
||||
## ഇവിടെ നിന്ന് ഇനി എങ്ങോട്ട്?
|
||||
|
||||
അഭിനന്ദനങ്ങൾ! താങ്കൾ താങ്കളുടെ ആദ്യത്തെ _fork -> clone -> edit -> PR_ പടികൾ വിജയകരമായി പൂർത്തിയാക്കിയിരുന്നു. ഒരു സംഭാവകൻ/സംഭാവിക എന്ന നിലക്ക് ഇത് താങ്കൾക്ക് ഇടയ്ക്കിടെ ചെയ്യേണ്ടി വരുന്ന ഒരു കാര്യം ആണ്!
|
||||
|
||||
താങ്കളുടെ സംഭാവന സുഹൃത്തുക്കളും പിൻഗാമികളുമായി (followers) പങ്കിട്ട് ആഘോഷിക്കുവാനായി ഈ [വെബ് ആപ്പ് ഉപയോഗിക്കുക](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
താങ്കൾക്ക് എന്തെങ്കിലും സഹായം വേണമെങ്കിൽ, അല്ലെങ്കിൽ എന്തെങ്കിലും ചോദ്യങ്ങൾ ഉണ്ടെങ്കിൽ ഞങ്ങളുടെ [slack team-ൽ ചേരുവാനായി റിക്വസ്റ്റ് അയക്കുക](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
ഇനി താങ്കൾക്ക് മറ്റുള്ള പ്രൊജെക്ടുകളിൽ സംഭാവന ചെയ്യുവാൻ സാധിക്കും. താങ്കൾക്ക് വേഗം തുടങ്ങുവാൻ വേണ്ടി ഞങ്ങൾ എളുപ്പത്തിൽ തീർക്കാവുന്ന പ്രശ്നങ്ങൾ (issues) ഉള്ള പ്രോജക്ടുകളുടെ ഒരു ലിസ്റ്റ് ഉണ്ടാക്കിയിട്ടുണ്ട്. അത് ഈ [പ്രോജക്ടുകളുടെ ലിസ്റ്റിൽ](https://firstcontributions.github.io/#project-list) ഉൾപ്പെടുത്തിയിട്ടുണ്ട്.
|
||||
|
||||
### [കൂടുതൽ വായിക്കുക](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## മറ്റു ഉപകരണങ്ങൾ ഉപയോഗിച്ച് ചെയ്യുന്നതിനെ പറ്റിയുള്ള ലേഖനങ്ങൾ
|
||||
|
||||
| <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) |
|
||||
@@ -1,139 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Bolomafara(contributions) fɔlɔw
|
||||
|
||||
A ka gɛlɛn tuma bɛɛ ni i ye fɛn dɔ kɛ siɲɛ fɔlɔ min na. Siranya min bɛ mɔgɔ la ka filiw kɛ, o tɛ mɔgɔ lafiya fewu, kɛrɛnkɛrɛnnenya la n’aw bɛ jɛ ka baara kɛ ɲɔgɔn fɛ. Nka porogaramu hɔrɔnma diɲɛ ye jɛkafɔ ni baara kɛli ye kuluw kɔnɔ. Ani fana, an b’a fɛ ka dɛmɛ donbaga kuraw bolo minnu bɛ porogaramu fuw la, olu ka se ka kalan nɔgɔya, an kɛtɔ k’aw kalan bolomafara kɛcogo la siɲɛ fɔlɔ.
|
||||
|
||||
Barokunw ni kalansenw kalanni bɛ se ka dɛmɛ don, nka mun ka fisa ni k’a ɲini k’a sɔrɔ i ma se ka filiw kɛ? Nin porozɛ in kun ye ka bilasirali kɛ ani ka kalandenw ka dɛmɛ fɔlɔ kɛcogo nɔgɔya. Aw ye aw hakili to a la: ni aw hakili sigilen don, aw bɛ kalan kɛ ka ɲɛ. N’i b’a fɛ k’i ka bolomafara fɔlɔ kɛ, i ka nin fɛɛrɛ ninnu labato dɔrɔn. N bɛ layidu ta ko a bɛna kɛ ɲɛnajɛ ye.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="embrancher ce repertoire" />
|
||||
|
||||
Ni git t i ka ɔridinatɛri kan, [ a sigi sen kan]( https://help.github.com/articles/set-up-git/ ).
|
||||
|
||||
## Aw ye nin ɲɛbilasɛbɛn in bolofara (a bɛ fɔ fana ko Fork) .
|
||||
|
||||
Forok kɛ nin ɲɛbilasɛbɛn in na ni fork butɔni digilen ye ɲɛ sanfɛ.
|
||||
O bɛna kɛ sababu ye ka kunnafonisɛbɛn kopi dɔ dilan i ka jatebɔsɛbɛn kan.
|
||||
|
||||
## aw ka kan ka nin ɲɛbilasɛbɛn in Clone
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonez ce répertoire" />
|
||||
|
||||
Sisan, i ka nin ɲɛbilasɛbɛn in clone i ka ɔridinatɛri kɔnɔ. Clone button digi o kɔfɛ *copier dans le presse-papier* taamasiyɛn digi.
|
||||
|
||||
Cikan yɔrɔ dɔ da wuli (n’i bɛ Windows kan) walima terminal (n’i bɛ MacOS walima Linux kan) ka nin git cikan ninnu kɛ:
|
||||
```
|
||||
git clone "URL min ye i kopi kɛ sisan"
|
||||
```
|
||||
wali "URL min ye i kopi kɛ sisan" (ni gillemants tɛ) ye url ye min bɛ kɛ ni ɲɛbilasɛbɛn ye. Aw ye tilayɔrɔ tɛmɛnen lajɛ walasa ka URL sɔrɔ.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copier l'URL dans le presse-papier" />
|
||||
|
||||
misale :
|
||||
```
|
||||
git clone https://github.com/votre-nom-d-utilisateur/first-contributions.git
|
||||
```
|
||||
yɔrɔ min na `i-tɔgɔ` ye i ka GitHub baarakɛla tɔgɔ ye. Yan i bɛ `first-contributions` ɲɛbilasɛbɛn kɔnɔkow kopi ka bɔ GitHub la ka taa i ka ɔridinatɛri kɔnɔ.
|
||||
|
||||
## Bolo(contributions) dɔ dabɔ
|
||||
|
||||
Aw bɛ taa poroze ɲɛbilasɛbɛn kura clone (n’aw tɛ yen fɔlɔ):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Sisan, bolofara(branch) dɔ dabɔ ni cikan ye`git checkout` :
|
||||
```
|
||||
git checkout -b <add-votre-nom>
|
||||
```
|
||||
|
||||
misale :
|
||||
```
|
||||
git checkout -b add-koffi-sani
|
||||
```
|
||||
(Bolofara tɔgɔ man kan ka kɛ ni *add* daɲɛ ye, nka a bɛnnen don k’a don a kɔnɔ bawo nin bolofara in kun ye k’i tɔgɔ fara lisi kan.)
|
||||
|
||||
## Yɛlɛma wajibiyalenw kɛ ani k’u bila
|
||||
|
||||
Sisan, `Contributors.md` file da wuli sɛbɛnnikɛlan dɔ kɔnɔ, k'i tɔgɔ fara a kan, k'a mara. N'i ye cikan-sɛbɛn da wuli ka `git status` cikan baara, i b'a ye ko fɛn dɔw b'a la. Aw ye nin bεnkanw Fàra bolofara kan aw ye min Dabɔ sisan ni `git add` cikan ye:
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Sisan, aw bɛ o fɛn caman Changements (Yɛlɛma) kɛ ni cikan(commade) ye`git commit`:
|
||||
```
|
||||
git commit -m "Add <votre-nom> to Contributors list"
|
||||
```
|
||||
ni `<add-votre-nom>` bilali ye i tɔgɔ nɔ na
|
||||
|
||||
## Yɛlɛma caman bɛ GitHub (GitHub) la
|
||||
|
||||
Aw bɛ aw ka fɛn caman Changements (Yɛlɛma) Gɛn ni cikan ye `git push` :
|
||||
```
|
||||
git push origin <add-votre-nom>
|
||||
```
|
||||
ni `<add-your-name>` bilali ye bolofara min dabɔra ka kɔrɔ, o tɔgɔ bila a nɔ na.
|
||||
|
||||
##Aw ye aw ka fɛn caman ci walasa ka segin u kan
|
||||
|
||||
N’i taara i ka marayɔrɔ la Github kan, i bɛna `Compare & pull request` butɔni ye. Butɔn digi.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Sisan, aw ka sama ɲinini sɛbɛn di
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Sɔɔni n bɛna aw ka fɛn caman Changements bɛɛ fara ɲɔgɔn kan ka kɛ nin porozɛ in bolofara belebele ye. I bɛna kunnafoni imɛri sɔrɔ ni farali banna dɔrɔn.
|
||||
I ka tɔnbolofara belebeleba tɛna yɛlɛma nin waati in na. Walasa k’aw ka bolofara ni ne ta ka bɛn, aw bɛ nin fɛɛrɛ ninnu tigɛ.
|
||||
|
||||
## Aw k’aw ka tɔnbolofara to ɲɔgɔn fɛ ni nin ɲɛbilasɛbɛn in ye
|
||||
|
||||
Fɔlɔ, i ka wuli ka taa bolofara belebeleba(main) la
|
||||
```
|
||||
git checkout main
|
||||
```
|
||||
|
||||
Ani ka n ka ɲɛbilasɛbɛn url fara a kan i n’a fɔ `upstream remote url`:
|
||||
```
|
||||
git yɔrɔjan fara sanfɛ https://github.com/Roshanjossey/fɔlɔ-dɛmɛ
|
||||
```
|
||||
Nin ye fɛɛrɛ ye k’a fɔ git ye ko nin ɲɛbilasɛbɛn in bɔko wɛrɛ bɛ yen ladɛrɛsi kofɔlen na wa an b’a wele ko `upstream`. Ni fɛn caman Changements (Yɛlɛma) farala ɲɔgɔn kan, i ka version kura ɲini n ka ɲɛbilasɛbɛn kɔnɔ:
|
||||
```
|
||||
git fetch upstream
|
||||
```
|
||||
|
||||
Yan an bɛ fɛn caman sɛmɛntiya n ka bolofara kɔnɔ (upstream remote). Sisan i ka kan ka n ka ɲɛbilasɛbɛn lajɛlen kura fara ɲɔgɔn kan i ka bolofara belebele kɔnɔ:
|
||||
```
|
||||
git rebase upstream/main
|
||||
```
|
||||
Yan, i ye fɛn minnu ɲini, an bɛ olu bɛɛ waleya bolofara belebeleba la. N’i ye bolofara belebele gɛlɛya sisan, i ka bolofara fana bɛna fɛn caman Changements:
|
||||
```
|
||||
git push origin main
|
||||
```
|
||||
Kɔlɔsili: Nin sen in na, i bɛ ka gɛlɛya ka taa yɔrɔjan ɲɛbilasɛbɛn na min bɛ wele ko origin.
|
||||
|
||||
Nin hakɛ in na n y'i ka bolofara `<add-your-name>` fara n ka bolofara belebele kan, wa i ye n bolofara belebele fara ɲɔgɔn kan n'i ka bolofara belebele ye. I ka bolofara `<add-your-name>` nafa tɛ yen tugun, o la i bɛ se k'a bɔ yen:
|
||||
```
|
||||
git branch -d <add-votre-nom>
|
||||
```
|
||||
ani i bɛ se k’a bɔko bɔ yɔrɔjan ɲɛbilasɛbɛn kɔnɔ fana:
|
||||
```
|
||||
git push origin --delete <add-votre-nom>
|
||||
```
|
||||
O tɛ wajibi ye, nka bolofara tɔgɔ b’a jira ko a sinsinnen bɛ fɛn kɛrɛnkɛrɛnnen kan kosɛbɛ. A si bɛ se ka kɛ waati surun ye.
|
||||
|
||||
## Kalan minnu bɛ kɛ ni baarakɛminɛn wɛrɛw ye
|
||||
|
||||
|
||||
| <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/2/2d/Visual_Studio_Code_1.18_icon.svg" 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) |
|
||||
|
||||
## An bɛ taa min kɔfɛ?
|
||||
|
||||
Aw bɛ se fana ka fara an ka jɛkulu kan Slack kan ni aw mago bɛ dɛmɛ na walima ni ɲininkali dɔw bɛ aw fɛ. [Rejoindre l'équipe sur Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
@@ -1,130 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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)
|
||||
|
||||
|
||||
# ပထမအကြိမ် ကူညီထောက်ပံ့ခြင်း
|
||||
|
||||
ဘယ်အရာမဆို ပထမဦးဆုံးလုပ်ဆောင်အခါ အခက်အခဲတွေ့ကြုံရပါတယ်။ အထူးသဖြင့် လူအများနဲ့ ပေါင်းသင်းလုပ်ကိုင်ကြတဲ့ အခါ မထင်မှတ်ထားတဲ့ အမှားများတွေ့ရတတ်ပြီး အဆင်မပြေတာတွေဖြစ်တတ်ပါတယ်။ Open source software များကတော့ လူအများနဲ့ ပေါင်းသင်းဆက်ဆံလုပ်ကိုင် ကြရတာပါ။ ဒါကြောင့်မို့ ပထမဦးဆုံးအကြိမ် open-source project များကို ပါဝင် ကူညီထောက်ပံ့သူများကို ပထမဆုံးအကြိမ် ကူညီထောက်ပံ့နိုင်ဖို့နဲ့ လွယ်ကူ ရိုးရှင်းတဲ့ လေ့လာနည်းဖြစ်ဖို့ ရည်ရွယ်ပါတယ်။
|
||||
|
||||
လေ့ကျင်ခန်း စာစောင်တွေနဲ့ ဗီဒီယိုတွေက အကူအညီရနိုင်သော်လဲ တကယ်လက်တွေ့လုပ်ဆောင်တာထက် ပိုကောင်းတာမရှိပါဘူး။ ဒီ project က ပထမဆုံးအကြိမ် ကူညီထောက်ပံ့ပေးမဲ့ သူတွေအတွက် လွယ်ကူ ရှိးရှင်းပြီး အကူအညီအထောက်ပံ့ဖြစ်စေဖို့ ရည်ရွယ်ပါတယ်။ **မှတ်ထားပါ** : သင်ကသက်တောင်သက်သာရှိလေလေ သင်ကပိုကောင်းကောင်းသင်ယူနိုင်လေ ဖြစ်ပါတယ်။ သင်သာ အောက်မှာရှိတဲ့ အဆင့်တိုင်းလုပ်သွားလျှင် သင့်ရဲ့ ပထမဆုံး ကူညီထောက်ပံခြင်းမှာ အဆင်ပြေစွာ ပြီးမြောက်သွားမှာဆိုတာ အာမခံပါတယ်။
|
||||
|
||||
_command line (သို့) terminal အသုံးပြုရတာ အဆင်မပြေပါက [GUI tools အသုံးပြုပုံများကို ဒီမှာကြည့်ရန်](#အခြား-Tools-များ-အသုံးပြုသည့်-tutorial)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### သင့်ကွန်ပျူတာထဲမှာ Git မသွင်းရသေးလျှင် [ဒီမှာ သွင်းနည်းကြည့်ရန်](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## ဒီ repository ကို fork လုပ်ပါ
|
||||
|
||||
Fork လုပ်ဖို့အတွက် စာမျက်နှာအပေါ်နားမှရှိတဲ့ fork ခလုတ် ကိုနှိပ်ပါ။
|
||||
ဒီ repository က သင့် အကောင့်ကို ပုံစံတူပွားအနေနဲ့ ရောက်လာပါမယ်။
|
||||
|
||||
## ဒီ repository ကို clone လုပ်ပါ
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
ခုနက fork လုပ်ထားတဲ့ repository ကို သင့်ကွန်ပျူတာထဲ clone လုပ်ပါမယ်။ သင့် Github အကောင့်ကိုသွားပြီး fork လုပ်ထားတဲ့ repository ကို ဖွင့်ပါ။ Code ဆိုတဲ့ ခလုတ်လေးကို နှိပ်ပြီး _copy to clipboard_ icon လေးကို နှိပ်ပါ။
|
||||
|
||||
command line (သို့) terminal ကိုဖွင့်ပြီး အောက်က Git command ကို run ပါ။
|
||||
|
||||
```
|
||||
git clone "ခုနက copy ထားတဲ့ လင့်ခ်"
|
||||
```
|
||||
|
||||
"ခုနက copy ထားတဲ့ လင့်ခ်" (quotation marks မထည့်ရပါ) ဆိုတာဟာ ဒီ repository (ဒီပရောဂျက်ရဲ့ သင့် fork) ရဲ့ လင့်ခ်ပဲ ဖြစ်ပါတယ်။ ဒီနေရာမှာ အဆင်မပြေဖြစ်ခဲ့ရင် အပေါ်က အဆင့်များကို ပြန်လုပ်ပါ။
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
ဥပမာ:
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
`this-is-you` ဆိုတာ သင့်ရဲ့ Github username ပဲ ဖြစ်ပါတယ်။ ဒီအဆင့်တွေက Github မှာရှိတဲ့ first-contributions repository ကို သင့်ကွန်ပျူတာထဲသို့ ကူးထည့်တာပဲ ဖြစ်ပါတယ်။
|
||||
|
||||
## Branch အသစ်လုပ်ခြင်း
|
||||
|
||||
သင် copy လုပ်ထားတဲ့ repository directory ကို မရောက်သေးရင် အောက်က command ကို run ပြီး ရောက်အောင်သွားပါ။
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Branch အသစ်ကို `git checkout` command ကို run ပြီးလုပ်ပါ။
|
||||
|
||||
```
|
||||
git checkout -b your-new-branch-name
|
||||
```
|
||||
|
||||
ဥပမာ:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
(Branch နာမည်ဘာဖြစ်ဖြစ်ရပါတယ် သို့သော်လဲ ဒီ project ကသင့် နာမည်ကိုထပ်ထည့်မှာဖြစ်လို့ _add_ သင့်နာမည်ကို အားလုံးနဲ့ အဆင်ပြေအောင်ထည့်ပေးပါ။)
|
||||
|
||||
## ပြောင်းစရာရှိတာများ ပြောင်းပြီး ထိုပြောင်းလဲမှုများကို commit လုပ်ခြင်း
|
||||
|
||||
သင့် text editor မှာ `Contributors.md` ကိုဖွင့်ပါ။ ထိပ်ဆုံးနှင့်နောက်ဆုံးမှလွဲ၍ သင့်ရဲ့ နာမည်ကို အဆင်ပြေတဲ့ နေရာမှာထည့်ပြီး save ပါ။
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
ပြီးရင် ဒီ folder ရှိတဲ့နေရာကိုသွားပြီး `git status` command ကို run ပါ။ သင်ဘာတွေပြောင်းထားလဲဆိုတာ မြင်ရပါလိမ့်မယ်။
|
||||
|
||||
ဒီပြောင်းလဲမှုတွေကို သင့်ရဲ့ branch ကိုထည့်ဖို့အတွက် `git add` command ကို run ပါ။
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
အခု commit လုပ်ဖို့ `git commit` command ကို run ပေးပါ။
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
`<your-name>` နေရာမှာ သင့်နာမည်ကို အစားထိုးပါ။
|
||||
|
||||
## သင့်ရဲ့ ပြောင်းလဲ ပြုပြင်မှုကိုများကို Github သို့တင်ပါ။
|
||||
|
||||
ပြောင်းလဲမှုများကို Github သို့တင်ဖို့အတွက် `git push` ကို run ပါ။
|
||||
|
||||
```
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
|
||||
`<add-your-name>` နေရာမှာ သင်အသစ်လုပ်ထားတဲ့ branch နာမည်ကိုထည့်ပါ။
|
||||
|
||||
## သင်ပြောင်းထားတာ တွေကို review လုပ်ဖို့ submit လုပ်ပါ။
|
||||
|
||||
သင့် GitHub က သင့် repository မှာ `Compare & pull request` ဆိုတဲ့ ခလုတ်မြင်နေရမှာပါ။ အဲ့ဒီ ခလုတ်ကို နှိပ်လိုက်ပါ။
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
အခု pull request ကို submit လုပ်လိုက်ပါ။
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
သင့်ရဲ့ပြောင်းလဲမှုတွေကို ဒီ project ရဲ့ master branch မှာ ထည့်သွင်းပေးမှာဖြစ်ပါတယ်။ ဒါကြောင့် ဒီ project ရဲ့ master branch မှာ ထည့်သွင်းပြီးရင် သင့်မှာ notification email ရောက်လာပါလိမ့်မယ်။
|
||||
|
||||
## ဒါပြီးရင် ဘာတွေဆက် လေ့လာမလဲ
|
||||
|
||||
Congratulation! Open Source Project တွေမှာ အမြဲလုပ်ရလေ့ရှိတဲ့ _fork -> clone -> edit -> pull request_ လုပ်ငန်းစဥ်ကို သင် အောင်မြင်စွာ လုပ်နိုင်ခဲ့ပါပြီ။
|
||||
|
||||
အခု သင်ကူညီထောက်ပံ့ခဲ့တာကို သင့်သူငယ်ချင်းတွေကို share ချင်ရင် [ဒီ web app](https://firstcontributions.github.io/#social-share) ကို သွားပါ။
|
||||
|
||||
တခြားအကူအညီများနဲ့ မေးစရာများရှိပါက ကျွန်တော်တို့ရဲ့ Slack team ကို ဝင်ရောက် မေးမြန်းနိုင်ပါတယ်။[Join slack team သို့ ဝင်ရန်](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
နောက်ထပ် ပရောဂျက်များကိုလည်း ဝင်ရောက်ကူညီလိုပါက ကျွန်တော်တို့ ပြုစုထားတဲ့ ပရောဂျက်စာရင်းကို လေ့လာနိုင်ပါတယ်။ [web app ထဲမှ ပရောဂျက်စာရင်း](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [အခြား ထွေလီကာလီများ](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## အခြား Tools များ အသုံးပြုသည့် tutorial
|
||||
|
||||
| <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) |
|
||||
@@ -1,131 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# प्रथम योगदान
|
||||
|
||||
सुरुवातीला कुठलीही गोष्ट करणे कठीण असते. विशेषत: आपण एकत्र काम करत असताना चुका होणे स्वाभाविक आहे. परंतु एकमेकांसोबत भेटणे आणि एकत्र कार्य करणे हेच तर मुक्त स्त्रोत (Open Source) चे गमक आहे. आम्ही आपले प्रथम मुक्त स्त्रोत योगदान (Contribution) सुलभ करण्यास मदत करू.
|
||||
|
||||
लेख वाचणे आणि ट्यूटोरियल पाहण्याने आपणास मदत होऊ शकते परंतु प्रत्यक्षात सराव करण्यापेक्षा काय चांगले आहे? या प्रकल्पाचा हेतू नवशिक्यांना आपले प्रथम योगदान देण्यासंदर्भात सोप्या स्वरुपात मार्गदर्शन प्रदान करण्याचा आहे. आपण आपले प्रथम योगदान देत असल्यास, खालील पायऱ्यांचे अनुसरण करा.
|
||||
|
||||
#### *जर आपल्याला कमांड लाईन (CLI) सोयीस्कर वाटत नसेल तर [GUI टूल्स वापरण्यासंदर्भात ट्यूटोरियल येथे आहेत.](#इतर-साधने-वापरण्याबाबतीत-ट्युटोरियल)*
|
||||
|
||||
|
||||
[<img src="https://firstcontributions.github.io/assets/Readme/pirate.png" width="22">](translations/README.en-pirate.md)
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
आपण आपल्या मशीनवर Git नसेल तर, [येथुन इन्स्टॉल करा](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## रिपॉझिटरी (Repository) ला फोर्क (Fork) करणे
|
||||
|
||||
फोर्क बटण क्लिक करून या रिपोला फोर्क करा.
|
||||
हे आपल्या खात्यात या रिपॉझिटरीची प्रत (कॉपी) तयार करेल.
|
||||
|
||||
## रिपॉझिटरी (Repository) ला क्लोन (Clone) करणे
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
आता फोर्क केलेला रिपो आपल्या संगणकावर क्लोन (Clone) करा. यासाठी आपण आपल्या गिटहब (GitHub) खात्यावर जा. जो रिपो आपण फोर्क केलेला आहे, त्याला उघडा. उघडलेल्या रिपोत उजव्या बाजुला वर `Clone or download` बटण दिसेल, त्यावर क्लिक करा. नंतर तेथील `Copy to clipboard` या आयकॉनवर क्लिक करा. याद्वारे प्रस्तुत रिपोची लिंक (URL) कॉपी झालेली असेल.
|
||||
|
||||
आता आपले टर्मिनल (Terminal) उघडा व त्यात खालील git आदेश (Command) चालवा.
|
||||
|
||||
```
|
||||
git clone <कॉपी-केलेली-लिंक>
|
||||
```
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
येथे `<कॉपी-केलेली-लिंक>` (त्रिकोणी कंस वगळता) यास आपण आताच कॉपी केलेली URL लिंक असे ग्राह्य धरण्यात यावे. ही URL लिंक मिळवण्याकरता याआधीच्या पायरीचे अवलोकन करावे.
|
||||
|
||||
उदाहरणार्थ:
|
||||
|
||||
```
|
||||
git clone https://github.com/तुमचे-युझर-नाव/first-contributions.git
|
||||
```
|
||||
|
||||
येथे `तुमचे-युझर-नाव` याचा अर्थ आहे, आपल्या गिटहब खात्याचे नाव (Username).
|
||||
|
||||
आता एंटर (Enter/Return) बटण दाबा. याद्वारे प्रस्तुत रिपो `first-contributions` आपल्या संगणकावर कॉपी होईल.
|
||||
|
||||
## ब्रांच (Branch) बनवणे.
|
||||
|
||||
आपल्या टर्मिनल वरुन आपली रिपो फोल्डर/डायरेक्टरी (Folder/Directory) बदला (जर आपण अद्याप बदलले नसेल तर).
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
आता `git checkout` ही कमांड वापरुन नवीन ब्रांच तयार करा.
|
||||
|
||||
```
|
||||
git checkout -b <आपल्या-ब्रांचचे-नाव-येथे-टाका>
|
||||
```
|
||||
|
||||
उदा:
|
||||
|
||||
```
|
||||
git checkout -b add-rahul-thakare
|
||||
```
|
||||
|
||||
(प्रत्येक ब्रांचच्या नावात `add` हा शब्द असणे आवश्यक नाही, परंतु वरील उदाहरणात त्याचा समावेश असणे ही एक वाजवी गोष्ट आहे कारण ईथे आपले नाव सूचीमध्ये जोडणे हा या शाखेचा उद्देश आहे.)
|
||||
|
||||
## आवश्यक बदल करणे आणि ते बदल कमिट (Commit) करणे.
|
||||
|
||||
आता मजकूर संपादक मध्ये `Contributors.md` फाइल उघडा, व त्यात आपले नाव जोडा. फाइलच्या सुरवातीस किंवा समाप्तीमध्ये जोडू नका. त्यामध्ये कुठेही ठेवा. आता फाईल सेव्ह (Save) करा.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
आता तुम्ही पुन्हा टर्मिनल कडे जाल आणि `git status` ही कमांड चालवाल तर तुम्हाला त्यात काही बदल झालेले दिसतील.
|
||||
|
||||
`git add` कमांड वापरुन आपण तयार केलेल्या शाखेत ते बदल जोडा
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
आता `git commit` ही कमांड वापरुन आपले बदल कमिट/सुरक्षित करा.
|
||||
|
||||
```
|
||||
git commit -m "Add <तुमचे-नाव> to Contributors list"
|
||||
```
|
||||
|
||||
`<तुमचे-नाव>` च्याऐवजी आपले नाव टाका.
|
||||
|
||||
## गिटहब मध्ये आपले बदल पुश करणे.
|
||||
|
||||
`git push` वापरून आपले बदल पुश करा
|
||||
|
||||
```
|
||||
git push origin <आपल्या-शाखेचे-नाव>
|
||||
```
|
||||
|
||||
`<आपल्या-शाखेचे-नाव>` च्या जागी आपल्या ब्रांचचे नाव टाका.
|
||||
|
||||
## पुनरावलोकनासाठी आपले बदल सबमिट करणे.
|
||||
|
||||
आपण आपल्या गिटहब प्रोफाइलवर आपल्या रिपो वर गेल्यास, आपल्याला `Compare & pull request` पाठविण्याचा पर्याय दिसेल, ते दाबा.
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
आता आपल्या `Pull request` सबमिट करा.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
लवकरच मी आपले बदल या प्रकल्पाच्या मुख्य शाखेत विलीन करेन. जेव्हा आपले बदल विलीन होतील तेव्हा आपल्याला ई-मेल मिळेल.
|
||||
|
||||
## आता पुढे काय?
|
||||
|
||||
अभिनंदन! आपण नुकतीच _fork -> clone -> edit -> PR_ ही कार्यपद्धती पूर्ण केली आहे ज्यास आपणास एक योगदानकर्ता (Contributor) म्हणून सदैवच तोंड द्यावे लागते!
|
||||
|
||||
आपले योगदान साजरे करा आणि [येथे](https://firstcontributions.github.io/#social-share) जाऊन आपल्या मित्र आणि अनुयायांसह शेअर/सामायिक करा.
|
||||
|
||||
आपल्याला कोणत्याही मदतीची आवश्यकता असल्यास किंवा काही प्रश्न असल्यास आपण आमच्या स्लॅक टीममध्ये सामील होऊ शकता. [स्लॅक टीममध्ये सामील व्हा](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
आता आपण इतर प्रकल्पांमध्येही आपले योगदान देऊ शकता. आपण प्रारंभ करू शकाल अशा सुलभ समस्यांसह (Issues) आम्ही काही प्रोजेक्टची सूची संकलित केली आहे. [येथे वेब अॅप मधील प्रकल्पांची यादी पहा.](https://firstcontributions.github.io/#project-list)
|
||||
|
||||
## इतर साधने वापरण्याबाबतीत ट्युटोरियल
|
||||
|
||||
| <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) |
|
||||
@@ -1,124 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Primeras contribuciones
|
||||
|
||||
Siempre resulta difícil la primera vez que haces algo. Principalmente cuando colaboras con otros, ya que cometer errores no es agradable. Es por ello que, queremos hacer más sencilla la forma en la que los nuevos contribuyentes de _open source_ aprenden y contribuyen por primera vez.
|
||||
|
||||
Leer artículos y ver tutoriales puede ayudar, pero ¿qué mejor que hacer las cosas en un ambiente de prácticas? Este proyecto se enfoca en guiar y en simplificar la forma en la que los principiantes hacen su primera contribución. Si buscas hacer tu primera contribución, sigue los pasos que se muestran a continuación.
|
||||
|
||||
#### *Si no estás cómodo con la línea de comandos, [aquí hay unos tutoriales usando herramientas gráficas.](#Tutoriales-con-otras-herramientas)*
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork de este repositorio" />
|
||||
|
||||
Si no tienes Git en tu equipo, aquí las instrucciones para instalarlo en el [enlace]( https://help.github.com/articles/set-up-git/ )
|
||||
|
||||
## Dale Fork al repositorio
|
||||
|
||||
Dale "fork" a este repositorio dando clic en el botón "*Fork*" en la parte superior derecha de la página.
|
||||
Esto creará una copia de este repositorio en tu cuenta.
|
||||
|
||||
## Clona "Clone" el repositorio
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonar este repositorio" />
|
||||
|
||||
Ahora clona este repositorio en tu equipo. Ve a tu cuenta de Github, y da clic en el botón "*clone or download*" y luego da clic en el ícono para *copiar*.
|
||||
|
||||
Abre tu consola o terminal y ejecuta el siguiente comando:
|
||||
|
||||
```
|
||||
git clone "la url del repositorio que copiaste"
|
||||
```
|
||||
|
||||
Donde "la url del repositorio que copiaste" (sin las comillas dobles) es la *url* a este repositorio (tu *fork* a este proyecto). Mira los pasos previos para obtener la *url*.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copiar URL al portapapeles" />
|
||||
|
||||
Por ejemplo:
|
||||
```
|
||||
git clone https://github.com/usuarioGitHub/first-contributions.git
|
||||
```
|
||||
Donde `usuarioGitHub` es tu usuario de GitHub. Aquí estás copiando los contenidos del repositorio *first-contributions* en GitHub a tu equipo.
|
||||
|
||||
## Crea una rama (*Branch*)
|
||||
|
||||
Cambia al directorio del repositorio en tu equipo (si es que no estás ahí ya).
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Ahora crea una rama (*branch*) usando el comando `git switch`:
|
||||
```
|
||||
git switch -c <añade tu nombre>
|
||||
```
|
||||
|
||||
Por ejemplo:
|
||||
```
|
||||
git switch -c add-juan-perez
|
||||
```
|
||||
(El nombre de la rama no tiene porqué contener la palabra *add*, pero es razonable que lo tenga porque el objetivo de esta rama es añadir tu nombre a la lista.)
|
||||
|
||||
## Haz los cambios necesarios y guarda (*Commit*) esos cambios
|
||||
|
||||
Abre el archivo `Contributors.md` en un editor de texto y añade tu nombre. No lo añadas ni al principio ni al final del archivo, hazlo en cualquier otro sitio. Guarda el archivo.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Si vas al directorio del proyecto y ejecutas el comando `git status`, podrás ver los cambios ya reflejados.
|
||||
|
||||
Agrega esos cambios a la rama (*branch*) que creaste antes usando el comando `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Ahora puedes hacer un *commit* sobre estos cambios ejecutando el comando `git commit`:
|
||||
```
|
||||
git commit -m "Add <nombre> to Contributors list"
|
||||
```
|
||||
reemplazando `<nombre>` con tu nombre.
|
||||
|
||||
|
||||
## Carga (*Push*) tus cambios a GitHub
|
||||
|
||||
Mandar un *push* de tus cambios usando el comando `git push`:
|
||||
```
|
||||
git push origin <nombre-rama>
|
||||
```
|
||||
Reemplaza `<nombre-rama>` con el nombre de la rama que creaste anteriormente.
|
||||
|
||||
## Envía (*Submit*) tus cambios para ser revisados
|
||||
|
||||
Si vas a tu repositorio en GitHub, verás un botón `Compare & pull request`. Haz clic sobre este botón.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="crea una pull request" />
|
||||
|
||||
Ahora envía el *pull request*.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="enviar la pull request" />
|
||||
|
||||
Pronto estaré combinando tus cambios (haciendo *merge*) con la rama master de este proyecto. Recibirás una notificación por correo electrónico cuando los cambios hayan sido combinados.
|
||||
|
||||
## ¿Cuáles son los siguientes pasos?
|
||||
|
||||
¡Felicidades! ¡Has completado la línea de trabajo *_fork -> clone -> edit -> PR_* que encontrarás habitualmente como contribuidor!
|
||||
|
||||
Festeja tu contribución y compártela con tus amigos y seguidores yendo a [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
También podrías unirte a nuestro *equipo* de Slack en caso de que necesites ayuda o tengas alguna pregunta. [Únete a nuestro Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Ahora empieza a contribuir a otros proyectos. Hemos reunido una lista de proyectos con *issues* sencillas para que puedas empezar. Échale un ojo a la [lista de proyectos en la web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Tutoriales con otras herramientas
|
||||
|
||||
|<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/Readme/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)|
|
||||
@@ -1,119 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Sumbangan Pertama
|
||||
|
||||
Projek ini bertujuan untuk memberikan panduan dan memudahkan individu yang baru mula belajar membuat sumbangan pertama mereka.
|
||||
Jika anda ingin membuat sumbangan pertama anda, sila ikuti arahan yang disediakan di bawah.
|
||||
|
||||
#### *Sekiranya anda tidak selesa dengan menggunakan antara muka baris perintah (CLI), anda boleh mengikuti [panduan untuk menggunakan alat GUI di sini.](#Tutorial-Menggunakan-Alat-Lain)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Jika git belum dipasang di mesin anda, sila memasangnya [di sini](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Fork repositori ini
|
||||
|
||||
Fork repositori ini dengan menekankan butang 'Fork' yang terletak di bahagian atas halaman ini.
|
||||
Tindakan tersebut akan menghasilkan salinan repositori ini ke dalam akaun GitHub anda.
|
||||
|
||||
## Klon repositori ini
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Klon repositori yang anda telah fork ke mesin anda. Selepas itu, layari akaun GitHub anda, buka repositori yang baru dicabang, klik butang Clone, dan kemudian klik ikon *Copy url to clipboard*.
|
||||
|
||||
Buka terminal dan jalankan arahan git berikut:
|
||||
|
||||
```
|
||||
git clone "URL anda baru disalin"
|
||||
```
|
||||
di mana "URL anda baru disalin" (tanpa tanda petikan) adalah URL ke repositori ini (fork anda bagi projek ini). Rujuk langkah-langkah sebelumnya untuk mendapatkan URL tersebut.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Contoh:
|
||||
```
|
||||
git clone https://github.com/<this-is-you>/first-contributions.git
|
||||
```
|
||||
di mana `this-is-you` adalah nama pengguna GitHub anda. Di sini, anda menyalinkan kandungan repositori GitHub 'first-contributions' ke komputer anda.
|
||||
|
||||
## Membuat branch
|
||||
|
||||
Tukar ke direktori repositori pada komputer anda (jika lokasi CLI belum berada di sana):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Sila buat branch menggunakan arahan `git switch`:
|
||||
```
|
||||
git switch -c add-your-name
|
||||
```
|
||||
|
||||
Contoh:
|
||||
```
|
||||
git switch -c add-emma-maembong
|
||||
```
|
||||
|
||||
## Buat perubahan yang diperlukan dan komit perubahan tersebut
|
||||
|
||||
Sekarang, buka fail `Contributors.md` dalam sebuah editor teks, dan tambahkan nama anda ke dalam fail itu. Jangan tambahkan pada awal atau akhir fail. Letakkan di mana-mana bahagian di antara kedua-duanya. Kemudian, simpan fail tersebut.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
|
||||
Jika anda pergi ke direktori projek dan laksanakan arahan `git status`, anda akan melihat perubahan tersebut.
|
||||
|
||||
Tambahkan perubahan itu ke branch yang baru anda cipta menggunakan arahan `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Selepas itu, komit perubahan tersebut menggunakan arahan `git commit`:
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
menggantikan `<your-name>` dengan nama anda.
|
||||
|
||||
## Push perubahan ke dalam GitHub
|
||||
|
||||
Tolak perubahan anda menggunakan arahan `git push`:
|
||||
```
|
||||
git push -u origin <add-your-name>
|
||||
```
|
||||
menggantikan `<add-your-name>` dengan nama branch yang kamu cipta sebelumnya.
|
||||
|
||||
## Hantar perubahan anda untuk semakan
|
||||
|
||||
Jika anda pergi ke repositori anda di GitHub, anda akan melihat butang `Compare & pull request`. Klik butang tersebut.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Hantar 'pull request' tersebut.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Tidak lama lagi, saya akan menggabungkan semua perubahan anda ke dalam branch 'main' projek ini. Anda akan menerima e-mel pemberitahuan sebaik sahaja perubahan telah digabungkan.
|
||||
|
||||
## Pergi ke mana selepas ini?
|
||||
|
||||
Tahniah! Anda baru saja selesai melaksanakan aliran kerja standard _fork -> clone -> edit -> pull request_ yang sering anda akan temui sebagai seorang penyumbang!
|
||||
|
||||
Raikan sumbangan anda dan kongsi dengan rakan-rakan serta pengikut melalui [aplikasi web](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Anda boleh menyertai pasukan 'Slack' kami sekiranya anda memerlukan bantuan atau mempunyai sebarang pertanyaan. [Sertai pasukan Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Mari kita mulakan dengan menyumbang kepada projek lain. Kami telah menyediakan senarai projek dengan isu-isu mudah yang boleh anda mula sumbangkan. Sila rujuk [senarai projek dalam aplikasi web](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Bahan tambahan](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Tutorial Menggunakan Alat Lain
|
||||
|
||||
| <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) |
|
||||
@@ -1,120 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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)
|
||||
|
||||
|
||||
# First Contributions
|
||||
|
||||
Dis project dey to make am simple and guide beginners how dem go make their first contribution. If you wan make your first contribution, follow these steps wey dey below.
|
||||
|
||||
_If command line no dey comfortable for you, [see tutorials wey use GUI tools here.](#tutorials-using-other-tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### If you no get git for your machine, [install am](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## Fork this repository
|
||||
|
||||
Fork this repository by clicking on the fork button for the top of this page.
|
||||
Dis one go create copy of dis repository for your account.
|
||||
|
||||
## Clone the repository
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Now clone the forked repository go your machine. Go to your GitHub account, open the forked repository, click on the code button and then click the _copy to clipboard_ icon.
|
||||
|
||||
Open a terminal and run the following git command:
|
||||
|
||||
```bash
|
||||
git clone "url wey you just copy"
|
||||
```
|
||||
|
||||
where "url wey you just copy" (without the quotation marks) na the url to this repository (your fork of this project). See the previous steps to get the url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
For example:
|
||||
|
||||
```
|
||||
git clone git@github.com:this-is-you/first-contributions.git
|
||||
|
||||
```
|
||||
|
||||
where this-is-you na your GitHub username. Here you dey copy the contents of the first-contributions repository for GitHub go your computer.
|
||||
|
||||
## Create a branch
|
||||
Change go the repository directory for your computer (if you no dey there already):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
|
||||
```
|
||||
|
||||
Now create a branch using the git switch command:
|
||||
|
||||
```
|
||||
git switch -c your-new-branch-name
|
||||
|
||||
```
|
||||
|
||||
For example:
|
||||
|
||||
```
|
||||
git switch -c add-desmond-ezo-ojile
|
||||
|
||||
```
|
||||
|
||||
## Make necessary changes and commit those changes
|
||||
Now open Contributors.md file for a text editor, add your name to am. No add am for the beginning or end of the file. Put am anywhere for middle. Now, save the file.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
If you go to the project directory and run the command git status, you go see say changes dey.
|
||||
|
||||
Add those changes to the branch wey you just create using the git add command:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
|
||||
```
|
||||
Now commit those changes using the git commit command:
|
||||
|
||||
```
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
|
||||
```
|
||||
|
||||
replace your-name with your own name.
|
||||
|
||||
## Push changes to GitHub
|
||||
Push your changes using the command git push:
|
||||
|
||||
```
|
||||
git push -u origin your-branch-name
|
||||
|
||||
```
|
||||
|
||||
replace your-branch-name with the name of the branch wey you create before.
|
||||
|
||||
<details>
|
||||
<summary> <strong>If you get any errors while pushing, click here:</strong> </summary>
|
||||
|
||||
## Authentication Error
|
||||
<pre>remote: Support for password authentication don remove since August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Go to GitHub's tutorial on how to generate and add SSH key to your account.
|
||||
</details>
|
||||
|
||||
## Submit your changes for review
|
||||
If you go to your repository on GitHub, you go see Compare & pull request button. Click on that button.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
Now submit the pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
Soon I go merge all your changes into the main branch of this project. You go get notification email once the changes don merge.
|
||||
|
||||
## Where to go from here?
|
||||
Congrats!
|
||||
@@ -1,142 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Eerste bijdragen
|
||||
|
||||
Dit project heeft als doel het versimpelen en het begeleiden van beginners in het maken van hun eerste bijdragen. Als je op het punt staat om je eerste bijdragen te maken, volg dan onderstaande stappen.
|
||||
|
||||
_Als je je niet comfortable voelt met de command line, vind je [hier handleidingen voor het gebruik van GUI tools.](#handleidingen-voor-andere-tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork deze repository" />
|
||||
|
||||
### Indien je git nog niet hebt op je systeem, [installeer het dan eerst](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## Deze repository forken
|
||||
|
||||
Fork deze repository door op de fork knop te klikken. Dit creëert een kopie van deze repository in jouw account.
|
||||
|
||||
## De repository clonen
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="kloon deze repository" />
|
||||
|
||||
Kloon nu deze repository naar je systeem. Klik op de kloon knop en dan op het kopiëren naar klembord icoon.
|
||||
|
||||
Open een terminal en voer het volgende git commando uit:
|
||||
|
||||
```bash
|
||||
git clone "Gekopieerde repository url"
|
||||
```
|
||||
|
||||
Waar "Gekopieerde repository url" (zonder aanhalingstekens) de url naar (jouw fork van) deze repository is. Zie de vorige stappen om de url te vinden.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="kopieer URL naar het klembord" />
|
||||
|
||||
Bijvoorbeeld:
|
||||
|
||||
```bash
|
||||
git clone git@github.com:this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
Waar 'this-is-you' staat, vul jij je GitHub gebruikersnaam is. Hiermee kopieer je de inhoud van de first-contributions repo op GitHub naar je systeem.
|
||||
|
||||
## Een branch aanmaken
|
||||
|
||||
Navigeer naar de map van de repository op je systeem (mocht je daar niet al zijn).
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Maak nu een branch aan door middel van het `git switch` commando:
|
||||
|
||||
```bash
|
||||
git switch -c je-nieuwe-branch-naam
|
||||
```
|
||||
|
||||
Bijvoorbeeld:
|
||||
|
||||
```bash
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
## Maak de benodigde wijzigingen en commit deze
|
||||
|
||||
Open nu het `Contributors.md` bestand in een teksteditor en voeg je naam toe. Doe dit niet aan het begin of eind, maar ergens in het midden. Sla vervolgens het bestand op.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Als je naar de projectmap gaat en `git status` doet, zul je zien dat er wijzigingen zijn.
|
||||
|
||||
Voeg deze toe aan je branch met behulp van onderstaand `git add` commando.
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Commit nu deze wijzigingen door onderstaand `git commit` commando te gebruiken.
|
||||
|
||||
```bash
|
||||
git commit -m "Add jouw-naam to Contributors list"
|
||||
```
|
||||
|
||||
vervang `jouw-naam` met jouw naam
|
||||
|
||||
## Push de wijzigingen naar GitHub
|
||||
|
||||
Push je wijzigingen met `git push`:
|
||||
|
||||
```bash
|
||||
git push -u origin je-nieuwe-branch-naam
|
||||
```
|
||||
|
||||
Vervang `je-nieuwe-branch-naam` met de naam van de branch die je eerder hebt aangemaakt.
|
||||
|
||||
|
||||
<details>
|
||||
<summary> <strong>Als je foutmeldingen krijgt tijdens het pushen, klik dan hier:</strong> </summary>
|
||||
|
||||
- ### Authentication Error
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Ga naar [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) voor het genereren en configureren van een SSH-sleutel in je account.
|
||||
|
||||
</details>
|
||||
|
||||
## Verstuur je wijzigingen voor review
|
||||
|
||||
Als je naar je repository gaat op GitHub, zal je zien dat er een `Compare & pull request` knop staat. Klik hierop.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="creëer een pull request" />
|
||||
|
||||
Verstuur nu je pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="verstuur je pull request" />
|
||||
|
||||
Nu ga ik (de beheerder) al je wijzigingen mergen in de master branch van dit project. Als de veranderingen gemerged zijn, zul je hier een e-mailnotificatie over ontvangen.
|
||||
|
||||
## Hoe nu verder?
|
||||
|
||||
Gefeliciteerd! Je hebt zojuist de standaard _fork -> clone -> edit -> PR_ workflow doorlopen die je vaak zult tegenkomen als bijdrager!
|
||||
|
||||
Vier je bijdrage en deel het met je vrienden en volgers via de [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Mocht je nog vragen of hulp nodig hebben dan kun je je aanmelden voor ons [Slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Laten we je nu op weg helpen met het bijdragen aan andere projecten. We hebben een lijst samengesteld met projecten die makkelijke issues bevatten waar je aan kunt werken. Bekijk [de lijst op de web app](https://firstcontributions.github.io/#project-list)
|
||||
|
||||
## Handleidingen voor andere tools
|
||||
|
||||
| <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) |
|
||||
|
||||
|
||||
<p>Dit project is gesponsord door:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,158 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
|
||||
# Første bidrag
|
||||
|
||||
Det er alltid vanskelig å gjøre noe for første gang. Spesielt når man samarbeider med andre kan det være tungt å gjøre feil. Vi ønsker å gjøre det lettere for nybegynnere å bidra til open-source.
|
||||
|
||||
Å lese artikler og se videoer kan hjelpe, men hva kan vel være bedre enn å gjøre det i praksis? Dette prosjektet håper å kunne tilby en enkel veiledning og gjøre det lett for nybegynnere å gi sitt første bidrag. Følg trinnene nedenfor hvis du ønsker å gi ditt første bidrag til dette prosjektet.
|
||||
|
||||
_Hvis du ikke er komfortabel med terminal, [så finnes det andre metoder med bruk av GUI.](#tutorials-using-other-tools)_
|
||||
|
||||
#### Om du ikke har git installert på din maskin, [følg denne veiledningen](https://help.github.com/articles/set-up-git/).
|
||||
<br/><br/>
|
||||
|
||||
## Fork dette prosjektet
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Fork prosjektet ved å klikke på "fork" knappen på toppen av denne siden. Dette vil legge til en kopi av dette prosjektet til din GitHub konto (prosjekter kalles repository på GitHub).
|
||||
<br/><br/>
|
||||
<br/><br/>
|
||||
|
||||
## Clone prosjektet
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Nå skal vi klone prosjektet fra GitHub til din maskin. Gå til din GitHub konto og åpne din nye fork, deretter klikk på "clone" knappen og kopier linken.
|
||||
|
||||
Åpne en terminal/kommandolinje og kjør følgende git kommando:
|
||||
|
||||
```bash
|
||||
git clone "din-link"
|
||||
```
|
||||
|
||||
Erstatt `<din-link>` med linken du kopierte i forrige trinn.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Eksempelvis:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/ditt-brukernavn/first-contributions.git
|
||||
```
|
||||
|
||||
der `ditt-brukernavn` er ditt GitHub brukernavn. Her kopierer vi innholdet i first-contributions prosjektet fra din GitHub konto til din lokale maskin.
|
||||
<br/><br/>
|
||||
<br/><br/>
|
||||
|
||||
## Opprett en branch
|
||||
|
||||
Naviger terminalen inn i prosjektet (hvis du ikke er der allerede):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Opprett en branch med `git checkout` kommandoen:
|
||||
|
||||
```bash
|
||||
git checkout -b <navn-til-branch-her>
|
||||
```
|
||||
|
||||
Eksempel:
|
||||
|
||||
```bash
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
Navnet på din branch behøver ikke å inneholde ordet _add_, men det gir mening å inkludere det i denne sammenhengen. Endre "alonzo-church" til ditt navn.
|
||||
<br/><br/>
|
||||
|
||||
## Lag nødvendige endringer og commit dem
|
||||
|
||||
Åpne filen `Contributors.md` i et program for å redigere tekst og legg til ditt navn i listen. Ikke legg det til i begynnelsen eller slutten av filen, legg det til hvor som helst i mellom. Når du har gjort dette kan du lagre filen.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Hvis du åpner terminalen igjen og kjører kommandoen `git status`, vil du se dine endringer.
|
||||
|
||||
Legg endringene til i din nye branch med kommandoen `git add`:
|
||||
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Commit endringene med kommandoen `git commit`:
|
||||
|
||||
```bash
|
||||
git commit -m "Add <ditt-navn> to Contributors list"
|
||||
```
|
||||
|
||||
Erstatt `<ditt-navn>` med ditt navn.
|
||||
<br/><br/>
|
||||
|
||||
## Push endringene til GitHub
|
||||
|
||||
Push til GitHub med kommandoen `git push`:
|
||||
|
||||
```bash
|
||||
git push origin <navn-på-din-branch>
|
||||
```
|
||||
|
||||
Erstatt `<navn-på-din-branch>` med navnet på branch som du opprettet tidligere.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Hvis du får noen feilmeldinger når du pusher til Github, klikk her:</strong> </summary>
|
||||
|
||||
- ### Authentication Error
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Gå til [GitHub's brukansvisning](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) med generering og konfigurering av SHH nøkkelen til kontoen din.
|
||||
|
||||
</details>
|
||||
<br/><br/>
|
||||
|
||||
## Send inn endringene for gjennomgang
|
||||
|
||||
Hvis du går til ditt prosjekt på GitHub, vil du se en `Compare & pull request` knapp. Klikk på den for å opprette en pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Send inn din pull request når du er klar.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Snart vil jeg merge dine endringer inn i master branch av mitt prosjekt. Du vil motta en notifikasjon på epost når dine endringer er lagt til.
|
||||
<br/><br/>
|
||||
|
||||
## Hva nå?
|
||||
|
||||
Gratulerer! Du har gjennomført standardprosessen for _fork -> clone -> edit -> PR_, en prosess du vil møte på ofte!
|
||||
|
||||
Feir ditt bidrag og del det med dine venner og følgere ved å gå til [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Behøver du hjelp eller vil stille spørsmål så kan du bli med i vår slack-gruppe. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Nå kan du gå videre og bidra til andre open-source prosjekter. Vi har satt sammen en liste med enkle og overkommelige problemer du kan starte med. Sjekk den ut her: [the list of projects in the web app](https://firstcontributions.github.io/#project-list).
|
||||
<br/><br/>
|
||||
|
||||
### [Ekstramateriale](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Veiledning for andre verktøy
|
||||
|
||||
| <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) |
|
||||
|
||||
<p>This project is supported by:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,221 +0,0 @@
|
||||
[](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)
|
||||
|
||||
#### _अन्य [भाषाहरूमा](translations/Translations.md) पढ्नुहोस्।_
|
||||
|
||||
<kbd>[<img title="Shqip" alt="Shqip" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/al.svg" width="22">](translations/README.al.md)</kbd>
|
||||
<kbd>[<img title="Uzbek" alt="Uzbek language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/uz.svg" width="22">](translations/README.uz.md)</kbd>
|
||||
<kbd>[<img title="Azərbaycan dili" alt="Azərbaycan dili" src="https://cdn.statically.io/flags/az.svg" width="22">](translations/README.aze.md)</kbd>
|
||||
<kbd>[<img title="বাংলা" alt="বাংলা" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/bd.svg" width="22">](translations/README.bn.md)</kbd>
|
||||
<kbd>[<img title="Bulgarian" alt="Bulgarian" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/bg.svg" width="22">](translations/README.bg.md)</kbd>
|
||||
<kbd>[<img title="Português (Brasil)" alt="Português (Brasil)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/br.svg" width="22">](translations/README.pt_br.md)</kbd>
|
||||
<kbd>[<img title="Català" alt="Català" src="https://firstcontributions.github.io/assets/Readme/catalan1.png" width="22">](translations/README.ca.md)</kbd>
|
||||
<kbd>[<img title="中文 (Simplified)" alt="中文 (Simplified)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/cn.svg" width="22">](translations/README.zh-cn.md)</kbd>
|
||||
<kbd>[<img title="Czech" alt="Czech" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/cz.svg" width="22">](translations/README.cs.md)</kbd>
|
||||
<kbd>[<img title="Deutsch" alt="Deutsch" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/de.svg" width="22">](translations/README.de.md)</kbd>
|
||||
<kbd>[<img title="Dansk" alt="Dansk" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/dk.svg" width="22">](translations/README.da.md)</kbd>
|
||||
<kbd>[<img title="العربية" alt="العربية" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/eg.svg" width="22">](translations/README.eg.md)</kbd>
|
||||
<kbd>[<img title="Española" alt="Española" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/es.svg" width="22">](translations/README.es.md)</kbd>
|
||||
<kbd>[<img title="Française" alt="Française" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/fr.svg" width="22">](translations/README.fr.md)</kbd>
|
||||
<kbd>[<img title="Galego" alt="Galego" src="https://upload.wikimedia.org/wikipedia/commons/thumb/6/64/Flag_of_Galicia.svg/1200px-Flag_of_Galicia.svg.png" width="22">](translations/README.gl.md)</kbd>
|
||||
<kbd>[<img title="Ελληνικά" alt="Ελληνικά" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/gr.svg" width="22">](translations/README.gr.md)</kbd>
|
||||
<kbd>[<img title="ქართული" alt="ქართული" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ge.svg" width="22">](translations/README.ge.md)</kbd>
|
||||
<kbd>[<img title="Magyar" alt="Magyar" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/hu.svg" width="22">](translations/README.hu.md)</kbd>
|
||||
<kbd>[<img title="Bahasa Indonesia" alt="Bahasa Indonesia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/id.svg" width="22">](translations/README.id.md)</kbd>
|
||||
<kbd>[<img title="עִברִית" alt="עִברִית" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/il.svg" width="22">](translations/README.hb.md)</kbd>
|
||||
<kbd>[<img title="हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்" alt="हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/in.svg" width="22">](translations/Translations.md)</kbd>
|
||||
<kbd>[<img title="தமிழ்" alt="தமிழ்" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lk.svg" width="22">](translations/README.ta.md)</kbd>
|
||||
<kbd>[<img title="فارسی" alt="فارسی" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ir.svg" width="22">](translations/README.fa.md)</kbd>
|
||||
<kbd>[<img title="پښتو" alt="پښتو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/af.svg" width="22">](translations/README.pus.md)</kbd>
|
||||
<kbd>[<img title="Italiano" alt="Italiano" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/it.svg" width="22">](translations/README.it.md)</kbd>
|
||||
<kbd>[<img title="日本語" alt="日本語" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/jp.svg" width="22">](translations/README.ja.md)</kbd>
|
||||
<kbd>[<img title="සිංහල" alt="සිංහල" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lk.svg" width="22">](translations/README.si.md)</kbd>
|
||||
<kbd>[<img title="Kiswahili (Kenya)" alt="Kiswahili (Kenya)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ke.svg" width="22">](translations/README.kws.md)</kbd>
|
||||
<kbd>[<img title="한국어" alt="한국어" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kr.svg" width="22"> <img title="한국어" alt="한국어" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kp.svg" width="22">](translations/README.ko.md)</kbd>
|
||||
<kbd>[<img title="Lietuvių kalba" alt="Lietuvių kalba" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lt.svg" width="22">](translations/README.lt.md)</kbd>
|
||||
<kbd>[<img title="Limba Română" alt="Limba Română" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/md.svg" width="22"> <img title="Limba Română" alt="Limba Română" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ro.svg" width="22">](translations/README.ro.md)</kbd>
|
||||
<kbd>[<img title="မြန်မာ" alt="မြန်မာ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mm.svg" width="22">](translations/README.mm_unicode.md)</kbd>
|
||||
<kbd>[<img title="Македонски" alt="Македонски" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mk.svg" width="22">](translations/README.mk.md)</kbd>
|
||||
<kbd>[<img title="Español de México" alt="Español de México" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mx.svg" width="22">](translations/README.mx.md)</kbd>
|
||||
<kbd>[<img title="Bahasa Melayu / بهاس ملايو / Malay" alt="Bahasa Melayu / بهاس ملايو / Malay" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/my.svg" width="22">](translations/README.my.md)</kbd>
|
||||
<kbd>[<img title="Dutch" alt="Dutch" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/nl.svg" width="22">](translations/README.nl.md)</kbd>
|
||||
<kbd>[<img title="Norsk" alt="Norsk" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/no.svg" width="22">](translations/README.no.md)</kbd>
|
||||
<kbd>[<img title="नेपाली" alt="नेपाली" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/np.svg" width="15">](translations/README.np.md)</kbd>
|
||||
<kbd>[<img title="Wikang Filipino" alt="Wikang Filipino" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ph.svg" width="22">](translations/README.tl.md)</kbd>
|
||||
<kbd>[<img title="English (Pirate)" alt="English (Pirate)" src="https://firstcontributions.github.io/assets/Readme/pirate.png" width="22">](translations/README.en-pirate.md)</kbd>
|
||||
<kbd>[<img title="اُاردو" alt="اردو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pk.svg" width="22">](translations/README.ur.md)</kbd>
|
||||
<kbd>[<img title="Polski" alt="Polski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pl.svg" width="22">](translations/README.pl.md)</kbd>
|
||||
<kbd>[<img title="Português (Portugal)" alt="Português (Portugal)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/pt.svg" width="22">](translations/README.pt-pt.md)</kbd>
|
||||
<kbd>[<img title="Русский язык" alt="Русский язык" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ru.svg" width="22">](translations/README.ru.md)</kbd>
|
||||
<kbd>[<img title="عربى" alt="عربى" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/sa.svg" width="22">](translations/README.ar.md)</kbd>
|
||||
<kbd>[<img title="Svenska" alt="Svenska" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/se.svg" width="22">](translations/README.se.md)</kbd>
|
||||
<kbd>[<img title="Slovenčina" alt="Slovenčina" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/sk.svg" width="22">](translations/README.slk.md)</kbd>
|
||||
<kbd>[<img title="Slovenščina" alt="Slovenščina" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/si.svg" width="22">](translations/README.sl.md)</kbd>
|
||||
<kbd>[<img title="ภาษาไทย" alt="ภาษาไทย" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/th.svg" width="22">](translations/README.th.md)</kbd>
|
||||
<kbd>[<img title="Türkçe" alt="Türkçe" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tr.svg" width="22">](translations/README.tr.md)</kbd>
|
||||
<kbd>[<img title="中文(Traditional)" alt="中文(Traditional)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tw.svg" width="22">](translations/README.zh-tw.md)</kbd>
|
||||
<kbd>[<img title="Українська" alt="Українська" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ua.svg" width="22">](translations/README.ua.md)</kbd>
|
||||
<kbd>[<img title="Tiếng Việt" alt="Tiếng Việt" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/vn.svg" width="22">](translations/README.vn.md)</kbd>
|
||||
<kbd>[<img title="Zulu (South Africa)" alt="Zulu (South Africa)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/za.svg" width="22">](translations/README.zul.md)</kbd>
|
||||
<kbd>[<img title="Afrikaans (South Africa)" alt="Afrikaans (South Africa)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/za.svg" width="22">](translations/README.afk.md)</kbd>
|
||||
<kbd>[<img title="Igbo (Nigeria)" alt="Igbo (Nigeria)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ng.svg" width="22">](translations/README.igb.md)</kbd>
|
||||
<kbd>[<img title="Yoruba (Nigeria)" alt="Yoruba (Nigeria)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ng.svg" width="22">](translations/README.yor.md)</kbd>
|
||||
<kbd>[<img title="Hausa (Nigeria)" alt="Hausa (Nigeria)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ng.svg" width="22">](translations/README.hau.md)</kbd>
|
||||
<kbd>[<img title="Latvia" alt="Latvia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lv.svg" width="22">](translations/README.lv.md)</kbd>
|
||||
<kbd>[<img title="Suomeksi" alt="Suomeksi" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/fi.svg" width="22">](translations/README.fi.md)</kbd>
|
||||
<kbd>[<img title="Беларуская мова" alt="Беларуская мова" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/by.svg" width="22">](translations/README.by.md)</kbd>
|
||||
<kbd>[<img title="Српски" alt="Српски" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/rs.svg" width="22">](translations/README.sr.md)</kbd>
|
||||
<kbd>[<img title="Қазақша" alt="Қазақша" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kz.svg" width="22">](translations/README.kz.md)</kbd>
|
||||
<kbd>[<img title="Bosanski" alt="Bosanski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ba.svg" width="22">](translations/README.bih.md)</kbd>
|
||||
<kbd>[<img title="Bosanski" alt="Bosanski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/et.svg" width="22">](translations/README.bih.md)</kbd>
|
||||
<kbd>[<img title="Hrvatski" alt="Hrvatski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/hr.svg" width="22">](translations/README.hr.md)</kbd>
|
||||
<kbd>[<img title="پښتو" alt="پښتو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/af.svg" width="22">](translations/README.ps.md)</kbd>
|
||||
<kbd>[<img title="Af-soomaali" alt="Somalia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/so.svg" width="22">](translations/README.so.md)</kbd>
|
||||
<kbd>[<img title="Español de Ecuador" alt="Ecuador" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ec.svg" width="22">](translations/README.ec.md)</kbd>
|
||||
|
||||
# पहिलो योगदान(contribution)।
|
||||
यस प्रोजेक्टले शुरुवातकर्ताहरूले आफ्नो पहिलो योगदान गर्ने तरिकालाई सरल बनाउने र मार्गदर्शन गर्ने लक्ष्य राखेको छ। यदि तपाईं आफ्नो पहिलो योगदान गर्न खोज्दै हुनुहुन्छ भने, तलका चरणहरूको पालना गर्नुहोस्। हामी पहिलो योगदान (contribution) को लागि यसै repository को प्रयोग गर्नेछौ ।
|
||||
|
||||
_यदि तपाईं कमाण्ड लाइन (command line) सँग सहज हुनुहुन्न भने, [यहाँ GUI tool हरु प्रयोग गर्ने Tutorial हरु छन्।](#अन्य-उपकरणहरू-प्रयोग-गर्ने-tutorial-हरु)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository ." />
|
||||
|
||||
#### यदि तपाईंसँग तपाइँको कम्प्यूटरमा git छैन भने,[ यहाँबाट install गर्नुहोस्।]( https://help.github.com/articles/set-up-git/)
|
||||
|
||||
## Repository Fork गर्नुहोस्।
|
||||
|
||||
यस page को Top मा रहेको `Fork` बटनमा क्लिक गरेर यो repository लाई Fork गर्नुहोस। यसले तपाईंको GitHub account मा यस रिपोको प्रतिलिपि(copy) बनाउदछ ।
|
||||
|
||||
## Repository Clone गर्नुहोस्।
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository " />
|
||||
|
||||
अब ` Fork ` गरेको repository लाई आफ्नो कम्प्युटरमा ` Clone ` गर्नको लागी तपाइको GitHub account मा जानुहोस् र Fork गरिएको Repository खोल्नुहोस्। अब ` Code ` बटनमा क्लिक गर्नुहोस् र त्यसपछि *copy to clipboard* आइकनमा क्लिक गर्नुहोस्।
|
||||
|
||||
टर्मिनल खोल्नुहोस् र निम्न git कमाण्ड चलाउनुहोस्:
|
||||
|
||||
```
|
||||
git clone "तपाइले copy गरेको URL"
|
||||
```
|
||||
|
||||
जहाँ `"तपाइले copy गरेको URL"` छ, त्यो तपाईले fork गरेको repository को url हो । ( Url प्राप्त गर्न clone गर्ने चित्रहरुमा हेर्नुहोस्। )
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="URL लाई क्लिपबोर्डमा प्रतिलिपि बनाउनुहोस्" />
|
||||
|
||||
उदाहरणका लागि:
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
जहाँ `this-is-you` छ, त्यहाँ तपाईंको GitHub username लेख्नुहोस् । यहाँ तपाइँले GitHub बाट तपाईंको कम्प्युटरमा `first-contributions` repository को file हरु प्रतिलिपि (copy) गर्दै हुनुहुन्छ।
|
||||
|
||||
## Repository Branch बनाउनुहोस्।
|
||||
|
||||
तपाईंको कम्प्यूटरमा Clone गरेको repository को directory लाई खोल्नुहोस् (यदि तपाईं पहिले नै हुनुहुन्न भने):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
अब `git switch` कमाण्ड प्रयोग गरेर एउटा branch बनाउनुहोस् :
|
||||
|
||||
```
|
||||
git switch -c ब्रन्चको-नाम
|
||||
```
|
||||
|
||||
उदाहरणको लागि:
|
||||
|
||||
```
|
||||
git switch -c add-ram-regmi
|
||||
```
|
||||
|
||||
(ब्रान्चको नाममा *add* शब्दको आवश्यकता छैन, तर यसमा add समावेश गर्न उचित छ किनभने यस branch को उद्देश्य तपाईंको नामलाई contributors को सूचीमा थप्ने हो।)
|
||||
|
||||
## Repository मा आवश्यक परिवर्तनहरू गर्नुहोस् र तिनी परिवर्तनहरूलाई commit गर्नुहोस्।
|
||||
|
||||
अब टेक्स्ट एडिटर (text editor) मा `Contributors.md` फाइल खोल्नुहोस्, यसमा तपाईंको नाम add गर्नुहोस् । तपाईंको नामलाई फाइलका नामहरुको बीचमा राख्नुहोस् , *सुरुवात वा अन्त्यमा तपाईंको नाम नथप्नुहोस्*। ।
|
||||
अब फाईल save गर्नुहोस्।
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
अब यदि तपाई project directory जानुभयो र `git status` कमाण्डलाई रन (run) गर्नुभयो भने,तपाइँले त्यहाँ परिवर्तन भएका फाइलहरुको सुची देख्नुहुनेछ।
|
||||
|
||||
तपाइले भर्खरै बनाउनु भएको branch मा `git add` कमाण्ड प्रयोग गरी तिनी परिवर्तनहरू थप्नुहोस्:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
अब `git commit` कमाण्ड प्रयोग गरेर तिनी परिवर्तनहरू कमिट (commit) गर्नुहोस्:
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
`<your-name>` को साटोमा तपाईंको आफ्नो नाम लेख्नुहोला।
|
||||
|
||||
## GitHub मा परिवर्तनहरुलाई push गर्नुहोस।
|
||||
|
||||
`git push` कमाण्डको प्रयोग गरेर आफ्नो परिवर्तनहरु पुश (push) गर्नुहोस्:
|
||||
|
||||
```
|
||||
git push -u origin <your-branch-name>
|
||||
```
|
||||
|
||||
`<your-branch-name>` को सट्टामा तपाईले पहिले बनाएको branch को नामको लेख्नुहोस्।
|
||||
|
||||
उदाहरणको लागि:
|
||||
|
||||
```
|
||||
git push -u origin add-ram-regmi
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary> <strong>यदि push गर्दा केहि समस्या परेमा यहाँ क्लिक गर्नुहोस् :</strong> </summary>
|
||||
|
||||
- ### Authentication Error
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
[GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) मा गएर आफ्नो account को लागी SSH key generate र configure गर्नुहोस ।
|
||||
</details>
|
||||
|
||||
## Review को लागि तपाईंको परिवर्तनहरू पेश गर्नुहोस्।
|
||||
|
||||
यदि तपाईं आफ्नो गिटहब रिपोजिटोरी ( GitHub Repository) मा जानुहुन्छ भने, तपाइँले `Compare & pull request` बटन देख्नुहुनेछ। त्यस बटनमा क्लिक गर्नुहोस्।
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="एउटा पुल अनुरोध सिर्जना गर्नुहोस्" />
|
||||
|
||||
अब pull request पेश गर्नुहोस्।
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
केहि समयमै म यस प्रोजेक्टको Master branch मा तपाईका सबै परिवर्तनहरू Merge गर्नेछु। परिवर्तनहरू merge भएपछि हजुरले एक notification इमेल(email) प्राप्त गर्नुहुनेछ।
|
||||
|
||||
## यहाँबाट कहाँ जाने?
|
||||
|
||||
बधाई छ! तपाईले *Fork* -> *Clone* -> *Edit* -> *Pull Request* कार्यप्रवाह(workflow) पूरा गर्नुभयो, जुन तपाई प्राय: एक योगदानकर्ता(contributor)को रूपमा गर्नुहुनेछ!
|
||||
|
||||
तपाईंले योगदान(contribution) दिनु भएकोमा खुशी मनाउनुहोस् र [web app](https://firstcontributions.github.io/#social-share) मा गएर आफ्नो friends and follower हरूमा पनि शेयर गर्नुहोस् ।
|
||||
|
||||
तपाइँलाई कुनै पनि मद्दत चाहिन्छ वा कुनै प्रश्न छ भने तपाइँ हाम्रो slack team मा सामेल हुन सक्नुहुनेछ। [join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
अब तपाईले अन्य प्रोजेक्टहरूमा योगदान दिन सुरु गर्नुहोस्। हामीले तपाईंले गर्न सक्नुहुने सजिलो समस्याहरू(issues)को साथमा प्रोजेक्टहरूको सूची संकलन गरेका छौ हेर्नुहोस् ।. [list of projects in the web app](https://firstcontributions.github.io/#project-list)।
|
||||
|
||||
### [थप सामग्री](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## अन्य उपकरणहरू प्रयोग गर्ने tutorial हरु
|
||||
|
||||
| <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) |
|
||||
|
||||
<p>यो project लाई समर्थन गर्ने:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,136 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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)
|
||||
|
||||
# ପ୍ରଥମ ଅବଦାନ
|
||||
|
||||
ଏହି ପ୍ରୋଜେକ୍ଟଟି ଆରମ୍ଭକାରୀମାନଙ୍କୁ ସେମାନଙ୍କର ପ୍ରଥମ ଅବଦାନକୁ ସରଳ ଏବଂ ମାର୍ଗଦର୍ଶନ କରିବାକୁ ଲକ୍ଷ୍ୟ ରଖିଛି | ଯଦି ତୁମେ ତୁମର ପ୍ରଥମ ଅବଦାନ ଦେବାକୁ ଚାହୁଁଛ, ନିମ୍ନରେ ଥିବା ପଦକ୍ଷେପଗୁଡ଼ିକୁ ଅନୁସରଣ କର |
|
||||
|
||||
_ଯଦି ଆପଣ କମାଣ୍ଡ୍ ଲାଇନ୍ ସହିତ ଆରାମଦାୟକ ନୁହଁନ୍ତି, [ଏଠାରେ GUI ଉପକରଣ ବ୍ୟବହାର କରି ଟ୍ୟୁଟୋରିଆଲ୍ ଅଛି |](https://github.com/firstcontributions/first-contributions/blob/main/translations/README.od.md#ଅନ୍ୟାନ୍ୟ-ଉପକରଣ-ବ୍ୟବହାର-କରି-ଟ୍ୟୁଟୋରିଆଲ୍-)_
|
||||
|
||||
|
||||
<img align = "right" width = "300" src = "https://firstcontributions.github.io/assets/Readme/fork.png" alt = "ଏହି ସଂଗ୍ରହାଳୟକୁ ଫଙ୍କ୍" />
|
||||
|
||||
#### ଯଦି ଆପଣଙ୍କର ମେସିନରେ ଗିଟ୍ ନାହିଁ, ତେବେ ଏହାକୁ [ସଂସ୍ଥାପନ କରନ୍ତୁ](https://docs.github.com/en/get-started/quickstart/set-up-git) |
|
||||
|
||||
## ଏହି ଭଣ୍ଡାରକୁ ଫର୍କ କରନ୍ତୁ |
|
||||
|
||||
ଏହି ପୃଷ୍ଠାର ଉପରି ଭାଗରେ ଥିବା ଫଙ୍କ ବଟନ୍ ଉପରେ କ୍ଲିକ୍ କରି ଏହି ସଂଗ୍ରହାଳୟକୁ ଫର୍କ କରନ୍ତୁ |
|
||||
ଏହା ଆପଣଙ୍କ ଆକାଉଣ୍ଟରେ ଏହି ସଂଗ୍ରହାଳୟର ଏକ କପି ସୃଷ୍ଟି କରିବ |
|
||||
|
||||
## ସଂଗ୍ରହାଳୟକୁ କ୍ଲୋନ କରନ୍ତୁ |
|
||||
|
||||
<img align = "right" width = "300" src = "https://firstcontributions.github.io/assets/Readme/clone.png" alt = "ଏହି ସଂଗ୍ରହାଳୟକୁ କ୍ଲୋନ କରନ୍ତୁ" />
|
||||
|
||||
ବର୍ତ୍ତମାନ ତୁମର ଯନ୍ତ୍ରରେ ଫଙ୍କଡ୍ ରେପୋଜିଟୋରୀକୁ କ୍ଲୋନ୍ କର | ଆପଣଙ୍କର GitHub ଆକାଉଣ୍ଟକୁ ଯାଆନ୍ତୁ, ଫଙ୍କଡ୍ ରେପୋଜିଟୋରୀ ଖୋଲନ୍ତୁ, କୋଡ୍ ବଟନ୍ ଉପରେ କ୍ଲିକ୍ କରନ୍ତୁ ଏବଂ ତା’ପରେ କ୍ଲିପବୋର୍ଡ_ ଆଇକନ୍ ପାଇଁ _ କପି କ୍ଲିକ୍ କରନ୍ତୁ |
|
||||
|
||||
ଏକ ଟର୍ମିନାଲ୍ ଖୋଲନ୍ତୁ ଏବଂ ନିମ୍ନଲିଖିତ git ନିର୍ଦ୍ଦେଶକୁ ଚଲାନ୍ତୁ:
|
||||
|
||||
``
|
||||
git clone "url ତୁମେ କେବଳ କପି କରିଛ"
|
||||
``
|
||||
|
||||
ଯେଉଁଠାରେ "url ତୁମେ କେବଳ କପି କରିଛ" (କୋଟେସନ୍ ମାର୍କ ବିନା) ଏହି ସଂଗ୍ରହାଳୟର url (ଏହି ପ୍ରୋଜେକ୍ଟର ଫଙ୍କ୍) | Url ପାଇବା ପାଇଁ ପୂର୍ବ ପଦକ୍ଷେପଗୁଡିକ ଦେଖନ୍ତୁ |
|
||||
|
||||
<img align = "right" width = "300" src = "https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt = "କ୍ଲିପବୋର୍ଡକୁ URL କପି କରନ୍ତୁ" />
|
||||
|
||||
ଉଦାହରଣ ସ୍ଵରୁପ:
|
||||
|
||||
``
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
``
|
||||
|
||||
ଯେଉଁଠାରେ "ଏହା-ତୁମେ" ତୁମର GitHub ଉପଯୋଗକର୍ତ୍ତା ନାମ | ଏଠାରେ ଆପଣ GitHub ରେ ପ୍ରଥମ-ଅବଦାନ ସଂଗ୍ରହାଳୟର ବିଷୟବସ୍ତୁକୁ ଆପଣଙ୍କ କମ୍ପ୍ୟୁଟରରେ କପି କରୁଛନ୍ତି |
|
||||
|
||||
## ଏକ ଶାଖା ସୃଷ୍ଟି କରନ୍ତୁ |
|
||||
|
||||
ଆପଣଙ୍କ କମ୍ପ୍ୟୁଟରରେ ରେପୋଜିଟୋରୀ ଡିରେକ୍ଟୋରୀକୁ ପରିବର୍ତ୍ତନ କରନ୍ତୁ (ଯଦି ଆପଣ ପୂର୍ବରୁ ନାହାଁନ୍ତି):
|
||||
|
||||
``
|
||||
cd first-contributions
|
||||
``
|
||||
|
||||
ବର୍ତ୍ତମାନ `git switch` କମାଣ୍ଡ ବ୍ୟବହାର କରି ଏକ ଶାଖା ସୃଷ୍ଟି କରନ୍ତୁ:
|
||||
|
||||
``
|
||||
git switch -c <ତୁମର-ନୂତନ-ଶାଖା-ନାମ>
|
||||
``
|
||||
|
||||
ଉଦାହରଣ ସ୍ଵରୁପ:
|
||||
|
||||
``
|
||||
git switch -c add-alonzo-church
|
||||
``
|
||||
|
||||
## ଆବଶ୍ୟକ ପରିବର୍ତ୍ତନ କର ଏବଂ ସେହି ପରିବର୍ତ୍ତନଗୁଡିକ କର |
|
||||
|
||||
ବର୍ତ୍ତମାନ ଟେକ୍ସଟ୍ ଏଡିଟର୍ ରେ `Contributors.md` ଫାଇଲ୍ ଖୋଲ, ଏଥିରେ ତୁମର ନାମ ଯୋଡ | ଫାଇଲ୍ ର ଆରମ୍ଭ କିମ୍ବା ଶେଷରେ ଏହାକୁ ଯୋଡନ୍ତୁ ନାହିଁ | ଏହାକୁ ଯେକ ଣସି ସ୍ଥାନରେ ରଖନ୍ତୁ | ବର୍ତ୍ତମାନ, ଫାଇଲ୍ ସେଭ୍ କରନ୍ତୁ |
|
||||
|
||||
<img align = "right" width = "450" src = "https://firstcontributions.github.io/assets/Readme/git-status.png" alt = "git status" />
|
||||
|
||||
ଯଦି ଆପଣ ପ୍ରୋଜେକ୍ଟ ଡିରେକ୍ଟୋରୀକୁ ଯାଆନ୍ତି ଏବଂ `git status` କମାଣ୍ଡ୍ ଏକଜେକ୍ୟୁଟ୍ କରନ୍ତି, ଆପଣ ଦେଖିବେ ସେଠାରେ କିଛି ପରିବର୍ତ୍ତନ ଅଛି |
|
||||
|
||||
ସେହି ପରିବର୍ତ୍ତନଗୁଡ଼ିକୁ ଆପଣ `git add` କମାଣ୍ଡ ବ୍ୟବହାର କରି ସୃଷ୍ଟି କରିଥିବା ଶାଖାରେ ଯୋଡନ୍ତୁ:
|
||||
|
||||
``
|
||||
git add Contributors.md
|
||||
``
|
||||
ବର୍ତ୍ତମାନ `git commit` କମାଣ୍ଡ ବ୍ୟବହାର କରି ସେହି ପରିବର୍ତ୍ତନଗୁଡ଼ିକୁ କର:
|
||||
|
||||
``
|
||||
git commit -m "Add <ତୁମର ନାମ> to Contributors list"
|
||||
``
|
||||
|
||||
<ତୁମର ନାମ> ସହିତ ତୁମର ନାମ ବଦଳାଇବା |
|
||||
|
||||
## GitHub କୁ ପରିବର୍ତ୍ତନ କର |
|
||||
|
||||
`git push` 'କମାଣ୍ଡ ବ୍ୟବହାର କରି ତୁମର ପରିବର୍ତ୍ତନକୁ ଠେଲିଦିଅ:
|
||||
|
||||
``
|
||||
git push -u <ଉତ୍ପତ୍ତି ତୁମର ଶାଖା-ନାମ>
|
||||
``
|
||||
|
||||
ଆପଣ ପୂର୍ବରୁ ସୃଷ୍ଟି କରିଥିବା ଶାଖାର ନାମ ସହିତ `ଉତ୍ପତ୍ତି ତୁମର ଶାଖା-ନାମ` କୁ ବଦଳାନ୍ତୁ |
|
||||
|
||||
<details>
|
||||
<summary> <strong> ଯଦି ଆପଣ ଠେଲିବା ସମୟରେ କ any ଣସି ତ୍ରୁଟି ପାଆନ୍ତି, ତେବେ ଏଠାରେ କ୍ଲିକ୍ କରନ୍ତୁ: </strong> </summary>
|
||||
|
||||
- ### ପ୍ରାମାଣିକିକରଣ ତ୍ରୁଟି |
|
||||
<pre> ସୁଦୂର: ପାସୱାର୍ଡ ପ୍ରାମାଣିକିକରଣ ପାଇଁ ସମର୍ଥନ ଅଗଷ୍ଟ 13, 2021 ରେ ଅପସାରିତ ହୋଇଥିଲା। ଦୟାକରି ଏହା ବଦଳରେ ଏକ ବ୍ୟକ୍ତିଗତ ପ୍ରବେଶ ଟୋକେନ୍ ବ୍ୟବହାର କରନ୍ତୁ |
|
||||
ସୁଦୂର: ଅଧିକ ସୂଚନା ପାଇଁ ଦୟାକରି https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ ଦେଖନ୍ତୁ |
|
||||
ସାଂଘାତିକ: 'https://github.com/ <your-username> /first-contributions.git/' </pre> ପାଇଁ ପ୍ରାମାଣିକିକରଣ ବିଫଳ ହେଲା |
|
||||
[GitHub ର ଟ୍ୟୁଟୋରିଆଲ୍] କୁ ଯାଆନ୍ତୁ (https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ଆପଣଙ୍କ ଖାତାକୁ ଏକ SSH କି ସୃଷ୍ଟି ଏବଂ ବିନ୍ୟାସ କରିବା |
|
||||
|
||||
</details>
|
||||
|
||||
## ସମୀକ୍ଷା ପାଇଁ ଆପଣଙ୍କର ପରିବର୍ତ୍ତନ ଦାଖଲ କରନ୍ତୁ |
|
||||
|
||||
ଯଦି ଆପଣ GitHub ରେ ଥିବା ରେପୋଜିଟୋରୀକୁ ଯାଆନ୍ତି, ତେବେ ଆପଣ ଏକ “ତୁଳନା ଏବଂ ଟାଣ ଅନୁରୋଧ” ବଟନ୍ ଦେଖିବେ | ସେହି ବଟନ୍ ଉପରେ କ୍ଲିକ୍ କରନ୍ତୁ |
|
||||
|
||||
<img style = "ଭାସମାନ: ଡାହାଣ;" src = "https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt = "ଏକ ଟାଣ ଅନୁରୋଧ ସୃଷ୍ଟି କରନ୍ତୁ" />
|
||||
|
||||
ବର୍ତ୍ତମାନ ଟାଣ ଅନୁରୋଧ ଦାଖଲ କରନ୍ତୁ |
|
||||
|
||||
<img style = "ଭାସମାନ: ଡାହାଣ;" src = "https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt = "ଟାଣ ଅନୁରୋଧ ଦାଖଲ" />
|
||||
|
||||
ଶୀଘ୍ର ମୁଁ ତୁମର ସମସ୍ତ ପରିବର୍ତ୍ତନକୁ ଏହି ପ୍ରକଳ୍ପର ମୁଖ୍ୟ ଶାଖାରେ ମିଶ୍ରଣ କରିବି | ପରିବର୍ତ୍ତନଗୁଡ଼ିକ ମିଶ୍ରିତ ହେବା ପରେ ତୁମେ ଏକ ବିଜ୍ email ପ୍ତି ଇମେଲ ପାଇବ |
|
||||
|
||||
## ଏଠାରୁ କେଉଁଠିକୁ ଯିବା?
|
||||
|
||||
ଅଭିନନ୍ଦନ! ତୁମେ କେବଳ ମାନକ _ଫୋର୍କ୍ -> କ୍ଲୋନ୍ -> ସଂପାଦନ -> ଟାଣ ଅନୁରୋଧ_ ୱାର୍କଫ୍ଲୋ ଯାହା ତୁମେ ପ୍ରାୟତ a ଏକ ସହଯୋଗୀ ଭାବରେ ସାମ୍ନା କରିବ!
|
||||
|
||||
ଆପଣଙ୍କର ଅବଦାନକୁ ପାଳନ କରନ୍ତୁ ଏବଂ [ୱେବ୍ ଆପ୍](https://firstcontributions.github.io/#social-share) କୁ ଯାଇ ଆପଣଙ୍କର ସାଙ୍ଗ ଏବଂ ଅନୁସରଣକାରୀଙ୍କ ସହିତ ଅଂଶୀଦାର କରନ୍ତୁ |
|
||||
|
||||
ଯଦି ତୁମର କ ଣସି ସାହାଯ୍ୟ ଦରକାର କିମ୍ବା କ ଣସି ପ୍ରଶ୍ନ ଅଛି ତେବେ ତୁମେ ଆମର ଅଳସୁଆ ଦଳରେ ଯୋଗ ଦେଇ ପାରିବ | [ଅଳିଆ ଦଳରେ ଯୋଗ ଦିଅନ୍ତୁ](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
|
||||
ବର୍ତ୍ତମାନ, ଅନ୍ୟ ପ୍ରୋଜେକ୍ଟରେ ଯୋଗଦାନ ସହିତ ଆରମ୍ଭ କରିବା | ସହଜ ପ୍ରସଙ୍ଗଗୁଡିକ ସହିତ ଆମେ ପ୍ରୋଜେକ୍ଟଗୁଡିକର ଏକ ତାଲିକା ସଂକଳନ କରିଛୁ ଯାହାକୁ ଆପଣ ଆରମ୍ଭ କରିପାରିବେ | [ୱେବ୍ ଆପରେ ପ୍ରୋଜେକ୍ଟଗୁଡିକର ତାଲିକା](https://firstcontributions.github.io/#project-list) ଦେଖନ୍ତୁ |
|
||||
|
||||
### [ଅତିରିକ୍ତ ସାମଗ୍ରୀ](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## ଅନ୍ୟାନ୍ୟ ଉପକରଣ ବ୍ୟବହାର କରି ଟ୍ୟୁଟୋରିଆଲ୍ |
|
||||
|
||||
| <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/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) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) |
|
||||
@@ -1,116 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
|
||||
# ਪਹਿਲਾ ਯੋਗਦਾਨ
|
||||
|
||||
ਇਸ ਪ੍ਰੋਜੈਕਟ ਦਾ ਉਦੇਸ਼ ਸ਼ੁਰੂਆਤੀ ਲੋਕਾਂ ਦਾ ਆਪਣਾ ਪਹਿਲਾ ਯੋਗਦਾਨ ਪਾਉਣ ਦੇ ਕਮ ਨੂੰ ਸਰਲ ਬਣਾਉਣ ਅਤੇ ਮਾਰਗਦਰਸ਼ਨ ਕਰਨਾ ਹੈ। ਜੇ ਤੁਸੀਂ ਆਪਣਾ ਪਹਿਲਾ ਯੋਗਦਾਨ ਪਾਉਣ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰ ਰਹੇ ਹੋ, ਤਾਂ ਹੇਠਾਂ ਦਿੱਤੇ ਕਦਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ।
|
||||
ਜੇ ਤੁਸੀਂ ਕਮਾਂਡ ਲਾਈਨ ਨਾਲ ਸੁਖੀ ਨਹੀਂ ਹੋ, [ਇੱਥੇ ਜੀ.ਯੁ.ਆੀ ਟੂਲਸ ਦੀ ਵਰਤੋਂ ਕਰਨ ਦਿਆਂ ਟੁਟੋਰਿਅਲਸ ਹਨ.](#ਹੋਰ-ਟੂਲਜ-ਦੀ-ਵਰਤੋਂ-ਕਰਦਿਆਂ-ਟੁਟੋਰਿਅਲ)
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### ਜੇ ਤੁਹਾਡੀ ਮਸ਼ੀਨ ਤੇ ਗਿੱਟ ਨਹੀਂ ਹੈ, [ਇਸ ਨੂੰ ਇੰਸਟਾਲ ਕਰੋ](https://help.github.com/articles/set-up-git/)।
|
||||
|
||||
## ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਫੋਰਕ ਕਰੋ
|
||||
ਇਸ ਪੰਨੇ ਦੇ ਸਿਖਰ ਤੇ 'ਫੋਰਕ ਬਟਨ' ਤੇ ਕਲਿੱਕ ਕਰਕੇ ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਫੋਰਕ ਕਰੋ. ਇਹ ਤੁਹਾਡੇ ਖਾਤੇ ਵਿੱਚ ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਦੀ ਇੱਕ ਕਾਪੀ ਬਣਾਏਗਾ.
|
||||
|
||||
## ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਕਲੋਨ ਕਰੋ
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
ਹੁਣ ਆਪਣੀ ਮਸ਼ੀਨ ਤੇ ਫੋਰਕਡ ਰਿਪੋਜ਼ਟਰੀ ਦਾ ਕਲੋਨ ਕਰੋ। ਆਪਣੇ ਗਿਟ-ਹਬ ਅਕਾਉਂਟ ਤੇ ਜਾਓ, ਫੋਰਕਡ ਰਿਪੋਜ਼ਟਰੀ ਖੋਲ੍ਹੋ, ਕੋਡ ਬਟਨ ਤੇ ਕਲਿਕ ਕਰੋ ਅਤੇ ਫਿਰ ਕਲਿੱਪਬੋਰਡ ਆਈਕਨ ਤੇ ਕਾਪੀ ਕਲਿੱਕ ਕਰੋ.
|
||||
ਇੱਕ ਟਰਮੀਨਲ ਖੋਲ੍ਹੋ ਅਤੇ ਹੇਠਲੀ ਗਿਟ ਕਮਾਂਡ ਚਲਾਓ:
|
||||
|
||||
```
|
||||
git clone "ਯੂ.ਆਰ.ਐਲ ਜੇੈਕਰ ਤੁਸੀਂ ਹੁਣੇ ਨਕਲ ਕੀਤੀ"
|
||||
```
|
||||
|
||||
ਜਿੱਥੇ “ਯੂ.ਆਰ.ਐਲ ਜੇੈਕਰ ਤੁਸੀਂ ਹੁਣੇ ਨਕਲ ਕੀਤੀ” (ਹਵਾਲਾ ਨਿਸ਼ਾਨਾਂ ਤੋਂ ਬਿਨਾਂ) ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਦਾ ਯੂ.ਆਰ.ਐਲ ਹੈ (ਇਸ ਪ੍ਰੋਜੈਕਟ ਦਾ ਤੁਹਾਡਾ ਫੋਰਕ)। ਯੂ.ਆਰ.ਐਲ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ ਪਿਛਲੇ ਕਦਮ ਵੇਖੋ।
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
ਉਦਾਹਰਣ ਲਈ:
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
ਜਿੱਥੇ `this-is-you` ਤੁਹਾਡਾ ਗਿਟ-ਹਬ ਉਪਯੋਗਕਰਤਾ ਨਾਮ ਹੈ। ਇੱਥੇ ਤੁਸੀਂ ਆਪਣੇ ਕੰਪਿਊਟਰ ਤੇ ਗਿਟ-ਹਬ ਉੱਤੇ ਪਹਿਲੇ-ਯੋਗਦਾਨ ਰਿਪੋਜ਼ਟਰੀ ਦੇ ਭਾਗਾਂ ਦੀ ਨਕਲ ਕਰ ਰਹੇ ਹੋ.
|
||||
|
||||
## ਇੱਕ ਸ਼ਾਖਾ ਬਣਾਓ
|
||||
ਆਪਣੇ ਕੰਪਿਊਟਰ ਉੱਤੇ ਰਿਪੋਜ਼ਟਰੀ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਬਦਲੋ (ਜੇ ਤੁਸੀਂ ਪਹਿਲਾਂ ਤੋਂ ਨਹੀਂ ਹੋ):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
ਹੁਣ `git checkout` ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਸ਼ਾਖਾ ਬਣਾਓ:
|
||||
|
||||
```
|
||||
git checkout -b ਤੁਹਾਡਾ-ਨਵੀਂ-ਸ਼ਾਖਾ-ਦਾ-ਨਾਮ
|
||||
```
|
||||
|
||||
ਉਦਾਹਰਣ ਲਈ:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
(ਸ਼ਾਖਾ ਦੇ ਨਾਮ ਨੂੰ ਇਸ ਵਿਚ _add_ ਸ਼ਬਦ ਦੀ ਜ਼ਰੂਰਤ ਨਹੀਂ ਹੈ, ਪਰ ਇਹ ਸ਼ਾਮਲ ਕਰਨਾ ਇਕ ਵਾਜਬ ਚੀਜ਼ ਹੈ ਕਿਉਂਕਿ ਇਸ ਸ਼ਾਖਾ ਦਾ ਉਦੇਸ਼ ਤੁਹਾਡੇ ਨਾਮ ਨੂੰ ਇਕ ਸੂਚੀ ਵਿਚ ਸ਼ਾਮਲ ਕਰਨਾ ਹੈ.)
|
||||
|
||||
## ਜ਼ਰੂਰੀ ਤਬਦੀਲੀਆਂ ਕਰੋ ਅਤੇ ਉਨ੍ਹਾਂ ਬਦਲਾਵਾਂ ਨੂੰ ਪ੍ਰਤੀਬੱਧ ਕਰੋ
|
||||
ਹੁਣ ਟੈਕਸਟ ਐਡੀਟਰ ਵਿੱਚ `Contributors.md` ਫਾਈਲ ਖੋਲ੍ਹੋ, ਇਸ ਵਿੱਚ ਆਪਣਾ ਨਾਮ ਸ਼ਾਮਲ ਕਰੋ. ਇਸ ਨੂੰ ਫਾਈਲ ਦੇ ਸ਼ੁਰੂ ਜਾਂ ਅੰਤ 'ਤੇ ਨਾ ਸ਼ਾਮਲ ਕਰੋ. ਇਸ ਨੂੰ ਕਿਤੇ ਵੀ ਵਿਚਕਾਰ ਰੱਖੋ। ਹੁਣ, ਫਾਈਲ ਸੇਵ ਕਰੋ।
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
ਜੇ ਤੁਸੀਂ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਤੇ ਜਾਂਦੇ ਹੋ ਅਤੇ `git status` ਕਮਾਂਡ ਚਲਾਉਂਦੇ ਹੋ, ਤਾਂ ਤੁਸੀਂ ਦੇਖੋਗੇ ਕਿ ਬਦਲਾਅ ਹਨ।
|
||||
|
||||
ਸ਼ਾਖਾ ਵਿੱਚ ਉਹ ਬਦਲਾਵ ਸ਼ਾਮਲ ਕਰੋ ਜੋ ਤੁਸੀਂ ਹੁਣੇ ਬਣਾਇਆ `git add` ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਬਣਾਈ ਹੈ:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
ਹੁਣ ਉਹ ਤਬਦੀਲੀਆਂ `git ਕਮਿ`` ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਨਾਲ ਕਰੋ:
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
ਤੁਹਾਡੇ ਨਾਮ ਨਾਲ `<ਤੁਹਾਡੇ ਆਪਣੇ ਨਾਮ> rep ਨੂੰ ਬਦਲਣਾ.
|
||||
|
||||
## GitHub ਵਿੱਚ ਬਦਲੋ ਧੱਕੋ
|
||||
|
||||
ਕਮਾਂਡ `git push` ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਆਪਣੀਆਂ ਤਬਦੀਲੀਆਂ ਧੱਕੋ:
|
||||
|
||||
```
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
|
||||
ਉਸ ਬ੍ਰਾਂਚ ਦੇ ਨਾਮ ਨਾਲ `<add-your-branch-name> la ਨੂੰ ਬਦਲਣਾ ਜੋ ਤੁਸੀਂ ਪਹਿਲਾਂ ਬਣਾਈ ਸੀ.
|
||||
|
||||
## ਆਪਣੀਆਂ ਤਬਦੀਲੀਆਂ ਨੂੰ ਸਮੀਖਿਆ ਲਈ ਦਰਜ ਕਰੋ
|
||||
|
||||
ਜੇ ਤੁਸੀਂ ਗਿੱਟਹੱਬ 'ਤੇ ਆਪਣੀ ਰਿਪੋਜ਼ਟਰੀ' ਤੇ ਜਾਂਦੇ ਹੋ, ਤਾਂ ਤੁਸੀਂ `ਤੁਲਨਾ ਕਰੋ ਅਤੇ ਖਿੱਚੋ ਬੇਨਤੀ` ਬਟਨ ਨੂੰ ਵੇਖੋਗੇ. ਉਸ ਬਟਨ 'ਤੇ ਕਲਿੱਕ ਕਰੋ.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
ਹੁਣ ਪੁਲੀ ਬੇਨਤੀ ਨੂੰ ਜਮ੍ਹਾ ਕਰੋ.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
ਜਲਦੀ ਹੀ ਮੈਂ ਤੁਹਾਡੀਆਂ ਸਾਰੀਆਂ ਤਬਦੀਲੀਆਂ ਨੂੰ ਇਸ ਪ੍ਰੋਜੈਕਟ ਦੀ ਮਾਸਟਰ ਬ੍ਰਾਂਚ ਵਿੱਚ ਮਿਲਾ ਦੇਵਾਂਗਾ. ਇਕ ਵਾਰ ਤਬਦੀਲੀਆਂ ਨੂੰ ਮਿਲਾਉਣ ਤੋਂ ਬਾਅਦ ਤੁਹਾਨੂੰ ਇਕ ਸੂਚਨਾ ਈਮੇਲ ਮਿਲੇਗੀ.
|
||||
|
||||
## ਇਥੋਂ ਕਿੱਥੇ ਜਾਣਾ ਹੈ?
|
||||
|
||||
ਵਧਾਈਆਂ! ਤੁਸੀਂ ਹੁਣੇ ਹੀ ਸਟੈਂਡਰਡ _ਫੋਰਕ -> ਕਲੋਨ -> ਐਡਿਟ -> ਖਿੱਚ ਬੇਨਤੀ_ ਵਰਕਫਲੋ ਪੂਰਾ ਕੀਤਾ ਹੈ ਜਿਸਦਾ ਤੁਸੀਂ ਅਕਸਰ ਇੱਕ ਯੋਗਦਾਨ ਪਾਉਣ ਵਾਲੇ ਦੇ ਰੂਪ ਵਿੱਚ ਸਾਹਮਣਾ ਕਰੋਗੇ!
|
||||
|
||||
ਆਪਣੇ ਯੋਗਦਾਨ ਦਾ ਜਸ਼ਨ ਮਨਾਓ ਅਤੇ ਜਾ ਕੇ ਇਸ ਨੂੰ ਆਪਣੇ ਦੋਸਤਾਂ ਅਤੇ ਪੈਰੋਕਾਰਾਂ ਨਾਲ ਸਾਂਝਾ ਕਰੋ। [ਵੈੱਬ ਐਪ](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
ਜੇਕਰ ਤੁਸੀਂ ਹੋਰ ਅਭਿਆਸ ਚਾਹੁੰਦੇ ਹੋ, ਤਾਂ [ਕੋਡ ਯੋਗਦਾਨਾਂ](https://github.com/roshanjossey/code-contributions) ਨੂੰ ਚੈੱਕਆਉਟ ਕਰੋ।
|
||||
|
||||
ਆਓ ਹੁਣ ਤੁਹਾਨੂੰ ਹੋਰ ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ ਯੋਗਦਾਨ ਪਾਉਣ ਲਈ ਸ਼ੁਰੂਆਤ ਕਰੀਏ. ਅਸੀਂ ਪ੍ਰੋਜੈਕਟਾਂ ਦੀ ਇੱਕ ਸੂਚੀ ਤਿਆਰ ਕੀਤੀ ਹੈ ਜਿਸ ਨਾਲ ਤੁਸੀਂ ਅਸਾਨ ਮੁੱਦਿਆਂ ਨੂੰ ਸ਼ੁਰੂ ਕਰ ਸਕਦੇ ਹੋ। [ਪ੍ਰੋਜੈਕਟਾਂ ਦੀ ਸੂਚੀ](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [ਵਾਧੂ ਸਮੱਗਰੀ](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## ਹੋਰ ਟੂਲਜ ਦੀ ਵਰਤੋਂ ਕਰਦਿਆਂ ਟੁਟੋਰਿਅਲ
|
||||
|
||||
| <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/Readme/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) |
|
||||
@@ -1,138 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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)
|
||||
|
||||
# Pierwsze kontrybucje
|
||||
|
||||
Zawsze jest ciężko, kiedy robisz coś po raz pierwszy. Szczególnie gdy współpracujesz z innymi ludźmi, ponieważ popełnianie błędów nie jest niczym przyjemnym. Jednak właśnie na współpracy opiera się idea otwartego oprogramowania. Chcemy nauczyć w prosty sposób nowych programistów jak wgrać swoją pierwszą zmianę w obcym projekcie.
|
||||
|
||||
Czytanie artykułów i oglądanie poradników może pomóc, ale czy jest coś lepszego niż spróbowanie czegoś samemu bez obaw, że się coś zepsuje? Ten projekt ma na celu dostarczyć nowicjuszom wskazówek i uprościć proces wgrania pierwszej zmiany. Pamiętaj: im bardziej jesteś zrelaksowany, tym lepiej się uczysz. Jeśli chcesz wgrać swoją pierwszą kontrybucję wykonaj kilka prostych kroków poniżej. Będzie fajnie, obiecujemy.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Jeśli nie masz Gita na swoim komputerze, [ zainstaluj go ](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Zrób fork repozytorium (`fork`)
|
||||
|
||||
Zrób fork tego repozytorium klikając przycisk `Fork` na górze tej strony. Stworzysz tym samym kopię tego repozytorium na swoim koncie.
|
||||
|
||||
## Sklonuj repozytorium (`clone`)
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Teraz sklonuj repozytorium na swój komputer. Przejdź do swojego konta GitHub, otwórz skopiowane repozytorium, kliknij przycisk `Code`, a później ikonkę _skopiuj do schowka_.
|
||||
|
||||
Otwórz konsolę i uruchom komendę git:
|
||||
|
||||
```
|
||||
git clone <skopiowany-adres>
|
||||
```
|
||||
|
||||
Gdzie `<skopiowany-adres>` to adres tego repozytorium (twojej kopii tego projektu). Zobacz poprzedni krok aby skopiować adres.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Przykład:
|
||||
|
||||
```
|
||||
git clone https://github.com/to-ty/first-contributions.git
|
||||
```
|
||||
|
||||
W miejscu `to-ty` to twój login na GitHubie. W tym kroku ściągasz zawartość twojej kopii repozytorium `first-contributions` z githuba na swój komputer.
|
||||
|
||||
## Stwórz gałąź (`branch`)
|
||||
|
||||
Wejdź do folderu ze swoim repozytorium (jeżeli jeszcze tam nie jesteś):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Teraz utwórz nową gałąź wykonując polecenie `git switch`:
|
||||
|
||||
```
|
||||
git switch -c <add-twoje-imie>
|
||||
```
|
||||
|
||||
Przykład
|
||||
|
||||
```
|
||||
git switch -c add-adam-kowalski
|
||||
```
|
||||
|
||||
(Nazwa gałęzi nie musi zawierać słowa _add_, ale dobrze jest je dodać z racji tego, że celem tej gałęzi jest dodanie twojego imienia do listy.)
|
||||
|
||||
## Wprowadź zmiany i wgraj je
|
||||
|
||||
Otwórz plik `Contributors.md` w edytorze tekstu. Musisz znać Markdown, lekki język znaczników. Tu masz <a href="https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet">ściągawkę</a> gdzie znajdziesz informację jak go używać.
|
||||
|
||||
Dodaj następującą linię w `Contributors.md`
|
||||
|
||||
```
|
||||
[Twoje imię](https://github.com/Twoja-nazwa-użytkownika)
|
||||
```
|
||||
|
||||
Przykład:
|
||||
|
||||
```
|
||||
[John Doe](https://github.com/johndoe)
|
||||
```
|
||||
|
||||
Nie dodawaj jej na początku ani na końcu pliku. Umieść ją w dowolnym miejscu pomiędzy.
|
||||
|
||||
Upewnij się że nie ma spacji pomiędzy `](`. Zapisz plik i następnie go zamknij.
|
||||
|
||||
Jeżeli wejdziesz do folderu ze swoim repozytorium i wykonasz komendę `git status`, zobaczysz, że są tam zmiany. Dodaj te zmiany do gałęzi którą właśnie utworzyłeś używając komendy `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Teraz zapisz te zmiany wykonując komendę `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Add <twoje-imie> to Contributors list"
|
||||
```
|
||||
|
||||
Zastąp `<twoje-imie>` swoim imieniem i nazwiskiem.
|
||||
|
||||
## Wyślij zmiany na GitHub
|
||||
|
||||
Wyślij swoje zmiany komendą `git push`:
|
||||
|
||||
```
|
||||
git push -u origin <add-twoje-imie>
|
||||
```
|
||||
|
||||
Zastąp `<add-twoje-imie>` nazwą gałęzi, którą wcześniej utworzyłeś.
|
||||
|
||||
## Wyślij swoje zmiany do zatwierdzenia
|
||||
|
||||
W swoim repozytorium na GitHubie znajdziesz przycisk `Compare & pull request`. Kliknij go.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Teraz wyślij prośbę o scalenie.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Niedługo dodam proponowane przez ciebie zmiany do głównej gałęzi projektu. Zostaniesz powiadomiony mailowo kiedy zmiany zostaną scalone.
|
||||
|
||||
## Co dalej?
|
||||
|
||||
Brawo! Właśnie ukończyłeś standardowy workflow _fork -> clone -> edit -> pull request_, który często będziesz napotykać jako współtwórca!
|
||||
|
||||
Świętuj swoją pierwszą zmianę i podziel się nią z przyjaciółmi i obserwującymi poprzez <a href="https://firstcontributions.github.io/#social-share" rel="nofollow">aplikację</a>.
|
||||
|
||||
Możesz dołączyć do naszego kanału slack w przypadku kiedy będziesz potrzebował pomocy albo miał jakieś pytania. <a href="https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA" rel="nofollow">Dołącz do slacka</a>.
|
||||
|
||||
Możesz teraz zacząć uczestniczyć w innych projektach. Przygotowaliśmy listę projektów z prostymi zadaniami które będą dobre na początek. Sprawdź <a href="https://firstcontributions.github.io/#project-list" rel="nofollow">listę projektów</a>.
|
||||
|
||||
### [Materiały dodatkowe](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Ćwiczenia przy użyciu innych narzędzi
|
||||
|
||||
| <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) |
|
||||
@@ -1,148 +0,0 @@
|
||||
<div dir="rtl" lang="ps">
|
||||
|
||||
<a href="https://github.com/ellerbrock/open-source-badges/">
|
||||
<img src="https://badges.frapsoft.com/os/v1/open-source.svg?v=103" alt="Open Source Love" />
|
||||
</a>
|
||||
<a href="https://opensource.org/licenses/MIT">
|
||||
<img src="https://img.shields.io/badge/License-MIT-green.svg" alt="MIT License" />
|
||||
</a>
|
||||
<a href="https://www.codetriage.com/roshanjossey/first-contributions">
|
||||
<img src="https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg" alt="Open Source Helpers" />
|
||||
</a>
|
||||
<a href="https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA">
|
||||
<img align="left" width="150" src="https://firstcontributions.github.io/assets/Readme/join-slack-team.png" alt="Join Slack Team" />
|
||||
</a>
|
||||
|
||||
---
|
||||
|
||||
## لومړی ګډون
|
||||
|
||||
**د دې پروژې هدف دا دی چې نویو ګډونوالو ته په خلاصو سرچینو پروژو (Open Source Projects) کې د ګډون اسانه طریقه وښيي.**
|
||||
که غواړئ خپله لومړنۍ مرسته وکړئ، لاندې ګامونه تعقیب کړئ.
|
||||
|
||||
**که د کمانډ لاین (CLI) سره راحت نه یاست،**
|
||||
[کولی شئ تصویري لارښود دلته وګورئ](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
|
||||
|
||||
**که مو Git انسټال نه وي،**
|
||||
[له دې ځایه یې ښکته او نصب کړئ](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## دا ذخیره (repository) فورک کړئ
|
||||
|
||||
<img align="left" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
- د دې پاڼې په سر کې د Fork تڼۍ کلیک کړئ.
|
||||
- فورک کول به د دې ذخیرې یوه کاپي ستاسو د GitHub اکاونټ ته انتقال کړي.
|
||||
|
||||
<br clear="all"/>
|
||||
|
||||
## دا ذخیره (repository) کلون کړئ
|
||||
|
||||
<img align="left" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
- خپل اکاونټ ته لاړ شئ او د فورک شوې ذخیرې لینک د **Code** تڼۍ څخه کاپي کړئ.
|
||||
|
||||
<br clear="all"/>
|
||||
|
||||
- ترمینل یا CMD خلاص کړئ او دا کمانډ اجرا کړئ:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/YourUsername/first-contributions.git
|
||||
```
|
||||
|
||||
**یادونه:** دلته `YourUsername` باید ستاسو د GitHub اکاونټ نوم وي.
|
||||
|
||||
## نوې څانګه (branch) جوړ کړئ
|
||||
|
||||
- د first-contribution پروژه په خپل کوډ ایډیټر کې خلاصه کړئ.
|
||||
- ترمینل کې دا کمانډ اجرا کړئ ترڅو نوې څانګه جوړه کړئ. ددې لپاره چې زمونږ د بدلونونو لپاره خپله څانګه وي او له نورو سره شریکه نشي. دې څانګې کې به مونږ ایډیټ کوو او بیا به یې له عمومي څانګې سره یوځای کوو.
|
||||
|
||||
```bash
|
||||
git switch -c your-branch-name
|
||||
```
|
||||
|
||||
your-branch-name ستاسو د څانګې نوم دی. کولای شئ چې هر نوم تاسې ټاکلی شئ.
|
||||
|
||||
## اړین بدلونونه راوړئ او commit کړئ
|
||||
|
||||
- د `Contributors.md` فایل خلاص کړئ او خپل نوم پکې اضافه کړئ کې).
|
||||
- فایل ذخیره کړئ.
|
||||
|
||||
<img align="left" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
- ترمینل ته لاړ شئ او دا کمانډ اجرا کړئ ترڅو وګورئ کوم فایلونه مو بدل کړي دي:
|
||||
|
||||
```bash
|
||||
git status
|
||||
```
|
||||
|
||||
- بدلونونه ذخیره کړئ:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
- اوس مو بدلونونه کمټ Commit کړئ:
|
||||
|
||||
```bash
|
||||
git commit -m "message"
|
||||
```
|
||||
|
||||
د مسیج پر ځای تاسې هر څه لیکلی شئ. بهتره دا ده چې تاسې په دې ځای کې ولیکئ چې کوم بدلونونه مو پروژې کې راوستل.
|
||||
|
||||
## بدلونونه GitHub ته push کړئ
|
||||
|
||||
- خپل بدلونونه کیټ هب ته پورته کړئ:
|
||||
|
||||
```bash
|
||||
git push origin -u your-branch-name
|
||||
```
|
||||
|
||||
د your-branch-name پر ځای باید تاسې په دقیق ډول سره د خپلې څانګې نوم ورکړئ. هغه نوم چې لږ مخکې مو انتخاب کړی وه.
|
||||
|
||||
<details align="right" dir="rtl">
|
||||
<summary><strong>که چېرې په دې لړ کې د کومې ستونزې سره مخ شوئ دا ځای کېکاږئ</strong></summary>
|
||||
|
||||
که چېرته ستاسې ستونزه داسي وي.
|
||||
|
||||
<div dir="ltr">
|
||||
<pre>
|
||||
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/
|
||||
</pre>
|
||||
<div>
|
||||
|
||||
[نو بیا دلته زده کړئ چې دا ستونزه څنګه حل کړئ](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)
|
||||
|
||||
</details>
|
||||
|
||||
## خپل بدلونونه د بیاکتنې لپاره وسپارئ
|
||||
|
||||
- خپل GitHub اکاونټ کې دې ریپوزیټوري ته لاړ شئ.
|
||||
- د **Compare & pull request** تڼۍ به ووینئ. پر هغې کلیک وکړئ.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
- اوس د pull request غوښتنه وسپارئ.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
- له دې وروسته به ستاسو بدلونه د اصلي یا main څانګې سره یوځای شي او ستاسو نوم به د ګډون کوونکو لیست ته اضافه کړل شي.
|
||||
|
||||
## له دې وروسته څه وکړئ؟
|
||||
|
||||
تاسو په بریالیتوب سره د فورک، کلون، ایډیټ، او pull request مرحلې بشپړې کړې. تاسې له دې نه وروسته کولی شئ چې په خلاص-سرچېنه پروژو کې په همدې طریقه برخه واخلئ.
|
||||
|
||||
- خپل لومړئ ګډون ولمانځئ او له خپلو ملګرو سره یې [شریک کړئ](https://firstcontributions.github.io/#social-share).
|
||||
- که کومه ستونزه یا پوښتنه لرئ، کولای شئ زموږ د Slack ټیم سره یوځای شئ.
|
||||
- اوس کولای شئ په نورو پروژو کې هم ګډون وکړئ. [دلته د پروژو لیست وګورئ](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
## <a href="additional-material/git_workflow_scenarios/additional-material.md">اضافي مواد</a>
|
||||
|
||||
## د نورو وسیلو په کارولو سره درسونه
|
||||
|
||||
| <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) |
|
||||
|
||||
</div>
|
||||
@@ -1,97 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Primeiras Contribuições
|
||||
|
||||
Começando no **Mundo Open-source ?** Então aqui você tem a sua oportunidade de fazer a sua primeira contribuição open-source, Siga os passos abaixo e no final você terá provalmente ter feito a sua primeira contribuição 🙂
|
||||
|
||||
Primeiramente, vamos começar por instalar o [Git](https://pt.wikipedia.org/wiki/Git) para que seja possível continuar os passos abaixos descritos, você poderá fazer a instalação do git, caso não tenha do através do link para a [Página de Instalação]( https://help.github.com/articles/set-up-git/ ).
|
||||
|
||||
|
||||
## Faz Fork deste repositório
|
||||
<img align="right" width="350" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork deste repositorio" />
|
||||
|
||||
Faz Fork clicando no botão "Fork" no topo desta página e de seguida click na opção *Create a new Fork(Criar novo fork, em português)*
|
||||
<br></br><br></br>
|
||||
## Clone o repositório
|
||||
|
||||
<img align="right" width="350" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonar este repositório" />
|
||||
|
||||
Pós o fork, clone o repositorío para o seu dispositivo, Clicando no botão de *Code(código, em português)* e de seguida copiar o link, que aparecerá.
|
||||
|
||||
Abra o seu Terminal ou PowerShell e digite o seguinte:
|
||||
```
|
||||
git clone <Qui aqele link que copiaste>
|
||||
```
|
||||
Para que fique assim:
|
||||
|
||||
> git clone https://github.com/firstcontributions/first-contributions.git
|
||||
|
||||
De seguida dê Enter
|
||||
|
||||
|
||||
## Cria uma nova Branch
|
||||
|
||||
Abra a pasta que foi criada quando você fez o clone
|
||||
|
||||
Agora crie uma nova Branch usando o comando no terminal: `git checkout`:
|
||||
```
|
||||
git checkout -b <add-teu-nome>
|
||||
```
|
||||
|
||||
Por exemplo:
|
||||
```
|
||||
git checkout -b edgar-dikenge
|
||||
```
|
||||
Obs.: O nome do Branch não precisa de ter a sigla "add", mas neste caso é recomendável, porque a finalidade deste Branch é a de adicionar o teu nome a uma lista.
|
||||
|
||||
## Efetua as alterações necessárias e faz um Commit
|
||||
|
||||
Agora vá para ficheiro `Contributors.md` no teu editor de código e adicione o seu nome e salve o ficheiro. Se fores para o diretório do projeto e executares o comando `git status`, verás que há alterações. Adiciona essas alterações ao Branch que acabaste de criar utilizando o comando `git add`:
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
Agora faz um Commit dessas alterações utilizando o comando `git commit`:
|
||||
```
|
||||
git commit -m "Add <Teu-nome> to Contributors list"
|
||||
```
|
||||
substitui `<Teu-nome>` pelo teu nome ou nickname.
|
||||
|
||||
## Faz um Push das alterações para o GitHub
|
||||
|
||||
Faz um Push utilizando o comando `git push`:
|
||||
```
|
||||
git push origin <add-teu-nome>
|
||||
```
|
||||
substitui `<add-teu-nome>` pelo nome do Branch que criaste anteriormente.
|
||||
|
||||
## Envia as tuas alterações para serem revistas
|
||||
|
||||
Se fores para o teu repositório no GitHub, verás um botão `Compare & pull request`. Clica nesse botão.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="Cria um Pull Request" />
|
||||
|
||||
Agora envia um Pull Request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="Envia um pull request" />
|
||||
|
||||
Quando puder incorporarei as tuas mudanças no Branch principal (master) deste projeto. Vais receber um e-mail de notificação quando as alterações forem incorporadas.
|
||||
|
||||
## E agora ?
|
||||
|
||||
Partilhe com seus amigos e seguidores [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Podes também juntar-te à nossa equipa no Slack caso precises de alguma ajuda ou tenhas alguma dúvida. [Junta-te à nossa equipa no Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Aqui tens mais suguestões para a sua próxima contribuição, Baza lá dar uma olhada:
|
||||
|
||||
### [ Material adicional ](../additional-material/translations/Portuguese/additional-material.pt_br.md)
|
||||
|
||||
## Tutoriais com outras ferramentas
|
||||
|
||||
|
||||
| <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) |
|
||||
@@ -1,104 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Primeiras Contribuições
|
||||
|
||||
É difícil. É sempre difícil fazer algo pela primeira vez. Especialmente quando se está a colaborar, errar não é algo agradável. Mas *open source* (código aberto) trata-se de colaboração e de trabalharmos juntos. Queremos simplificar a forma com que novos colaboradores *open source* aprendem e contribuem pela primeira vez.
|
||||
|
||||
Ler artigos e ver tutoriais pode ajudar, mas nada melhor do que realmente "pôr a mão na massa" sem estragar nada. Este projecto visa simplificar a forma com que os novatos fazem a sua primeira contribuição. Lembre-se: quanto mais relaxado(a) estiveres, melhor aprenderás. Se quiseres fazer a tua primeira contribuição, siga os passos abaixo. Nós prometemos, será divertido.
|
||||
|
||||
Se ainda não tens o git na tua máquina, [instala-o aqui]( https://help.github.com/articles/set-up-git/ ).
|
||||
|
||||
## Faz Fork deste repositório
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork deste repositorio" />
|
||||
|
||||
Faz Fork clicando no botão "Fork" no topo desta página. Esta operação criará uma cópia deste repositório na tua conta.
|
||||
<br></br><br></br>
|
||||
## Clona o repositório
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonar este repositório" />
|
||||
|
||||
Agora clona este repositório para a tua máquina local. Clique no botão "Clone or download" e, em seguida, clica no ícone "Copy to clipboard" para copiar o URL.
|
||||
|
||||
Abre o teu terminal e executa o comando seguinte:
|
||||
```
|
||||
git clone "url que copiou"
|
||||
```
|
||||
onde "url que copiou" (sem as aspas) é o URL deste repositório. Consulte as etapas anteriores para obter o URL.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copiar URL" />
|
||||
|
||||
Por exemplo:
|
||||
```
|
||||
git clone https://github.com/este-é-voce/first-contributions.git
|
||||
```
|
||||
onde "este-é-voce" é o teu nome de usuário do GitHub. Aqui estás a copiar o conteúdo do repositório first-contributions para o teu computador.
|
||||
|
||||
## Cria um Branch
|
||||
|
||||
Vá para o diretório do repositório no teu computador (caso ainda não estejas lá):
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Agora crie um novo Branch usando o comando `git checkout`:
|
||||
```
|
||||
git checkout -b <add-teu-nome>
|
||||
```
|
||||
|
||||
Por exemplo:
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
Obs.: O nome do Branch não precisa de ter a sigla "add", mas neste caso é recomendável, porque a finalidade deste Branch é a de adicionar o teu nome a uma lista.
|
||||
|
||||
## Efetua as alterações necessárias e faz um Commit
|
||||
|
||||
Agora abra o ficheiro `Contributors.md` no teu editor de código, adiciona o teu nome e guarda o ficheiro. Se fores para o diretório do projeto e executares o comando `git status`, verás que há alterações. Adiciona essas alterações ao Branch que acabaste de criar utilizando o comando `git add`:
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
Agora faz um Commit dessas alterações utilizando o comando `git commit`:
|
||||
```
|
||||
git commit -m "Add <Teu-nome> to Contributors list"
|
||||
```
|
||||
substitui `<Teu-nome>` pelo teu nome ou nickname.
|
||||
|
||||
## Faz um Push das alterações para o GitHub
|
||||
|
||||
Faz um Push utilizando o comando `git push`:
|
||||
```
|
||||
git push origin <add-teu-nome>
|
||||
```
|
||||
substitui `<add-teu-nome>` pelo nome do Branch que criaste anteriormente.
|
||||
|
||||
## Envia as tuas alterações para serem revistas
|
||||
|
||||
Se fores para o teu repositório no GitHub, verás um botão `Compare & pull request`. Clica nesse botão.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="Cria um Pull Request" />
|
||||
|
||||
Agora envia um Pull Request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="Envia um pull request" />
|
||||
|
||||
Quando puder incorporarei as tuas mudanças no Branch principal (master) deste projeto. Vais receber um e-mail de notificação quando as alterações forem incorporadas.
|
||||
|
||||
## Para onde ir a partir daqui?
|
||||
|
||||
Celebra as tuas contribuições e partilha-as com amigos e seguidores através da [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Se quiseres praticar mais, acede a [code contributions](https://github.com/roshanjossey/code-contributions).
|
||||
|
||||
Aqui estão alguns repositórios com Issues a nível de principiante em que tu podes ajudar a resolver. Vai em frente e clica nos repositórios para saber mais.
|
||||
|
||||
### [ Material adicional ](../additional-material/translations/Portugues/additional-material.pt_br.md)
|
||||
|
||||
## Tutoriais com outras ferramentas
|
||||
|
||||
|
||||
| <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) |
|
||||
@@ -1,123 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Primeiras Contribuições
|
||||
|
||||
Este projeto visa facilitar o caminho e guiar os iniciantes em suas primeiras contribuições. Se você deseja fazer a sua primeira contribuição, siga os passos abaixo.
|
||||
|
||||
#### _Se não se sente confortável com a linha de comando, [aqui estão alguns tutoriais de ferramentas gráficas.](#Tutoriais-usando-outras-ferramentas)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork deste repositório" />
|
||||
|
||||
Se não possui o git em sua máquina, [instale-o aqui](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Faça um _Fork_ deste repositório
|
||||
|
||||
Faça um _Fork_ clicando no botão "_Fork_" no topo desta página, uma cópia deste repositório será criada em sua conta.
|
||||
|
||||
## Clone o repositório
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonar este repositório" />
|
||||
|
||||
Agora clone este repositório para a sua máquina. Clique no botão "_Code_" e, em seguida, clique no ícone "_Copy to clipboard_" para copiar a URL.
|
||||
|
||||
Abra um terminal e execute o seguinte comando do git:
|
||||
|
||||
```
|
||||
git clone "url que copiou"
|
||||
```
|
||||
|
||||
onde "url que copiou" (sem as aspas) é a URL deste repositório (seu fork deste projeto). Consulte as etapas anteriores para obter a URL.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copiar URL" />
|
||||
|
||||
Por exemplo:
|
||||
|
||||
```
|
||||
git clone https://github.com/seu-usuario/first-contributions.git
|
||||
```
|
||||
|
||||
onde "seu-usuário" é o seu usuário do _GitHub_. Aqui você estará copiando o conteúdo do repositório _first-contributions_ para o seu computador.
|
||||
|
||||
## Crie um Branch
|
||||
|
||||
Acesse o diretório do repositório no seu computador (caso você não esteja nele):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Agora crie um _Branch_ usando o comando `git switch`:
|
||||
|
||||
```
|
||||
git switch -c <nome-da-sua-nova-branch>
|
||||
```
|
||||
|
||||
Por exemplo:
|
||||
|
||||
```
|
||||
git switch -c add-andre-oliveira
|
||||
```
|
||||
|
||||
Obs.: O nome do _Branch_ não precisa ter a sigla "add", mas nesse caso é recomendável, porque a finalidade deste _Branch_ é a de adicionar o seu nome à uma lista.
|
||||
|
||||
## Efetue as alterações necessárias e faça um _Commit_
|
||||
|
||||
Agora, abra o arquivo `Contributors.md` em seu editor de código e adicione o seu nome a ele. Não o adicione no início ou no final do arquivo. Coloque-o em qualquer lugar no meio. Agora, salve o arquivo.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Se você for para o diretório do projeto e executar o comando `git status`, verá que há alterações. Adicione essas alterações ao _Branch_ que você acabou de criar utilizando o comando `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Agora, confirme essas alterações usando o comando git commit `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Add <seu-nome> to Contributors list"
|
||||
```
|
||||
|
||||
substituindo `<seu-nome>` pelo seu nome.
|
||||
|
||||
## Faça um Push das alterações para o _GitHub_
|
||||
|
||||
Envie suas alterações usando o comando `git push`:
|
||||
|
||||
```
|
||||
git push origin <nome-da-sua-branch>
|
||||
```
|
||||
|
||||
substituindo `<nome-da-sua-branch>` pelo nome do _Branch_ que você criou anteriormente.
|
||||
|
||||
## Envie suas alterações para serem revisadas
|
||||
|
||||
Se você for para o seu repositório no _GitHub_, verá um botão `Compare & pull request`. Clique nesse botão.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="Crie um Pull Request" />
|
||||
|
||||
Agora envie um _Pull Request_.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="Envie o Pull Request" />
|
||||
|
||||
Logo estará mesclando ('mergeando') as suas mudanças no _Branch_ principal (main) deste projeto. Você receberá um e-mail de notificação quando as alterações forem mescladas.
|
||||
|
||||
## Para onde ir a partir daqui?
|
||||
|
||||
Parabéns! Você completou o fluxo de trabalho básico _fork -> clone -> edit -> PR_ que você encontrará frequentemente como contribuidor!
|
||||
|
||||
Celebre sua contribuição e compartilhe com seus amigos e seguidores no [app web](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Se você quiser mais prática, verifique [code contributions](https://github.com/roshanjossey/code-contributions).
|
||||
|
||||
Agora você pode colaborar com outros projetos. Nós compilamos uma lista de projetos com problemas simples que você pode começar. Verifique em [a lista de projetos no web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [ Material adicional ](../additional-material/translations/Portugues/additional-material.pt_br.md)
|
||||
|
||||
## Tutoriais usando outras ferramentas
|
||||
|
||||
| <a href="../gui-tool-tutorials/translations/github-desktop-tutorial.pt_br.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/translations/github-windows-intellij-tutorial.pt_br.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/translations/github-desktop-tutorial.pt_br.md) | [Visual Studio 2017](../gui-tool-tutorials/translations/github-windows-vs2017-tutorial.pt_br.md) | [IntelliJ IDEA](../gui-tool-tutorials/translations/github-windows-intellij-tutorial.pt_br.md) |
|
||||
@@ -1,143 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Primele Contribuții
|
||||
|
||||
Acest proiect își propune să simplifice și să îndrume modul în care începătorii își fac prima contribuție. Dacă doriți să faceți prima contribuție, urmați pașii de mai jos.
|
||||
|
||||
_Dacă nu vă simțiți confortabil folosind linia de comandă, [aici sunt tutoriale folosind alte unelte (GUI)](#tutoriale-folosind-alte-unelte)._
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="Realizați bifurcația depozitului" />
|
||||
|
||||
#### Dacă nu ai git instalat, [instalează-l](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Realizați bifurcația depozitului
|
||||
|
||||
Efectuați bifurcația acestui depozit apăsând pe butonul `Fork` din partea de sus a acestei pagini.
|
||||
Aceasta va crea o copie a acestui depozit în contul dvs.
|
||||
|
||||
## Clonați depozitul
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="Clonați acest depozit" />
|
||||
|
||||
Acum clonați depozitul bifurcat pe computerul dvs. Mergeți în contul dvs. GitHub, deschideți depozitul bifurcat, apăsați pe butonul `Code` și apoi pe pictograma de _copiere în clipboard_.
|
||||
|
||||
Deschideți un terminal și executați următoarea comandă Git:
|
||||
|
||||
```bash
|
||||
git clone "URL-ul pe care l-ați copiat"
|
||||
```
|
||||
unde `URL-ul pe care l-ați copiat` (fără ghilimele) este URL-ul către acest depozit (bifurcarea dvs. a acestui proiect). Consultați pașii anteriori pentru a obține URL-ul.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="Copiați URL-ul în clipboard" />
|
||||
|
||||
De exemplu:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/numele-tau/first-contributions.git
|
||||
```
|
||||
unde `numele-tau` reprezintă numele dvs. de utilizator GitHub. Aici copiați conținutul depozitului _first-contributions_ de pe GitHub pe computerul dvs.
|
||||
|
||||
## Creați o ramură
|
||||
|
||||
Schimbați directorul depozitului de pe computerul dvs. (dacă nu sunteți deja acolo):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Acum creați o ramură folosind comanda `git switch`:
|
||||
|
||||
```bash
|
||||
git switch -c numele-noii-ramuri
|
||||
```
|
||||
|
||||
De exemplu:
|
||||
|
||||
```bash
|
||||
git switch -c adaug-alonzo-church
|
||||
```
|
||||
|
||||
## Efectuați modificările necesare și comiteți acele modificări
|
||||
|
||||
Acum deschideți fișierul `Contributors.md` într-un editor de text, adăugați-vă numele în el. Nu-l adăugați la începutul sau la sfârșitul fișierului. Puneți-l oriunde între acestea. Apoi, salvați fișierul.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="Stare git" />
|
||||
|
||||
Dacă mergeți în directorul proiectului și executați comanda `git status`, veți vedea că există modificări.
|
||||
|
||||
Adăugați aceste modificări în ramura pe care tocmai ați creat-o folosind comanda `git add`:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Acum comiteți acele modificări folosind comanda `git commit`:
|
||||
|
||||
```bash
|
||||
git commit -m "Adaug numele-tau la lista de Contribuitori"
|
||||
```
|
||||
înlocuind `numele-tau` cu numele dvs.
|
||||
|
||||
## Încărcați modificările pe GitHub
|
||||
|
||||
Împinge schimbările tale cu comanda `git push`:
|
||||
|
||||
```bash
|
||||
git push -u origin numele-ramurii-tale
|
||||
```
|
||||
înlocuind `numele-ramurii-tale` cu numele ramurii pe care ați creat-o anterior.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Dacă întâmpinați erori în timpul încărcării, apăsați aici:</strong> </summary>
|
||||
|
||||
- ### Eroare de autentificare
|
||||
<pre>remote: Suportul pentru autentificarea prin parolă a fost eliminat la 13 august 2021. Vă rugăm să utilizați un token de acces personal în schimb.
|
||||
remote: Vă rugăm să consultați https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ pentru mai multe informații.
|
||||
fatal: Autentificare eșuată pentru 'https://github.com/<numele-tau>/first-contributions.git/'</pre>
|
||||
înlocuind `numele-tau` cu numele dvs. de utilizator GitHub.
|
||||
|
||||
Mergeți la [tutorialul GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) pentru a genera și configura o cheie SSH pentru contul dvs.
|
||||
|
||||
</details>
|
||||
|
||||
## Trimiteți modificările pentru a fi revizuite
|
||||
|
||||
Dacă mergeți în depozitul dvs. de pe GitHub, veți vedea un buton `Compară și cereți trageri`. Faceți clic pe acest buton.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="Creați o cerere de tragere" />
|
||||
|
||||
Acum trimiteți cererea de tragere.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="Trimiteți cererea de tragere" />
|
||||
|
||||
În curând, voi integra toate modificările dvs. în ramura principală a acestui proiect. Veți primi o notificare prin e-mail odată ce modificările vor fi integrate.
|
||||
|
||||
## Unde să mergeți de aici?
|
||||
|
||||
Felicitări! Ați finalizat fluxul standard _fork -> clone -> edit -> pull request_ pe care îl veți întâlni adesea ca contributor!
|
||||
|
||||
Sărbătoriți-vă contribuția și partajați-o cu prietenii și urmăritorii dvs., accesând [aplicația web](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Puteți să vă alăturați echipei noastre Slack dacă aveți nevoie de ajutor sau aveți întrebări. [Alăturați-vă echipei Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w).
|
||||
|
||||
Acum să vă începem cu contribuția la alte proiecte. Am compilat o listă de proiecte cu probleme ușoare cu care puteți începe. Verificați [lista de proiecte din aplicația web](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Materiale suplimentare](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Tutoriale Folosind Alte Unelte (GUI)
|
||||
|
||||
| <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) |
|
||||
|
||||
<p>Acest proiect este susținut de:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,174 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# Первый вклад в проект
|
||||
|
||||
Сложно. Всегда сложно начинать что-то с самого начала. Довольно неприятно совершать ошибки, особенно если вы работаете в команде. Весь open source состоит из сотрудничества и совместной работы. Мы хотим облегчить первые шаги в обучении и сотрудничестве начинающим разработчикам.
|
||||
|
||||
Чтение статей и учебников может помочь, но что может быть лучше, чем настоящий практический опыт, без риска что-либо испортить? Цель этого проекта - должным образом направить молодых новобранцев, а также предоставить им возможность сделать их первый вклад. Помните: чем меньше вы напряжены, тем лучше вы учитесь. Если вы ищете возможность осуществить свой первый вклад, просто следуйте простым шагам, расположенным ниже. Обещаем, будет интересно.
|
||||
|
||||
Если вам нужна помощь с командной строкой, [это руководство использует инструменты графической операционной системы (GUI).](#Использование-других-инструментов)
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="сделать ветку" />
|
||||
|
||||
Если у вас не установлен git на компьютере, [ установите его. ](https://help.github.com/articles/set-up-git/)
|
||||
|
||||
## Создайте ветку
|
||||
|
||||
Создайте собственную ветку, нажав на кнопку `fork` сверху этой страницы. Таким образом, вы создадите копию этого репозитория в своем аккаунте.
|
||||
|
||||
## Клонируйте репозиторий
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="клонировать репозиторий" />
|
||||
|
||||
Теперь клонируйте ваш репозиторий на ПК. Нажмите на кнопку `clone`, а затем на иконку `copy to clipboard`, чтобы скопировать ссылку.
|
||||
|
||||
Откройте терминал и запустите следующую git команду:
|
||||
|
||||
```
|
||||
git clone "ссылка на репозиторий"
|
||||
```
|
||||
|
||||
Где "ссылка на репозиторий" (без кавычек) - это ссылка на ваш репозиторий. Посмотрите предыдущие шаги, чтобы получить эту ссылку.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="скопируйте ссылку в буфер обмена" />
|
||||
|
||||
Например:
|
||||
|
||||
```
|
||||
git clone https://github.com/ваш-логин/first-contributions.git
|
||||
```
|
||||
|
||||
Где `ваш логин` ваш логин на github'e. Таким образом вы копируете репозиторий 'first-contributions' с GitHub на ваш ПК.
|
||||
|
||||
## Создайте ветку
|
||||
|
||||
Перейдите в каталог репозитория на вашем компьютере, если вы еще не там.
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Теперь создайте ветку с помощью команды `git checkout`
|
||||
|
||||
```
|
||||
git checkout -b <add-your-name>
|
||||
```
|
||||
|
||||
Например:
|
||||
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
(Синтаксически не требуется, чтобы название ветки содержало слово _add_, но это оправдано, поскольку подчеркивает назначение этой ветки: добавить ваше имя в список.)
|
||||
|
||||
## Внесите необходимые изменения и создайте коммит
|
||||
|
||||
Теперь откройте файл `Contributors.md` в вашем текстовом редакторе, впишите ваше имя и сохраните файл. Если вы перейдёте в директорию проекта и выполните `git status`, вы увидите изменения. Добавьте эти изменения с помощью команды `git add`.
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Теперь закоммитьте данные изменения с помощью команды `git commit`.
|
||||
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
Измените `<your-name>` на ваше имя
|
||||
|
||||
## Запушьте изменения на github
|
||||
|
||||
Запушьте ваши изменения с помощью `git push`
|
||||
|
||||
```
|
||||
git push origin <add-your-name>
|
||||
```
|
||||
|
||||
Измените `<add-your-name>` на имя ветки, которую вы создали ранее.
|
||||
|
||||
## Подтвердите изменения для ревью
|
||||
|
||||
Если вы зайдете в свой репозиторий на GitHub, вы увидите кнопку `Compare & pull request`. Нажмите на нее.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Теперь подтвердите пулл-реквест.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Скоро я произведу объединение всех ваших изменений с основной веткой данного проекта. Вы получите сообщение по электронной почте, когда изменения будут приняты (смержены).
|
||||
|
||||
Основная ветка вашего репозитория не будет изменена. Для синхронизации выполните шаги, расположенные ниже.
|
||||
|
||||
## Синхронизируйте вашу ветку с данным репозиторием
|
||||
|
||||
Прежде всего перейдите в основную ветку:
|
||||
|
||||
```
|
||||
git checkout main
|
||||
```
|
||||
|
||||
Затем добавьте url моего репозитория в поле `upstream remote url`:
|
||||
|
||||
```
|
||||
git remote add upstream https://github.com/Roshanjossey/first-contributions
|
||||
```
|
||||
|
||||
Таким образом мы сообщим git'у, что существует другая версия данного проекта по определенной ссылке, и мы ее считаем мастером. Как только изменения смержены, подгрузите новую версию моего репозитория.
|
||||
|
||||
```
|
||||
git fetch upstream
|
||||
```
|
||||
|
||||
Таким образом мы забрали все изменения в моём ответвлении (upstream remote). После, вам нужно смержить новую версию моего репозитория с вашей мастер-веткой.
|
||||
|
||||
```
|
||||
git rebase upstream/main
|
||||
```
|
||||
|
||||
Так вы применяете все изменения, которые вы подтянули к вашей мастер-ветке. Если вы запушите сейчас мастер-ветку, ваше ответвление тоже будет содержать изменения.
|
||||
|
||||
```
|
||||
git push origin main
|
||||
```
|
||||
|
||||
Обратите внимание, что вы пушите в удаленный репозиторий origin.
|
||||
|
||||
На этом этапе я объединил вашу ветку `<add-your-name>` со своей мастер-веткой, а вы объединили свою мастер-ветку с моей. Ваша ветка больше не нужна, вы можете удалить её:
|
||||
|
||||
```
|
||||
git branch -d <add-your-name>
|
||||
```
|
||||
|
||||
Так же можете удалить её версию в удалённом репозитории:
|
||||
|
||||
```
|
||||
git push origin --delete <add-your-name>
|
||||
```
|
||||
|
||||
Это совершенно не обязательно, но название этой ветки отражает её довольно специфическое назначение. И продолжительность её жизни может быть соответствующе короткой.
|
||||
|
||||
## Использование других инструментов
|
||||
|
||||
| <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) |
|
||||
|
||||
## Что дальше?
|
||||
|
||||
Ниже несколько популярных репозиториев, где вы можете найти задания для новичков. Вперёд, перейдите в репозитории, чтобы узнать больше.
|
||||
|
||||
| [](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22) | [](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [<img width="100" src="https://upload.wikimedia.org/wikipedia/commons/a/a7/React-icon.svg">](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22) | [](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [<img width="100" src="https://leiningen.org/img/leiningen.jpg">](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)(https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie) | [<img width="100" src="https://images.plot.ly/plotly-documentation/thumbnail/numpy-logo.jpg">](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22) | [](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22) |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [exercism](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22) | [Fun Retros](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [react](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22) | [habitat](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [scikit-learn](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [Leiningen](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie) | [numpy](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22) | [elasticsearch](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22) |
|
||||
| [](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) | [](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy) | [](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22) | [](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy) | [](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs) | [](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer) | [](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs) |
|
||||
| [homebrew](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) | [Rust](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy) | [vuejs](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22) | [Suave](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy) | [OpenRA](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [PowerShell](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs) | [coala](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer) | [moment](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs) |
|
||||
| [](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22) | [](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22) | [](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) | [](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level) | [](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [<img width="100" src="https://cdn.worldvectorlogo.com/logos/brackets-1.svg">](https://github.com/adobe/brackets/labels/Starter%20bug) |
|
||||
| [ava](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22) | [freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [webpack](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22) | [hoodie](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [pouchdb](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) | [neovim](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level) | [babel](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [brackets](https://github.com/adobe/brackets/labels/Starter%20bug) |
|
||||
| [](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | [<img width="100" src="https://github.com/Semantic-Org/Semantic-UI-React/raw/master/docs/public/logo.png">](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |
|
||||
| [Node.js](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | [Semantic-UI-React](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |
|
||||
@@ -1,123 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# First Contributions
|
||||
|
||||
Det är alltid svårt första gången man gör något och speciellt när du samarbetar med andra kan det vara extra känsligt att göra misstag. Vi vill göra det lättare för dig att lära dig hur man bidrar till ett öppet källkods-projekt.
|
||||
|
||||
Att läsa artiklar och titta på handledningar kan så klart hjälpa men det är alltid bättre att göra det på riktigt. Detta projeket har som syfte att tillhandahålla en guide och göra det enkelt för nybörjare att göra sina första bidrag. Om du är ute efter att göra ditt första bidrag kan du följa stegen nedan.
|
||||
|
||||
|
||||
#### *Om du inte känner dig bekväm med kommandoraden, [så finns en vägledning här.](#Handledningar-för-andra-verktyg)*
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Om du inte har git installerat [så installera det]( https://help.github.com/articles/set-up-git/ )
|
||||
|
||||
## Gör en Fork på detta repository
|
||||
|
||||
Forka repot genom att klicka på fork-knappen överst på denna sida.
|
||||
Detta kommer att skapa en kopia av repot i ditt GitHub-konto.
|
||||
|
||||
## Klona repository
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Klona repot till din dator. Gå till ditt GitHub-konto och klicka på clone-knappen och klicka sedan på *copy to clipboard*-ikonen.
|
||||
|
||||
Öppna en terminal och kör följande kommando:
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
där "url you just copied" (utan citat-tecken) är URL:en för detta repo (din fork för detta projekt). Se föregående steg för att hitta URL:en.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Till exempel:
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
där `this-is-you` är ditt användarnamn på GitHub. På detta sätt kopierar du innehållet i repot till din dator.
|
||||
|
||||
## Skapa en branch
|
||||
|
||||
Gå till repo-katalogen på din dator (om du inte redan står i den katalogen):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Nu skapar du en branch genom att använda `git checkout`-kommandot:
|
||||
```
|
||||
git checkout -b <lägg till ditt branch-namn>
|
||||
```
|
||||
|
||||
Till exempel:
|
||||
```
|
||||
git checkout -b mitt-tillag
|
||||
```
|
||||
|
||||
## Gör de ändringar du vill göra och commita dem
|
||||
|
||||
Nu öppnar du `Contributors.md` i en text-editor och lägger till ditt namn. Lägg inte till något i början eller slutet av dokumentet utan lägg till någonstans mitt emellan. Spara filen.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Ge kommando `git status` i projektkatalogen för att se de ändringar du gjort.
|
||||
|
||||
|
||||
Lägg till dina ändringar genom att använda kommando `git add -A`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Commita dina ändringar genom att använda `git commit`:
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
ersätt `<your-name>` med ditt namn.
|
||||
|
||||
## Pusha ändringar till GitHub
|
||||
|
||||
Pusha dina ändringar genom att använda kommando `git push`:
|
||||
```
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
ersätt `<add-your-branch-name>` med det branch-namn du använt tidigare.
|
||||
|
||||
## Skicka iväg dina ändringar för granskning
|
||||
|
||||
Om du navigerar till ditt repo på GitHub kan du se en knapp med texten `Compare & pull request`. Klicka på den.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Skicka iväg din s.k. pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Snart kommer jag införa dina ändringar i huvudprojektet. Du kommer att få ett e-mail så fort dina ändringar blivit införda.
|
||||
|
||||
## Hur går man vidare?
|
||||
|
||||
Gratulerar! Du har just genomfört standardprocessen för _fork -> clone -> edit -> PR_, en process du kommer att stöta på ofta!
|
||||
|
||||
Fira genom att dela med dina vänner och följare genom att gå till [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Behöver du hjälp eller vill du ställa frågor så kan du gå med i vår slack-grupp. [Gå med i slack-gruppen](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Nu kan du gå vidare genom att bidra i andra projekt. Vi har sammanställt en lista med enkla uppgifter som du kan starta med. Kolla in [projektlistan i webbapplikationen](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Ytterligare material](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Handledningar för andra verktyg
|
||||
|
||||
| <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) |
|
||||
@@ -1,129 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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)
|
||||
|
||||
# පළමු දායකත්වය
|
||||
|
||||
ආරම්භකයින්ගේ පළමු දායකත්වය ලබා දෙන ආකාරය සරල කිරීම සහ මඟ පෙන්වීම මෙම ව්යාපෘතියේ අරමුණයි. ඔබ ඔබේ පළමු දායකත්වය ලබා දීමට බලාපොරොත්තු වන්නේ නම්, පහත පියවර අනුගමනය කරන්න.
|
||||
|
||||
#### *ඔබ විධාන රේඛාව (command line) සමඟ අපහසු නම්, [GUI මෙවලම් භාවිතා කරන නිබන්ධන මෙන්න.](#tutorials-using-other-tools)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="මෙම ගබඩාව fork කරන්න" />
|
||||
|
||||
ඔබේ පරිගණකයේ git නොමැති නම්, [ස්ථාපනය කරන්න](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## මෙම ගබඩාව fork කිරීම
|
||||
|
||||
පිටුවේ ඉහළින් ඇති fork බොත්තම ක්ලික් කිරීමෙන් මෙය කළ හැකිය. මෙය ඔබගේ ගිණුමේ
|
||||
පිටපතක් සාදනු ඇත.
|
||||
|
||||
## මෙම ගබඩාව clone කරන්න
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="මෙම ගබඩාව clone කරන්න" />
|
||||
|
||||
දැන් ඔබේ පරිගණකට fork කරපු repository ය ක්ලෝන කරන්න. ඔබට ඔබගේ GitHub ගිණුමට ගොස් fork කරපු repository විවෘත කර clone බොත්තම ක්ලික් කර එය පසුරු පුවරුවට (clipboard) පිටපත් කිරීමෙන් මෙය කළ හැක.
|
||||
|
||||
*terminal* හෝ *command prompt* විවෘත කර පහත git විධානය ක්රියාත්මක කරන්න:
|
||||
|
||||
```
|
||||
git clone "ඔබ පිටපත් කළ url එක"
|
||||
```
|
||||
|
||||
මෙහි "ඔබ පිටපත් කළ url එක" (උපුටා දැක්වීම් ලකුණු නොමැතිව) මෙම ගබඩාවේ url එක වේ (මෙම ව්යාපෘතියේ ඔබේ දෙබල (fork) ). url එක ලබා ගැනීමට පෙර පියවර බලන්න.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
|
||||
උදාහරණ වශයෙන්:
|
||||
|
||||
```
|
||||
git clone https://github.com/මෙය-ඔබයි/first-contributions.git
|
||||
```
|
||||
|
||||
මෙහි `මෙය ඔබයි` යනු GitHub පරිශීලක නාමයයි. මෙය ඔබගේ GitHub ගිණුමේ first-contributions repository පිටපතක් සෑදීමට ඔබට ඉඩ සලසයි.
|
||||
|
||||
## ශාඛාවක් නිර්මාණය කිරීම
|
||||
|
||||
ඔබේ පරිගණකයේ ගබඩා නාමාවලියට වෙනස් කරන්න (ඔබ දැනටමත් එහි නොමැති නම්):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
|
||||
දැන් `git checkout` විධානය භාවිතා කරමින් ශාඛාවක් සාදන්න:
|
||||
|
||||
```
|
||||
git checkout -b <ඔබගේ-නව-ශාඛාවේ-නම>
|
||||
```
|
||||
|
||||
උදාහරණ වශයෙන්:
|
||||
|
||||
```
|
||||
git checkout -b add-luke-oliff
|
||||
```
|
||||
|
||||
(ශාඛාවේ නමට *add* එකතු කිරීම අවශ්ය නොවේ, නමුත් එය සාධාරණ දෙයකි, මන්ද මෙම ශාඛාවේ අරමුණ ඔබේ නම ලැයිස්තුවකට එකතු කිරීමයි.)
|
||||
|
||||
## අවශ්ය වෙනස්කම් සිදු කර commit කරන්න
|
||||
|
||||
දැන් Contributors.md ගොනුව පෙළ සංස්කාරකයක විවෘත කරන්න, එයට ඔබේ නම එක් කරන්න. ගොනුවේ ආරම්භයේ හෝ අවසානයේ එය එකතු නොකරන්න. එය අතර මැද ඕනෑම තැනකට එකතු කරන්න. දැන්, ගොනුව save කරන්න.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
ඔබ ව්යාපෘති නාමාවලිය වෙත ගොස් git status විධානය ක්රියාත්මක කළහොත්, වෙනස්කම් ඇති බව ඔබට පෙනෙනු ඇත.
|
||||
|
||||
`git add` විධානය භාවිතයෙන් ඔබ දැන් නිර්මාණය කළ ශාඛාවට එම වෙනස්කම් එක් කරන්න:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
දැන් `git commit` විධානය භාවිතා කර එම වෙනස්කම් සිදු කරන්න:
|
||||
|
||||
```
|
||||
git commit -m "Add <ඔයාගේ_නම> to Contributors list"
|
||||
```
|
||||
|
||||
`<ඔබේ_නම>` වෙනුවට ඔබේ නම ඇතුල් කරන්න.
|
||||
|
||||
## GitHub වෙත වෙනස්කම් තල්ලු කරන්න
|
||||
|
||||
`git push` විධානය භාවිතයෙන් ඔබගේ වෙනස්කම් තල්ලු කරන්න:
|
||||
```
|
||||
git push origin -u <ඔබගේ-නව-ශාඛාවේ-නම>
|
||||
```
|
||||
|
||||
`<ඔබගේ-නව-ශාඛාවේ-නම>` ඔබ කලින් නිර්මාණය කළ නම සමඟ ශාඛාව ප්රතිස්ථාපනය කරන්න.
|
||||
|
||||
## සමාලෝචනය සඳහා ඔබේ වෙනස්කම් ඉදිරිපත් කරන්න
|
||||
|
||||
|
||||
ඔබ GitHub හි ඔබගේ ගබඩාවට ගියහොත්, ඔබට `Compare & pull request` බොත්තමක් පෙනෙනු ඇත. එම බොත්තම මත ක්ලික් කරන්න.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
දැන් pull request ඉදිරිපත් කරන්න.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
මම ළඟදීම ඔබේ සියලු වෙනස්කම් මෙම ව්යාපෘතියේ ප්රධාන ශාඛාවට ඒකාබද්ධ කරමි. වෙනස්කම් ඒකාබද්ධ කළ පසු ඔබට දැනුම්දීමේ Email පණිවිඩයක් ලැබෙනු ඇත.
|
||||
|
||||
## මෙතැන් සිට කොහේ යන්නද?
|
||||
|
||||
සුභ පැතුම්! ඔබ දායකයෙකු ලෙස සම්මත 'fork -> clone -> edit -> pull request' කාර්ය ප්රවාහය ඔබ සම්පුර්ණ කර ඇත!
|
||||
|
||||
ඔබේ දායකත්වය සහ ඔබේ මිතුරන් සහ අනුගාමිකයින් සමඟ සමරන්න [web app](https://firstcontributions.github.io/#social-share) ගිහින් share කරන්න.
|
||||
|
||||
ඔබට කිසියම් උදව්වක් අවශ්ය නම් හෝ කිසියම් ප්රශ්නයක් ඇත්නම් ඔබට අපගේ slack කණ්ඩායමට සම්බන්ධ විය හැකිය. [අපගේ slack කණ්ඩායමට එක්වන්න](https://join.slack.com/t/firstcontributors/shared_invite/zt-kpbyrmkk-JDkRtchcvRvQ0qK4iPmyvA)..
|
||||
|
||||
දැන් අපි ඔබට වෙනත් ව්යාපෘති සඳහා දායක වීම ආරම්භ කරමු. ඔබට ආරම්භ කළ හැකි පහසු ගැටළු සහිත ව්යාපෘති ලැයිස්තුවක් අපි සම්පාදනය කර ඇත්තෙමු. පරීක්ෂා කරන්න [web app ව්යාපෘති ලැයිස්තුව](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [අතිරේක සම්පත්](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## වෙනත් මෙවලම් භාවිතා කරන නිබන්ධන
|
||||
|
||||
| <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) |
|
||||
@@ -1,132 +0,0 @@
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
[<img align="right" width="150" src="assets/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)
|
||||
|
||||
# پهريون تعاون
|
||||
|
||||
اهو ڏکيو آهي. اهو هميشه مشڪل آهي پهريون دفعو توهان ڪجهه ڪيو خاص طور تي جڏهن توهان تعاون ڪري رهيا آهيو ، غلطيون ڪرڻ هڪ آرام واري شيءِ نه آهي. اسان پهريون طريقو کولڻ چاهيون ٿا نئون کليل ذريعو مددگار سکن ٿا ۽ پهريون ڀيرو حصو وٺن ٿا.
|
||||
|
||||
پڙهائي آرٽيڪل ۽ ڏسڻ وارا سبق مدد ڪري سگھن ٿا ، پر اصل ۾ عملي ماحول ۾ شيون ڪرڻ سان سٺو ڇا آهي؟ ھن پروجيڪٽ جو مقصد مقصد مهيا ڪرڻ ۽ آسانيون جوڙيندڙن کي پنھنجي ابتدائي مدد ڪرڻ جو طريقو آھي. جيڪڏھن توھان پنھنجو پھريون حصو بڻائڻ جي ڪوشش ڪري رھيا آھيو ، ھيٺين قدمن تي عمل ڪريو.
|
||||
|
||||
### جيڪڏهن توهان ڪمانڊ لائن سان مطمئن نه آهيو ، [هتي GUI ٽولز استعمال ڪرڻ وارا سبق آهن.] (# سبق استعمال ڪندڙ-ٻئي اوزار) _
|
||||
|
||||
|
||||
#### _ ھن [ٻين ٻولين ۾] پڙھو (ترجما / ترجما. ايم ڊي) ._
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### جيڪڏهن توهان کي پنهنجي مشين تي گٽ نه آهي ، ته [انسٽال ڪريو] (https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## هن مخزن کي سنڀاليو
|
||||
|
||||
هن صفحي جي مٿئين حصي تي فورڪ بٽن تي ڪلڪ ڪري هن مخزن کي دٻايو.
|
||||
اهو توهان جي اڪائونٽ ۾ هن مخزن جي ڪاپي ٺاهي ڏيندو.
|
||||
|
||||
## مخزن کي کلون
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
هاڻي ڪلون محفوظ ڪيل مخزن کي توهان جي مشين ڏانهن پهچايو. پنھنجي GitHub اڪائونٽ ڏانھن وڃو ، فورڪ ٿيل مخزن کي کوليو ، ڪوڊ واري بٽڻ تي ڪلڪ ڪريو ۽ پوءِ _ ڪپي ڪلپ بورڊ جي آئڪن تي ڪلڪ ڪريو.
|
||||
|
||||
هڪ ٽرمينل کوليو ۽ هيٺيان گٽ ڪمانڊ هلايو.
|
||||
|
||||
"
|
||||
گٽ کلون ”يو آر ايل توهان ڪاپي ئي ڪئي آهي“
|
||||
"
|
||||
|
||||
جتي "صرف توهان يوپي ايل ڪاپي ڪئي آهي" (ڪڻڪ جي نشانين کانسواءِ) هن ريزنزوري ڏانهن يو آر ايل (هن پراجيڪٽ جي ڪانٽ). يو آر ايل حاصل ڪرڻ لاءِ پوئين قدم ڏسو.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
مثال طور:
|
||||
|
||||
"
|
||||
گٽ کلون https://github.com/this-is-you/first-contactions.git
|
||||
"
|
||||
|
||||
جتي-هي-تون-توهان جو آهي توهان جو GitHub صارف نالو هتي توهان پنهنجي ڪمپيوٽر ڏانهن GitHub تي سڀ کان پهرين شراڪت جي مخزن جو مواد نقل ڪري رهيا آهيو.
|
||||
|
||||
## هڪ شاخ ٺاهيو
|
||||
|
||||
توهان جي ڪمپيوٽر تي مخزن ڊاريڪٽري ۾ تبديل ڪريو (جيڪڏهن توهان پهريان ئي نه آهيو)
|
||||
|
||||
"
|
||||
سي ڊي پهرين تعاون
|
||||
"
|
||||
|
||||
ھاڻي شاخ ٺاھيو حڪم "گٽ چيڪ آئوٽ" استعمال ڪندي.
|
||||
|
||||
"
|
||||
ڏسي چڪاس ڪريو -آب نئون-شاخ-نالو
|
||||
"
|
||||
|
||||
مثال طور:
|
||||
|
||||
"
|
||||
گٽ چيڪ آئوٽ -b شامل الونزو-چرچ
|
||||
"
|
||||
|
||||
(شاخ جو نالو _add_ لفظ شامل ڪرڻ جي ضرورت ناهي ، پر ان ۾ شامل ٿيڻ مناسب ڳالهه آهي ڇاڪاڻ ته هن برانچ جو مقصد توهان جي نالي کي لسٽ ۾ شامل ڪرڻ آهي.)
|
||||
|
||||
## ضروري تبديليون ڪيو ۽ انهن تبديلين کي انجام ڏيو
|
||||
|
||||
ھاڻي ٽيڪسٽ ايڊيٽر ۾ Contributors.md فائل کوليو ، پنھنجو نالو ان ۾ شامل ڪريو. فائل جي شروعات يا آخر ۾ ان کي شامل نه ڪريو. ان کي وچ ۾ ڪٿي به وجھو. ھاڻي ، فائل کي بچايو.
|
||||
|
||||
<img align="right" width="450" src="assets/git-status.png" alt="git status" />
|
||||
|
||||
جيڪڏهن توهان پروجيڪٽ ڊاريڪٽري ڏانهن وڃو ۽ حڪم کي ختم ڪريو گٽ اسٽيٽس ، توهان ڏسندا ته هتي تبديليون آهن.
|
||||
|
||||
جن شاخن کي توھان ٺاھيو آھي انھن کي شامل ڪريو جيڪي تبديلي آڻي سگھوٿا
|
||||
|
||||
"
|
||||
git شامل ڪريو Contributors.md
|
||||
"
|
||||
|
||||
ھاڻي انھن تبديلين کي انجام ڏيو "گٽ ڪمٽ" حڪم استعمال ڪندي:
|
||||
|
||||
"
|
||||
git commit -m "شرڪت ڪندڙن جي لسٽ ۾ <توھان جو نالو شامل ڪريو"
|
||||
"
|
||||
|
||||
توهان جي نالي سان "توهان جو نالو" بدلجي ٿو.
|
||||
|
||||
## گٽ هب ۾ پش تبديلين
|
||||
|
||||
پنھنجن تبديلين کي ھٿ سان ڌڪايو "گشت پش":
|
||||
|
||||
"
|
||||
گٽ پش اصل <add-your-branch-name>
|
||||
"
|
||||
|
||||
توهان جي ٺاهي ڪيل شاخ جي نالي سان <add-your-branch-name> "کي تبديل ڪرڻ
|
||||
|
||||
## پنھنجون تبديليون راءِ لاءِ پيش ڪريو
|
||||
|
||||
جيڪڏهن توهان GitHub تي پنهنجي مخزن ڏانهن ويندا آهيو ، توهان ڏسندا "تقابلي ۽ پلڻ واري درخواست" بٽڻ. انهي بٽڻ تي ڪلڪ ڪيو.
|
||||
|
||||
<img style="float: right;" src="assets/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
هاڻي پل جي درخواست جمع ڪر.
|
||||
|
||||
<img style="float: right;" src="assets/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
جلد ئي آئون توهان جي سڀني تبديلين کي ان منصوبي جي ماسٽر برانچ ۾ ضم ڪري ڇڏيندس. توهان جون هڪ ڀيرو اطلاع ملڻ واري اي ميل حاصل ٿيندي هڪ ڀيرو تبديليون ضم ٿي ويون آهن.
|
||||
|
||||
## ڪيڏانهن وڃڻو آهي؟
|
||||
|
||||
مبارڪون هجن! توهان صرف معياري _فورڪ -> ڪلون -> ايڊٽ ڪيو -> پل درخواست_ ڪم جي وهڪري کي مڪمل ڪيو جنهن سان توهان اڪثر منهن ڏيڻ ۾ مدد ڪندا!
|
||||
|
||||
پنهنجي حصي جو جشن ملهايو ۽ ان کي [ويب ايپ] تي وڃڻ سان پنهنجن دوستن ۽ پوئلڳن سان حصيداري ڪريو (https://firstcontactions.github.io/#social-share).
|
||||
|
||||
جيڪڏهن توهان ڪنهن مدد جي گهرج ۾ يا ڪنهن سوال جي صورت ۾ توهان اسان جي سستي ٽيم ۾ شامل ٿي ويا [سليڪ ٽيم ۾ شامل ٿيو] (https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
هاڻي اچو ته توهان شروع ڪيو ٻين منصوبن ۾ ڀاڙي سان حصو وٺي اسان منصوبن جي هڪ فهرست مرتب ڪئي آهي توهان کي آسان مسئلن تي جيڪي توهان شروع ڪري سگهو ٿا. [ويب ائپ ۾ منصوبن جي فهرست] چيڪ ڪريو (https://firstcontactions.github.io/#project-list).
|
||||
|
||||
### [اضافي مواد] (additional-material/git_workflow_scenarios/extra-material.md)
|
||||
|
||||
## ٻين اوزارن کي استعمال ڪندي سبق
|
||||
|
||||
| <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) |
|
||||
@@ -1,125 +0,0 @@
|
||||
[](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/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Prvý príspevok
|
||||
|
||||
Život je ťažký. Obzvlášť keď niečo robíte prvýkrát. V prípade, že na niečom spolupracujete, nie je robenie chýb niečo, čo by vám robilo radosť. My by sme radi zjednodušili cestu novým prispievateľom do open-source pri ich učení sa ako na to.
|
||||
|
||||
Čítanie článkov alebo zhliadnutie video návodov sú tiež cesty, ale čo je lepšie ako si danú vec priamo ohmatať na vlastnej koži v reálnom prostredí? Tento projekt je zameraný na poskytnutie pomoci začiatočníkom s ich prvým prispením do open-source. Ak ste ním práve vy, nasledujte kroky popísané nižšie.
|
||||
|
||||
#### *Ak nemáte radi príkazový riadok, [tu nájdete návody na použitie nástrojov s GUI (grafické užívateľské rozhranie)](#Návod-za-použitie-ďalších-nástrojov)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="forknite tento repozitár" />
|
||||
|
||||
Ak máte nainštalovaný git, [nainštalujte si ho]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Forknite tento repozitár
|
||||
|
||||
Forknite (vytvorenie kópie z originálu, z anglického *fork* - *vidlička*, ako vytvorenie novej odnože) tento repozitár kliknutím na tlačidlo **Fork** hore na tejto stránke. Tým vytvoríte kópiu tohto repozitára na svojom vlastnom GitHib účte.
|
||||
|
||||
## Naklonujte repozitár
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="naklonujte tento repozitár" />
|
||||
|
||||
Teraz naklonujte (anglicky *clone*) forknutý repozitár na váš počítač, naklonovanie nie je nič iné ako stiahnutie obrazu repozitára k vám na počítač. Na vašom GitHub účte si otvoríte forknutý repozitár, kliknite na tlačidlo **Clone or download** a následne v okienku, ktoré sa objaví, kliknite na tlačidlo s ikonkou **copy to clipboard** vedľa URL adresy, čím si ju skopírujete do schránky.
|
||||
|
||||
Teraz otvorte terminál a spustite nasledujúci príkaz:
|
||||
|
||||
````
|
||||
git clone "url ktoré ste práve skopírovali"
|
||||
|
||||
````
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="skopírujte adresu do schránky" />
|
||||
|
||||
Napríklad:
|
||||
|
||||
````
|
||||
git clone https://github.com/vas-username/first-contributions.git
|
||||
````
|
||||
|
||||
Týmto na svojom počítači vytvoríte priečinok so súbormi daného repozitára.
|
||||
|
||||
## Vytvorte vetvu
|
||||
|
||||
V príkazovom riadku sa prepnite do zložky s repozitárom (ak v nej už nie ste)
|
||||
|
||||
````
|
||||
cd first-contributions
|
||||
````
|
||||
|
||||
Teraz vytvorte novú vetvu (anglicky *branch*) za použitia príkazu `git checkout`:
|
||||
|
||||
````
|
||||
git checkout -b <meno-novej-vetvy>
|
||||
````
|
||||
|
||||
Napríklad:
|
||||
````
|
||||
git checkout -b pridanie-mojho-mena
|
||||
````
|
||||
|
||||
Meno vetvy by malo vypovedať o tom, čo kód alebo čokoľvek iné do nej pridané bude robiť/vykonávať, prípadne prečo sa daná vec deje.
|
||||
|
||||
## Urobte zmeny a zaznamenajte ich
|
||||
|
||||
Otvorte súbor `Contributors.md` v textovom editore a pridajte do neho svoje meno. Napíšte ho niekam doprostred a súbor uložte.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme//git-status.png" alt="git status" />
|
||||
|
||||
Pokiaľ teraz v príkazovom riadku spustíte príkaz `git status`, uvidíte aké zmeny boli v repozitári vykonané.
|
||||
|
||||
Tieto zmeny do danej vetvy pridáte príkazom `git add`:
|
||||
|
||||
````
|
||||
git add Contributors.md
|
||||
````
|
||||
|
||||
Zostáva už len potvrdiť (anglicky *commit*) zmeny príkazom `git commit`:
|
||||
|
||||
````
|
||||
git commit -m "Add <vase-meno> to Contributors list"
|
||||
````
|
||||
|
||||
Za prepínač `-m` sa píše čo dané zmeny predstavujú, popis by mal byť jednoduchý ale výstižný.
|
||||
|
||||
## Pretlačte zmeny na GitHub
|
||||
|
||||
Teraz zmeny vykonané lokálne na počítači pretlačíme (anglicky *push*) na GitHub príkazom `git push`:
|
||||
|
||||
````
|
||||
git push origin <meno-vasej-vetvy>
|
||||
````
|
||||
|
||||
## Predložte svoje zmeny na posúdenie
|
||||
|
||||
Pokiaľ sa teraz pozriete do svojho GitHub repozitára, uvidíte tlačidlo **Compare & pull request**. Kliknite naň.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme//compare-and-pull.png" alt="vytvorte pull request" />
|
||||
|
||||
Teraz vytvorte žiadosť o pretiahnutie vašej vetvy do originálneho repozitára (anglicky *pull request*).
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme//submit-pull-request.png" alt="potvrďte pull request" />
|
||||
|
||||
Čoskoro budú správcovia vykonávať zapracovanie vašich zmien do hlavnej (anglicky *master*) vetvy tohto projektu. Až sa do nej vaše zmeny dostanú, dostanete emailové upozornenie.
|
||||
|
||||
## Kam ďalej?
|
||||
|
||||
Blahoželáme! Práve ste dokončili štandardný _fork -> clone -> edit ->_ priebeh práce (anglicky *workflow), s ktorým sa ako prispievateľ do projektov stretnete dennodenne.
|
||||
|
||||
Oslávte svoj prvý príspevok so svojimi priateľmi a nasledovníkmi cez [webovú aplikáciu](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
V prípade, ak by ste mali akékoľvek otázky alebo potrebovali pomoc, môžete sa [pridat k našemu Slack teamu](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY).
|
||||
|
||||
Teraz vám už nič nebráni v prispievaní do ostatných projektov. Pripravili sme pre vás zoznam projektov, ktoré majú jednoduché záležitosti na vyriešenie/naprogramovanie, s ktorými môžete začať. Pozrite sa [tu](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Ďalšie materiály](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Návod za použitia ďalších nástrojov
|
||||
|
||||
|<a href="../github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width=" 100"></a>|<a href="../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="../gitkraken-tutorial.md"><img alt="GitKraken" src="https:/ /firstcontributions.github.io/assets/Readme/gk-icon.png" width="100"></a>|<a href="../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>|
|
||||
|---|---|---|---|
|
||||
|[GitHub Desktop](../github-desktop-tutorial.md)|[Visual Studio 2017](../github-windows-vs2017-tutorial.md)|[GitKraken](../gitkraken-tutorial.md )|[Visual Studio Code](../github-windows-vs-code-tutorial.md)|
|
||||
@@ -1,121 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Prvi prispevek
|
||||
|
||||
Vsak začetek je težak. Ko sodeluješ z drugimi, so napake še veliko bolj neprijetne. Zato smo se odločili, da novincem olajšamo prispevanje k odprti kodi (ang. Open source).
|
||||
|
||||
Branje člankov in sledenje vodičem lahko pomaga, vendar je še vedno najbolje da nove veščine vadimo sami v varnem okolju. Namen tega projekta je da novince vodi in jim olajša prvi prispevek k odprti kodi. Če želite narediti prvi prispevek, sledite spodnjim korakom.
|
||||
|
||||
Angleški izrazi so v oklepajih, da dodajo kontekst vsebini.
|
||||
|
||||
#### *Če se ne počutite dobro v ukazni vrstici (ang. command line), so tukaj [navodila za uporabo orodij z grafičnim vmesnikom.]( #vodiči-za-uporabo-drugih-orodij )*
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Če na svojem računalniku še nimaš "git", si ga [naloži]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Ustvari svojo različico repository-ja ( Fork this repository )
|
||||
|
||||
S pritiskom na gumb "Fork" na vrhu te strani, ustvari svojo različico repositorya ( pogosto skrajšano v "repo" ) v svojem GitHub računu.
|
||||
|
||||
## Kloniraj ta repository ( Clone the repository )
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Sedaj kloniraj ta repository na svoj računalnik. Pojdi v svoj GitHub račun in poišči svojo različico tega repositorya, klikni na gumb "Clone or download" in si kopiraj povezavo. Lahko uporabiš "Ctrl+C" ali pa klikni na ikono na desni strani povezave *copy to clipboard*.
|
||||
|
||||
Odpri terminal in se postavi v direktorij, v katerem želiš imeti svojo kopijo repositorya. Nato zaženi naslednji ukaz:
|
||||
|
||||
```
|
||||
git clone "url naslov, ki si ga ravno skopiral"
|
||||
```
|
||||
"url naslov, ki si ga ravno skopiral" (brez navednic) je naslov, ki si ga skopiral na Githubu ( naslov tvoje različice projekta ). Glej prejšne korake da dobiš url naslov.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Primer:
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
`this-is-you` je tvoje GitHub uporabniško ime. Ta ukaz skopira vsebino repositorya "first-contributions" z GitHuba v tvoj računalnik.
|
||||
|
||||
## Ustvari vejo ( Create a branch )
|
||||
|
||||
Prestavi se v direktorij repositorya na svojem računalniku (če še nisi v njem):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Sedaj ustvari vejo z uporabo ukaza `git checkout`:
|
||||
```
|
||||
git checkout -b <add-your-new-branch-name>
|
||||
```
|
||||
|
||||
Primer:
|
||||
```
|
||||
git checkout -b add-janez-novak
|
||||
```
|
||||
(Ni potrebno da je v imenu veje *add*, vendar je v tem primeru smiselno, ker je namen veje da dodaš svoje ime na seznam.)
|
||||
|
||||
## Naredi spremembe in izvedi commmit teh sprememb ( Make necessary changes and commit those changes )
|
||||
|
||||
Odpri datoteko `Contributors.md` v urejevalniku besedila in dodaj svoje ime. Ne dodajaj ga na začetek ali konec datoteke, dodaj ga nekje vmes. Shrani datoteko.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Če se postaviš v direktorij projekta in izvedeš ukaz `git status`, vidiš da obstajajo spremembe v projektu.
|
||||
|
||||
|
||||
Dodaj te spremembe veji, ki si jo ravno ustvaril, z ukazom `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Sedaj izvedi commit teh sprememb z ukazom `git commit`:
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
Zamenjaj `<your-name>` s svojim imenom. Tekst med navednicami je komentar spremembe, ki se shrani s spremembo.
|
||||
|
||||
## Pošlji spremembe na GitHub ( Push changes to GitHub )
|
||||
|
||||
Pošlji svoje spremembe z ukazom `git push`:
|
||||
```
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
Zamenjaj `<add-your-branch-name>` z imenom veje, ki si jo ustvaril.
|
||||
|
||||
## Vloži svoje spremembe v pregled ( Submit your changes for review )
|
||||
|
||||
Če preveriš svoj repository na GitHubu, vidiš gumb `Compare & pull request`. Klikni na ta gumb.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Sedaj izvedi submit svojega pull requesta.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Kmalu bom združil tvoje spremembe v master vejo tega projekta. V svoj e-poštni nabiralnik boš dobil sporočilo, da so bile spremembe združene.
|
||||
|
||||
## Kako nadaljevati? ( Where to go from here? )
|
||||
|
||||
Čestitke! Pravkar si končal običajni _fork -> clone -> edit -> PR_ potek dela, ki ga boš srečal kot sodelavec v odprto kodnih projektih!
|
||||
|
||||
Lahko se pridružiš naši slack ekipi, če rabiš pomoč ali imaš vprašanja. [Pridruži se slack ekipi](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Sedaj lahko začneš prispevati drugim projektom. Sestavili smo seznam projektov z enostavnimi problemi (issues), ki jih lahko začneš reševati. Preveri [seznam projektov v spletni aplikaciji](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Dodatne informacije](../additional-material/translations/Slovenian/additional-material.sl.md)
|
||||
|
||||
|
||||
## Vodiči za uporabo drugih orodij
|
||||
|
||||
| <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) |
|
||||
@@ -1,121 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Prvé príspevky
|
||||
|
||||
Je to ťažké. Je to vždy ťažké, keď niečo robíš prvýkrát. Najmä vtedy, keď spolupracuješ, robiť chyby nie je pohodlná vec. Chceli sme zjednodušiť spôsob, akým sa noví prispievatelia do open source učia a prispievajú prvýkrát.
|
||||
|
||||
Čítanie článkov a sledovanie tutoriálov môže pomôcť, ale čo je lepšie, ako skutočne robiť veci v skúšobnom prostredí? Cieľom tohto projektu je poskytnúť usmernenie a zjednodušiť spôsob, akým prvýkrát prispievajú začiatočníci. Ak máš záujem o prvý príspevok, postupuj podľa nižšie uvedených krokov.
|
||||
|
||||
#### *Ak sa ti nedarí s príkazovým riadkom, [tu sú návody s nástrojmi grafického rozhrania.]( #návody-pomocou-iných-nástrojov )*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Ak nemáš na svojom počítači git, [nainštaluj ho]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Skopíruj toto úložisko
|
||||
|
||||
Skopíruj toto úložisko kliknutím na tlačidlo vidlice(fork) v hornej časti tejto stránky.
|
||||
Tým sa vytvorí kópia tohto úložiska na tvojom účte.
|
||||
|
||||
## Stiahni toto úložisko
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Teraz stiahni toto úložisko do tvojho zariadenia. Prejdi do tvojho účtu GitHub, otvor skopírované úložisko, klikni na tlačidlo klonovania a potom klikni na ikonu * kopírovať do schránky *.
|
||||
|
||||
Otvor terminál a spusti nasledujúci git príkaz:
|
||||
|
||||
```
|
||||
git clone "adresa, ktorú si práve skopíroval"
|
||||
```
|
||||
kde "adresa ktorú si práve skopíroval" (bez úvodzoviek) je adresa URL tohto úložiska (tvoja kópia tohto projektu). Pozri si predchádzajúce kroky na získanie adresy URL.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Napríklad:
|
||||
```
|
||||
git clone https://github.com/toto-si-ty/prve-prispevky.git
|
||||
```
|
||||
kde `toto-si-ty` je tvoje GitHub užívateľské meno. Tu skopíruješ obsah GitHub úložiska prve-prispevky do tvojho počítača.
|
||||
|
||||
## Vytvor vetvu
|
||||
|
||||
Prejdi do adresára úložiska v tvojom počítači (ak ešte nie si tam):
|
||||
|
||||
```
|
||||
cd prve-prispevky
|
||||
```
|
||||
Teraz vytvor vetvu pomocou príkazu `git checkout`:
|
||||
```
|
||||
git checkout -b <pridaj-meno-tvojej-novej-vetvy>
|
||||
```
|
||||
|
||||
Napríklad:
|
||||
```
|
||||
git checkout -b pridaj-ferko-mrkvicka
|
||||
```
|
||||
(Názov pobočky nemusí obsahovať slovo * pridaj *, ale je rozumné pridať ho, pretože účelom tejto pobočky je pridať tvoje meno do zoznamu.)
|
||||
|
||||
## Vykonaj potrebné zmeny a potvrď tieto zmeny
|
||||
|
||||
Teraz otvor súbor `Contributors.md` v textovom editore a pridaj do neho svoje meno. Nepridávaj ho na začiatok alebo na koniec súboru. Daj ho kdekoľvek medzi tým. Teraz súbor ulož.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Ak prejdeš do adresára projektu a vykonáš príkaz `git status`, uvidíš zmeny.
|
||||
|
||||
Pridaj tieto zmeny do vetvy, ktorú si práve vytvoril, pomocou príkazu `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Teraz vykonaj tieto zmeny pomocou príkazu `git commit`:
|
||||
```
|
||||
git commit -m "Pridaj <tvoje-meno> do zoznamu pripievateľov"
|
||||
```
|
||||
nahraď `<tvoje-meno>` tvojim menon.
|
||||
|
||||
## Nahraj zmeny na GitHub
|
||||
|
||||
Nahraj svoje zmeny pomocou príkazu `git push`:
|
||||
```
|
||||
git push origin <pridaj-meno-tvojej-novej-vetvy>
|
||||
```
|
||||
nahraď `<pridaj-meno-tvojej-novej-vetvy>` názvom vetvy, ktorú si vytvoril skôr.
|
||||
|
||||
## Odošli svoje zmeny na kontrolu
|
||||
|
||||
Ak prejdeš do tvojho úložiska v službe GitHub, zobrazí sa tlačidlo `Compare & pull request`. Klikni na toto tlačidlo.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Teraz predlož požiadavku na vytiahnutie.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
|
||||
Čoskoro budem zlučovat všetky vaše zmeny do hlavnej pobočky tohto projektu. Po zlúčení zmien dostaneš upozornenie.
|
||||
|
||||
## Kam ísť odtiaľto?
|
||||
|
||||
Gratulujem! Práve si dokončil štandardný _fork -> klon -> upraviť -> PR_ pracovný postup, ktorý sa často stretneš ako prispievateľ!
|
||||
|
||||
Osláv svoj príspevok a zdieľaj ho so svojimi priateľmi a nasledníkmi [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Môžeš sa pripojiť k nášmu slack tímu v prípade, že potrebuješ nejakú pomoc alebo máš nejaké otázky. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Teraz začni s účasťou na iných projektoch. Vytvorili sme zoznam projektov s jednoduchými problémami, s ktorými môžeš začať. Pozri [zoznam projektov vo webovej aplikácii](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Dodatočný materiál](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Návody pomocou iných nástrojov
|
||||
|
||||
| <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) |
|
||||
@@ -1,154 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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)
|
||||
|
||||
# Wax ku biirinta kowaad
|
||||
|
||||
Mashruucan ujeedadiisu waxey tahay in la fududeyo iyo in la hago kuwa bilawga ah si ay usameyan wax ku biirintooda kowaad "First contribution". Hadii aad raadinayso sida aad usameyn laheyd wax ku biirintaada kowaad, talaabooyinkan soo socda raac.
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### Haddii git uusan kuugu jirrin kombiyuutarkaaga, [Soo dagso](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## kala qeybi Kaydkan (Repository)
|
||||
|
||||
Kala qeybi kaydkan adigoo gujinayo badhanka kore ee page-ka kuna qoran "Fork".
|
||||
Tani waxay ciwaankaga kudhax abuuri doontaa koobiga kaydkan
|
||||
|
||||
## Koobbi (clone) kaydka
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Hadda ku koobbi kaydkan kombiyuutarkaaga.Tag Akoonkaaga GitHub, Waxaad furtaa kaydki aad Kala qeybisay, Waxaad gujisa badhanka ku qoran "Code" ka dibna taabo koobiga sumadda sabuuradda.
|
||||
|
||||
Waxaad furta "Teminal" ka kadib waxad ku qorta amarada git-ka soo socda:
|
||||
|
||||
```
|
||||
git clone "url-ka aad hadda soo koobbiyeysay"
|
||||
```
|
||||
|
||||
Iyadoo "url-ka aad hadda soo koobbiyeysay" (oo aan lahayn calaamadaha xigashada) uu yahay url-ka ama linkiga kaydkaan. waxaad dib usoo eegtaa talaabooyinkii hore si aad u hesho url-ka
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Tusaale:
|
||||
|
||||
```
|
||||
git clone https://github.com/magaca-isticmalaha/first-contributions.git
|
||||
```
|
||||
|
||||
Halka `magaca-isticmalaha` uu yahay magacaaga aad ku isticmasho Github.Halkan waxa aad kombayutarkaaga ku koobiyaynaysaa waxa ku jira kaydka wax ku biirinta koowaad ee GitHub.
|
||||
|
||||
## Abuur laan (branch)
|
||||
|
||||
Haddii aadan weli ku jirin galka (folder), u gudub halka uu kaaga yaalo galka kombiyuutarkaaga:
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Abuur laan cusub adigoo isticmaalaya amarka `git checkout`:
|
||||
|
||||
```
|
||||
git checkout -b <magacaada-cusub-ee-laanta>
|
||||
```
|
||||
|
||||
Tusaale:
|
||||
|
||||
```
|
||||
git checkout -b kudar-nur-farah-omar
|
||||
```
|
||||
|
||||
Waajib ma ahan inaad ku darto ereyga `kudar` magaca laanta, laakin waxey uyeleysa micno maadama laantaan loo sameeyay in aad magacaada ku darto listiga wax kubiiriyasha.
|
||||
|
||||
## Samee isbedelada lagama maarmaanka ah oo gali (commit) Github isbedeladaas
|
||||
|
||||
Hadda ku fur faylka `Contributors.md` tafatiraha qoraalka,
|
||||
Waa inaad aqoon u leedahay "Markdown", oo ah luqad calaamadeyn ah oo fudud. Fiiri [xaashida qishka](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) si aad u barato sida loo isticmaalo.
|
||||
Ku dar magacaada, Hana ku darin bilowga ama dhamaadka faylka. Kudar meel kasta oo u dhaxaysa.
|
||||
|
||||
```
|
||||
- [Magacaada](https://github.com/magaca-isticmalaha)
|
||||
```
|
||||
|
||||
Tusaale:
|
||||
|
||||
```
|
||||
- [Nur Farah](https://github.com/Nur-farah)
|
||||
```
|
||||
|
||||
Hubi in aysan jirin meelo bannaan oo u dhexeeya `](`. Keydi oo xidh faylka.
|
||||
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Haddii aad tagto galka aad fuliso amarka `git status` waxaad arki doonta inay jiraan isbedelo
|
||||
|
||||
Ku dar isbeddeladaas laanta aad hadda abuurtay adigoo isticmaalaya ammarka `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Hadda gali (commit) isbeddeladaas adigoo isticmaalaya amarka `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Kudar Magacaada listiga wax biirinta kowaad"
|
||||
```
|
||||
|
||||
Adigoo `Magacaada` ku badalayo magacaada shaqsiga.
|
||||
|
||||
(N.B: Waxaad ku qori kartaa fariinta xaqiijinta Ingiriisi maadaama aad la shaqayn doonto dad ka kala yimid meelo kala duwan oo adduunka ah.)
|
||||
|
||||
## Ku riix isbedelada GitHub
|
||||
|
||||
Riix isbedeladaada adigoo isticmaalaya amarka `git push`:
|
||||
|
||||
```
|
||||
git push -u origin magaca-laantaada
|
||||
```
|
||||
|
||||
Adigoo `magaca-laantaada` ku badalaya magaca laanta aad hore u abuurtay.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Haddii aad wax qalad ah aad aragto markaad riixayso, guji halkan:</strong> </summary>
|
||||
|
||||
- ### Cilad Xaqiijin
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Tag [casharrada GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ee ku saabsan abuuritaanka iyo habaynta furaha SSH ee akoonkaaga
|
||||
|
||||
</details>
|
||||
|
||||
## Soo gudbi isbeddelladaada si dib loogu eego
|
||||
|
||||
Haddii aad tagto kaydkaaga GitHub,waxaad arki doontaa badhanka `Compare & pull request`. Badhankaas guji.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Hadda soo gudbi codsiga jiidista (pull request).
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Dhawaan waxaan ku dari doonaa dhammaan isbeddelladaada laanta ugu weyn ee mashruucan (master). Waxaad heli doontaa iimayl ogeysiin ah marka isbeddelada la isku daro.
|
||||
|
||||
## Halkee laga aadaa halkan?
|
||||
|
||||
Hambalyo! Waxaad hadda dhamaystirtay heerka caadiga ah ee kalaqaybinta(fork) -> koobbi-ga (clone) -> wax kabedelka -> codsiga jiidista habka shaqada oo aad inta badan la kulmi doonto ka qaybqaate ahaan!
|
||||
|
||||
U dabaaldeg wax ku biirintaada oo la wadaag asxaabtaada iyo kuwa ku raacsan adiga oo aadaya [abka shabakada](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Waxaad ku biiri kartaa kooxdeena slack ah haddii aad u baahan tahay wax caawimo ah ama aad qabto wax su'aalo ah. [Ku biir kooxda slack ](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Hadda aan kuu bilowno ka qayb qaadashada mashaariicda kale. Waxaan soo diyaarinay liis mashruucyo ah oo leh qaladaad sahlan oo aad ku bilaabi karto. Fiiri [liiska mashaariicda ku jira abka shabakada](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Waxyaabo dheeraad ah](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Casharrada Isticmaalka Aalado Kale
|
||||
|
||||
| <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) |
|
||||
@@ -1,118 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Prvi prilog
|
||||
|
||||
Teško je. Prvi pokušaj je uvek težak. Kada sarađuješ sa drugima, napraviti greške je utoliko strašnije. Želeli bismo da olakšamo proces kroz koji novi programeri koji doprinose otvorenom softveru (eng. open source) uče i doprinose po prvi put.
|
||||
|
||||
Iako blogovi i tutorijali mogu da pomognu, ništa nije bolje nego uzeti stvari u svoje ruke i zaista doprinositi u trening-sredini. Ovaj projekat ima za cilj da pruži konkretne korake i olakša način na koji početnici prilažu svoje prve doprinose (eng. contributions). Ukoliko ste se prepoznali u tekstu iznad, pratite sledeće korake.
|
||||
|
||||
|
||||
#### *Ako vam je nezgodno da čitate tekst u komandnoj liniji, [evo linka kroz GUI alate.](#Uputstva-za-druge-alate)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="Napravite fork repozitorijuma" />
|
||||
|
||||
Ukoliko nemati git instaliran na vašoj mašini, [instalirajte ga ovde]( https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Napravite fork repozitorijuma
|
||||
|
||||
Napravite račvanje (fork) tako što ćete kliknuti na dugme *fork* na vrhu stranice. Ovako pravite kopiju repozitorijuma na vašoj strani.
|
||||
|
||||
## Klonirajte repozitorijum
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Sledeće, klonirajte repozitorijum koji ste prethodno račvali. Posetite svoj GitHub profil, otvorite repozitorijum koji ste račvali, kliknite na *clone* dugme i kliknite na ikonicu *copy to clipboard*.
|
||||
|
||||
Otvorite terminal i upišite sledeće git komande:
|
||||
|
||||
```
|
||||
git clone "url you just copied"
|
||||
```
|
||||
Umesto "url you just copied" (bez navodnika i razmaka) upišite url repozitorijuma koji ste kopirali u prethodnom koraku.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Na primer:
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
Gde je umesto `this-is-you` upisano vaše korisničko ime. Ovim kopirate sadržaj repozitorijuma *first-contributions* na vašu mašinu.
|
||||
|
||||
## Pravljenje grane *branch*
|
||||
|
||||
Prebacite se u radni direktorijum na vašoj mašini:
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
Pa zatim napravite novo grananje *branch* koristeći `git checkout` comandu:
|
||||
```
|
||||
git checkout -b <add-your-new-branch-name>
|
||||
```
|
||||
|
||||
Na primer:
|
||||
```
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
(Naziv grane ne mora da sadrži *add* na početku, ali je zgodno uključiti ga jer je svrha ove grane da doda vaše ime na listu.
|
||||
|
||||
## Napravite potrebne izmene i potvrdite promene
|
||||
|
||||
Otvorite `Contributors.md` fajl u tekst editoru i dodajte vaše ime. Nemojte dodavati ime na sam početak ili kraj. Stavite ga negde u sredinu. Potom sačuvajte fajl.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Ukoliko odete u radni direktorijum i izvršite komandu `git status`,primetićete da postoje promene.
|
||||
|
||||
Dodajte ove promene u granu koju ste gore napravili koristeći `git add` komandu:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Sada potvrdite ove promene koristeći `git commit` komandu:
|
||||
```
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
Gde umesto `<your-name>` upisujete svoje ime.
|
||||
|
||||
## Push changes to GitHub
|
||||
|
||||
Pošaljite izmene u repozitorijum na GitHub nalogu `git push`:
|
||||
```
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
gde umesto `<add-your-branch-name>` stavljate ime vašeg grananja.
|
||||
|
||||
## Pošaljite izmene na reviziju
|
||||
|
||||
Ukoliko odete na repozitorijum na vašem GitHub nalogu primetićete `Compare & pull request` Dugme. Kliknite na njega.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
a potom pošaljite zahtev klikom na dugme *submit*.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Nakon toga, ja ću spojiti promene koje ste napravili sa master granom projekta. Dobićete mejl potvrde kada se grane spoje.
|
||||
|
||||
## Šta dalje?
|
||||
|
||||
Čestitamo! Završili ste standardni _fork -> clone -> edit -> PR_ tok koji će vas pratiti kroz vaš čitav programerski život!
|
||||
|
||||
Proslavite tako što ćete podeliti vaš doprinos sa prijateljima i pratiocima otvaranjem [stranice](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Pridružite se i našem Slack timu u slučaju da vam je potrebna ikakva pomoć ili imate bilo kakvih pitanja. [Slack tim](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
A sada, možemo početi sa doprinosima drugim projektima. Napravili smo spisak projekata sa jednostavnim problemima na kojima možete početi da radite. Posetite stranicu sa [the list of projects na našem sajtu](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Dodatni materijali](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Uputstva za druge alate
|
||||
|
||||
| <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) |
|
||||
@@ -1,130 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Mchango wa Kwanza
|
||||
|
||||
Ni vigumu. Mara zote ni vigumu kufanya kitu kwa mara ya kwanza. Hasa kama unashirikiana na wengine, kufanya makosa sio jambo la kushangaza. Tulitaka kurahisisha namna ambavyo wachangiaji wapya wa mifumo ya wazi wanavyojifunza na kuchangia kwa mara ya kwanza.
|
||||
|
||||
Kusoma makala na kuangalia mafunzo ya video yaweza kusaidia, lakini ni jambo lipi bora zaidi kuliko kufanya kwa vitendo katika mazingira ya kujifunzia? Mradi huu unalenga kutoa mwongozo na kurahisisha namna ambavyo wachangiaji wapya wanavyoweza kuchangia kwa mara ya kwanza. Ikiwa unataka kuchangia kwa mara ya kwanza , fuata hatua zifuatazo.
|
||||
|
||||
#### *Kama haujazoea kutumia 'command line', [waweza kutumia GUI.](#Makala ya namna ya kutumia nyenzo nyingine)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Kama hauna git kwenye kompyuta yako, [pakua](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Tengeneza nakala ya repository kwenye akaunti yako ya Github
|
||||
|
||||
'Fork' repository hii kwa kubonyeza kitufe kilichopo juu ya ukurasa huu
|
||||
Kwa kufanya hivyo nakala ya repository hii itatengenezwa kwenye akaunti yako ya Github.
|
||||
|
||||
## Tengeneza nakala ya repository kwenye kompyuta yako
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Sasa clone repository kwenye kompyuta yako. Nenda kwenye akaunti yako ya Github bonyeza kitufe kilichoandikwa clone na baada ya hapo bonyeza kitufe kilichoandikwa *copy to clipboard* icon.
|
||||
|
||||
Fungua terminal >_ kwenye kompyuta yako kisha command ifuatayo:
|
||||
|
||||
```
|
||||
git clone "url-uliyo-nakili-github"
|
||||
```
|
||||
|
||||
url hiyo inapatikana kwenye hatua ya ku clone, hakikisha unaondoa fungua semi na funga semi.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Kwa mfano:
|
||||
|
||||
```
|
||||
git clone https://github.com/jina-lako-unalotumia-Github/first-contributions.git
|
||||
```
|
||||
|
||||
Kwa kufanya hivyo utakuwa umenakili first-contributions repository kutoka Github kwenda kwenye kompyuta yako.
|
||||
|
||||
## Tengeneza branch:
|
||||
|
||||
Kwenye kompyuta yako, ukiwa kwenye terminal ingia kwenye repository uliyonakili
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Sasa tengeneza branch kwa kutumia command ifuatayo `git checkout` command:
|
||||
|
||||
```
|
||||
git checkout -b <add-your-new-branch-name>
|
||||
```
|
||||
|
||||
Kwa mfano:
|
||||
|
||||
```
|
||||
git checkout -b add-luke-oliff
|
||||
```
|
||||
|
||||
(Jina la branch sio lazima lianze na neno *add*.)
|
||||
|
||||
## Fanya mabadiliko na baada ya hapo commit:
|
||||
|
||||
Sasa fungua faili linaloitwa `Contributors.md`, Andika jina lako. Usiweke jina lako mwanzoni au mwishoni mwa faili. Weka sehemu yoyote katikati. Baada ya hapo save faili.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Ukiwa ndani ya directory hii kwenye terminal command ya `git status` itakuonesha mabadiliko yote uliyoyafanya.
|
||||
|
||||
Jumuisha mabadiliko yote uliyoyafanya kwenye branch uliyotengeneza kwa kutumia command `git add` command:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Sasa commit mabadiliko uliyoyafanya kwa kutumia command ya `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Add <jina> to Contributor list"
|
||||
```
|
||||
|
||||
Badilisha neno `<jina>` na jina lako.
|
||||
|
||||
## Tuma mabadiliko uliyoyafanya kwenda Github
|
||||
|
||||
Tuma mabadiliko uliyoyafanya kwa kutumia command ya `git push`:
|
||||
|
||||
```
|
||||
git push origin <jina-la-branch>
|
||||
```
|
||||
|
||||
Badilisha `<jina-la-branch>` na jina la branch ulilotengeneza hapo awali.
|
||||
|
||||
## Kusanya mabadiliko uliyoyafanya kwa ajili ya uhakiki
|
||||
|
||||
Ukiwa Github kwenye repository hii utaona kitufe kilichoandikwa `Compare & pull request`. Bonyeza kitufe hicho.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Sasa tuma pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Haitochukua muda mrefu nitaanza kuchukua mabadiliko yaliyofanyika na kuyapeleka kwenye master branch ya mradi huu. Utapokea email kukujulisha mara tu hatua hii itakapokamilika.
|
||||
|
||||
## Nini cha kufanya baada ya hapa?
|
||||
|
||||
Hongera! Umeweza kumaliza hatua za msingi ambazo ni _fork -> clone -> edit -> PR_ ambazo utakutana nazo mara nyingi ukiwa kama mchangiaji!
|
||||
|
||||
Sherehekea hatua uliyofikia na wajulishe wengine kwa kwenda kwenye [wavuti](https://roshanjossey.github.io/first-contributions/#social-share).
|
||||
|
||||
Waweza kujiunga na kundi letu la slack endapo utakuwa unahitaji msaada wowote. [Jiunge na kundi letu la slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Sasa tuanze kuchangia kwenye miradi mingine. Tumekusanya orodha ya miradi ambayo ina mambo mepesi unayoweza kuanza kushughulika nayo. Angalia [Orodha ya miradi](https://roshanjossey.github.io/first-contributions/#project-list).
|
||||
|
||||
### [Nyenzo za ziada](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Mafunzo ya namna ya kutumia nyenzo nyingine
|
||||
|
||||
| <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) |
|
||||
@@ -1,153 +0,0 @@
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
# முதல் பங்களிப்புகள்
|
||||
|
||||
நீங்கள் ஏதாவது ஒன்றை முதல் முறை செய்யும் போது அது எப்போதுமே கடினமாக தான் இருக்கும்.
|
||||
குறிப்பாக, நீங்கள் குழுவாக சேர்ந்து வேலை செய்யும் போது, தவறு செய்துவிட்டால் அது மிகவும்
|
||||
வருத்தம் அளிக்கக்கூடியாதாக இருக்கும். ஆகையால், திறந்த மூல மென்பொருள்
|
||||
(open-source software) பங்களிப்பாளர்களாக எவ்வாறு செயலாற்ற வேண்டும் என்பதையும்
|
||||
அதில் முதல் முறையாக பங்களிப்பு செய்வதை எளிதாக்குவதுமே எங்கள் நோக்கம்.
|
||||
|
||||
கட்டுரைகளைப் படிப்பதும், பயிற்சிகளைப் பார்ப்பதும் உதவக்கூடும், ஆனால் நடைமுறைச் சூழலில்
|
||||
செய்முறையாகச் செய்வதை விட சிறந்தது என்ன? இந்த திட்டம் வழிகாட்டுதல்களை வழங்குவதையும்,
|
||||
ஆரம்பநிலை பங்களிப்பாளர்களை அவர்களின் முதல் பங்களிப்பை எளிதாக்குவதையும் நோக்கமாகக்
|
||||
கொண்டுள்ளது. உங்கள் முதல் பங்களிப்பை வழங்க விரும்பினால், கீழே உள்ள வழிமுறைகளை
|
||||
பின்பற்றவும்.
|
||||
|
||||
#### *command line tool உங்களுக்கு வசதியாக இல்லை என்றால், [இங்கே GUI tools ஐ பயன்படுத்தி பயிற்சிகள் உள்ளன.](#பிற-கருவிகளைப்-பயன்படுத்தி-பயிற்சிகள்)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="இந்த repository ஐ fork செய்யவும்" />
|
||||
|
||||
உங்கள் கணினியில் git இல்லை என்றால், [install செய்யவும்](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## இந்த repository ஐ fork செய்தல்
|
||||
|
||||
|
||||
இந்த பக்கத்தின் மேலே உள்ள fork பொத்தானைக் கிளிக் செய்வதன் மூலம் செயட்படுத்தலாம்.
|
||||
இது உங்கள் account இல் ஒரு copy ஐ உருவாக்கும்.
|
||||
|
||||
## இந்த repository ஐ clone செய்தல்
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="இந்த repository ஐ clone செய்யவும்" />
|
||||
|
||||
இப்போது உங்கள் கணினியில் fork செய்யப்பட்ட repository ஐ clone செய்யவும். உங்கள் GitHub கணக்கிற்குச் சென்று, forked செய்யப்பட்ட repository ஐ open செய்து clone பொத்தானைக் கிளிக் செய்து copy to clipboard கிளிக் செய்வதன் மூலம் நிறைவேற்றலாம்.
|
||||
|
||||
*terminal* அல்லது *command prompt* ஐ open செய்து பின்வரும் git கட்டளையை இயக்கவும்:
|
||||
|
||||
```
|
||||
git clone "நீங்கள் copy செய்த url"
|
||||
```
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
|
||||
உதாரணத்திற்கு:
|
||||
|
||||
```
|
||||
git clone https://github.com/இது நீங்கள்/first-contributions.git
|
||||
```
|
||||
|
||||
இங்கு `இது நீங்கள்` என்பது GitHub username என்பதாகும். இதன் மூலம் நீங்கள் first-contributions repository இன் பிரதி ஒன்றை உங்கள் GitHub கணக்கில் செயட்படுத்துகிறீர்கள்.
|
||||
|
||||
## கிளையொன்றை உருவாக்குதல்
|
||||
|
||||
repository directory க்கு செல்லவும் (நீங்கள் ஏற்கனவே அங்கு இல்லையென்றால்):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
|
||||
இப்போது `git checkout` கட்டளையைப் பயன்படுத்தி ஒரு கிளையை உருவாக்கவும்:
|
||||
|
||||
```
|
||||
git checkout -b <உங்கள்-கிளையின்-பெயர்>
|
||||
```
|
||||
|
||||
உதாரணத்திற்கு:
|
||||
|
||||
```
|
||||
git checkout -b உங்கள்-கிளையின்-பெயர்
|
||||
```
|
||||
|
||||
(கிளையின் பெயருக்கு அதில் *add* சேர்க்க வேண்டிய அவசியமில்லை, ஆனால் இது ஒரு நியாயமான விஷயம், ஏனெனில் இந்த கிளையின் நோக்கம் உங்கள் பெயரை ஒரு பட்டியலில் சேர்ப்பதுதான்.)
|
||||
|
||||
## தேவையான மாற்றங்களைச் செய்து அந்த மாற்றங்களை commit செய்யுங்கள்
|
||||
|
||||
இப்போது *text editor* அல்லது *notepad* இல் `Contributors.md` கோப்பைத் திறந்து, அதில் உங்கள் பெயரைச் சேர்க்கவும். கோப்பின் தொடக்கத்திலோ அல்லது முடிவிலோ இதைச் சேர்க்க வேண்டாம். இடையில் எங்கும் வைக்கவும். இப்போது, கோப்பை சேமிக்கவும்.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
நீங்கள் project directory சென்று `git status` இயக்கினால், மாற்றங்கள் இருப்பதை நீங்கள் காண்பீர்கள்.
|
||||
|
||||
|
||||
`git add` கட்டளையைப் பயன்படுத்தி நீங்கள் உருவாக்கிய கிளையில் அந்த மாற்றங்களைச் சேர்க்கவும்:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
இப்போது `git commit` கட்டளையைப் பயன்படுத்தி அந்த மாற்றங்களைச் செய்யுங்கள்:
|
||||
|
||||
```
|
||||
git commit -m "Add <உங்கள்_பெயர்> to Contributors list"
|
||||
```
|
||||
|
||||
`உங்கள்_பெயர்` என்ற இடத்தில் உங்கள் பெயரை கொடுங்கள்.
|
||||
|
||||
## மாற்றங்களை GitHub இட்கு push செய்தல்
|
||||
|
||||
`git push` கட்டளையைப் பயன்படுத்தி உங்கள் மாற்றங்களைத் தள்ளுங்கள்:
|
||||
|
||||
```
|
||||
git push origin <உங்கள்-கிளையின்-பெயர்>
|
||||
```
|
||||
|
||||
|
||||
`<உங்கள்-கிளையின்-பெயர்>` ஐ நீங்கள் முன்பு உருவாக்கிய கிளையின் பெயருடன் மாற்றுங்கள்.
|
||||
|
||||
<details>
|
||||
<summary> <strong>push செய்யும் போது ஏதேனும் பிழைகள் ஏற்பட்டால், இங்கே கிளிக் செய்யவும்:</strong> </summary>
|
||||
|
||||
- ### அங்கீகாரப் பிழை
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
|
||||
உங்கள் account இல் ஒரு SSH key உருவாக்குதல் மற்றும் கட்டமைத்தல் பற்றிய [GitHub இன் பயிற்சிக்கு](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) செல்லவும்.
|
||||
</details>
|
||||
|
||||
## உங்கள் மாற்றங்களை மதிப்பாய்வுக்கு சமர்ப்பிக்கவும்
|
||||
|
||||
|
||||
GitHub இல் உள்ள உங்கள் களஞ்சியத்திற்குச் சென்றால், `Compare & pull request` கோரிக்கை பொத்தானைக் காண்பீர்கள். அந்த பொத்தானைக் கிளிக் செய்க.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
இப்போது இழுக்கும் கோரிக்கையை சமர்ப்பிக்கவும்.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
விரைவில் உங்கள் எல்லா மாற்றங்களையும் இந்த திட்டத்தின் முதன்மை கிளையில் இணைக்கப்படும். மாற்றங்கள் ஒன்றிணைக்கப்பட்டவுடன் உங்களுக்கு அறிவிப்பு மின்னஞ்சல் கிடைக்கும்.
|
||||
|
||||
## இங்கிருந்து எங்கு செல்வது?
|
||||
|
||||
வாழ்த்துக்கள்! நீங்கள் ஒரு பங்களிப்பாளராக அடிக்கடி சந்திக்கும் _fork -> clone -> edit -> PR_ பணிப்பாய்வு முடித்துவிட்டீர்கள்.
|
||||
|
||||
|
||||
உங்கள் பங்களிப்பைக் கொண்டாடுங்கள் மற்றும் உங்கள் நண்பர்கள் மற்றும் பின்தொடர்பவர்களுடன் [web app](https://firstcontributions.github.io/#social-share) சென்று பகிர்ந்து கொள்ளுங்கள்.
|
||||
|
||||
உங்களுக்கு மேலும் பயிற்சி தேவைப்பட்டால், [code contributions](https://github.com/roshanjossey/code-contributions) என்னும் செயலை சரிபார்க்கலாம்.
|
||||
|
||||
இப்போது மற்ற திட்டங்களுக்கு பங்களிப்பதன் மூலம் தொடங்குவோம். நீங்கள் தொடங்கக்கூடிய எளிதான சிக்கல்களுடன் திட்டங்களின் பட்டியலை நாங்கள் தொகுத்துள்ளோம். பாருங்கள் [the list of projects in the web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [கூடுதல் வளங்கள்](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## பிற கருவிகளைப் பயன்படுத்தி பயிற்சிகள்
|
||||
|
||||
| <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) |
|
||||
@@ -1,127 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
# ఓపెన్సోర్స్కు మీ మొదటి సహకారం
|
||||
|
||||
ఇది కష్టం. మీరు ఏదైనా మొదటిసారి చేస్తున్నప్పుడు, ముఖ్యంగా ఇతరులతో కలిసి పని చేస్తున్నప్పుడు, తప్పులు చేయడం సౌకర్యంగా ఉండదు. కానీ ఓపెన్ సోర్స్ అంటే సహకారం మరియు కలిసి పనిచేయడం. మొదటిసారి ఓపెన్ సోర్స్ కంట్రిబ్యూటర్లు నేర్చుకోవాలని మరియు కంట్రిబ్యూట్ చేయాలని అనుకునే విధానాన్ని సరళం చేయాలని మేము అనుకుంటున్నాము.
|
||||
|
||||
వ్యాసాలు చదవడం మరియు ట్యుటోరియల్స్ చూడటం సహాయపడవచ్చు, కానీ వాస్తవంగా ఆచరణాత్మక వాతావరణంలో చేయడం కంటే మెరుగైనది ఏముంది? ఈ ప్రాజెక్ట్ యొక్క లక్ష్యం ప్రారంభకులకు మార్గదర్శకత్వం మరియు వారి మొదటి కంట్రిబ్యూషన్ చేసే విధానాన్ని సరళీకరించడం. మీరు మీ మొదటి కంట్రిబ్యూషన్ చేయాలని చూస్తున్నట్లయితే, దిగువ దశలను అనుసరించండి.
|
||||
|
||||
#### *మీకు కమాండ్ లైన్తో సౌకర్యంగా లేకపోతే, [ఇక్కడ GUI సాధనాలను ఉపయోగించి ట్యుటోరియల్స్ ఉన్నాయి.](#ఇతర-సాధనాలను-ఉపయోగించి-ట్యుటోరియల్స్)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### మీ కంప్యూటర్లో git లేకపోతే, [దాన్ని ఇన్స్టాల్ చేయండి](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## ఈ రిపోజిటరీని ఫోర్క్ చేయండి
|
||||
|
||||
ఈ రిపోజిటరీని ఫోర్క్ చేయండి ఈ పేజీ ఎగువ భాగంలో ఫోర్క్ బటన్పై క్లిక్ చేయడం ద్వారా.
|
||||
ఇది మీ ఖాతాలో ఈ రిపోజిటరీ కాపీని సృష్టిస్తుంది.
|
||||
|
||||
## రిపోజిటరీని క్లోన్ చేయండి
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
ఇప్పుడు మీ కంప్యూటరులో ఫోర్క్ రిపోను క్లోన్ చేయండి. మీ GitHub ఖాతాకు వెళ్లండి, ఫోర్క్డ్ రెపోని తెరిచి, క్లోన్ బటన్పై క్లిక్ చేసి, ఆపై * కాపీ * క్లిప్బోర్డ్కు క్లిక్ చేయండి.
|
||||
|
||||
టెర్మినల్ తెరిచి కింది git ఆదేశాన్ని అమలు చేయండి:
|
||||
```
|
||||
git clone "మీరు ఇప్పుడే కాపీ చేసిన url"
|
||||
```
|
||||
ఇక్కడ "మీరు ఇప్పుడే కాపీ చేసిన url" (కోట్ మార్కులు లేకుండా) ఈ రిపోజిటరీకి URL (ఈ ప్రాజెక్టు మీ ఫోర్క్). Url ను పొందడానికి మునుపటి దశలను చూడండి.
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
ఉదాహరణకి:
|
||||
```bash
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
ఇక్కడ 'this-is-you' మీ GitHub ప్రొఫైల్ నేమ్. ఇక్కడ మీరు `first-contribution` రిపోజిటరీ యొక్క కంటెంట్లను మీ GitHub అకౌంట్ లో మీ కంప్యూటర్కు కాపీ చేస్తున్నారు.
|
||||
|
||||
## నూతన బ్రాంచ్ ను సృష్టించండి
|
||||
|
||||
మీ కంప్యూటర్లోని రిపోజిటరీ డైరెక్టరీకి మార్చండి (మీరు ఇప్పటికే అక్కడ లేకపోతే):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
ఇప్పుడు 'git checkout' కమాండ్ ను ఉపయోగించి ఒక బ్రాంచ్ ను సృష్టించండి:
|
||||
|
||||
|
||||
ఉదాహరణకి:
|
||||
```bash
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
(బ్రాంచ్ యొక్క పేరు దానిలో పదం * add * ను కలిగి ఉండవలసిన అవసరం లేదు.
|
||||
|
||||
## అవసరమైన మార్పులు - చేర్పులు చేసి, ఆ మార్పులను నిరూపించండి.
|
||||
|
||||
టెక్స్ట్ ఎడిటర్లో ఇప్పుడు ఓపెన్ `Contributors.md` ఫైల్లో, **మీ పేరుని జోడించండి. ఫైల్ ప్రారంభంలో లేదా ముగింపులో జోడించవద్దు. మధ్యలో ఎక్కడైనా ఉంచండి. ఇప్పుడు, ఫైల్ను సేవ్ చేయండి.**
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
|
||||
మీరు ప్రాజెక్ట్ డైరెక్టరీకి వెళ్లి `git status` కమాండ్ ని ఆదేశిస్తే, **మార్పులు-చేర్పులు ఉన్నాయి** అని మీరు చూస్తారు.
|
||||
|
||||
`Git add ` కమాండ్ ను ఉపయోగించి మీరు సృష్టించిన బ్రాంచ్లో ఈ మార్పులను జోడించండి.
|
||||
|
||||
`Git add` కమాండ్ను ఉపయోగించి మీరు సృష్టించిన బ్రాంచ్లో ఈ మార్పులను జోడించండి:
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
ఇప్పుడు ఆ మార్పులను 'git commit' ఆదేశం ఉపయోగించి కట్టుకోండి:
|
||||
```bash
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
`<your-name>` ని తొలగించి మీ పేరును కలపండి.
|
||||
|
||||
## GitHubకి మార్పులను పుష్ చేయండి
|
||||
|
||||
కమాండ్ ఉపయోగించి మీ మార్పులను పంపండి `git push`:
|
||||
```bash
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
మీరు ముందుగా సృష్టించిన బ్రాంచీ పేరుతో `<add-your-branch-name>` ను జోడించుము.
|
||||
<details>
|
||||
<summary> <strong>GitHubలోకి నెట్టేటప్పుడు మీకు ఏవైనా లోపాలు వస్తే, ఇక్కడ క్లిక్ చేయండి:</strong> </summary>
|
||||
|
||||
- ### ప్రమాణీకరణ లోపం
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
మీ ఖాతాకు SSH కీని రూపొందించడం మరియు కాన్ఫిగర్ చేయడంపై [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) వెళ్లండి.
|
||||
|
||||
</details>
|
||||
|
||||
## సమీక్ష కోసం మీ మార్పులను సమర్పించండి
|
||||
|
||||
మీరు GitHub లో మీ రిపోజిటరీకి వెళ్లినట్లయితే, మీరు 'Compare & pull request' బటన్ను చూస్తారు. ఆ బటన్పై క్లిక్ చేయండి.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
ఇప్పుడు పుల్ అభ్యర్థనను సమర్పించండి.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
నేను మీ అన్ని మర్పులను ఈ ప్రాజెక్ట్ యొక్క ప్రధాన విభాగానికి విలీనం`merge to main branch` చేస్తాను.
|
||||
మార్పులు విలీనం`merge` అయిన తర్వాత మీరు ఒక నోటిఫికేషన్ ఈమెయిల్ పొందుతారు.
|
||||
|
||||
## ఇక్కడ నుండి ఎక్కడికి వెళ్లాలి?
|
||||
|
||||
అభినందనలు! మీరు స్టాండర్డ్ _fork -> clone -> edit -> PR_ వర్క్ ఫ్లో ను పూర్తి చేసారు.
|
||||
|
||||
[వెబ్ యాప్కి](https://firstcontributions.github.io/#social-share) వెళ్లడం ద్వారా మీ సహకారాన్ని జరుపుకోండి మరియు మీ స్నేహితులు మరియు అనుచరులతో భాగస్వామ్యం చేయండి.
|
||||
|
||||
మీకు ఏదైనా సహాయం అవసరమైతే లేదా ఏవైనా ప్రశ్నలు ఉంటే మీరు మా స్లాక్ టీమ్లో చేరవచ్చు.[స్లాక్ జట్టులో చేరండి](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
|
||||
ఇక, ఇప్పుడు మీరు ఇతర ప్రాజెక్టులకు తోడ్పడటం ప్రారంభించండి. మీరు ప్రారంభించగల సులభమైన సమస్యలతో ప్రాజెక్టుల జాబితాను మేము రెడీ చేసాము. [వెబ్ ప్రాజెక్టుల జాబితాలు](https://firstcontributions.github.io/#project-list) ను చూడండి.
|
||||
|
||||
### [అదనపు విషయం](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## ఇతర సాధనాలను ఉపయోగించి ట్యుటోరియల్స్
|
||||
|
||||
| <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) |
|
||||
@@ -1,120 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# อยากเริ่ม Contribute โปรเจคใน GitHub ของผู้อื่นเป็นครั้งแรกใช่ไหม?
|
||||
|
||||
แน่นอนว่ามันอาจฟังดูเป็นเรื่องยาก, เพราะครั้งแรกของทุกอย่างมันมักจะยากเสมอแหละ โดยเฉพาะการทำงานร่วมกับผู้อื่น เพราะเมื่อเราทำอะไรผิดพลาดเรามักจะรู้สึกไม่สบายใจ
|
||||
แต่สำหรับโลกของโอเพนซอร์ส(open source) มันคือโลกของการทำงานร่วมกัน! ดังนั้นไม่ต้องกลัว เราจะสอนให้คุณรู้วิธีในการ contribute ผลงานร่วมกับผู้อื่นใน GitHub แบบง่ายๆ เลยล่ะ
|
||||
|
||||
การอ่านบทความและการทำตามตัวอย่างต่างๆ ก็อาจจะช่วยได้ แต่จะมีอะไรดีไปกว่าการที่เราได้ลงมือทำสิ่งนั้นๆ ด้วยตัวเองล่ะ! สำหรับโปรเจ็คนี้จะช่วยสอนให้มือใหม่ส่ง contribute กับโปรเจคต่างๆได้อย่างง่ายๆเลย เพียงทำตามขั้นตอนต่อไปนี้
|
||||
|
||||
โปรดทำใจให้สบาย ยิ่งคุณผ่อนคลายมากเท่าไหร่ คุณก็ยิ่งเรียนรู้ได้ดีมากขึ้นเท่านั้น!
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
ถ้าหากคุณยังไม่ได้ติดตั้ง git ลงบนเครื่องของคุณ คุณสามารถ[ติดตั้งได้ที่นี่]( https://help.github.com/articles/set-up-git/)
|
||||
|
||||
ก่อนอื่นเลย หาโปรเจคที่คุณอยากจะร่วม contribute ก่อนเลย เมื่อคุณเจอโปรเจคที่สนใจแล้วมาเริ่มทำตามขั้นตอนต่อไปนี้กัน
|
||||
(ต่อไปนี้เราจะขอเรียกโปรเจคต้นทางว่า "โปรเจ็คต้นน้ำ" (Source-project\Upstream-project))
|
||||
|
||||
## การ "Fork" โปรเจ็ค
|
||||
เพื่อให้คุณสามารถคัดลอกเพื่อแยกโปรเจ็คต้นน้ำออกไปทำที่แอคเคาน์ส่วนตัวของคุณได้ โดยการกดปุ่ม "Fork" ที่ด้านบนของหน้านี้
|
||||
|
||||
แล้วโปรเจ็คต้นน้ำจะถูกคัดลอกนำไปใส่ไว้ในแอคเคาน์ของคุณ
|
||||
|
||||
## การ "Clone" โปรเจ็ค
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
การ clone โปรเจคนั้น เป็นการ download sourcecode จาก GtiHub repository นั้นๆ มาลงคอมพิวเตอร์ของคุณ
|
||||
โดยการคลิ๊กที่ปุ่ม "Clone" แล้วเลือก *Copy to clipboard* (คำสั่งคัดลอก)
|
||||
|
||||
เปิดโปรแกรมเทอร์มินอลในเครื่อง (เช่น Terminal ใน MacOS หรือ cmd ใน Windows) แล้วรันคำสั่ง git ต่อไปนี้:
|
||||
|
||||
```bash
|
||||
git clone "url ที่คัดลอกไว้"
|
||||
```
|
||||
"url ที่คัดลอกไว้" (ไม่ต้องใส่ " ") คือ url ของโปรเจ็คของคุณ คุณสามารถเลื่อนกลับไปดูวิธีการคัดลอก url ได้จากหัวข้อก่อนหน้านี้
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
ตัวอย่าง:
|
||||
```bash
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
`this-is-you` คือชื่อ username ของคุณบน GitHub ถึงตรงนี้คุณได้ "Clone" โปรเจ็ค first-contributions ไปไว้ที่คอมพิวเตอร์ของคุณแล้ว
|
||||
|
||||
## การสร้าง branch
|
||||
|
||||
ในโปรแกรมเทอร์มินอล เปลี่ยน directory ไปยังที่ที่คุณได้ Clone โปรเจ็คไว้:
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
ตรงนี้ให้สร้าง branch (แตกกิ่งการทำงานใหม่) ด้วยคำสั่ง `git checkout`:
|
||||
```bash
|
||||
git checkout -b <ชื่อ branch>
|
||||
```
|
||||
|
||||
ตัวอย่าง:
|
||||
```bash
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
(ปกติชื่อของ branch ไม่จำเป็นต้องมีคำว่า *add* แต่ในโปรเจ็คนี้อยากให้ใช้ add-ชื่อ-ของ-คุณ เพราะชื่อของคุณจะไปแสดงอยู่ในรายชื่อ Contributors (ผู้เข้าร่วม) ของโปรเจ็คนี้
|
||||
|
||||
## เพิ่มหรือลดโค้ดลงไปเลย แล้วอย่าลืม "Commit" บอกว่าคุณได้เปลี่ยนอะไรไปบ้างล่ะ
|
||||
|
||||
ตอนนี้ให้เปิดไฟล์ `Contributors.md` ในโปรแกรม text editor เพิ่มชื่อของคุณลงไป จากนั้นเซฟไฟล์
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
ในโปรแกรมเทอร์มินอล ถ้าคุณอยู่ที่ directory ของโปรเจ็ค ให้ลองพิมพ์คำสั่ง `git status` จะเห็นว่าคุณได้ทำการเปลี่ยนอะไรไปบ้าง
|
||||
|
||||
เพิ่มการเปลี่ยนแปลงนั้น ๆ เข้าไปใน branch ที่เพิ่งสร้าง ด้วยคำสั่ง `git add`:
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
ตอนนี้ "Commit" การเปลี่ยนแปลงนั้น ๆ ด้วยคำสั่ง `git commit`:
|
||||
```bash
|
||||
git commit -m "Add <ชื่อของคุณ> to Contributors list"
|
||||
```
|
||||
แทนที่ `<ชื่อของคุณ>` ด้วยชื่อจริง ๆ ของคุณ.
|
||||
|
||||
## "Push" โค้ดที่เปลี่ยนไปขึ้นบน GitHub
|
||||
|
||||
"Push" ผลงานที่คุณทำเมื่อกี้นี้ขึ้น GitHub ด้วยคำสั่ง `git push`:
|
||||
```bash
|
||||
git push origin <ชื่อ branch ของคุณ>
|
||||
```
|
||||
แทนที่ `<ชื่อ branch ของคุณ>` ด้วยชื่อของ branch ของคุณที่เพิ่งสร้างไปเมื่อหัวข้อที่แล้ว ๆ (add-ชื่อ-ของ-คุณ)
|
||||
|
||||
## ส่งผลงานของคุณและรอรีวิวจากเจ้าของโปรเจ็ค
|
||||
|
||||
ไปที่ repository ของคุณบน GitHub คลิ๊กที่ `Compare & pull request`
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
ตอนนี้ก็ส่ง Pull Request ไปที่โปรเจ็คต้นน้ำได้เลย
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
แล้วเดี๋ยวเราจะ "Merge" หรือรวมผลงานที่คุณได้เปลี่ยนแปลงโค้ดมาที่ master branch ของโปรเจ็คนี้ คุณจะได้รับอีเมล เมื่อเราได้ทำการ Merge ผลงานของคุณเรียบร้อยแล้ว
|
||||
|
||||
## เสร็จแล้วทำยังไงต่อดี
|
||||
ยินดีด้วย คุณเพิ่งทำวัฏจักรพื้นฐานของการทำ contribute คือ fork -> clone -> edit -> pull request ซึ่งสิ่งเหล่านี้คุณจะพบเจอเป็นปกติเมื่อเป็น contributor
|
||||
ฉลองการมีส่วนร่วมของคุณ จากนั้นก็แบ่งปันให้เพื่อน ๆ ได้ทราบ โดยการไปที่ [หน้าเว็บนี้](https://firstcontributions.github.io/#social-share)
|
||||
|
||||
หรือจะมาร่วมสนทนากับเราผ่าน Slack ในกรณีที่คุณต้องการความช่วยเหลือ หรือมีข้อสงสัยใด ๆ [เข้าร่วม slack กับเรา](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
|
||||
จากนี้คุณสามารถคอนทริบิ้วต์ให้กับโครงการอื่น ๆ ได้ โดยเราได้สร้างรายการบางส่วน เพื่อให้ง่ายต่อการเริ่มต้น [รายชื่อโครงการที่น่าสนใจ](https://firstcontributions.github.io/#project-list)
|
||||
|
||||
### [ข้อมูลอื่น ๆ เพิ่มเติม](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## ฝึกการคอนทริบิ้วต์โดยใช้เครื่องมืออื่น ๆ
|
||||
|
||||
| <a href="../gui-tool-tutorials/translations/github-desktop-tutorial.th.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/translations/github-desktop-tutorial.th.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) |
|
||||
@@ -1,127 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Mga unang kontribusyon
|
||||
|
||||
Mahirap. Palaging mahirap sa unang pagkakataon ng anumang gawain. Lalo na sa isang kolaborasyon, kung saan hindi komportableng paglaanan ng tuon ang mga pagkakamali. Gusto naming simplehan at linawin ang modernong pamamaraan kung papaanong matuto at tumulong ang mga bagong *open-source contributors*.
|
||||
|
||||
Maaaring makatulong ang pagbabasa ng mga artikulo at panonood ng mga *tutorials*, pero ano pa bang mas epektibong pamamaraan kaysa sa aktual na aplikasyon ng isang pagsasanay? Ang pangunahing pakay ng proyektong ito ay gabayan ang mga baguhan na gawin ang kanilang unang *contribution*. Kung ikaw ay isa sa mga taong iyon, sundin lang ang mga sumusunod na tagubilin.
|
||||
|
||||
Kung hindi comfortable sa paggamit ng *command line*, [may mga tutorials din gamit ang mga *GUI* tools.](#Mga-tutorials-gamit-ang-ibang-tools)*
|
||||
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Kung wala pang *git* sa iyong computer, [i-install ito](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
|
||||
## I-fork ang repository
|
||||
|
||||
I-fork ang *repository* sa pamamagitan ng pag-click sa *fork* *button* na matatagpuan sa bandang itaas na kanan ng *webpage* na ito.
|
||||
Magkakaroon na ng kopya ng *repository* na ito sa iyong account.
|
||||
|
||||
## I-clone ang repository
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Ngayon, i-clone ang repository na iyong na-fork sa iyong computer.
|
||||
Pumunta lang sa iyong GitHub account, buksan ang nai-fork na repository, i-click ang clone button pagkatapos i-click ang *copy to clipboard* icon.
|
||||
|
||||
Buksan ang terminal at i-enter ang sumusunod na git command:
|
||||
|
||||
```bash
|
||||
git clone "url na nakopya mo"
|
||||
```
|
||||
kung saan ang "url na nakopya mo" (wala ang mga panipi) ay ang URL ng repository (ang fork ng iyong proyekto). Pakitingnan nang mabuti ang mga nakaraang hakbang upang makuha ang url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Halimbawa:
|
||||
```bash
|
||||
git clone https://github.com/iyong-username/first-contributions.git
|
||||
```
|
||||
kung saan ang `iyong-username` ang iyong username sa GitHub. Mula sa command na ito, dito nagsisimula ng paggawa ng kopya ng nilalaman ng first-contributions repository mula sa GitHub papunta sa iyong kompyuter.
|
||||
|
||||
## Gumawa ng isang branch
|
||||
|
||||
Pumunta sa kompyuter directory ng iyong repository (kung hindi ka pa nakapunta):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
Ngayon, gumawa na ng isang branch gamit ang `git checkout` command:
|
||||
```bash
|
||||
git checkout -b <dagdag-branch-name>
|
||||
```
|
||||
|
||||
Halimbawa:
|
||||
```bash
|
||||
git checkout -b dagdag-juan-dela-cruz
|
||||
```
|
||||
(Hindi kailangan ng salitang *"dagdag"* sa pangalan ng i-dadagdag na branch pero makatwiran pa rin na gawin dahil layunin ng branch ang pagdagdag ng iyong pangalan sa isang listahan.)
|
||||
|
||||
## Gumawa ng kinakailangan na pagbabago at i-commit ang mga nagawang pagbabago
|
||||
|
||||
Ngayon, buksan ang `Contributors.md` file sa isang text editor, idagdag ang iyong pangalan. Huwag mong idagdag sa simula o sa hulian ng tinutukoy na file. Ilagay sa kalagitnaan ng file. At i-save and file.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
|
||||
Kapag pumunta ka sa directory ng iyong proyekto at i-enter ang command na `git status`, may makikita kang mga pagbabago.
|
||||
|
||||
|
||||
Idagdag ang mga pagbabagong naganap papunta sa iyong branch gamit ang `git add` command:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Ngayon, i-commit ang mga nabagong files gamit ang `git commit` command:
|
||||
```bash
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
kung saan ang `<your-name>` ay ang iyong pangalan.
|
||||
|
||||
## I-push ang mga changes sa GitHub
|
||||
|
||||
I-push ang mga nabago mong files gamit ang command na `git push`:
|
||||
```bash
|
||||
git push origin <dagdag-branch-name>
|
||||
```
|
||||
kung saan ang `<dagdag-branch-name>` ay ang pangalan ng branch na naidagdag mo kani-kanila lang.
|
||||
|
||||
## I-submit ang changes para sa review
|
||||
|
||||
Pumunta sa iyong repository sa GitHub at may makikita kang `Compare & pull request` button, i-click mo ang tumutukoy na button.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
I-submit ang pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Pagkalipas ng ilang oras ay isasama ko ang mga pagbabago na nagawa mo papunta sa master branch ng proyekto na ito. May makukuha kang notification email kapag ang mga pagbabago ay na-isama sa proyekto.
|
||||
|
||||
## Ano ang susunod na hakbang?
|
||||
|
||||
|
||||
Congrats! Nakumpleto mo ang standard _fork -> clone -> edit -> PR_ na workflow na lagi mong magagamit bilang isang kontribyutor!
|
||||
|
||||
I-celebrate ang iyong kontribusyon at i-share mo sa mga kaibigan at followers mo sa pagpunta sa [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Puwede ka rin sumama sa aming Slack team kung kailangan mo ng karagdagan tulong o gustong magtanong. [Sumama sa aming Slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Ngayon, magsimula ka na mag-contribute sa ibang proyekto. Nagtipon kami ng listahan ng mga proyekto na may madaling issues na puwedeng-puwede kang makisabay. Paki-visit lang [ang listahan mula sa web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Mga karagdagan na materyal](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Mga tutorials gamit ang ibang tools
|
||||
|
||||
| <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) |
|
||||
File diff suppressed because one or more lines are too long
@@ -1,133 +0,0 @@
|
||||
[](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)
|
||||
|
||||
# İlk katkı
|
||||
|
||||
Zor gelir... Herhangi bir işi ilk kez yapmak daima zor gelir. Özellikle başkalarıyla ortak çalışıyorsanız, hata yapmak içinize sinmez. Ancak "Açık Kaynakın" temelinde işbirliği ve birlikte çalışma yatmakta. Biz, açık kaynak projelere ilk kez katkıda bulunacak kişilerin bu süreci öğrenmesini ve ilk katkılarını sunmalarını kolaylaştırmayı istiyoruz.
|
||||
|
||||
Makale okumak ve eğitim videoları izlemek yardımcı olabilir, fakat bir işi gerçekten yapmanın yerini ne tutabilir ki? Bu proje yeni başlayanların veya ilk defa katkıda bulunacakların işini kolaylaştırmak ve onlara rehberlik etmek amacındadır. Unutmayın ki ne kadar rahat olursanız o kadar rahat öğrenirsiniz. Eğer bir GitHub projesine ilk defa katkıda bulunacaksanız, aşağıda gösterilen basit adımları takip etmeniz yeterli olacaktır. Söz veriyoruz, eğlenceli olacak.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Eğer bilgisayarınızda git kurulu değil ise, [ yükleyin ]( https://help.github.com/articles/set-up-git/ ).
|
||||
|
||||
## Projeyi "forklama"
|
||||
|
||||
Sayfanın sağ üst köşesinde bulunan "Fork" butonuna basıp bu projeyi çatallayın.
|
||||
Bu işlem sizin hesabınız altında projenin bir kopyasını oluşturacaktır.
|
||||
|
||||
## Depoyu (Repository) klonlama
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Şimdi bu depoyu bilgisayarınıza klonlayın. GitHub hesabınıza gidin, çatalladığınız depoyu açın, 'clone' butonuna basıp ardından *copy to clipboard* simgesine basın.
|
||||
|
||||
Daha sonra komut istemini açıp aşağıdaki git komutunu çalıştırın:
|
||||
|
||||
```bash
|
||||
git clone "kopyaladığınız-url"
|
||||
```
|
||||
"kopyaladığınız-url" (tırnak işaretleri olmadan) yerine bu deponun GitHub sayfasından aldığınız linki kopyalayın.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Örneğin:
|
||||
```bash
|
||||
git clone https://github.com/kullanıcı-adi/first-contributions.git
|
||||
```
|
||||
`kullanıcı-adi` sizin GitHub kullanıcı adınız. Burada GitHub üzerinde bulunan first-contributions reposunun içeriğini bilgisayarınıza kopyalıyorsunuz.
|
||||
|
||||
## Dal (Branch) oluşturma
|
||||
|
||||
Eğer henüz klasör içerisinde değilseniz komut isteminde ana klasörünün konumuna gidin:
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
`git checkout` komutunu kullanarak yeni bir dal(branch) oluşturun:
|
||||
```bash
|
||||
git checkout -b <sizin-yeni-dal-isminiz>
|
||||
```
|
||||
|
||||
Örneğin:
|
||||
```bash
|
||||
git checkout -b ekle-aydin-cagri-dumlu
|
||||
```
|
||||
(Dal ismi içinde *ekle* kelimesinin geçme zorunluluğu yok, fakat bu dal isminizi katkı sunanlar listesine ekleme amacıyla oluşturulduğundan, ekle yazmak mantıklı olacaktır.)
|
||||
|
||||
## Gerekli değişiklikleri yapma ve değişiklikleri onaylama
|
||||
|
||||
Şimdi, bir metin editöründe `Contributors.md` dosyasını açın. Basit bir işaretleme dili olan Markdown'a alışkın olmanız gerekmektedir. Nasıl kullanacağınızı öğrenmek için bu [kopya kağıdına](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) göz atabilirsiniz.
|
||||
|
||||
`Contributors.md` dosyasının sonuna bu satırı ekleyin:
|
||||
|
||||
```markdown
|
||||
- [İsminiz](https://github.com/kullanici-adiniz)
|
||||
```
|
||||
|
||||
Örneğin:
|
||||
|
||||
```markdown
|
||||
- [Ahmet Yılmaz](https://github.com/ahmet-yilmaz)
|
||||
```
|
||||
|
||||
`](` arasında boşluk olmadığından emin olun. Dosyayı kaydedin ve kapatın.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Komut istemi üzerinde proje klasörüne gidip `git status` komutunu yazdığınızda yaptığınız değişiklikleri göreceksiniz.
|
||||
|
||||
`git add` komutu ile bu değişiklikleri oluşturduğunuz dal içerisine ekleyin.
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Şimdi `git commit` komutunu kullanarak değişikliklerinizi onaylayın (commit):
|
||||
```bash
|
||||
git commit -m "<isminiz> katkıda bulunanlar listesine eklendi"
|
||||
```
|
||||
`<isminiz>` yerine kendi isminizi yazın.
|
||||
|
||||
(Ç.N: Açık kaynak dünyasında dünyanın farklı yerlerinden insanlarla birlikte çalışacağınız için onay mesajını İngilizce yazabilirsiniz.)
|
||||
|
||||
## Değişiklikleri GitHub üzerine "itme" (Push)
|
||||
|
||||
`git push` komutu ile değişikliklerinizi ittirin:
|
||||
```bash
|
||||
git push origin <ekle-sizin-dal-isminiz>
|
||||
```
|
||||
`<ekle-sizin-dal-isminiz>` yerine daha önce oluşturduğunuz dalın ismini girin.
|
||||
|
||||
## Değişikliklerinizi inceleme için gönderin
|
||||
|
||||
Oluşturduğunuz deponun Github sayfasında `Compare & pull request` butonunu göreceksiniz. Bu butona basın.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Şimdi çekme isteğini (pull request) gönderin.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Yaptığınız değişiklikleri en kısa zamanda projenin "master" dalı ile birleştireceğiz. Bu işlem tamamlandığı zaman bir bilgilendirme e-postası alacaksınız.
|
||||
|
||||
## Bundan sonra ne yapabilirim?
|
||||
|
||||
Tebrikler! Katkıda bulunan kişi olarak sıklıkla karşılaşacağınız standart _çatal -> klon -> düzenle -> çekme isteği_ iş akışını tamamladınız!
|
||||
|
||||
Sunduğunuz katkının coşkusunu yaşamak ve bunu arkadaşlarınız ve takipçilerinizle paylaşmak için [bu bağlantıdaki](https://firstcontributions.github.io/#social-share) uygulamamızı kullanabilirsiniz.
|
||||
|
||||
Bir sorunuz veya yardıma ihtiyacınız olursa Slack takımımıza katılabilirsiniz. [Slack takımına katıl](https://firstcontributions.herokuapp.com)
|
||||
|
||||
Artık diğer projelere katkı sunmaya hazırsınız. Çözmeye başlayabileceğiniz giriş seviyesindeki konulara (issue) sahip projeleri [sizin için derledik](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Ek bilgi](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Diğer araçlarla ilgili eğitimler
|
||||
|
||||
|
||||
| <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) |
|
||||
@@ -1,135 +0,0 @@
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Перший внесок
|
||||
|
||||
Цей проект спрямований на те, щоб спростити та спрямувати шлях новачків, які роблять свій перший внесок. Якщо ви хочете зробити свій перший внесок, виконайте наведені нижче дії.
|
||||
|
||||
_Якщо ви не вмієте працювати з командним рядком, [ось навчальні посібники з використанням інструментів GUI.](#tutorials-using-other-tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Якщо ви ще не встановили git, тоді [зробіть це](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Форкніть репозиторій
|
||||
|
||||
Форкніть свою власну копію цього репозиторію, натиснувши кнопку `fork` вгорі цієї сторінки.
|
||||
Таким чином, ви створите копію цього репозиторію у вашому акаунті.
|
||||
|
||||
## Клонуйте репозиторій
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Тепер клонуйте цей репозиторій на ваш комп’ютер. Натисніть на кнопку `clone`, а потім - на іконку `copy to clipboard`.
|
||||
|
||||
Відкрийте термінал і виконайте наступні команди:
|
||||
|
||||
```bash
|
||||
git clone "посилання, яке ви щойно скопіювали"
|
||||
```
|
||||
|
||||
де `посилання, яке ви щойно скопіювали` (без лапок) - адреса цього репозиторію. Дивіться попередній крок для того, щоб отримати цю адресу.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Наприклад:
|
||||
```bash
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
де `this-is-you` - ваш нікнейм з GitHub. Таким чином, ви копіюєте вміст репозиторію з GitHub, в який збираєтесь зробити внесок, на ваш комп’ютер.
|
||||
|
||||
## Створюємо гілку
|
||||
|
||||
Перейдіть в директорію з репозиторієм на вашому комп’ютері (якщо ви ще цього не зробили):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Тепер створюємо гілку за допомогою команди `git checkout`:
|
||||
|
||||
```bash
|
||||
git checkout -b <add-your-name>
|
||||
```
|
||||
|
||||
Наприклад:
|
||||
|
||||
```bash
|
||||
git checkout -b add-petro-church
|
||||
```
|
||||
|
||||
(Назва гілки не повинна обов’язково містити слово *add*, але це має сенс, якщо майбутні зміни передбачають додавання чогось, наприклад, вашого імені у список контрибуторів.)
|
||||
|
||||
## Робимо необхідні зміни та записуємо їх в репозиторій
|
||||
|
||||
Тепер відкриваємо файл `Contributors.md` в текстовому редакторі та додаємо ваше ім’я, а потім зберігаємо файл. Якщо ви перейдете в директорію проєкту і виконаєте команду `git status`, ви побачите зміни. Додайте ці зміни до гілки, яку ви тільки що створили, за допомогою команди `git add`:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Тепер запишіть ці зміни за допомогою команди `git commit`:
|
||||
|
||||
```bash
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
замініть `<your-name>` своїм іменем.
|
||||
|
||||
## Відправляємо зміни в GitHub
|
||||
|
||||
Відправте зміни на віддалений репозиторій в GitHub за допомогою команди `git push`:
|
||||
|
||||
```bash
|
||||
git push -г origin <your-branch-name>
|
||||
```
|
||||
|
||||
Замініть `<your-branch-name>` назвою гілки, яку ви створили раніше.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Якщо під час натискання виникають помилки, натисніть тут:</strong> </summary>
|
||||
|
||||
- ### Authentication Error
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Перейдіть до [туторіалу GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) щодо створення та налаштування ключа SSH для вашого облікового запису.
|
||||
|
||||
</details>
|
||||
|
||||
## Відправляємо зміни на перевірку
|
||||
|
||||
Коли ви перейдете до свого репозиторію в GitHub, ви побачите кнопку `Compare & pull request`. Сміливо натисніть на неї.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Тепер зміни відправлені на перевірку і затвердження.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Згодом я об’єднаю ваші запропоновані зміни з основною гілкою цього репозиторію. Ви отримаєте повідомлення, коли це буде зроблено.
|
||||
|
||||
## Що далі?
|
||||
|
||||
Вітаю! Ви щойно виконали стандартний робочий процес _fork -> clone -> edit -> pull request_, з яким ви часто стикаєтеся як контрибутор!
|
||||
|
||||
Відзначте свій внесок і поділіться ним із друзями та читачами, перейшовши до [веб-програми](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Тепер давайте почнемо робити внески в інші проекти. Ми склали список проектів із простими проблемами, з яких ви можете почати. Перегляньте [список проектів у веб-додатку](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Додаткові матеріали](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Інструкції для інших інструментів
|
||||
|
||||
| <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) |
|
||||
|
||||
<p>Цей проект підтримується:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,129 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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)
|
||||
|
||||
|
||||
# ⎎⟟⍀⌇⏁ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏⌇
|
||||
|
||||
⏁⊑⟟⌇ ⌿⍀⍜⟊⟒☊⏁ ⏃⟟⋔⌇ ⏁⍜ ⌇⟟⋔⌿⌰⟟⎎⊬ ⏃⋏⎅ ☌⎍⟟⎅⟒ ⏁⊑⟒ ⍙⏃⊬ ⏚⟒☌⟟⋏⋏⟒⍀⌇ ⋔⏃☍⟒ ⏁⊑⟒⟟⍀ ⎎⟟⍀⌇⏁ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏. ⟟⎎ ⊬⍜⎍ ⏃⍀⟒ ⌰⍜⍜☍⟟⋏☌ ⏁⍜ ⋔⏃☍⟒ ⊬⍜⎍⍀ ⎎⟟⍀⌇⏁ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏, ⎎⍜⌰⌰⍜⍙ ⏁⊑⟒ ⌇⏁⟒⌿⌇ ⏚⟒⌰⍜⍙.
|
||||
|
||||
_⟟⎎ ⊬⍜⎍'⍀⟒ ⋏⍜⏁ ☊⍜⋔⎎⍜⍀⏁⏃⏚⌰⟒ ⍙⟟⏁⊑ ☊⍜⋔⋔⏃⋏⎅ ⌰⟟⋏⟒, [⊑⟒⍀⟒ ⏃⍀⟒ ⏁⎍⏁⍜⍀⟟⏃⌰⌇ ⎍⌇⟟⋏☌ ☌⎍⟟ ⏁⍜⍜⌰⌇.](#tutorials-using-other-tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### ⟟⎎ ⊬⍜⎍ ⎅⍜⋏'⏁ ⊑⏃⎐⟒ ☌⟟⏁ ⍜⋏ ⊬⍜⎍⍀ ⋔⏃☊⊑⟟⋏⟒, [⟟⋏⌇⏁⏃⌰⌰ ⟟⏁](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## ⎎⍜⍀☍ ⏁⊑⟟⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬
|
||||
|
||||
⎎⍜⍀☍ ⏁⊑⟟⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⏚⊬ ☊⌰⟟☊☍⟟⋏☌ ⍜⋏ ⏁⊑⟒ `fork` ⏚⎍⏁⏁⍜⋏ ⍜⋏ ⏁⊑⟒ ⏁⍜⌿ ⍜⎎ ⏁⊑⟟⌇ ⌿⏃☌⟒.
|
||||
⏁⊑⟟⌇ ⍙⟟⌰⌰ ☊⍀⟒⏃⏁⟒ ⏃ ☊⍜⌿⊬ ⍜⎎ ⏁⊑⟟⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⟟⋏ ⊬⍜⎍⍀ ⏃☊☊⍜⎍⋏⏁.
|
||||
|
||||
## ☊⌰⍜⋏⟒ ⏁⊑⟒ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
⋏⍜⍙ ☊⌰⍜⋏⟒ ⏁⊑⟒ ⎎⍜⍀☍⟒⎅ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⏁⍜ ⊬⍜⎍⍀ ⋔⏃☊⊑⟟⋏⟒. ☌⍜ ⏁⍜ ⊬⍜⎍⍀ ☌⟟⏁⊑⎍⏚ ⏃☊☊⍜⎍⋏⏁, ⍜⌿⟒⋏ ⏁⊑⟒ ⎎⍜⍀☍⟒⎅ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬, ☊⌰⟟☊☍ ⍜⋏ ⏁⊑⟒ ☊⍜⎅⟒ ⏚⎍⏁⏁⍜⋏ ⏃⋏⎅ ⏁⊑⟒⋏ ☊⌰⟟☊☍ ⏁⊑⟒ _copy to clipboard_ ⟟☊⍜⋏.
|
||||
|
||||
⍜⌿⟒⋏ ⏃ ⏁⟒⍀⋔⟟⋏⏃⌰ ⏃⋏⎅ ⍀⎍⋏ ⏁⊑⟒ ⎎⍜⌰⌰⍜⍙⟟⋏☌ `git` ☊⍜⋔⋔⏃⋏⎅:
|
||||
|
||||
```bash
|
||||
git clone "url you just copied"
|
||||
```
|
||||
|
||||
⍙⊑⟒⍀⟒ "url you just copied" (⍙⟟⏁⊑⍜⎍⏁ ⏁⊑⟒ ⍾⎍⍜⏁⏃⏁⟟⍜⋏ ⋔⏃⍀☍⌇) ⟟⌇ ⏁⊑⟒ ⎍⍀⌰ ⏁⍜ ⏁⊑⟟⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ (⊬⍜⎍⍀ ⎎⍜⍀☍ ⍜⎎ ⏁⊑⟟⌇ ⌿⍀⍜⟊⟒☊⏁). ⌇⟒⟒ ⏁⊑⟒ ⌿⍀⟒⎐⟟⍜⎍⌇ ⌇⏁⟒⌿⌇ ⏁⍜ ⍜⏚⏁⏃⟟⋏ ⏁⊑⟒ ⎍⍀⌰.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
⎎⍜⍀ ⟒⌖⏃⋔⌿⌰⟒:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
⍙⊑⟒⍀⟒ `this-is-you` ⟟⌇ ⊬⍜⎍⍀ GitHub ⎍⌇⟒⍀⋏⏃⋔⟒. ⊑⟒⍀⟒ ⊬⍜⎍'⍀⟒ ☊⍜⌿⊬⟟⋏☌ ⏁⊑⟒ ☊⍜⋏⏁⟒⋏⏁⌇ ⍜⎎ ⏁⊑⟒ ⎎⟟⍀⌇⏁-☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⍜⋏ GitHub ⏁⍜ ⊬⍜⎍⍀ ☊⍜⋔⌿⎍⏁⟒⍀.
|
||||
|
||||
## ☊⍀⟒⏃⏁⟒ ⏃ ⏚⍀⏃⋏☊⊑
|
||||
|
||||
☊⊑⏃⋏☌⟒ ⏁⍜ ⏁⊑⟒ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⎅⟟⍀⟒☊⏁⍜⍀⊬ ⍜⋏ ⊬⍜⎍⍀ ☊⍜⋔⌿⎍⏁⟒⍀ (⟟⎎ ⊬⍜⎍ ⏃⍀⟒ ⋏⍜⏁ ⏃⌰⍀⟒⏃⎅⊬ ⏁⊑⟒⍀⟒):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
⋏⍜⍙ ☊⍀⟒⏃⏁⟒ ⏃ ⏚⍀⏃⋏☊⊑ ⎍⌇⟟⋏☌ ⏁⊑⟒ `git checkout` ☊⍜⋔⋔⏃⋏⎅:
|
||||
|
||||
```bash
|
||||
git checkout -b your-new-branch-name
|
||||
```
|
||||
|
||||
⎎⍜⍀ ⟒⌖⏃⋔⌿⌰⟒:
|
||||
|
||||
```bash
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
## ⋔⏃☍⟒ ⋏⟒☊⟒⌇⌇⏃⍀⊬ ☊⊑⏃⋏☌⟒⌇ ⏃⋏⎅ ☊⍜⋔⋔⟟⏁ ⏁⊑⍜⌇⟒ ☊⊑⏃⋏☌⟒⌇
|
||||
|
||||
⋏⍜⍙ ⍜⌿⟒⋏ `Contributors.md` ⎎⟟⌰⟒ ⟟⋏ ⏃ ⏁⟒⌖⏁ ⟒⎅⟟⏁⍜⍀, ⏃⎅⎅ ⊬⍜⎍⍀ ⋏⏃⋔⟒ ⏁⍜ ⟟⏁. ⎅⍜⋏'⏁ ⏃⎅⎅ ⟟⏁ ⏃⏁ ⏁⊑⟒ ⏚⟒☌⟟⋏⋏⟟⋏☌ ⍜⍀ ⟒⋏⎅ ⍜⎎ ⏁⊑⟒ ⎎⟟⌰⟒. ⌿⎍⏁ ⟟⏁ ⏃⋏⊬⍙⊑⟒⍀⟒ ⟟⋏ ⏚⟒⏁⍙⟒⟒⋏. ⋏⍜⍙, ⌇⏃⎐⟒ ⏁⊑⟒ ⎎⟟⌰⟒.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
⟟⎎ ⊬⍜⎍ ☌⍜ ⏁⍜ ⏁⊑⟒ ⌿⍀⍜⟊⟒☊⏁ ⎅⟟⍀⟒☊⏁⍜⍀⊬ ⏃⋏⎅ ⟒⌖⟒☊⎍⏁⟒ ⏁⊑⟒ ☊⍜⋔⋔⏃⋏⎅ `git status`, ⊬⍜⎍'⌰⌰ ⌇⟒⟒ ⏁⊑⟒⍀⟒ ⏃⍀⟒ ☊⊑⏃⋏☌⟒⌇.
|
||||
|
||||
⏃⎅⎅ ⏁⊑⍜⌇⟒ ☊⊑⏃⋏☌⟒⌇ ⏁⍜ ⏁⊑⟒ ⏚⍀⏃⋏☊⊑ ⊬⍜⎍ ⟊⎍⌇⏁ ☊⍀⟒⏃⏁⟒⎅ ⎍⌇⟟⋏☌ ⏁⊑⟒ `git add` ☊⍜⋔⋔⏃⋏⎅:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
⋏⍜⍙ ☊⍜⋔⋔⟟⏁ ⏁⊑⍜⌇⟒ ☊⊑⏃⋏☌⟒⌇ ⎍⌇⟟⋏☌ ⏁⊑⟒ `git commit` ☊⍜⋔⋔⏃⋏⎅:
|
||||
|
||||
```bash
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
⍀⟒⌿⌰⏃☊⟟⋏☌ `<your-name>` ⍙⟟⏁⊑ ⊬⍜⎍⍀ ⋏⏃⋔⟒.
|
||||
|
||||
## ⌿⎍⌇⊑ ☊⊑⏃⋏☌⟒⌇ ⏁⍜ GitHub
|
||||
|
||||
⌿⎍⌇⊑ ⊬⍜⎍⍀ ☊⊑⏃⋏☌⟒⌇ ⎍⌇⟟⋏☌ ⏁⊑⟒ ☊⍜⋔⋔⏃⋏⎅ `git push`:
|
||||
|
||||
```bash
|
||||
git push origin -u <add-your-branch-name>
|
||||
```
|
||||
|
||||
⍀⟒⌿⌰⏃☊⟟⋏☌ `<add-your-branch-name>` ⍙⟟⏁⊑ ⏁⊑⟒ ⋏⏃⋔⟒ ⍜⎎ ⏁⊑⟒ ⏚⍀⏃⋏☊⊑ ⊬⍜⎍ ☊⍀⟒⏃⏁⟒⎅ ⟒⏃⍀⌰⟟⟒⍀.
|
||||
|
||||
<details>
|
||||
<summary> <strong>⟟⎎ ⊬⍜⎍ ☌⟒⏁ ⏃⋏⊬ ⟒⍀⍀⍜⍀⌇ ⍙⊑⟟⌰⟒ ⌿⎍⌇⊑⟟⋏☌, ☊⌰⟟☊☍ ⊑⟒⍀⟒:</strong> </summary>
|
||||
|
||||
- ### ⏃⎍⏁⊑⟒⋏⏁⟟☊⏃⏁⟟⍜⋏ ⟒⍀⍀⍜⍀
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
☌⍜ ⏁⍜ [GitHub's ⏁⎍⏁⍜⍀⟟⏃⌰](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ⍜⋏ ☌⟒⋏⟒⍀⏃⏁⟟⋏☌ ⏃⋏⎅ ☊⍜⋏⎎⟟☌⎍⍀⟟⋏☌ ⏃⋏ ⌇⌇⊑ ☍⟒⊬ ⏁⍜ ⊬⍜⎍⍀ ⏃☊☊⍜⎍⋏⏁.
|
||||
|
||||
</details>
|
||||
|
||||
## ⌇⎍⏚⋔⟟⏁ ⊬⍜⎍⍀ ☊⊑⏃⋏☌⟒⌇ ⎎⍜⍀ ⍀⟒⎐⟟⟒⍙
|
||||
|
||||
⟟⎎ ⊬⍜⎍ ☌⍜ ⏁⍜ ⊬⍜⎍⍀ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⍜⋏ ☌⟟⏁⊑⎍⏚, ⊬⍜⎍'⌰⌰ ⌇⟒⟒ ⏃ `Compare & pull request` ⏚⎍⏁⏁⍜⋏. ☊⌰⟟☊☍ ⍜⋏ ⏁⊑⏃⏁ ⏚⎍⏁⏁⍜⋏.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
⋏⍜⍙ ⌇⎍⏚⋔⟟⏁ ⏁⊑⟒ `pull request`.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
⌇⍜⍜⋏ ⟟'⌰⌰ ⏚⟒ ⋔⟒⍀☌⟟⋏☌ ⏃⌰⌰ ⊬⍜⎍⍀ ☊⊑⏃⋏☌⟒⌇ ⟟⋏⏁⍜ ⏁⊑⟒ ⋔⏃⌇⏁⟒⍀ ⏚⍀⏃⋏☊⊑ ⍜⎎ ⏁⊑⟟⌇ ⌿⍀⍜⟊⟒☊⏁. ⊬⍜⎍ ⍙⟟⌰⌰ ☌⟒⏁ ⏃ ⋏⍜⏁⟟⎎⟟☊⏃⏁⟟⍜⋏ ⟒⋔⏃⟟⌰ ⍜⋏☊⟒ ⏁⊑⟒ ☊⊑⏃⋏☌⟒⌇ ⊑⏃⎐⟒ ⏚⟒⟒⋏ ⋔⟒⍀☌⟒⎅.
|
||||
|
||||
## ⍙⊑⟒⍀⟒ ⏁⍜ ☌⍜ ⎎⍀⍜⋔ ⊑⟒⍀⟒?
|
||||
|
||||
☊⍜⋏☌⍀⏃⏁⌇! ⊬⍜⎍ ⟊⎍⌇⏁ ☊⍜⋔⌿⌰⟒⏁⟒⎅ ⏁⊑⟒ ⌇⏁⏃⋏⎅⏃⍀⎅ _fork -> clone -> edit -> pull request_ ⍙⍜⍀☍⎎⌰⍜⍙ ⏁⊑⏃⏁ ⊬⍜⎍'⌰⌰ ⟒⋏☊⍜⎍⋏⏁⟒⍀ ⍜⎎⏁⟒⋏ ⏃⌇ ⏃ ☊⍜⋏⏁⍀⟟⏚⎍⏁⍜⍀!
|
||||
|
||||
☊⟒⌰⟒⏚⍀⏃⏁⟒ ⊬⍜⎍⍀ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏ ⏃⋏⎅ ⌇⊑⏃⍀⟒ ⟟⏁ ⍙⟟⏁⊑ ⊬⍜⎍⍀ ⎎⍀⟟⟒⋏⎅⌇ ⏃⋏⎅ ⎎⍜⌰⌰⍜⍙⟒⍀⌇ ⏚⊬ ☌⍜⟟⋏☌ ⏁⍜ [⍙⟒⏚ ⏃⌿⌿](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
⊬⍜⎍ ☊⍜⎍⌰⎅ ⟊⍜⟟⋏ ⍜⎍⍀ slack ⏁⟒⏃⋔ ⟟⋏ ☊⏃⌇⟒ ⊬⍜⎍ ⋏⟒⟒⎅ ⏃⋏⊬ ⊑⟒⌰⌿ ⍜⍀ ⊑⏃⎐⟒ ⏃⋏⊬ ⍾⎍⟒⌇⏁⟟⍜⋏⌇. [⟊⍜⟟⋏ slack ⏁⟒⏃⋔](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
⋏⍜⍙ ⌰⟒⏁'⌇ ☌⟒⏁ ⊬⍜⎍ ⌇⏁⏃⍀⏁⟒⎅ ⍙⟟⏁⊑ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⋏☌ ⏁⍜ ⍜⏁⊑⟒⍀ ⌿⍀⍜⟊⟒☊⏁⌇. ⍙⟒'⎐⟒ ☊⍜⋔⌿⟟⌰⟒⎅ ⏃ ⌰⟟⌇⏁ ⍜⎎ ⌿⍀⍜⟊⟒☊⏁⌇ ⍙⟟⏁⊑ ⟒⏃⌇⊬ ⟟⌇⌇⎍⟒⌇ ⊬⍜⎍ ☊⏃⋏ ☌⟒⏁ ⌇⏁⏃⍀⏁⟒⎅ ⍜⋏. ☊⊑⟒☊☍ ⍜⎍⏁ [⏁⊑⟒ ⌰⟟⌇⏁ ⍜⎎ ⌿⍀⍜⟊⟒☊⏁⌇ ⟟⋏ ⏁⊑⟒ ⍙⟒⏚ ⏃⌿⌿](https://firstcontributions.github.io/#project-list).
|
||||
@@ -1,168 +0,0 @@
|
||||
[](https://github.com/firstcontributions/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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# <div dir="rtl"> پہلی شراکت يا کانٹریبیوشن </div>
|
||||
|
||||
<div dir="rtl">
|
||||
اس پروجیکٹ کا مقصد ابتدائی افراد کے اپنا پہلى شركت يا کانٹریبیوشن کرنے کے طریقے کو آسان بنانا اور رہنمائی کرنا ہے۔ اگر آپ اپنا پہلا حصہ ڈالنا چاہتے ہیں تو نیچے دیے گئے مراحل پر عمل کریں۔
|
||||
</div>
|
||||
<br />
|
||||
<div dir="rtl">
|
||||
اگر آپ کمانڈ لائن سے واقف نہیں ہیں تو، یہاں
|
||||
<a href="#tutorials-using-other-tools">جى يو آئ ٹولز استعمال کرنے كا طریقہ</a>
|
||||
موجود ہے۔
|
||||
</div>
|
||||
<br />
|
||||
<div dir="rtl">
|
||||
اگر آپ کی مشین پر گٹ نہیں ہے تو،
|
||||
<a href="https://help.github.com/articles/set-up-git/">انسٹال کریں</a>
|
||||
</div>
|
||||
|
||||
## <div dir="rtl"> اس ریپوزٹری کو فورک کریں </div>
|
||||
<div dir="rtl">
|
||||
اس صفحے کے سب سے اوپر فورک بٹن دبا کر اس ریپوزٹری کا استعمال کریں.
|
||||
|
||||
<img style="float: left" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="اس ریپوزٹری کوفورک کریں" />
|
||||
<br />
|
||||
|
||||
یہ آپ کے اکاؤنٹ میں اس کی ایک نقل بنا كے ذخیرہ کرے گا۔.
|
||||
</div>
|
||||
<br />
|
||||
|
||||
## <div dir="rtl">ریپوزٹری کا کلون کیجیے</div>
|
||||
|
||||
<div dir="rtl">
|
||||
اب آپ اپنے کمپیوٹر مشین پر یہ ریپوزٹری کلون کریں.
|
||||
</div>
|
||||
|
||||
<img style="float: left;" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="ریپوزٹری کا کلون کیجیئے" />
|
||||
|
||||
<div dir="rtl">
|
||||
کلون بٹن کو دبائیں اور پھر "copy to clipboard" آئیکن کو دبائیں۔
|
||||
</div>
|
||||
|
||||
<img style="float: left;" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="یوآرایل کلپ بورڈ پر کاپی کریں" />
|
||||
|
||||
<div dir="rtl">
|
||||
ایک ٹرمینل کھولیں اور مندرجہ ذیل گٹ کمانڈ چلائیں:
|
||||
</div>
|
||||
|
||||
```bash
|
||||
git clone "یو آر ایل جو آپ نے ابھی کاپی کیا"
|
||||
```
|
||||
|
||||
<div dir="rtl">
|
||||
جہاں "یو آر ایل جو آپ نے ابھی کاپی کیا" (اقتباس کے نشانات " " کے بغیر) اس ریپوزٹری کو کلون کرنے کا یو آر ایل کا اندراج مراد ہے. یو آر ایل حاصل کرنے کیلئے پچھلے مرحلے کو دیکھیں.
|
||||
</div>
|
||||
|
||||
<div dir="rtl">مثال کے طور پر:</div>
|
||||
|
||||
```bash
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
<div dir="rtl">اس میں 'this-is-you' آپکا GitHub یوزرنیم ہے۔ یہاں آپ first-contributions GitHub ریپوزٹری کے مندرجات کمپیوٹر پر نقل کر رہے ہیں.</div>
|
||||
|
||||
## <div dir="rtl"> ایک شاخ (برانچ) بنائیں </div>
|
||||
|
||||
<div dir="rtl"> اپنے کمپیوٹر پر ریپوزٹری کی ڈائرکٹری تبدیل کریں (اگرآپ پہلے سے وہاں نہیں ہیں): </div>
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
<div dir="rtl"> اب <code>git checkout</code> کمانڈ استعمال کرتے ہوئے ایک شاخ/برانچ تشکیل دیں : </div>
|
||||
|
||||
```bash
|
||||
git checkout -b <add-your-name>
|
||||
```
|
||||
|
||||
<div dir="rtl">مثال کے طور پر:</div>
|
||||
|
||||
```bash
|
||||
git checkout -b add-alonzo-church
|
||||
```
|
||||
|
||||
<div dir="rtl"> شاخ (برانچ) کا نام میں ضروری نہیں <i>add</i> شامل کریں، لیکن یہ مناسب ہے کہ اس میں یہ شامل ہو، کیونکہ اس شاخ کا مقصد آپ کے نام کو فہرست میں شامل کرنا ہے. </div>
|
||||
|
||||
## <div dir="rtl"> ضروری تبدیلیاں کریں اور ان تبدیلیوں کو انجام دیں۔ </div>
|
||||
|
||||
<div dir="rtl">
|
||||
اب <code>Contributors.md</code> فائل کو ٹیکسٹ ایڈیٹر پر کھولیں، اپنا نام اس میں شامل کریں، اور پھر فائل کو محفوظ کریں۔ نام فائل کے شروع یا آخر میں شامل نہ کریں۔ اسے درمیان میں کہیں بھی ڈال دیں۔اگر آپ پراجیکٹ ڈائرکٹری میں جاتے ہیں اور کمانڈ <code>git status</code> کو چلاتے ہیں، تو آپ دیکھیں گے کہ تبدیلیاں موجود ہیں. ان تبدیلیوں کو اس شاخ میں <code>git add</code> کمانڈ استعمال کرتے ہوئے شامل کریں، جسے ابھی آپ نے بنایا تھا۔ :
|
||||
</div>
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
<div dir="rtl"> اب <code>git commit</code> کمانڈ کا استعمال کرتے ہوئے ان تبدیلیوں کا ارتکاب کریں: </div>
|
||||
|
||||
```bash
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
|
||||
<div dir="rtl"> <code><your-name></code> کو اپنے نام کے ساتھ تبدیل کردیں. </div>
|
||||
|
||||
## <div dir="rtl"> ان تبدیلیوں کو GitHub پردهکیل دیں۔ </div>
|
||||
|
||||
<div dir="rtl"> <code>git push</code> کمانڈ کے ذریعے اپنی تبدیلیوں کو پش کریں: </div>
|
||||
|
||||
```bash
|
||||
git push origin <add-your-name>
|
||||
```
|
||||
|
||||
<div dir="rtl"> <code><add-your-name></code> کو شاخ کے نام کے ساتھ بدل دیں، جسے آپ نے پہلے بنایا تھا. </div>
|
||||
|
||||
## <div dir="rtl"> اپنی تبدیلیوں کو جائزے کیلئے جمع کروائیں۔ </div>
|
||||
|
||||
<div dir="rtl"> اگر آپ GitHub پر اپنی ریپوزٹری پر جاتے ہیں تو، آپ کو <code>Compare & pull request</code> دکھائی دے گا. اس بٹن کو دبائیں. </div>
|
||||
|
||||
<img style="float: left;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="ایک پل درخواست کریں" />
|
||||
|
||||
<div dir="rtl"> اب پل درخواست جمع کروائیں. </div>
|
||||
|
||||
<img style="float: left;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="پل درخواست جمع کروائیں" />
|
||||
|
||||
<div dir="rtl"> جلد ہی میں آپ کی تمام تبدیلیوں کو اس پروجیکٹ کی ماسٹر شاخ میں ضم کر دونگا. تبدیلیوں کو ضم کرنے کے بعد آپ کو نوٹیفکیشن ای میل مل جائے گی </div>
|
||||
|
||||
## <div dir="rtl">آگے کیا کرنا چاہیے؟</div>
|
||||
<div dir="rtl">
|
||||
مبارک ہو! آپ نے کامیابی سے
|
||||
فورک -> کلون -> ترمیم -> پل ریکویسٹ ورک فلو
|
||||
مکمل کر لیا ہے جو آپ کو اکثر ایک شراکت دار کے طور پر ملے گا
|
||||
|
||||
اپنی شراکت کا جشن منائیں اور اپنے دوستوں اور فالوورز کے ساتھ اسے
|
||||
<a href="https://firstcontributions.github.io/#social-share"> ویب ایپ</a>
|
||||
پر جا کر شیئر کریں۔
|
||||
</div>
|
||||
<div dir="rtl">
|
||||
آپ کو مدد کی ضرورت ہے یا کوئی سوال ہو تو آپ ہماری سلیک ٹیم میں بھی شامل ہوسکتے ہیں.
|
||||
<a href="https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA">سلیک ٹیم میں شمولیت اختیار کریں۔</a>
|
||||
</div>
|
||||
<br />
|
||||
<div dir="rtl">
|
||||
اب ہم آپ کو دوسرے پراجيكٹس میں شراکت کرنے کے لئے دعوت ديتے ہیں۔
|
||||
ادھر آپ چند
|
||||
<a href="https://firstcontributions.github.io/#project-list"> مقبول ذخیروں</a>
|
||||
میں کچھ ابتدائی سطح کے مسائل حل کر سکتے ہیں. آگے بڑھیے اور مزید جاننے کے لئے ان ذخیروں پر جائیے۔
|
||||
</div>
|
||||
|
||||
### <div dir="rtl"> [ اضافی مواد ](../additional-material/git_workflow_scenarios/additional-material.md) </div>
|
||||
|
||||
## <div dir="rtl"> دوسرے ٹولز کو استعمال کرتے ہوئے سبق۔ </div>
|
||||
|
||||
|
||||
| <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) |
|
||||
|
||||
<div dir="rtl">
|
||||
اس منصوبے کی حمایت کی ہے
|
||||
</div>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,147 +0,0 @@
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
# Birinchi hissalar
|
||||
|
||||
Ushbu loyiha yangi boshlanuvchilarning birinchi hissasini qo'shish usullarini soddalashtirish va yo'naltirishga qaratilgan. Agar siz birinchi hissangizni qo'shmoqchi bo'lsangiz, quyidagi amallarni bajaring.
|
||||
|
||||
_Agar buyruq satri sizga mos bo'lmasa, [Bu erda GUI vositalaridan foydalanib amalga oshirishga oid darsliklari mavjud](#boshqa-vositalardan-foydalanish-uchun-qollanmalar)_
|
||||
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="repositoryni fork qiling" />
|
||||
|
||||
#### Agar kompyuteringizda git mavjud bo'lmasa, [buni o'rnating](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Bu repositoryni fork qilib oling
|
||||
|
||||
Bu repositoryni ushbu sahifaning yuqorisidagi fork tugmasini bosish orqali fork qilib oling.
|
||||
Bu akkountingizda ushbu repositoryning nusxasini yaratadi.
|
||||
|
||||
## Bu repositoryni klon qilib oling
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="bu repositoryni klon qilib oling" />
|
||||
|
||||
Endi fork qilingan repositoryni kompyuteringizga klon qiling. GitHub akkountingizga kirib, fork qilingan repositoryni oching, code tugmasi ustiga bosing va keyin _copy to clipboard_ belgisi (icon) ustiga bosing.
|
||||
|
||||
Terminalni oching va quyidagi git buyruqlarini yurg'izing:
|
||||
|
||||
```bash
|
||||
git clone "siz horizgina ko'chirib olgan url"
|
||||
```
|
||||
|
||||
bu yerda "siz horizgina ko'chirib olgan url" (qo'shtirnoqlarsiz) ushbu repositoryning (siz fork qilingan proyekt) 'URL'idir. URLni olish uchun oldingi bosqichlarni ko'ring.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="urlni klipboardga ko'chiring" />
|
||||
|
||||
Misol uchun:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/bu-siz/first-contributions.git
|
||||
```
|
||||
|
||||
bu yerdagi `bu-siz` sizning Github akkount nomingiz (username). Bu yerda Githubdagi first-contributions repositorysining kontentlarini kompyuteringizga
|
||||
ko'chiryapsiz.
|
||||
|
||||
## Branch yaratish
|
||||
|
||||
Kompyuteringizda repository papkasiga kiring (agar u yerda bo'lmasangiz)
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Endi `git switch` buyrug'i orqali branch yarating:
|
||||
|
||||
```bash
|
||||
git switch -c yangi-branch-nomingiz
|
||||
```
|
||||
|
||||
Misol uchun:
|
||||
|
||||
```bash
|
||||
git switch -c add-aliml92
|
||||
```
|
||||
|
||||
## Kerakli o'zgarishlarni qiling va bu o'zgarishlarni commit qiling
|
||||
|
||||
Endi matn muharririda `Contributors.md` faylini oching, unga ismingizni qo'shing. Uni faylning boshiga yoki oxiriga qo'shmang. Uni istalgan o'rta qismga qo'shing. Endi faylni saqlang.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Agar proyekt papkasiga o'tsangiz va `git status` buyrug'ini yurg'izsangiz, o'zgarishlar borligini ko'rasiz.
|
||||
|
||||
`git add` buyrug'i yordamida hosil qilgan branchingizga o'zgarishlarni qo'shing:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Endi `git commit` buyrug'i yordamida bu o'zgarishlarni commit qiling:
|
||||
|
||||
```bash
|
||||
git commit -m "Contributors royxatiga ismingiz-ni kiritish"
|
||||
```
|
||||
`ismingiz-` ni o'rniga o'zingizni ismingizni yozing.
|
||||
|
||||
## O'zgarishlarni Githubga push qilish
|
||||
|
||||
`git push` buyrug'i bilan o'zgartishlaringizni push qiling:
|
||||
|
||||
```bash
|
||||
git push origin -u yangi-branch-nomingiz
|
||||
```
|
||||
|
||||
albatta, `yangi-branch-nomingiz` ni biroz oldin yaratgan branch nomiga almashtirgan holda.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Push qilish vaqtida biror xatolarni ko'rsangiz, bu yerni bosing</strong> </summary>
|
||||
|
||||
- ### Autentifikatsiya Xatoligi
|
||||
<pre>
|
||||
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'
|
||||
</pre>
|
||||
|
||||
Akkountingizga SSH kalit yaratish va konfiguratsiya qilish uchun [GitHub qo'llanma](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ga o'ting.
|
||||
|
||||
</details>
|
||||
|
||||
## O'zgartirishlaringizni ko'rib chiqilishi uchun topshirish
|
||||
|
||||
Agar Githubdagi repositoryingizga o'tsangiz, `Compare & pull request` tugmasini ko'rasiz. O'sha tugmani bosing.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="pull request hosil qilish" />
|
||||
|
||||
Endi pull requestni submit qiling.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="pull request submit qilish" />
|
||||
|
||||
Tez orada men sizning barcha o'zgarishlaringizni ushbu proyektning main branchiga birlashtiraman. O'zgarishlar birlashtirilgandan so'ng sizga elektron pochta xabarnomasi keladi.
|
||||
|
||||
## Bu yerdan qayerga borish?
|
||||
|
||||
Tabriklayman! Siz horizgina contributor sifatida tez-tez uchraydigan standard ish ketma-ketligi ya'ni _fork -> clone -> edit -> pull request_ ni tamonladingiz.
|
||||
|
||||
Hissangizni nishonlang va [web app](https://firstcontributions.github.io/#social-share)ga o'tish orqali do'stlaringizga va ergashuvchilaringizga ulashing.
|
||||
|
||||
Agar ko‘proq mashq qilishni xohlasangiz, [code contributions](https://github.com/firstcontributions/first-contributions/blob/main/code-contributions.md) faylini ko‘rib chiqing.
|
||||
|
||||
|
||||
|
||||
Agar koʻproq mashq qilishni istasangiz, [kod hissalarini](https://github.com/roshanjossey/code-contributions) tekshiring.
|
||||
|
||||
|
||||
|
||||
|
||||
Endi boshqa proyektlarga hissa qo‘shishni boshlaylik. Siz boshlashingiz mumkin bo'lgan oson masalalar bilan proyektlar ro'yxatini tuzdik. Ko'zdan kechiring [web appdagi proyektlar ro'yxati](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Qo'shimcha materiallar](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Boshqa Vositalardan Foydalanish Uchun Qollanmalar
|
||||
|
||||
| <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) |
|
||||
@@ -1,126 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Những đóng góp đầu tiên
|
||||
|
||||
Lần đầu tiên bạn làm điều gì đó có thể gặp nhiều trở ngại. Đặc biệt khi bạn đang cộng tác, sai lầm là điều rất khó tránh khỏi.
|
||||
|
||||
Việc đọc hướng dẫn có tác dụng, nhưng có gì tốt hơn là thực sự đóng góp trong môi trường thực tiễn? Dự án này là nhằm mục đích cung cấp sự hướng dẫn và đơn giản hóa cách thức những người mới tham gia đóng góp. Nếu bạn mong muốn thực hiện việc đóng góp đầu tiên của mình, chỉ cần làm theo các bước đơn giản bên dưới.
|
||||
|
||||
#### *Nếu bạn không thoải mái khi làm việc với dòng lệnh, [đây là các hướng dẫn sử dụng các công cụ có giao diện đồ họa (GUI).]( #Hướng-dẫn-sử-dụng-các-công-cụ-khác )*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Nếu bạn không có git trên máy tính của bạn, [cài đặt git](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Sao chép kho lưu trữ (Fork)
|
||||
|
||||
Sao chép (copy) kho lưu trữ mã nguồn (repository) này bằng cách nhấn vào nút `Fork` (Tạo nhánh) đầu trang này. Một bản sao kho lưu trữ này sẽ được tạo ra trong tài khoản của bạn.
|
||||
|
||||
## Tạo bản lưu nội bộ của kho lưu trữ trên máy tính của bạn (clone)
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Bây giờ, hãy sao chép bản sao (clone) kho lưu trữ đã được sao chép (fork) này vào máy của bạn. Để thực hiện thao tác này, truy xuất vào tài khoản GitHub của bạn, mở kho lưu trữ đã tạo nhánh rồi nhấn vào nút `Code`, và sau đó nhấn vào biểu tượng *copy to clipboard*
|
||||
|
||||
Mở một cửa sổ terminal và chạy lệnh git sau đây:
|
||||
|
||||
```bash
|
||||
git clone "url bạn vừa sao chép"
|
||||
```
|
||||
Trong đó `"url bạn vừa sao chép"` (không có dấu ngoặc kép) là url dẫn vào kho mã nguồn (mà bạn đã sao chép) này. Xem các bước trước đó để có được url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Ví dụ:
|
||||
```bash
|
||||
git clone https://github.com/tên-bạn/first-contributions.git
|
||||
```
|
||||
Trong đó `tên-bạn` là tên người dùng (username) tài khoản GitHub của bạn. Ở đây bạn đang sao chép nội dung của kho mã nguồn "first-contributions" trên GitHub vào máy tính của bạn
|
||||
|
||||
## Tạo nhánh (branch)
|
||||
|
||||
Di chuyển đến thư mục chứa kho lưu trữ trên máy tính của bạn (nếu bạn chưa ở đó):
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
Bây giờ tạo ra một nhánh (branch) sử dụng lệnh `git switch`
|
||||
```bash
|
||||
git switch -c <tên-nhánh-mới-của-bạn>
|
||||
```
|
||||
|
||||
Ví dụ:
|
||||
```bash
|
||||
git switch -c thêm-Tran-Ly-Vu
|
||||
```
|
||||
(Tên của nhánh mới không cần phải có từ *thêm* trong đó, nhưng nó được dùng vì mục đích của nhánh này là thêm tên của bạn vào danh sách.)
|
||||
|
||||
## Thực hiện những thay đổi cần thiết và chấp nhận (commit) những thay đổi này
|
||||
|
||||
Bây giờ mở tập tin `Contributors.md` trong một trình soạn thảo văn bản và thêm tên của bạn vào. Đừng thêm vào đầu hoặc cuối tập tin. Thêm vào bất cứ nơi nào ở giữa. Sau đó, lưu tập tin.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Nếu bạn vào thư mục hiện tại của project và thực hiện lệnh `git status`, bạn sẽ thấy những thay đổi.
|
||||
|
||||
Thêm những thay đổi vào nhánh bạn vừa tạo bằng lệnh `git add`:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Bây giờ chấp nhận những thay đổi bằng cách sử dụng dòng lệnh `git commit` dưới đây:
|
||||
```bash
|
||||
git commit -m "Them <ten-ban> vào danh sách Cộng tác viên"
|
||||
```
|
||||
|
||||
thay thế `<ten-ban>` bằng tên của bạn.
|
||||
|
||||
## Đẩy (push) các thay đổi lên GitHub
|
||||
|
||||
Đẩy những thay đổi của bạn sử dụng `git push`:
|
||||
```bash
|
||||
git push origin <tên-nhánh-của-bạn>
|
||||
```
|
||||
thay thế `<tên-nhánh-của-bạn>` với tên của nhánh bạn tạo ra trước đó.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Nếu bạn gặp bất cứ lỗi gì trong lúc thực hiện thao tác push, nhấn vào đây:</strong> </summary>
|
||||
|
||||
- ### Lỗi xác thực (Authentication Error)
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Truy cập vào [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) về việc tạo cấu hình khóa SSH cho tài khoản của bạn.
|
||||
|
||||
</details>
|
||||
|
||||
## Gửi yêu cầu xem xét các thay đổi của bạn
|
||||
|
||||
Nếu bạn mở kho mã nguồn của bạn trên GitHub, bạn sẽ thấy nút `Compare & pull request`. Nhấn vào nút đó.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Bây giờ, hãy gửi yêu cầu xem xét thay đổi (pull request)
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Tôi sẽ sớm hợp nhất (merge) tất cả các thay đổi của bạn vào nhánh chính (master branch) của dự án này. Bạn sẽ nhận được email thông báo sau khi các thay đổi đã được gộp.
|
||||
|
||||
## Bước tiếp theo là gì?
|
||||
|
||||
Chúc mừng! Bạn vừa hoàn thành quy trình tiêu chuẩn copy (fork) -> Sao chép (clone) -> chỉnh sửa (edit) -> yêu cầu kéo (pull request) mà bạn sẽ thường gặp khi đóng góp vào những dự án!
|
||||
|
||||
Hãy ăn mừng đóng góp của bạn, và chia sẻ nó với bạn bè và những người theo dõi của bạn bằng cách truy cập [ứng dụng web](https://roshanjossey.github.io/first-contribution/#social-share).
|
||||
|
||||
Để hỗ trợ bạn với việc đóng góp cho các dự án (project) khác, chúng tôi đã tổng hợp một danh sách các dự án có các vấn đề đơn giản mà bạn có thể bắt đầu. Hãy kiểm tra [danh sách dự án trong ứng dụng web](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Tài liệu bổ sung](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Hướng dẫn sử dụng các công cụ khác
|
||||
|
||||
| <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) |
|
||||
@@ -1,129 +0,0 @@
|
||||
[](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)
|
||||
|
||||
|
||||
# Akọkọ ilowosi
|
||||
|
||||
Lati dasi nko lakoko n'le, pataki ti a ba ronu nipa asise ti a le bapade, a fe ko rorun fun awon ilowosi akoko lati le dasi
|
||||
ise agbese lakoko, ise agbese yi a ko yin be ese le se, e tele ilana ni isalẹ
|
||||
|
||||
|
||||
#### *to ba le lo pipaṣẹ, [awon ona mi re.](#Tutorials-Usin'-Other-Tools)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
e fi git sori ẹrọ [install it](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## orita ibi ipamọ yii
|
||||
orita ibi ipamọ yii, e te ' fork bọtini' ni oke oju iwe yi, e leyi a fun yin ni daako ni accounti yin
|
||||
|
||||
## Dide ibi ipamọ
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
oya e de ibi ipamọ yi si account yin, e lo si githubu accounti yin, e te 'clone botini, ke wa te 'copy to clipboard'
|
||||
.
|
||||
|
||||
e sii ebute in ero ise yin, e te pipaṣẹ to be a labe oro yi si:
|
||||
|
||||
```bash
|
||||
git clone "ọna asopọ ' te daakọ"
|
||||
```
|
||||
|
||||
ibi, "ọna asopọ ' te daakọ" (lai awọn ' quote iṣmiṣ) lo je ono asopo ti e dide ibi ipamo (e dide ibi ipamo ise igbesi). e wo awon atono ti tele to n be loke
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
oye ko ri bi:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/oruko yin/first-contributions.git
|
||||
```
|
||||
|
||||
ibi `oruko yin` ni oruko githubu accounti yin. ni bi yi en didako awon akoonu ' first-contributions repository in GitHubu' si ero ise yin.
|
||||
|
||||
## ṣẹda ẹka
|
||||
|
||||
seda eka si ero, amo ko to sebe te pipaṣẹ yi si ibe
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
oya seda eka si pelu ' `git checkout` pipase:
|
||||
|
||||
```bash
|
||||
git checkout -b <oruko to fe so eka to fe seda>
|
||||
```
|
||||
|
||||
fun apere:
|
||||
|
||||
```bash
|
||||
git checkout -b add-luke-oliff
|
||||
```
|
||||
|
||||
(kon se dadun ki e lo "add", amo o daa fun irun nnkan bayii)
|
||||
|
||||
## Ṣe awọn ayipada to ṣe pataki 'n ṣe awọn ayipada yẹn
|
||||
|
||||
oya shi faili `Contributors.md` ninu olootu ọrọ, fi oruko re mo awon oruko to 'n wan be, ma fe se akoko tabi igbeyn, fi si arin.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
to ba te pipase `git status` si ebute re, wa re awon ayipada ti ose
|
||||
|
||||
fi won mo eka ti ode pelu pipase yii `git add`:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
oya dawon papop pelu pipase yi `git commit`:
|
||||
|
||||
```bash
|
||||
git commit -m "Add <oruko githubu account yin> to Contributors list"
|
||||
```
|
||||
|
||||
yi `<oruko githubu account yin>` pada si oruko re.
|
||||
|
||||
## Titari awọn ayipada si GitHub
|
||||
|
||||
te pipase yi `git push`:
|
||||
|
||||
```bash
|
||||
git push origin <oruko eda ti e se>
|
||||
```
|
||||
|
||||
yi `<oruko eda ti e se>` pada si orku e da ti ese ni ibere
|
||||
|
||||
## Fi yer ayipada fer awotẹlẹ
|
||||
|
||||
Ti o ba lọ t' yer ibi ipamọ lori GitHub, iwọ yoo ri a `Compare & pull request` botini. te botini yen.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
oya fi silẹ.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
To ba ya a ma so gbogo yipada ti e se papo, e o gba iwifunni lori imeeli yin
|
||||
|
||||
## Nibo ni lati lọ?
|
||||
|
||||
Ku ise oti pari boṣewa bisesenlo _fork -> clone -> edit -> PR_ bisesenlo ti o ma bapade ni ise asowopo
|
||||
|
||||
Ṣe ayẹyẹ ilowosi yer 'ki o pin pẹlu' awọn ọkan ati awọn ọmọlẹyin nipasẹ lilọ’ si [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Ẹ lè darapọ̀ mọ́ àwọn òṣìṣẹ́ òṣìṣẹ́ wa tí kò já fáfá tí ẹ bá nílò ìrànlọ́wọ́ èyíkéyìí tàbí kí ẹ lè gba àlọ́ kankan. [Darapo](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Bayi jẹ ki a bẹrẹ pẹlu' idasi' t' awọn iṣẹ akanṣe miiran. A ti ṣe akojọpọ awọn iṣẹ akanṣe pẹlu awọn ọran irọrun ti o le bẹrẹ. Ṣayẹwo [awon re](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Ptu le ka](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Tutorial lilo 'miiran Irinṣẹ
|
||||
|
||||
| <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) |
|
||||
Reference in New Issue
Block a user