د دې پروژې موخه دا ده چې د پیل کونکو لپاره د دوی لومړنۍ مرسته کولو لاره ساده او لارښود کړي. که تاسو د خپلې لومړۍ مرستې په لټه کې یاست، لاندې مرحلې تعقیب کړئ.
که تاسو د کمانډ لاین (CLI) سره راحته نه یاست ، دا لارښوونې وکاروئ ترڅو پوه شئ چې د GUI وسیلو کارولو څرنګوالی.
که تاسو git نصب نلرئ له دې ځایه نصب کړئ.
د دې پاڼې په سر کې د Fork تڼۍ په کلیک کولو سره دا ذخیره فورک کړئ. دا به ستاسو په حساب کې د دې ذخیره کاپي رامینځته کړي.
اوس خپل ماشین ته د فورک شوي ذخیره کلون کړئ. خپل GitHub حساب ته لاړ شئ، د فورک شوي ریپازیتوری خلاص کړئ، د Code تڼۍ باندې کلیک وکړئ او بیا د کلپ بورډ ته د Copy To Clipboard باندې کلیک وکړئ.
بیا یو ټرمینل خلاص کړئ او لاندې کمانډ چل کړئ:
git clone "url you just copied"
چیرته چې "url you just copied" (پرته د نرخ نښه) د دې ریپازیتوری url دی (ستاسو د دې پروژې فورک). د url ترلاسه کولو لپاره مخکیني ګامونه وګورئ.
د مثال په توګه:
git clone https://github.com/this-is-you/first-contributions.git
چیرته چې 'this-is-you' ستاسو د GitHub کاربری نوم دی. دلته تاسو خپل کمپیوټر ته په GitHub کې د لومړۍ مرستې ذخیره مینځپانګې کاپي کوئ.
په خپل کمپیوټر کې د ریپوزیتوری لارښود ته بدل کړئ (که تاسو دمخه نه لرئ):
cd first-contributions
اوس د git switch کمانډ په کارولو سره څانګه جوړه کړئ:
git checkout -b 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"
د خپل نوم سره بدل کړئ.
د 'git push' کمانډ په کارولو سره خپل بدلونونه فشار (Push) وکړئ:
git push origin <add-your-branch-name>
د your-branch-name بدلول د هغه څانګې نوم سره چې تاسو مخکې جوړ کړی:
که تاسو په GitHub کې خپل ریپازیتوری ته لاړ شئ، نو تاسو به د Compare & pull request تڼۍ وګورئ. په هغه تڼۍ کلیک وکړئ.
اوس د پلولو غوښتنه (Pull Request) وسپارئ.
ډیر ژر به زه ستاسو ټول بدلونونه د دې پروژې په اصلي څانګه کې یوځای کړم. تاسو به د خبرتیا بریښنالیک ترلاسه کړئ کله چې بدلونونه یوځای شي.
مبارک شه! تاسو یوازې د معیاري فورک(Fork)، کلون(Clone)، ایډیټ(Edit)، او پلولو غوښتنې (Pull Request) کاري فلو بشپړ کړی چې تاسو به ډیری وختونه د مرسته کونکي په توګه ورسره مخ شئ!
خپله ونډه ولمانځئ او له خپلو ملګرو او پیروانو سره یې شریک کړئ دلته لاړ شئ.
همدارنګه، تاسو کولی شئ زموږ د Slack ټیم سره یوځای شئ که تاسو کومې مرستې ته اړتیا لرئ یا کومه پوښتنه لرئ. دلته کلیک وکړی
اوس راځئ چې تاسو په نورو پروژو کې د مرستې سره پیل وکړو. موږ د اسانه مسلو سره د پروژو لیست ترتیب کړی چې تاسو یې پیل کولی شئ. بشپړ ی وګوره
 |
 |
 |
 |
 |
 |
|---|---|---|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |