README.kh.md

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

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

ប្រសិនបើអ្នកមិនដឹងពីរបៀបប្រើបន្ទាត់ពាក្យបញ្ជា hនេះគឺជាការបង្រៀនសម្រាប់ឧបករណ៍ GUI

ប្រសិនបើអ្នកមិនមាន git នៅលើម៉ាស៊ីនរបស់អ្នក។, ទាញយកនិងដំឡើងវា។ទាញយកនិងដំឡើងវា។

បំបែកឯកសារនេះ។

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

ក្លូនឯកសារ

ឥឡូវនេះក្លូនឯកសារទៅម៉ាស៊ីនរបស់អ្នក។ ចូលទៅកាន់គណនី GitHub របស់អ្នក។ បើកឯកសារ ចុចលើប៊ូតុងកូដ ហើយបន្ទាប់មកចុចលើរូបតំណាងចម្លងទៅក្ដារតម្បៀតខ្ទាស់។

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

git clone "url you just copied"

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

ឧទាហរណ៍:

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

ដែល this-is-you គឺជា username នៃគណនី GitHub របស់អ្នក ។ ធ្វើដូចនេះ មានន័យថាអ្នកកំពុងចម្លង contents នៃ​ first-contributions repository នៅលើ GitHub ចូលទៅក្នុងកុំព្យូទ័ររបស់អ្នក ។

បង្កើត branch ថ្មី

សូមចូលទៅកាន់ folder នៃ repository ដែលអ្នកទើបតែចម្លង (ប្រសិនបើអ្នកមិននៅក្នុង folder នោះ):

cd first-contributions

បន្ទាប់មកបង្កើត branch ថ្មីដោយប្រើប្រាស់ command git checkout:

git checkout -b your-new-branch-name

ឧទាហរណ៍:

git checkout -b add-alonzo-church

(ឈ្មោះសាខាមិនចាំបាច់មានពាក្យបន្ថែមនៅក្នុងវាទេ ប៉ុន្តែវាជារឿងសមហេតុផលក្នុងការបញ្ចូល ព្រោះគោលបំណងនៃសាខានេះគឺដើម្បីបន្ថែមឈ្មោះរបស់អ្នកទៅក្នុងបញ្ជី។)

ធ្វើការផ្លាស់ប្តូរជាចាំបាច់ ហើយធ្វើការផ្លាស់ប្តូរទាំងនោះ

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

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

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

git add Contributors.md

រួច commit វាដោយប្រើប្រាស់ command git commit:

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

ជំនួសឈ្មោះ <your-name> ដោយឈ្មោះរបស់អ្នក។

បន្ថែមការផ្លាស់ប្តូរទៅ GitHub

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

git push origin <add-your-branch-name>

ដោយប្តូរ <add-your-branch-name> ជាមួយនឹងឈ្មោះ branch ដែលអ្នកបានបង្កើតមុននេះ ។

ដាក់ស្នើកំណែប្រែថ្មីដើម្បីឲ្យគេត្រួតពិនិត្យ

ប្រសិនបើអ្នកចូលទៅកាន់ repository របស់អ្នកនៅលើ GitHub នោះអ្នកនឹងឃើញប៊ូតុងមួយដាក់ថា Compare & pull request ។ សូមចុចលើប៊ូតុងនោះ!

ឥឡូវសូមធ្វើការដាក់ស្នើ pull request!

បន្ទាប់មករង់ចាំបន្តិចនោះគេនឹង merge កំណែប្រែថ្មីរបស់អ្នកចូលទៅកាន់ branch​ master នៃ project នេះ​ ។ អ្នកនឺងទទួលបាន email បន្ទាប់ពីគេបានដាក់បញ្ចូលកំណែប្រែថ្មីរបស់អ្នករួចរាល់ ។

បន្ទាប់មកធ្វើអីទៀត?

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

ធ្វើការអបអរ contribution របស់អ្នកដោយ share វាជាមួយមិត្តភក្តិនិង followers តាមរយៈ web app.

អ្នកអាចចូលរួមជាមួយយើងនៅលើ Slack ប្រសិនបើអ្នកត្រូវការជំនួយឫមានសំណួរ Join slack team.

អ្នកអាចចាប់ផ្តើមធ្វើការ contribute ជាមួយ project ផ្សេងៗទៀតដែលយើងចងក្រងមកដែលសុទ្ធសឹងជា issue ងាយៗដែលអ្នកអាចចាប់ផ្តើមជាមួយវាបាន ។ សូមសំណាងល្អណា បញ្ជីនៃ project នៅលើ web app.

Material បន្ថែម

របៀបប្រើប្រាស់ Tools ផ្សេងៗទៀត

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