Ayontika Pal
28 KiB
អានឯកសារនេះជា ភាសាផ្សេង.
ការរួមចំណែកជាលើកដំបូង
គម្រោងនេះមានគោលបំណងធ្វើឱ្យសាមញ្ញ និងណែនាំពីរបៀបដែលអ្នកចាប់ផ្តើមធ្វើការរួមចំណែកដំបូងរបស់ពួកគេ។ ប្រសិនបើអ្នកកំពុងស្វែងរកការរួមចំណែកដំបូងរបស់អ្នក សូមអនុវត្តតាមជំហានខាងក្រោម។
ប្រសិនបើអ្នកមិនសូវស្រួលជាមួយបន្ទាត់ពាក្យបញ្ជាទេ នេះគឺជាការបង្រៀនដោយប្រើឧបករណ៍ 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 |
គម្រោងនេះត្រូវបានគាំទ្រដោយ៖
