[![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![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) #### _អានឯកសារនេះជា [ភាសាផ្សេង](translations/Translations.md)._ [Shqip](translations/README.al.md) [Armenian](translations/README.arm.md) [Uzbek language](translations/README.uz.md) [Azərbaycan dili](translations/README.aze.md) [বাংলা](translations/README.bn.md) [Bulgarian](translations/README.bg.md) [Português (Brasil)](translations/README.pt_br.md) [Català](translations/README.ca.md) [中文 (Simplified)](translations/README.zh-cn.md) [Czech](translations/README.cs.md) [Deutsch](translations/README.de.md) [Dansk](translations/README.da.md) [العربية](translations/README.eg.md) [Dezéiriya](translations/README.dz.md) [Española](translations/README.es.md) [Française](translations/README.fr.md) [Gaeilge](translations/README.ga.md) [Galego](translations/README.gl.md) [Ελληνικά](translations/README.gr.md) [ქართული](translations/README.ge.md) [Magyar](translations/README.hu.md) [Bahasa Indonesia](translations/README.id.md) [עִברִית](translations/README.hb.md) [हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்](translations/Translations.md) [தமிழ்](translations/README.ta.md) [فارسی](translations/README.fa.md) [پښتو](translations/README.pus.md) [Italiano](translations/README.it.md) [日本語](translations/README.ja.md) [සිංහල](translations/README.si.md) [Kiswahili (Kenya)](translations/README.kws.md) [한국어](translations/README.ko.md) [Lietuvių kalba](translations/README.lt.md) [Limba Română Limba Română](translations/README.ro.md) [မြန်မာ](translations/README.mm_unicode.md) [Македонски](translations/README.mk.md) [Español de México](translations/README.mx.md) [Bahasa Melayu / بهاس ملايو‎ / Malay](translations/README.my.md) [Dutch](translations/README.nl.md) [Norsk](translations/README.no.md) [नेपाली](translations/README.np.md) [Wikang Filipino](translations/README.tl.md) [English (Pirate)](translations/README.en-pirate.md) [اردو](translations/README.ur.md) [Polski](translations/README.pl.md) [Português (Portugal)](translations/README.pt-pt.md) [Русский язык](translations/README.ru.md) [عربى](translations/README.ar.md) [Svenska](translations/README.se.md) [Slovenčina](translations/README.slk.md) [Slovenščina](translations/README.sl.md) [ภาษาไทย](translations/README.th.md) [Türkçe](translations/README.tr.md) [中文(Traditional)](translations/README.zh-tw.md) [Українська](translations/README.ua.md) [Tiếng Việt](translations/README.vn.md) [Swahili language](translations/README.sw.md) [Zulu (South Africa)](translations/README.zul.md) [Afrikaans (South Africa)](translations/README.afk.md) [Igbo (Nigeria)](translations/README.igb.md) [Yoruba (Nigeria)](translations/README.yor.md) [Hausa (Nigeria)](translations/README.hau.md) [Latvia](translations/README.lv.md) [Suomeksi](translations/README.fi.md) [Беларуская мова](translations/README.by.md) [Српски](translations/README.sr.md) [Қазақша](translations/README.kz.md) [Bosanski](translations/README.bih.md) [Bosanski](translations/README.bih.md) [Hrvatski](translations/README.hr.md) [پښتو](translations/README.ps.md) [Somalia](translations/README.so.md) [Ecuador](translations/README.ec.md) [Turkmen language](translations/README.tm.md) [Ewe (TOGO)](translations/README.ewe.md) [አማርኛ](translations/README.et.md) [ភាសាខ្មែរ](translations/README.kh.md) # ការរួមចំណែកជាលើកដំបូង គម្រោងនេះមានគោលបំណងធ្វើឱ្យសាមញ្ញ និងណែនាំពីរបៀបដែលអ្នកចាប់ផ្តើមធ្វើការរួមចំណែកដំបូងរបស់ពួកគេ។ ប្រសិនបើអ្នកកំពុងស្វែងរកការរួមចំណែកដំបូងរបស់អ្នក សូមអនុវត្តតាមជំហានខាងក្រោម។ _ប្រសិនបើអ្នកមិនសូវស្រួលជាមួយបន្ទាត់ពាក្យបញ្ជាទេ [នេះគឺជាការបង្រៀនដោយប្រើឧបករណ៍ GUI ។](#tutorials-using-other-tools)_ fork this repository #### ប្រសិនបើអ្នកមិនមាន git នៅលើម៉ាស៊ីនរបស់អ្នក [សូមដំឡើង](https://docs.github.com/en/get-started/quickstart/set-up-git). ## ស៊ាំសាខានេះ (Fork this repository) សូមស៊ាំសាខានេះដោយចុចលើប៊ូតុង Fork ដែលនៅផ្នែកខាងលើនៃទំព័រនេះ។ វានឹងបង្កើតច្បាប់ចម្លងនៃសាខានេះក្នុងគណនីរបស់អ្នក។ ## ចម្លងសាខានេះ (Clone the repository) clone this repository ឥឡូវនេះ ចម្លងសាខាដែលអ្នកបានស៊ាំទៅកាន់កុំព្យូទ័ររបស់អ្នក។ ចូលទៅគណនី GitHub របស់អ្នក បើកសាខាដែលបានស៊ាំ ចុចលើប៊ូតុង Code ហើយចុចលើរូបតំណាង​​ _copy to clipboard_។ បើក terminal ហើយដំណើរការពាក្យបញ្ជា git ខាងក្រោម៖ ```bash git clone "url you just copied" ``` កន្លែងដែល "url ដែលអ្នកទើបតែចម្លង" (ដោយគ្មានសញ្ញាសម្រង់) គឺជា url ទៅកាន់ឃ្លាំងនេះ (ចំនុចប្រសព្វរបស់អ្នកនៃគម្រោងនេះ)។ សូមមើលជំហានមុនដើម្បីទទួលបាន url ។ copy URL to clipboard ឧទាហរណ៍៖ ```bash git clone git@github.com:this-is-you/first-contributions.git ``` កន្លែងដែល `this-is-you` គឺជាឈ្មោះអ្នកប្រើប្រាស់ GitHub របស់អ្នក។ នៅទីនេះអ្នកកំពុងចម្លងមាតិកានៃឃ្លាំងការរួមចំណែកដំបូងនៅលើ GitHub ទៅកាន់កុំព្យូទ័ររបស់អ្នក។ ## បង្កើតសាខាថ្មី (Create a branch) ផ្លាស់ប្តូរទៅថតឃ្លាំងនៅលើកុំព្យូទ័ររបស់អ្នក (ប្រសិនបើអ្នកមិនទាន់នៅទីនោះ)៖ ```bash cd first-contributions ``` ឥឡូវបង្កើតសាខាមួយដោយប្រើពាក្យបញ្ជា 'git switch'៖ ```bash git switch -c your-new-branch-name ``` ឧទាហរណ៍៖ ```bash git switch -c add-alonzo-church ``` ## កែប្រែលើកែលម្អដែលចាំបាច់ និងធ្វើការប្តិត (commit) ប្រែប្រួលទាំងនោះ ឥឡូវនេះបើកឯកសារ 'Contributors.md' នៅក្នុងកម្មវិធីនិពន្ធអត្ថបទ បន្ថែមឈ្មោះរបស់អ្នកទៅវា។ កុំបន្ថែមវានៅដើម ឬចុងបញ្ចប់នៃឯកសារ។ ដាក់វានៅកន្លែងណាមួយនៅចន្លោះ។ ឥឡូវនេះរក្សាទុកឯកសារ។ git status ប្រសិនបើអ្នកចូលទៅកាន់ថតគម្រោង ហើយប្រតិបត្តិពាក្យបញ្ជា 'git status' អ្នកនឹងឃើញមានការផ្លាស់ប្តូរ។ បន្ថែមការផ្លាស់ប្តូរទាំងនោះទៅសាខាដែលអ្នកទើបតែបង្កើតដោយប្រើពាក្យបញ្ជា `git add`៖ ```bash git add Contributors.md ``` ឥឡូវនេះធ្វើការផ្លាស់ប្តូរទាំងនោះដោយប្រើពាក្យបញ្ជា 'git commit'៖ ```bash git commit -m "Add your-name to Contributors list" ``` ជំនួស 'ឈ្មោះរបស់អ្នក' ជាមួយឈ្មោះរបស់អ្នក។ ## ផ្តួលប្រែប្រួលទៅ GitHub (Push changes to GitHub) រុញការផ្លាស់ប្តូររបស់អ្នកដោយប្រើពាក្យបញ្ជា 'git push': ```bash git push -u origin your-branch-name ``` ជំនួស `your-branch-name` ជាមួយនឹងឈ្មោះសាខាដែលអ្នកបានបង្កើតមុន។
ប្រសិនបើអ្នកទទួលបានកំហុសណាមួយនៅពេលរុញ សូមចុចទីនេះ៖ - ### កំហុសនៅក្នុងការ Authentication (Authentication Error) 
remote: ការគាំទ្រសម្រាប់ការបញ្ចូលពាក្យសម្ងាត់ត្រូវបានដកហូតនៅថ្ងៃទី 13 ខែសីហា ឆ្នាំ 2021។ សូមប្រើ **Personal Access Token** ជំនួស។
  remote: សូមមើល https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ សម្រាប់ព័ត៌មានបន្ថែម។
  fatal: ការ Authenticate បរាជ័យសម្រាប់ 'https://github.com//first-contributions.git/'
សូមចូលទៅកាន់ [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ដើម្បីបង្កើត និងកំណត់រចនាសម្ព័ន្ធ SSH Key ទៅក្នុងគណនី GitHub របស់អ្នក។
## ដាក់បញ្ជូនការផ្លាស់ប្តូររបស់អ្នកសម្រាប់ការពិនិត្យ ប្រសិនបើអ្នកចូលទៅកាន់ឃ្លាំងរបស់អ្នកនៅលើ GitHub អ្នកនឹងឃើញប៊ូតុង 'Compare & pull request' ។ ចុចលើប៊ូតុងនោះ។ create a pull request ឥឡូវនេះដាក់សំណើទាញ។ submit pull request ឆាប់ៗនេះ ខ្ញុំនឹងបញ្ចូលការផ្លាស់ប្តូររបស់អ្នកទាំងអស់ទៅក្នុងសាខាចម្បងនៃគម្រោងនេះ។ អ្នកនឹងទទួលបានអ៊ីមែលជូនដំណឹង នៅពេលដែលការផ្លាស់ប្តូរត្រូវបានបញ្ចូលគ្នា។ ## តើត្រូវទៅណាពីទីនេះ? អបអរសាទរ! អ្នកទើបតែបានបញ្ចប់ស្តង់ដារ _fork -> clone -> edit -> pull request_ workflow ដែលអ្នកនឹងជួបប្រទះជាញឹកញាប់ក្នុងនាមជាអ្នករួមចំណែក! អបអរសាទរការរួមចំណែករបស់អ្នក ហើយចែករំលែកវាជាមួយមិត្តភក្តិ និងអ្នកដើរតាមរបស់អ្នកដោយចូលទៅកាន់ [កម្មវិធីគេហទំព័រ](https://firstcontributions.github.io/#social-share). អ្នកអាចចូលរួមជាមួយក្រុម slack របស់យើង ប្រសិនបើអ្នកត្រូវការជំនួយ ឬមានសំណួរណាមួយ។ [ចូលរួមក្រុម slack](https://firstcontributors.slack.com/join/shared_invite/zt-29qhyr9lt-Bi7WLbgGIFqV7aCEG_grvg#/shared-invite/email). ឥឡូវនេះ ចូរអ្នកចាប់ផ្តើមជាមួយនឹងការរួមចំណែកដល់គម្រោងផ្សេងទៀត។ យើងបានចងក្រងបញ្ជីគម្រោងដែលមានបញ្ហាងាយស្រួលដែលអ្នកអាចចាប់ផ្តើមបាន។ ពិនិត្យមើល [បញ្ជីគម្រោងក្នុងកម្មវិធីបណ្ដាញ](https://firstcontributions.github.io/#project-list). ### [សម្ភារៈបន្ថែម](additional-material/git_workflow_scenarios/additional-material.md) ## ការបង្រៀនដោយប្រើឧបករណ៍ផ្សេងទៀត | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [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) |

គម្រោងនេះត្រូវបានគាំទ្រដោយ៖