forked from firstcontributions/first-contributions
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
38b71c6
commit 61861dd
Showing
2 changed files
with
132 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,131 @@ | ||
# የመጀመሪያ አስተዋጽዖዎች | ||
|
||
ይህ ፕሮጀክት ጀማሪዎች የመጀመሪያ አስተዋፅዖቸውን እንዲያደርጉ መንገዱን ለማቅለል እና ለመምራት ያለመ ነው። የመጀመሪያውን አስተዋፅዖ ማድረግ ከፈለጉ ከታች ያሉትን ደረጃዎች ይከተሉ። | ||
|
||
_በትእዛዝ መስመሩ ካልተመቻችሁ [የጂአይ መሳሪያዎችን በመጠቀም መማሪያ ይኸውና](#መማሪያዎች-ሌሎች-መሳሪያዎችን-በመጠቀም)_ | ||
|
||
|
||
<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> | ||
|
||
- ### 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/የተጠቃሚ ስምህ/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/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) | |