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.
Add Swahili Translation for README.md
- Loading branch information
Showing
1 changed file
with
131 additions
and
0 deletions.
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,131 @@ | ||
[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](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) | ||
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) | ||
[![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) | ||
|
||
|
||
# Mchango wa kwanza | ||
|
||
Ni vigumu. Mara zote ni vigumu kufanya kitu kwa mara ya kwanza. Hasa 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. | ||
|
||
## 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 na weka 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! | ||
|
||
Sheherekea hatua uliyofikia na wajulishe wengine kwa kwenda kwenye [wavuti](https://roshanjossey.github.io/first-contributions/#social-share). | ||
|
||
Waweza kujiunga 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) | ||
|
||
## Mafundisho 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/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) | | ||
|