README.kh.md

អានឯកសារនេះជា ភាសាផ្សេង.

ការរួមចំណែកជាលើកដំបូង

គម្រោងនេះមានគោលបំណងធ្វើឱ្យសាមញ្ញ និងណែនាំពីរបៀបដែលអ្នកចាប់ផ្តើមធ្វើការរួមចំណែកដំបូងរបស់ពួកគេ។ ប្រសិនបើអ្នកកំពុងស្វែងរកការរួមចំណែកដំបូងរបស់អ្នក សូមអនុវត្តតាមជំហានខាងក្រោម។

ប្រសិនបើអ្នកមិនសូវស្រួលជាមួយបន្ទាត់ពាក្យបញ្ជាទេ នេះគឺជាការបង្រៀនដោយប្រើឧបករណ៍ GUI ។

ប្រសិនបើអ្នកមិនមាន git នៅលើម៉ាស៊ីនរបស់អ្នក សូមដំឡើង.

ស៊ាំសាខានេះ (Fork this repository)

សូមស៊ាំសាខានេះដោយចុចលើប៊ូតុង Fork ដែលនៅផ្នែកខាងលើនៃទំព័រនេះ។ វានឹងបង្កើតច្បាប់ចម្លងនៃសាខានេះក្នុងគណនីរបស់អ្នក។

ចម្លងសាខានេះ (Clone the repository)

ឥឡូវនេះ ចម្លងសាខាដែលអ្នកបានស៊ាំទៅកាន់កុំព្យូទ័ររបស់អ្នក។ ចូលទៅគណនី GitHub របស់អ្នក បើកសាខាដែលបានស៊ាំ ចុចលើប៊ូតុង Code ហើយចុចលើរូបតំណាង​​ copy to clipboard។

បើក terminal ហើយដំណើរការពាក្យបញ្ជា git ខាងក្រោម៖

git clone "url you just copied"

កន្លែងដែល "url ដែលអ្នកទើបតែចម្លង" (ដោយគ្មានសញ្ញាសម្រង់) គឺជា url ទៅកាន់ឃ្លាំងនេះ (ចំនុចប្រសព្វរបស់អ្នកនៃគម្រោងនេះ)។ សូមមើលជំហានមុនដើម្បីទទួលបាន url ។

ឧទាហរណ៍៖

git clone git@github.com:this-is-you/first-contributions.git

កន្លែងដែល this-is-you គឺជាឈ្មោះអ្នកប្រើប្រាស់ GitHub របស់អ្នក។ នៅទីនេះអ្នកកំពុងចម្លងមាតិកានៃឃ្លាំងការរួមចំណែកដំបូងនៅលើ GitHub ទៅកាន់កុំព្យូទ័ររបស់អ្នក។

បង្កើតសាខាថ្មី (Create a branch)

ផ្លាស់ប្តូរទៅថតឃ្លាំងនៅលើកុំព្យូទ័ររបស់អ្នក (ប្រសិនបើអ្នកមិនទាន់នៅទីនោះ)៖

cd first-contributions

ឥឡូវបង្កើតសាខាមួយដោយប្រើពាក្យបញ្ជា 'git switch'៖

git switch -c your-new-branch-name

ឧទាហរណ៍៖

git switch -c add-alonzo-church

កែប្រែលើកែលម្អដែលចាំបាច់ និងធ្វើការប្តិត (commit) ប្រែប្រួលទាំងនោះ

ឥឡូវនេះបើកឯកសារ 'Contributors.md' នៅក្នុងកម្មវិធីនិពន្ធអត្ថបទ បន្ថែមឈ្មោះរបស់អ្នកទៅវា។ កុំបន្ថែមវានៅដើម ឬចុងបញ្ចប់នៃឯកសារ។ ដាក់វានៅកន្លែងណាមួយនៅចន្លោះ។ ឥឡូវនេះរក្សាទុកឯកសារ។

ប្រសិនបើអ្នកចូលទៅកាន់ថតគម្រោង ហើយប្រតិបត្តិពាក្យបញ្ជា 'git status' អ្នកនឹងឃើញមានការផ្លាស់ប្តូរ។

បន្ថែមការផ្លាស់ប្តូរទាំងនោះទៅសាខាដែលអ្នកទើបតែបង្កើតដោយប្រើពាក្យបញ្ជា git add៖

git add Contributors.md

ឥឡូវនេះធ្វើការផ្លាស់ប្តូរទាំងនោះដោយប្រើពាក្យបញ្ជា 'git commit'៖

git commit -m "Add your-name to Contributors list"

ជំនួស 'ឈ្មោះរបស់អ្នក' ជាមួយឈ្មោះរបស់អ្នក។

ផ្តួលប្រែប្រួលទៅ GitHub (Push changes to GitHub)

រុញការផ្លាស់ប្តូររបស់អ្នកដោយប្រើពាក្យបញ្ជា 'git push':

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 ដើម្បីបង្កើត និងកំណត់រចនាសម្ព័ន្ធ SSH Key ទៅក្នុងគណនី GitHub របស់អ្នក។

ដាក់បញ្ជូនការផ្លាស់ប្តូររបស់អ្នកសម្រាប់ការពិនិត្យ

ប្រសិនបើអ្នកចូលទៅកាន់ឃ្លាំងរបស់អ្នកនៅលើ GitHub អ្នកនឹងឃើញប៊ូតុង 'Compare & pull request' ។ ចុចលើប៊ូតុងនោះ។

ឥឡូវនេះដាក់សំណើទាញ។

ឆាប់ៗនេះ ខ្ញុំនឹងបញ្ចូលការផ្លាស់ប្តូររបស់អ្នកទាំងអស់ទៅក្នុងសាខាចម្បងនៃគម្រោងនេះ។ អ្នកនឹងទទួលបានអ៊ីមែលជូនដំណឹង នៅពេលដែលការផ្លាស់ប្តូរត្រូវបានបញ្ចូលគ្នា។

តើត្រូវទៅណាពីទីនេះ?

អបអរសាទរ! អ្នកទើបតែបានបញ្ចប់ស្តង់ដារ fork -> clone -> edit -> pull request workflow ដែលអ្នកនឹងជួបប្រទះជាញឹកញាប់ក្នុងនាមជាអ្នករួមចំណែក!

អបអរសាទរការរួមចំណែករបស់អ្នក ហើយចែករំលែកវាជាមួយមិត្តភក្តិ និងអ្នកដើរតាមរបស់អ្នកដោយចូលទៅកាន់ កម្មវិធីគេហទំព័រ.

អ្នកអាចចូលរួមជាមួយក្រុម slack របស់យើង ប្រសិនបើអ្នកត្រូវការជំនួយ ឬមានសំណួរណាមួយ។ ចូលរួមក្រុម slack.

ឥឡូវនេះ ចូរអ្នកចាប់ផ្តើមជាមួយនឹងការរួមចំណែកដល់គម្រោងផ្សេងទៀត។ យើងបានចងក្រងបញ្ជីគម្រោងដែលមានបញ្ហាងាយស្រួលដែលអ្នកអាចចាប់ផ្តើមបាន។ ពិនិត្យមើល បញ្ជីគម្រោងក្នុងកម្មវិធីបណ្ដាញ.

សម្ភារៈបន្ថែម

ការបង្រៀនដោយប្រើឧបករណ៍ផ្សេងទៀត

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

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