README.am.md

የመጀመሪያ አስተዋፅኦዎች

ይህ ፕሮጀክት ጀማሪዎች የመጀመሪያ አስተዋጾ የሚያደርጉበትን መንገድ ለማቅለል እና ለመምራት ያለመ ነው። የመጀመሪያዎን አስተዋፅዖ ለማድረግ ከፈለጉ ከታች ያሉትን ደረጃዎች ይከተሉ።

በcommand line(ተርሚናል) ካልተመቸዎት፣ የGUI መሳሪያዎችን ለመጠቀም አጋዥ ስልጠናዎች እዚህ ያገኛሉ።

በማሽንዎ ላይ ጊት(git) ከሌለዎት ፤ ይጫኑት ።

ይህንን ማከማቻ fork ያድርጉ

በዚህ ገጽ ላይኛው ክፍል ላይ ያለውን የfork button ጠቅ በማድረግ ይህንን ማከማቻ fork ያድርጉት። ይህ በእርስዎ account ውስጥ የዚህን repository ቅጂ ይፈጥራል።

የማከማቻውን ተመሳሳይ ይፍጠሩ (Clone)

አሁን fork የተደረገውን ማከማቻ (repository) ቅጂ በማሽንዎ(በኮምፒውተርዎ) ይፍጥሩ። ወደ GitHub (account)መለያዎ ይሂዱ፤ fork የተደረገውን ማከማቻ ይክፈቱ፤ ኮድ የሚለውን button ጠቅ ያድርጉ እና ከዚያ ወደ clipboard ቅዳ የሚለውን ጠቅ ያድርጉ::

ተርሚናል ይክፈቱ እና የሚከተለውን የgit ትዕዛዝ run ያድርጉ:

git clone "የቀዱትን url"

"አሁን የገለበጡት url" (ያለ ጥቅስ ምልክቶቹ) የማከማቻው (የዚህ ፕሮጀክት fork) url ነው። urlን ለማግኘት የቀደመውን ደረጃዎች ይመልከቱ።

ለምሳሌ:-

git clone git@github.com:ይህ-እርስዎ-ኖት/first-contributions.git

'ይህ-እርስዎ-ኖት' የእርሶ GitHub ተጠቃሚ username ነው። አሁን በ GitHub ላይ ያለውን የመጀመሪያ አስተዋፅዖ(first-contributions) ማከማቻ ይዘቶችን ወደ ኮምፒውተርዎ እየገለበጡ ነው።

ቅርንጫፍ ይፍጠሩ

በኮምፒተርዎ ላይ ወዳለው የማከማቻ ማህደር ይግቡ (እዚያው ከሌሉ ማለት ነው!)፡

cd first-contributions

አሁን የ‹git switch› ትዕዛዝን በመጠቀም ቅርንጫፍ ይፍጠሩ፡

git switch -c የእርስዎ-አዲሱ-ቅርንጫፍ-ስም

ለምሳሌ:-

git switch -c ይሁን-አለማየሁ

አስፈላጊ ለውጦችን ያድርጉ እና ለውጦችን ይፈጥሙ (commit)

አሁን የ‹Contributors.md› ፋይልን በጽሑፍ አርታኢ ውስጥ ይክፈቱ እና ስምዎትን ይጨምሩበት። በፋይሉ መጀመሪያ ወይም መጨረሻ ላይ አይጨምሩት። በመካከል የትኛውም ቦታ ላይ ያስቀምጡት። አሁን, ፋይሉን save ያድርጉ።

ወደ የፕሮጀክት ማህደሩ ሄደው ይህን ትዕዛዝ (git status) ከፈጸሙ፣ ለውጦች እንዳሉ ያያሉ።

የ‹git add› ትዕዛዙን በመጠቀም እነዚያን ለውጦች ወደ ፈጠሩት ቅርንጫፍ ያክሉ።

git add Contributors.md

አሁን የ‹git commit› ትዕዛዙን በመጠቀም እነዚህን ለውጦች ያድርጉ፡:

git commit -m "የአስተዋጽዖ አበርካቾች ዝርዝር ውስጥ የእርስዎን-ስም ያክሉ"

'የእርስዎን-ስም' የሚለውን በስምዎ ይተኩ፡፡

ለውጦችን ወደ GitHub ይግፉ

‹git push› የሚለውን ትዕዛዝ በመጠቀም ለውጦችዎን ይግፉ፡፡

git push -u origin የእርስዎ-ቅርንጫፍ-ስም

ቀደም ብለዉ በፈጠሩት የቅርንጫፍ ስም 'የእርስዎን-ቅርንጫፍ-ስም'ን ይትኩ።

በመግፋት ላይ ማንኛውም ስህተት ካጋጠሞት ፤ እዚህ ጠቅ ያድርግ:

• Authentication Error

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/'

Go to GitHub's tutorial on generating and configuring an SSH key to your account.

ለውጦችዎን ለግምገማ ያስገቡ (Pull request)

በ GitHub ላይ ወደ ማከማቻዎ ከሄዱ፣ ‘compare & pull request' የሚለውን ቁልፍ ያያሉ። በዚያ ቁልፍ ላይ ጠቅ ያድርጉ።

አሁን pull request ያስገቡ።

በቅርቡ ሁሉንም ለውጦችዎን ወደዚህ ፕሮጀክት ዋና ቅርንጫፍ አዋህዳቸዋለሁ። ለውጦቹ ከተዋሃዱ በኋላ የማሳወቂያ 'ኢይሜል' ይደርስዎታል።

ከዚህስ ወዴት ልሂድ?

እንኳን ደስ ያሎዎት! ልክ እንደ አስተዋጽዖ አበርካች የሚያጋጥሙትን መደበኛ fork -> clone -> edit -> pull request የስራ ፍሰትን አጠናቀዋል!

አስተዋጾዎን ያጣጣጥሙ እና ወደ ድህረ-ግፅ በመሄድ ለጓደኞችዎ እና ተከታዮችዎ ያካፍሉ።

ተጨማሪ ልምምድ ከፈለጉ በዚህ ሊንክ code contributions ይግቡ.

አሁን ለሌሎች ፕሮጀክቶች በማበርከት እንጀምር። እርስዎ ሊጀምሩባቸው የሚችሉ ቀላል ጉዳዮች ያላቸውን የፕሮጀክቶች ዝርዝር አዘጋጅተናል። በዚህ ሊንክ በመግባት በድር መተግበሪያ ውስጥ ያሉትን የፕሮጀክቶች ዝርዝር ይመልከቱ።

ተጨማሪ ቁሳቁስ

የሌሎች መሳሪያዎች አጠቃቀም አጋዥ ስልጠናዎች

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree	IntelliJ IDEA