mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-14 17:21:51 +00:00
129 lines
13 KiB
Markdown
129 lines
13 KiB
Markdown
[](https://github.com/ellerbrock/open-source-badges/)
|
|
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-old-version-tutorial/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 alt="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> | Git Bash Edition |
|
|
| ------------------------------------------------------------------------------------------------------------------ | ---------------- |
|
|
|
|
|
|
ഇത് ബുദ്ധിമുട്ടാണ്. നിങ്ങൾ ആദ്യമായി എന്തെങ്കിലും ചെയ്യുമ്പോൾ എല്ലായ്പ്പോഴും ബുദ്ധിമുട്ടാണ്. പ്രത്യേകിച്ചും നിങ്ങൾ സഹകരിക്കുമ്പോൾ, തെറ്റുകൾ വരുത്തുന്നത് സുഖകരമായ കാര്യമല്ല. എന്നാൽ ഓപ്പൺ സോഴ്സ് എന്നത് സഹകരിച്ച് പ്രവർത്തിക്കുന്നതിനും ഒരുമിച്ച് പ്രവർത്തിക്കുന്നതിനുമാണ്. പുതിയ ഓപ്പൺ സോഴ്സ് സംഭാവകർ ആദ്യമായി പഠിക്കുകയും സംഭാവന ചെയ്യുകയും ചെയ്യുന്ന രീതി ലളിതമാക്കാൻ ഞങ്ങൾ ആഗ്രഹിക്കുന്നു.
|
|
|
|
ലേഖനങ്ങൾ വായിക്കുന്നതും ട്യൂട്ടോറിയലുകൾ കാണുന്നതും സഹായിക്കും, എന്നാൽ യാതൊന്നും കുഴപ്പത്തിലാക്കാതെ കാര്യങ്ങൾ ചെയ്യുന്നതിനേക്കാൾ നല്ലത് എന്താണ്. ഈ പ്രോജക്റ്റ് മാർഗ്ഗനിർദ്ദേശം നൽകാനും പുതുമുഖങ്ങൾ അവരുടെ ആദ്യ സംഭാവന നൽകുന്ന രീതി ലളിതമാക്കാനും ലക്ഷ്യമിടുന്നു. നിങ്ങൾ എത്രത്തോളം വിശ്രമിക്കുന്നുവോ അത്രയും നന്നായി പഠിക്കുമെന്ന് ഓർക്കുക. നിങ്ങളുടെ ആദ്യ സംഭാവന നൽകാൻ നിങ്ങൾ ആഗ്രഹിക്കുന്നുവെങ്കിൽ, ചുവടെയുള്ള ലളിതമായ ഘട്ടങ്ങൾ പിന്തുടരുക. ഞങ്ങൾ നിങ്ങൾക്ക് വാഗ്ദാനം ചെയ്യുന്നു, അത് രസകരമായിരിക്കും.
|
|
|
|
നിങ്ങളുടെ വിൻഡോസ് മെഷീനിൽ ഗീത് ബാഷ് ഇല്ലെങ്കിൽ, [install it](https://git-scm.com/download/win).
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt="fork this repository" />
|
|
|
|
## ഈ ശേഖരം ഫോർക്ക് ചെയ്യുക
|
|
|
|
ഈ പേജിൻ്റെ മുകളിൽ വലതുവശത്തുള്ള ഫോർക്ക് ബട്ടണിൽ ക്ലിക്കുചെയ്ത് ഈ റിപ്പോ ഫോർക്ക് ചെയ്യുക.
|
|
ഇത് നിങ്ങളുടെ അക്കൗണ്ടിൽ ഈ ശേഖരത്തിൻ്റെ ഒരു പകർപ്പ് സൃഷ്ടിക്കും.
|
|
|
|
## ശേഖരം ക്ലോൺ ചെയ്യുക
|
|
|
|
ഇപ്പോൾ ഈ റിപ്പോ നിങ്ങളുടെ മെഷീനിലേക്ക് ക്ലോൺ ചെയ്യുക.
|
|
|
|
പ്രധാനപ്പെട്ടത്: ഒറിജിനൽ റിപ്പോ ക്ലോൺ ചെയ്യരുത്. നിങ്ങളുടെ നാൽക്കവലയിലേക്ക് പോയി അത് ക്ലോൺ ചെയ്യുക.
|
|
|
|
റിപ്പോ ക്ലോൺ ചെയ്യാൻ, "കോഡ്" ക്ലിക്ക് ചെയ്യുക, തുടർന്ന് താഴെയുള്ള സ്ട്രിംഗ് പകർത്തുക.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copy string" />
|
|
|
|
നിങ്ങൾ ഇപ്പോൾ ഡൗൺലോഡ് ചെയ്ത ഗീത് ബാഷ് ആപ്ലിക്കേഷൻ തുറക്കുക. ഇത് വിൻഡോസ് മെഷീനിലാണെങ്കിൽ താഴെയുള്ള ചിത്രം പോലെയായിരിക്കണം.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="open git bash terminal" />
|
|
|
|
ഈ കമാൻഡ് ഉപയോഗിച്ച് ഈ പ്രോജക്റ്റ് സംരക്ഷിക്കാൻ നിങ്ങൾ ആഗ്രഹിക്കുന്ന ഫോൾഡറിലേക്ക് പോകുക
|
|
|
|
`cd <folder>`
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-2.png" alt="cd into a folder" />
|
|
|
|
ഈ കമാൻഡ് ഉപയോഗിച്ച് റിപ്പോസിറ്ററി ക്ലോൺ ചെയ്യുന്നതിന് മുകളിലുള്ള ഘട്ടത്തിൽ നിങ്ങൾ പകർത്തിയ സ്ട്രിംഗ് ഉപയോഗിക്കുക
|
|
|
|
`git clone <repo-url>`
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-2.png" alt="clone the repository" />
|
|
|
|
നിങ്ങളുടെ മാറ്റങ്ങൾ വരുത്താൻ റിപ്പോ ഉള്ള ഡയറക്ടറിയിലേക്ക് പോയി അത് vs കോഡിൽ തുറക്കുക.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-3.png" alt="cd into the newly cloned repo" />
|
|
|
|
## Create a branch
|
|
|
|
ഇപ്പോൾ ഈ ലളിതമായ കമാൻഡ് ഉപയോഗിച്ച് ഒരു ബ്രാഞ്ച് സൃഷ്ടിക്കുക. ഈ കമാൻഡ് നിങ്ങൾക്കായി ഒരു ശാഖ സൃഷ്ടിക്കുക മാത്രമല്ല, ആ ബ്രാഞ്ചിലേക്ക് മാറാനും നിങ്ങളെ അനുവദിക്കുന്നു.
|
|
|
|
```
|
|
git checkout -b <ശാഖ-നാമം>
|
|
```
|
|
|
|
നിങ്ങളുടെ ശാഖയ്ക്ക് പേര് നൽകുക `<നിങ്ങളുടെ പേര് ചേർക്കുക>`. ഉദാഹരണത്തിന്, "ആഡ്-ജെയിംസ്-സ്മിത്ത്"
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-branch.png" alt="create a branch" />
|
|
|
|
## ആവശ്യമായ മാറ്റങ്ങൾ വരുത്തുകയും ആ മാറ്റങ്ങൾ വരുത്തുകയും ചെയ്യുക
|
|
|
|
ഇപ്പോൾ ഒരു ടെക്സ്റ്റ് എഡിറ്ററിൽ `Contributors.md` ഫയൽ തുറക്കുക, പേജിൻ്റെ താഴേക്ക് സ്ക്രോൾ ചെയ്ത് അതിൽ നിങ്ങളുടെ പേര് ചേർക്കുക, തുടർന്ന് ഫയൽ സംരക്ഷിക്കുക.
|
|
|
|
ഉദാഹരണം: നിങ്ങളുടെ പേര് ജെയിംസ് സ്മിത്ത് എന്നാണെങ്കിൽ, അത് ഇതുപോലെ ആയിരിക്കണം.
|
|
|
|
\[James Smith](https://github.com/jamessmith)
|
|
|
|
ഈ കമാൻഡ് പ്രവർത്തിപ്പിക്കുന്നതിലൂടെ Contributors.md-ൽ മാറ്റങ്ങൾ ഉണ്ടെന്ന് നിങ്ങൾക്ക് കാണാൻ കഴിയും
|
|
|
|
`git status`
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="check the status" />
|
|
|
|
ഇപ്പോൾ ആ മാറ്റങ്ങൾ വരുത്തുക:
|
|
|
|
ആദ്യം ഉപയോഗിച്ച് സ്റ്റേജിംഗ് ഏരിയയിൽ നിങ്ങൾ വരുത്തിയ മാറ്റം ചേർക്കുക
|
|
|
|
`git add ഫയലിൻ്റെ പേര്`
|
|
|
|
തുടർന്ന് ഈ കമാൻഡ് പാടി ഒരു കമ്മിറ്റ് സന്ദേശം എഴുതുക
|
|
|
|
`git commit -m "സംഭാവകരുടെ പട്ടികയിൽ നിങ്ങളുടെ പേര് ചേർക്കുക"`
|
|
|
|
നിങ്ങളുടെ പേര് ഉപയോഗിച്ച് `<your-name>` മാറ്റിസ്ഥാപിക്കുക.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit changes" />
|
|
|
|
നിങ്ങളുടെ പ്രതിബദ്ധത പൂർത്തീകരിച്ചിട്ടുണ്ടോ എന്നറിയാൻ നിങ്ങൾക്ക് ഒരു ലളിതമായ `git log --oneline` കമാൻഡ് പ്രവർത്തിപ്പിക്കാം.
|
|
|
|
## മാറ്റങ്ങൾ Github-ലേക്ക് പുഷ് ചെയ്യുക
|
|
|
|
മുകളിലുള്ള ഘട്ടങ്ങൾ പൂർത്തിയാക്കിക്കഴിഞ്ഞാൽ, ഈ കമാൻഡ് ഉപയോഗിച്ച് നിങ്ങൾക്ക് മാറ്റങ്ങൾ വരുത്താൻ കഴിയും
|
|
|
|
`git push origin <branch-name>`
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-push.png" alt="push changes" />
|
|
|
|
## നിങ്ങളുടെ മാറ്റങ്ങൾ അവലോകനത്തിനായി സമർപ്പിക്കുക
|
|
|
|
നിങ്ങൾ github-ൽ നിങ്ങളുടെ ശേഖരണത്തിലേക്ക് പോയാൽ, നിങ്ങൾ `Compare & pull request` ബട്ടൺ കാണും. ആ ബട്ടണിൽ ക്ലിക്ക് ചെയ്യുക.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="create a pull request" />
|
|
|
|
ഇപ്പോൾ പുൾ റിക്വസ്റ്റ് സമർപ്പിക്കുക.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="submit pull request" />
|
|
|
|
ഉടൻ തന്നെ നിങ്ങളുടെ എല്ലാ മാറ്റങ്ങളും ഈ പ്രോജക്റ്റിൻ്റെ മാസ്റ്റർ ബ്രാഞ്ചിലേക്ക് ഞാൻ ലയിപ്പിക്കും. മാറ്റങ്ങൾ ലയിച്ചുകഴിഞ്ഞാൽ നിങ്ങൾക്ക് ഒരു അറിയിപ്പ് ഇമെയിൽ ലഭിക്കും.
|
|
|
|
## ഇവിടെ നിന്ന് എവിടെ പോകണം?
|
|
അഭിനന്ദനങ്ങൾ! നിങ്ങൾ ഒരു സംഭാവകൻ എന്ന നിലയിൽ പലപ്പോഴും കണ്ടുമുട്ടുന്ന സ്റ്റാൻഡേർഡ് _ഫോർക്ക് -> ക്ലോൺ -> എഡിറ്റ് -> PR_ വർക്ക്ഫ്ലോ പൂർത്തിയാക്കി!
|
|
|
|
[വെബ് ആപ്പ്](https://firstcontributions.github.io#social-share) എന്നതിലേക്ക് പോയി നിങ്ങളുടെ സംഭാവനകൾ ആഘോഷിക്കുകയും സുഹൃത്തുക്കളുമായും പിന്തുടരുന്നവരുമായും അത് പങ്കിടുകയും ചെയ്യുക.
|
|
|
|
നിങ്ങൾക്ക് എന്തെങ്കിലും സഹായം ആവശ്യമുണ്ടെങ്കിൽ അല്ലെങ്കിൽ എന്തെങ്കിലും ചോദ്യങ്ങൾ ഉണ്ടെങ്കിൽ ഞങ്ങളുടെ സ്ലാക്ക് ടീമിൽ ചേരാം. [സ്ലാക്ക് ടീമിൽ ചേരുക](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
|
|
|
### [അധിക മെറ്റീരിയൽ](../additional-material/git_workflow_scenarios/additional-material.md)
|
|
|
|
## മറ്റ് ടൂളുകൾ ഉപയോഗിച്ചുള്ള ട്യൂട്ടോറിയലുകൾ
|
|
|
|
[പ്രധാന താളിലേക്ക് മടങ്ങുക](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
|