msb-public
/
Web-Dev-For-Beginners
mirror of https://github.com/microsoft/Web-Dev-For-Beginners.git
1
0
Code Issues Projects Releases Wiki Activity

chore(i18n): sync translations with latest source changes (chunk 1/1, 2 changes)

Browse Source
pull/1793/head
localizeflow[bot] 5 months ago
parent b82e39c5ad
commit 08efa3b0e3
2 changed files with 217 additions and 217 deletions
Show Stats Download Patch File Download Diff File

2
translations/km/.co-op-translator.json
Unescape View File

@ -487,7 +487,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T19:04:32+00:00", "translation_date": "2026-04-20T16:26:54+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "km" "language_code": "km"
}, },

432
translations/km/AGENTS.md
Unescape View File

@ -1,30 +1,30 @@
# AGENTS.md # AGENTS.md
## ទិដ្ឋភាព​សេចក្តី​សង្ខេប​គម្រោង ## ពិភាក្សាពីគម្រោង
នេះគឺជាគណនីយោបល់វគ្គសិក្សា​សម្រាប់បង្ហាញមូលដ្ឋានអភិវឌ្ឍន៍គេហទំព័រដល់អ្នកចុងក្រោយ។ វគ្គសិក្សានេះជាវគ្គសិក្សា​ពេញលេញរយៈពេល ១២ សប្តាហ៍ដែលបានបង្កើតដោយ Microsoft Cloud Advocates មានមេរៀន ២៤ វគ្គដែលផ្តោតលើ JavaScript, CSS និង HTML។ នេះជាឃ្លាំងមេរៀនសិក្សាសម្រាប់បង្រៀនមូលដ្ឋាននៃការអភិវឌ្ឍវែបដល់អ្នកចាប់ផ្តើម។ មេរៀននេះជាកម្មវិធីសិក្សាពេញលេញរយៈពេល ១២ សប្តាហ៍ ដែលបានបង្កើតឡើងដោយអ្នករៀបចំកម្មវិធី Microsoft Cloud Advocates មានមេរៀនទាំងស្រុង ២៤ នៅក្នុងគម្រោងអនុវត្តន៍ដែលគ្របដណ្តប់លើ JavaScript, CSS និង HTML។
### ធាតុសំខាន់ៗ ### ផ្នែកសំខាន់ៗ
- **មាតិកាអប់រំ**៖ មេរៀន ២៤ វគ្គដែលបានរៀបចំក្នុងម៉ូឌុលផ្អែកលើគម្រោង - **មាតិកាសិក្សា**៖ មេរៀន ២៤ ដែលមានរចនាសម្ព័ន្ធ ក្នុងម៉ូឌុលមូលដ្ឋានគម្រោង
- **គម្រោងយ៉ាងជាក់ស្តែង**៖ Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, និង AI Chat Assistant - **គម្រោងអនុវត្តន៍**៖ Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor និង AI Chat Assistant
- **ការប្រលងអន្តរកម្ម**៖ ការប្រលង ៤៨ ប្រការ មួយក្នុងនីមួយៗមានសំណួរ ៣ (ការវាយតម្លៃមុន/ក្រោយមេរៀន) - **វិញ្ញាសាបែបមានអន្តរកម្ម**៖ វិញ្ញាសា ៤៨ ដែលមាន ៣ សំណួរក្នុងមួយវិញ្ញាសា (ប៉ុន្មានមុន / បន្ទាប់មេរៀន)
- **គាំទ្រភាសាច្រើន**៖ បកប្រែកម្មវិធីស្វ័យប្រវត្តិនៅក្នុងភាសាច្រើនជាង ៥០ ជាមួយ GitHub Actions - **គាំទ្រភាសាច្រើន**៖ បកប្រែដោយស្វ័យប្រវត្តិជាង ៥០ ភាសា តាមរយៈ GitHub Actions
- **បច្ចេកវិទ្យា**៖ HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (សម្រាប់គម្រោង AI) - **បច្ចេកវិទ្យា**៖ HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (សម្រាប់គម្រោង AI)
### សំណុំបែបបទ ### វិស្វកម្ម
- គណនីយោបល់អប់រំដែលមានរចនាសម្ព័ន្ធផ្អែកលើមេរៀន - ឃ្លាំងសម្រាប់ការសិក្សា ជារចនាសម្ព័ន្ធមេរៀន
- ការភ្ជាប់មេរៀននីមួយៗមាន README, ឧទាហរណ៍កូដ និងដំណោះស្រាយ - តំបន់មេរៀននីមួយៗមាន README, ឧទាហរណ៍កូដ និងដំណោះស្រាយ
- គម្រោងឯករាជ្យក្នុងថតប្រៀបប្រដាប់ផ្សេងទៀត (quiz-app, គម្រោងវគ្គផ្សេងៗ) - គម្រោងឯកាពេញខុសគ្នា (quiz-app, គម្រោងមេរៀនផ្សេងៗ)
- ប្រព័ន្ធបកប្រែប្រើ GitHub Actions (co-op-translator) - ប្រព័ន្ធបកប្រែដោយ GitHub Actions (co-op-translator)
- เอกสารបែបគេហទំព័រដោយ Docsify ហើយអាចរកបានជា PDF - ឯកសារបង្ហាញតាម Docsify និងមានជាទម្រង់ PDF
## ពាក្យ​បញ្ជា​បង្កើត​បរិស្ថាន ## ពាក្យបញ្ជា Setup
គណនីនេះគឺ​សម្រាប់​ផ្តល់​មាតិកាអប់រំនៅ​ជា​ចម្បង។ សម្រាប់ធ្វើការ​ជាមួយគម្រោងជាក់លាក់៖ ឃ្លាំងនេះសំរាប់ការប្រើប្រាស់មាតិកាសិក្សាសម្រាប់សិស្ស។ សម្រាប់ធ្វើការអនុវត្តន៍ជាមួយគម្រោងពិសេស៖
### ការតំឡើង​គណនីជាមេដ្ឋាន ### ការតំឡើងឃ្លាំងមេ
```bash ```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -36,159 +36,159 @@ cd Web-Dev-For-Beginners
```bash ```bash
cd quiz-app cd quiz-app
npm install npm install
npm run dev # ចាប់ផ្តើមម៉ាស៊ីនបម្រើអភិវឌ្ឍន៍ npm run dev # ដំណើរការផ្ទុកបង្កើតសេវាកម្ម
npm run build # សង់សម្រាប់ផលិតកម្ម npm run build # សាងសង់សម្រាប់ផលិតកម្ម
npm run lint # ប្រតិបត្តិ ESLint npm run lint # រត់ ESLint
``` ```
### API គម្រោងធនាគារ (Node.js + Express) ### Banking Project API (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm install npm install
npm start # ចាប់ផ្តើមម៉ាស៊ីនបម្រើ API npm start # ចាប់ផ្តើមម៉ាស៊ីនបម្រើ API
npm run lint # ដំណើរការ ESLint npm run lint # ដំណើរការ ESLint
npm run format # រៀបចំដោយ Prettier npm run format # ទ្រង់ទ្រាយជាមួយ Prettier
``` ```
### គម្រោងបន្ថែម Browser Extension ### គម្រោង Browser Extension
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# អនុវត្តន៍​នីតិវិធី​ផ្ទុក​ផ្នែកបន្ថែម​ដែលផ្ទាល់ខ្លួន​សម្រាប់កម្មវិធីរុករក។ # អនុវត្តតាមការណែនាំការផ្ទុកបន្ថែមដែលជាក់លាក់ទ្វារទស្សនា
``` ```
### គម្រោងហ្គេម Space Game ### គម្រោង Space Game
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
npm install npm install
# បើក index.html ក្នុងកម្មវិធីទស្សនាកំរិត ឬប្រើ Live Server # បើក index.html នៅក្នុងកម្មវិធីរុករក ឬប្រើ Live Server
``` ```
### គម្រោងជជែក Chat Project (Python Backend) ### គម្រោង Chat (Python Backend)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
pip install openai pip install openai
# កំណត់អថេរ PÉPOTE_GITHUB_TOKEN ទៅក្នុងបរិយាកាស # កំណត់អថេរបរិបទ GITHUB_TOKEN
python api.py python api.py
``` ```
## វិធីសាស្រ្តអភិវឌ្ឍន៍ ## ដំណើរការអភិវឌ្ឍ
### សម្រាប់អ្នកចូលរួមផ្គត់ផ្គង់មាតិកា ### សម្រាប់អ្នកចូលរួមដាក់ទិន្នន័យ
1. **Fork គណនីនេះ** ទៅគណនី GitHub របស់អ្នក 1. **ចម្លងឃ្លាំងនេះ** ទៅទៅគណនី GitHub របស់អ្នក
2. **Clone fork របស់អ្នក** ទៅក្នុងម៉ាស៊ីនភ្លាម 2. **ចម្លងបង្កើតទីតាំងក្នុងម៉ាស៊ីនប័ណ្ណ** របស់អ្នក
3. **បង្កើតសាខាថ្មី** សម្រាប់បម្រែបម្រួលរបស់អ្នក 3. **បង្កើតសាខាថ្មី** សម្រាប់ការផ្លាស់ប្តូររបស់អ្នក
4. ប្រែប្រួលមាតិកាមេរៀន ឬ ឧទាហរណ៍កូដ 4. បង្កើតកំណែប្រែខ្លះៗលើមាតិកាមេរៀន ឬឧទាហរណ៍កូដ
5. សាកល្បងកូដនៅក្នុងថតគម្រោងដែលពាក់ព័ន្ធ 5. សាកល្បងកូដនៅក្នុងថតគម្រោងពាក់ព័ន្ធ
6. ដាក់ការស្នើសុំ PR តាមប្រតិបត្តិការចូលរួម 6. បញ្ចូន pull requests ទៅតាមកម្រិតការចូលរួម
### សម្រាប់អ្នករៀន ### សម្រាប់អ្នករៀន
1. Fork ឬ clone គណនីនេះ 1. ចម្រាស់ឬចម្លងឃ្លាំងនេះ
2. រៀបចំទៅកាន់ថតវគ្គសិក្សាលំដាប់គ្នា 2. ចូលទៅថតមេរៀនដោយជាប់លំដាប់
3. អានឯកសារ README នៃមេរៀននីមួយៗ 3. អានឯកសារ README នីមួយៗ
4. បញ្ចប់ការប្រលងមុនមេរៀន នៅ https://ff-quizzes.netlify.app/web/ 4. បញ្ចប់វិញ្ញាសាមុនមេរៀន នៅ https://ff-quizzes.netlify.app/web/
5. ធ្វើឧទាហរណ៍កូដក្នុងថតមេរៀន 5. អនុវត្តឧទាហរណ៍កូដនៅថតមេរៀន
6. សម្រេចបញ្ហា​និងបញ្ហាតស៊ូមាត្រ 6. បញ្ចប់ការងារនិងសំណួរប្រកួតប្រជែង
7. ធ្វើការប្រលងបន្ទាប់មកបន្ទប់មេរៀន 7. ធ្វើវិញ្ញាសាបន្ទាប់មេរៀន
### ការអភិវឌ្ឍបន្តផ្ទាល់ ### អភិវឌ្ឍបន្តផ្ទាល់
- **ឯកសារ**៖ រត់ `docsify serve` នៅថតគ្រប់គ្រង (ផត ៣០០០) - **ឯកសារ**៖ រត់ `docsify serve` នៅថតឫស (port 3000)
- **Quiz App**៖ រត់ `npm run dev` នៅក្នុងថត quiz-app - **Quiz App**៖ រត់ `npm run dev` នៅថត quiz-app
- **គម្រោង**៖ ប្រើ VS Code Live Server extension សំរាប់គម្រោង HTML - **គម្រោង**៖ ប្រើ VS Code Live Server សម្រាប់គម្រោង HTML
- **API គម្រោង**៖ រត់ `npm start` នៅក្នុងថត API ដែលសមរម្យ - **គម្រោង API**៖ រត់ `npm start` នៅថត API ពាក់ព័ន្ធ
## ការណែនាំតេស្ត ## សេចក្ដីណែនាំសម្រាប់ការប្រឡង
### ការតេស្ត Quiz App ### ការសាកល្បង Quiz App
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # ตรวจสอบបញ្ហារចនាសម្ព័ន្ធកូដ npm run lint # ពិនិត្យមើលចំពោះបញ្ហាសំរាប់រចនាប័ទ្មកូដ
npm run build # ពិនិត្យមើលការបង្កើតបានជោគជ័យ npm run build # បញ្ជាក់ការសម្រេចការបង្កើតបានជោគជ័យ
``` ```
### ការតេស្ត API ធនាគារ ### ការសាកល្បង Bank API
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # ពិនិត្យរកបញ្ហារចនារបស់កូដ npm run lint # ពិនិត្យសម្រាប់បញ្ហារចនាប័ទ្មកូដ
node server.js # ផ្ទៀងផ្ទាត់ម៉ាស៊ីនបម្រើចាប់ផ្តើមដោយគ្មានកំហុស node server.js # ផ្ទៀងផ្ទាត់ថារត្ន័មិនមានកំហុសក្នុងការចាប់ផ្តើម
``` ```
### វិធីសាស្ត្រតេស្តទូទៅ ### វិធីសាស្ត្រសាកល្បងទូទៅ
- គណនីនេះគឺ​សម្រាប់អប់រំនិងមិនមានតេស្តស្វ័យប្រវត្តិត្រឹមត្រូវទាំងមូល - នេះជាឃ្លាំងសិក្សាទេ មិនមានសាកល្បងស្វ័យប្រវត្តិពេញលេញទេ
- តេស្ត​ដោយដៃផ្តោតលើ: - ការសាកល្បងដៃផ្តោតលើ៖
- ឧទាហរណ៍កូដដំណើរការដោយគ្មានកំហុស - កូដទាំងអស់រត់បានដោយគ្មានកំហុស
- តំណភ្ជាប់ក្នុងឯកសារពិតប្រាកដ - គំនែក្នុងឯកសារដំណើរការបានត្រឹមត្រូវ
- ការបង្កើតគម្រោងបានជោគជ័យ - ការបង្កើតគម្រោងបានជោគជ័យ
- ការដើរតាមបែងចែស្តង់ដារល្អ - ឧទាហរណ៍បច្ចេកទេសត្រូវបានគោរព
### ការត្រួតពិនិត្យមុនដាក់ស្នើ ### ពិនិត្យមុនបញ្ចូន
- ដំណើរការ `npm run lint` ក្នុងថតដែលមាន package.json - រត់ `npm run lint` នៅថតដែលមាន package.json
- បញ្ជាក់ថាតំណMarkdown តំណដែលមានសុពលភាព - ផ្ទៀងផ្ទាត់តំណភ្ជាប់ markdown មានសុពលភាព
- សាកល្បងឧទាហរណ៍កូដនៅក្នុងប្រ្វៅសើរឬ Node.js - စាកពិនិត្យឧទាហរណ៍កូដ នៅក្នុងកម្មវិធីរុករកឬ Node.js
- ពិនិត្យថាការបកប្រែមិនបំផ្លាញរចនាសម្ព័ន្ធ - ពិនិត្យថាបកប្រែរក្សារចនាសម្ព័ន្ធត្រឹមត្រូវ
## ស្តង់ដារស្ទាយកូដ ## គោលការណ៍ស្ទីលកូដ
### JavaScript ### JavaScript
- ប្រើវីធីសាស្ត្រថ្មី ES6+ - ប្រើរចនាសម្ព័ន្ធ ES6+
- អនុវត្ត ESLint ធម្មតា​ដែលបានផ្តល់នៅគម្រោង - ធ្វើតាមការកំណត់ ESLint នៅក្នុងគម្រោង
- ប្រើឈ្មោះអថេរនិងមុខងារដែលមានន័យសម្រាប់ការអប់រំ - ប្រើឈ្មោះអថេរនិងមុខងារមានន័យសម្រាប់ការអប់រំ
- បន្ថែមមតិយោបល់ពណ៌នាគន្លងសម្រាប់អ្នករៀន - បន្ថែមកំណត់ចំណាំអំពីមូលដ្ឋានដើម្បីជួយអ្នករៀន
- រៀបចំដោយ Prettier នៅកន្លែងបានកំណត់ - បង្ហាញក្នុងប្រព័ន្ធ Prettier ពេលមានកំណត់
### HTML/CSS ### HTML/CSS
- ប្រើធាតុ HTML5 ដូចគ្នា - ធាតុ HTML5 មានន័យសំខាន់
- គោលការណ៍រចនារូបភាពឆ្លាតវៃ - គោលការណ៍រចនាបែបឆ្លាតវៃ
- គោលការណ៍ច្បាស់លាស់ក្នុងការកំណត់ឈ្មោះ class - ឈ្មោះថ្នាក់ដែលច្បាស់លាស់
- មតិយោបល់ពន្យល់បច្ចេកទេស CSS សម្រាប់អ្នករៀន - កំណត់ចំណាំបង្ហាញបច្ចេកទេស CSS សម្រាប់អ្នករៀន
### Python ### Python
- គោលការណ៍ស្ទាយ PEP 8 - គោលការណ៍ស្ទីល PEP 8
- ឧទាហរណ៍កូដសិក្សាច្បាស់លាស់ - ឧទាហរណ៍កូដច្បាស់លាស់ និងផ្តោតលើការអប់រំ
- ការបង្ហាញប្រភេទតាមតម្រូវការសម្រាប់ការរៀន - ចំណាំប្រភេទនៅកន្លែងមានប្រយោជន៍សម្រាប់ការសិក្សា
### ឯកសារបែប Markdown ### ឯកសារម៉ាគដោន
- ឋានៈច្បាស់ក្នុងចំណងជើង - រចនាសម្ព័ន្ធក្បាលច្បាស់លាស់
- ប្លុកកូដមានការបញ្ជាក់ភាសា - ប្លុកកូដមានកំណត់ភាសា
- តំណទៅកាន់ធនធានបន្ថែម - តំណទៅកាន់ធនធានបន្ថែម
- រូបភាពនិង​ស្ក្រីនស៊ុតនៅក្នុងថត `images/` - រូបភាព និងផ្ទាំងរូបនៅថត `images/`
- អក្សរប្រើសម្រាប់រូបភាពដើម្បីអនុវត្តសមត្ថភាពចូលដំណើរការ - ចំណងជើងរូបភាពសម្រាប់ការចូលដល់អត្តសញ្ញាណ
### ការរៀបចំឯកសារ ### រៀបចំឯកសារ
- វគ្គសិក្សាចំនួនរៀបចំពីទំរង់ (1-getting-started-lessons, 2-js-basics, ល.ហ) - មេរៀនត្រូវបានលេខរៀងជាលំដាប់ (1-getting-started-lessons, 2-js-basics, ...)
- គម្រោងមួយៗមានផ្ទាំង `solution/` និងភាគច្រើនមាន `start/` ឬ `your-work/` - គម្រោងនីមួយៗមានថត `solution/` និងភាគច្រើនមាន `start/` ឬ `your-work/`
- រូបភាពផ្ទុកក្នុងថត `images/` ផ្តោតលើមេរៀន - រូបភាពរក្សាទុកក្នុងថត `images/` របស់មេរៀននីមួយៗ
- ការបកប្រែក្នុងថត `translations/{language-code}/` - បកប្រែថតក្នុង `translations/{language-code}/`
## ការបង្កើតនិងចេញផ្សាយ ## ការបង្កើត និងការចាក់ផ្សាយ
### ការចេញផ្សាយ Quiz App (Azure Static Web Apps) ### ការចាក់ផ្សាយ Quiz App (Azure Static Web Apps)
Quiz App ត្រូវបានកំណត់សម្រាប់ការចេញផ្សាយ Azure Static Web Apps៖ quiz-app ត្រូវបានកំណត់សម្រាប់ចាក់ផ្សាយ Azure Static Web Apps:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # បង្កើតថត dist/ npm run build # បង្កើតថត dist/
# ប្រើប្រាស់ការបំពេញតាមកម្មវិធី GitHub Actions នៅពេលចុចដាក់ទៅ main # ចាក់ផ្សាយតាមរយៈដំណើរការងារប្រតិបត្តិ GitHub Actions នៅពេលបញ្ចូនទៅ main
``` ```
ការកំណត់ពិសេស Azure Static Web Apps: កំណត់ Azure Static Web Apps៖
- **ទីតាំងកម្មវិធី**: `/quiz-app` - **ទីតាំងកម្មវិធី**: `/quiz-app`
- **ទីតាំងចេញ**: `dist` - **ទីតាំងចេញ**: `dist`
- **ប្រតិបត្តិការ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **ប្រតិបត្តិការ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
@ -200,83 +200,83 @@ npm install # ដំឡើង docsify-to-pdf
npm run convert # បង្កើត PDF ពី docs npm run convert # បង្កើត PDF ពី docs
``` ```
### ឯកសារ Docsify ### ឯកសារដោយ Docsify
```bash ```bash
npm install -g docsify-cli # តំឡើង Docsify ជាសកល npm install -g docsify-cli # ដំឡើង Docsify សាកលវិជ្ជា
docsify serve # បម្រើលើ localhost:3000 docsify serve # បម្រើនៅលើ localhost:3000
``` ```
### ការបង្កើតគម្រោងជាក់លាក់ ### ការបង្កើតគម្រោងជាពិសេស
ថតគម្រោងនីមួយៗអាចមានដំណើរការបង្កើតរបស់ខ្លួន៖ ថតគម្រោងនីមួយៗអាចមានដំណើរការបង្កើតខ្លួនឯង៖
- គម្រោង Vue: `npm run build` បង្កើតគ្រឿងបន្លាស់ផលិតកម្ម - គម្រោង Vue៖ `npm run build` បង្កើតកញ្ចប់ផលិតកម្ម
- គម្រោងស្តាត៖ គ្មានជំហានបង្កើត ប្រើសេវាទាញយកឯកសារដែលមាន - គម្រោងជារបស់ស្ថិតិ៖ មិនមានដំណើរការបង្កើត ធ្វើសេវាទៅឯកសារផ្ទាល់ចុះ
## មគ្គុទេសក៍ការស្នើសុំ PR ## ការណែនាំសម្រាប់ Pull Request
### ទំរង់ចំណងជើង ### រចនាបទចំណងជើង
ប្រើចំណងជើងច្បាស់ដែលបង្ហាញផ្នែកដែលបានផ្លាស់ប្តូរ៖ ប្រើចំណងជើងច្បាស់លាស់ សំដៅការផ្លាស់ប្តូរយ៉ាងច្បាស់៖
- `[Quiz-app] បន្ថែមការប្រលងថ្មីសម្រាប់មេរៀន X` - `[Quiz-app] បន្ថែមវិញ្ញាសាថ្មី សម្រាប់មេរៀន X`
- `[Lesson-3] បញ្ចុះបញ្ញាក់កំហុសក្នុងគម្រោង terrarium` - `[Lesson-3] កែសម្រួលកំហុសកំណត់ពាក្យក្នុងគម្រោង terrarium`
- `[Translation] បន្ថែមការបកប្រែភាសាស្ប៉ាញសម្រាប់មេរៀន 5` - `[Translation] បន្ថែមបកប្រែភាសាស្ប៉ាញសម្រាប់មេរៀន 5`
- `[Docs] អាប់ដេតការណែនាំការតំឡើង` - `[Docs] បន្ទាន់សម័យការណែនាំតំឡើង`
### ការត្រួតពិនិត្យចាំបាច់ ### ពិនិត្យតម្រូវការ
មុនដាក់ស្នើ PR: មុនបញ្ចូន PR៖
1. **គុណភាពកូដ**: 1. **គុណភាពកូដ**៖
- រត់ `npm run lint` នៅថតគម្រោងដែលទាក់ទង - រត់ `npm run lint` នៅថតគម្រោងដែលពាក់ព័ន្ធ
- បញ្ចប់កំហុសនិងការព្រមានទាំងអស់ - ជួសជុលកំហុស និងសញ្ញាព្រមានទាំងអស់
2. **ការប្រាកដថាបានបង្កើត**: 2. **បញ្ជាក់ការបង្កើត**៖
- រត់ `npm run build` ប្រសិនបើអាច - រត់ `npm run build` ប្រសិនបើត្រូវការ
- ត្រូវប្រាកដថាគ្មានកំហុសក្នុងការបង្កើត - ធានារួចជាភាពគ្មានកំហុសបង្កើត
3. **ត្រួតពិនិត្យតំណ**: 3. **ផ្ទៀងផ្ទាត់តំណ**៖
- សាកល្បងតំណ Markdown ទាំងអស់ - សាកល្បងតំណ markdown ទាំងអស់
- បញ្ជាក់ការចងក្រងរូបភាពបានត្រឹមត្រូវ - ផ្ទៀងផ្ទាត់ឯកសាររូបភាពមើលបានត្រឹមត្រូវ
4. **ពិនិត្យមាតិកា**: 4. **ពិនិត្យមាតិកា**៖
- ពិនិត្យការកែសម្រួលឲ្យបានត្រឹមត្រូវនិងមិនមានកំហុស - អានកែសម្រួលសំរាប់វាកម្មនិងវេយ្យាករណ៍
- បញ្ជាក់ឧទាហរណ៍កូដត្រឹមត្រូវ និងមានការបង្រៀន - ធានាអោយឧទាហរណ៍កូដត្រឹមត្រូវនិងអប់រំ
- វាយតម្លៃការបកប្រែថាមានសារសំខាន់ដដែល - ពិនិត្យថាបកប្រែរក្សាភាសាដើម
### ទាមទារសម្រាប់ចូលរួម ### ជំនួយការចូលរួម
- អនុញ្ញាត Microsoft CLA (បញ្ចាក់ស្វ័យប្រវត្តិពេល PR ដំបូង) - អនុម័ត Microsoft CLA (ត្រួតពិនិត្យដោយស្វ័យប្រវត្តិនៅ PR ដំបូង)
- អនុវត្តអំពី [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - បន្តបទបញ្ជារបស់ Microsoft Open Source Code of Conduct
- មើល [CONTRIBUTING.md](./CONTRIBUTING.md) សម្រាប់លម្អិត - មើល [CONTRIBUTING.md](./CONTRIBUTING.md) សម្រាប់គោលការណ៍ពិសេស
- យោងលេខបញ្ហាក្នុងការពិពណ៌នា PR ប្រសិនបើមាន - យោងលេខបញ្ហានៅក្នុងការពិពណ៌នារបស់ PR ប្រសិនបើមាន
### ដំណើរការពិនិត្យឡើងវិញ ### ដំណើរការពិនិត្យ
- PR ត្រូវបានអ្នកថែទាំ និងសហគមន៍ពិនិត្យ - PR ត្រូវបានពិនិត្យដោយអ្នកថែទាំ និងសហគមន៍
- ផ្តោតលើភាពច្បាស់លាស់អប់រំ - ផ្តោតលើភាពច្បាស់ថ្លា និងការអប់រំ
- ឧទាហរណ៍កូដត្រូវតែបន្តដំណើរការតាមស្តង់ដារ - ឧទាហរណ៍កូដត្រូវតែគោរពតាមអនុវិធីល្អបំផុត
- ការបកប្រែត្រូវបានពិនិត្យឲ្យត្រឹមត្រូវនិងសមស្រប - បកប្រែត្រូវតែពិនិត្យភាពត្រឹមត្រូវ និងរចនាបថវប្បធម៌
## ប្រព័ន្ធបកប្រែ ## ប្រព័ន្ធបកប្រែ
### បកប្រែស្វ័យប្រវត្តិ ### បកប្រែដោយស្វ័យប្រវត្តិ
- ប្រើ GitHub Actions ជាមួយផ្លូវការងារ co-op-translator - ប្រើ GitHub Actions និង co-op-translator workflow
- បកប្រែទៅភាសាជាង ៥០ ដោយស្វ័យប្រវត្តិ - បកប្រែជាង ៥០ ភាសា ដោយស្វ័យប្រវត្តិ
- ឯកសារមូលដ្ឋានក្នុងថតមេ - ឯកសារដើមនៅក្នុងថតមេ
- ឯកសារបកប្រែសម្រាប់ភាពច្បាស់នៅក្នុងថត `translations/{language-code}/` - ឯកសារបកប្រែក្នុង `translations/{language-code}/`
### បន្ថែមជំនួយបកប្រែដោយដៃ ### ការកែលម្អបកប្រែ ដោយដៃ
1. ស្វែងរកឯកសារនៅក្នុងថត `translations/{language-code}/` 1. រកឃើញឯកសារ​នៅក្នុង `translations/{language-code}/`
2. បម្លែងដោយរក្សារចនាសម្ព័ន្ធដើម 2. បញ្ចូលការកែលម្អ បើក្សនាផ្លូវរចនាសម្ព័ន្ធ
3. ធានាថាឧទាហរណ៍កូដនៅថ្មីនិងដំណើរការ 3. ធានាឲ្យឧទាហរណ៍កូដនៅស្ថិតក្នុងសភាពដើម
4. សាកល្បងមាតិកាការប្រលងបកប្រែ 4. សាកល្បងមាតិកាវិញ្ញាសា​ដែលបានបកប្រែ
### ទិន្នន័យពីលើការបកប្រែ ### បញ្ជីមេតាអំពីបកប្រែ
ឯកសារបកប្រែមានក្បាល metadata: ឯកសារបកប្រែរួមបញ្ចូលក្បាលទិន្នន័យមេតា៖
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
--> -->
``` ```
## ការដោះស្រាយបញ្ហានិងព្យាបាលកំហុស ## ការស្វែងរកកំហុស និងដំណោះស្រាយ
### បញ្ហាទូទៅ ### បញ្ហាទូទៅ
**Quiz app មិនចាប់ផ្តើមបាន**: **Quiz app ចាប់ផ្តើមមិនបាន**៖
- ពិនិត្យកំណែ Node.js (v14+ កំណត់អនុសាសន៍) - ពិនិត្យកំណែ Node.js (ផ្តល់អនុសាសន៍ v14 ឡើង)
- លុប `node_modules` និង `package-lock.json` រួចបញ្ចូលស្ដារឡើងវិញដោយ `npm install` - លុប `node_modules` និង `package-lock.json` រួចហើយរត់ `npm install` ម្ដងទៀត
- ពិនិត្យទំនាក់ទំនងផត (លំនាំដើម: Vite ប្រើផត ៥១៧៣) - ពិនិត្យការប្រឈមមុខនឹងតំណរភ្ជាប់ port (លំនាំដើម៖ Vite ប្រើ port 5173)
**ម៉ាស៊ីនមេ API មិនចាប់ផ្តើមបាន**: **API សេវាកម្មមិនចាប់ផ្តើម**៖
- ពិនិត្យកំណែ Node.js ឲ្យជាតម្លៃទាបបំផុត (node >=10) - ពិនិត្យកំណែ Node.js >= 10
- ពិនិត្យថាផតមិនត្រូវបានប្រើរួច - ពិនិត្យថាតំណ port មិនត្រូវបានប្រើរួចហើយ
- ប្រាកដថាដំឡើងផ្នែកបំរើទាំងអស់ដោយ `npm install` - ធានាថា dependencies ទាំងអស់បានដំឡើង `npm install`
**Browser extension មិនដំណើរការ**: **Browser extension មិនត្រូវផ្ទុកទេ**៖
- ពិនិត្យមើលថា manifest.json ត្រូវបានរៀបចំត្រឹមត្រូវ - ពិនិត្យ manifest.json មានទ្រង់ទ្រាយត្រឹមត្រូវ
- មើលកុងសូលកម្មវិធីដូចកំហុស - ពិនិត្យកុងសូលរុករកសម្រាប់កំហុស
- អនុវត្តតាមការណែនាំដំឡើងផ្នែកបន្ថែមកំណត់គ្រប់គ្រង - អនុវត្ដតាមការណែនាំដំឡើង extension ក្រៅបណ្ដាញ
**បញ្ហាគម្រោងជជែក Python**: **បញ្ហាគម្រោង Python chat**៖
- ប្រាកដថាដំឡើងកញ្ចប់ OpenAI: `pip install openai` - ធានាបញ្ចូលកញ្ចប់ OpenAI៖ `pip install openai`
- ពិនិត្យថាផ្លាក GITHUB_TOKEN បានកំណត់ - ពិនិត្យថា GITHUB_TOKEN បានកំណត់ជាផ្លាកបរិស្ថាន
- ពិនិត្យសិទ្ធិចូលប្រើគំរូ GitHub - ពិនិត្យសិទ្ធិចូលប្រើម៉ូដែល GitHub
**Docsify មិនបម្រើឯកសារ**: **Docsify មិនបង្ហាញឯកសារទេ**៖
- ដំឡើង docsify-cli ទូទៅ: `npm install -g docsify-cli` - ដំឡើង docsify-cli ទូទាំងប្រព័ន្ធ៖ `npm install -g docsify-cli`
- រត់ពីថតគណនីនេះ - រត់ពីថតឫស repositories
- ពិនិត្យឲ្យមានឯកសារ `docs/_sidebar.md` - ពិនិត្យឯកសារ `docs/_sidebar.md` មានស្រាប់
### ជំនួយបរិស្ថានអភិវឌ្ឍ ### អ្នកអភិវឌ្ឍផ្នែកបរិយាកាស
- ប្រើ VS Code ជាមួយ Live Server extension សម្រាប់គម្រោង HTML - ប្រើ VS Code ជាមួយ Live Server extension សម្រាប់គម្រោង HTML
- ដំឡើង ESLint និង Prettier extension ដើម្បីរក្សាទំរង់ត្រឹមត្រូវ - ដំឡើង ESLint និង Prettier extension សម្រាប់លំអរយក
- ប្រើ DevTools ក្នុងប្រ្វៅសើរក្នុងការលួងលោម JavaScript - ប្រើ DevTools រុករកសម្រាប់ដោះស្រាយជំហាន JavaScript
- សម្រាប់គម្រោង Vue, ដំឡើង Vue DevTools browser extension - សម្រាប់គម្រោង Vue, ដំឡើង Vue DevTools extension រុករក
### ការពិចារណា​ពហុភាព ### ចំណាំសមត្ថភាព
- មានឯកសារបកប្រែច្រើន (ភាសាជាង ៥០) ហើយការ clone ពេញលេញមានទំហំធំ - ចំនួនឯកសារបកប្រែច្រើន (ជាង ៥០ ភាសា) មានទំហំធំ
- ប្រើ shallow clone ប្រសិនបើប៉ុណ្ណោះកំពុងធ្វើការ៖ `git clone --depth 1` - ប្រើ shallow clone ប្រសិនបើគ្រាន់តែធ្វើការងារជាមួយមាតិកា៖ `git clone --depth 1`
- មិនស្វែងរកក្នុងថតបកប្រែពេលធ្វើការលើមាតិកាភាសាអង់គ្លេស - មិនស្វែងរកក្នុងបកប្រែពេលធ្វើការជាមួយមាតិកាអង់គ្លេស
- ដំណើរការបង្កើតមួយចំនួន​អាចយឺតនៅពេលដំបូង (npm install, ការបង្កើត Vite) - ដំណើរការប្រមូលផលអាចប្រហែលយឺតនៅលើការដំណើរការដំបូង (npm install, របៀប build Vite)
## ការពិចារណាអំពីសុវត្ថិភាព ## ចំណុចសុវត្ថិភាព
### បរិយាកាស Environment Variables ### ផ្លាកបរិស្ថាន
- កូនសោ API មិនគួរតែបញ្ចូលក្នុងគណនី - កូនសោ API មិនគួរត្រូវបានបញ្ចូលក្នុងឃ្លាំង
- ប្រើគ្រប់ឯកសារ `.env` (ដែលបានរាយថាត្រូវអោបរួចហើយក្នុង .gitignore) - ប្រើឯកសារ `.env` (មានរួចក្នុង `.gitignore`)
- បញ្ជាក់បរិយាកាសត្រូវការនៅក្នុង README គម្រោង - រៀបរាប់ប្រាប់ពីផ្លាកបរិស្ថានចាំបាច់ក្នុង README គម្រោង
### គម្រោង Python ### គម្រោង Python
- ប្រើបរិវេណវេជ្ជៈន៍: `python -m venv venv` - ប្រើបរិយាកាសវេរ៉ែល (virtual environments): `python -m venv venv`
- រក្សាប្រភេទផ្នែកបំរើសម័យទាន់ - រក្សាអាប់ដេត dependencies ជានិច្ច
- សញ្ញា GitHub គួរតែមានសិទ្ធិតិចបំផុត - ស្លាក GitHub token ត្រូវមានសិទ្ធិចូលតិចតួចបំផុត
### ការផ្តល់សិទិ្ធផ្លូវ GitHub Models ### សិទ្ធិចូលម៉ូដែល GitHub
- ត្រូវការសញ្ញាចូលប្រើ (PAT) - ត្រូវការបាន Personal Access Tokens (PAT) សម្រាប់ពេលប្រើម៉ូដែល GitHub
- សញ្ញាគួរតែរក្សាទុកជា environment variables - ត្រូវរក្សាគោលបំណងស្លាកជា environment variable
- មិនគួរបញ្ចូលសញ្ញា ឬ ព័ត៌មានសម្ងាត់ណាមួយនៅក្នុងគណនី - មិនគួរបញ្ចូលលេខសម្ងាត់ឬកូនសោឡើយ
## កំណត់សម្គាល់បន្ថែម ## កំណត់សម្គាល់បន្ថែម
### គោលដៅអ្នកប្រើប្រាស់ ### គោលដៅអ្នកប្រើប្រាស់
- អ្នកចេះតិចថ្មីក្នុងការអភិវឌ្ឍន៍គេហទំព័រ - អ្នកចាប់ផ្តើមបំពេញក្នុងការអភិវឌ្ឍវែប
- សិស្ស និងអ្នករៀនដោយខ្លួនឯង - សិស្ស និងអ្នករៀនដោយខ្លួនឯង
- គ្រូបង្រៀនប្រើវគ្គសិក្សានៅថ្នាក់រៀន - គ្រូបង្រៀនដែលប្រើមេរៀននៅថ្នាក់សិក្សា
- មាតិកាត្រូវបានរចនាសម្រាប់ភាពងាយស្រួលនិងការកែលម្អជักษា - មាតិកាផ្ដោតលើភាពងាយស្រួល និងការកែលម្អជារបៀបជាប់ជាលំដាប់
### ទស្សនវិជ្ជាអប់រំ ### ទស្សនវិជ្ជាអប់រំ
- វិធីសាស្ត្រសិក្សាដោយគម្រោង - វិធីសាស្ត្រសិក្សាជាគម្រោង
- ការត្រួតពិនិត្យចំណេះដឹងជាប្រចាំ (ការប្រលង) - ការត្រួតពិនិត្យចំណេះដឹងជាប្រចាំ (វិញ្ញាសា)
- ច្នៃប្រឌិតកូដដោយដៃ - អនុវត្តន៍​កូដ​ដោយដៃ
- ឧទាហរណ៍ឧប្បទានពីពិភពជាក់ស្តែង - ឧទាហរណ៍នៃកម្មវិធីពិតប្រាកដ
- ផ្តោតលើមូលដ្ឋានមុនគន្លងបច្ចេកវិទ្យា - ព្រមទាំងផ្ដោតលើមូលដ្ឋាន មុនចូលទៅ framework
### ថែទាំគណនី ### ការថែទាំឃ្លាំង
- សហគមន៍សកម្មរបស់អ្នករៀននិងអ្នករួមចំណែក - សហគមន៍សកម្មនៃអ្នករៀន និងអ្នកចូលរួម
- ការអាប់ដេតជាប្រចាំសម្រាប់ផ្នែករឹងនិងមាតិកា - បន្តពិនិត្យ និងធ្វើបច្ចុប្បន្នភាពលើ dependencies និងមាតិកា
- តាមដានបញ្ហានិងការពិភាក្សាដោយអ្នកថែទាំ - ចំណុចបញ្ហា និងការពិភាក្សាត្រូវបានគ្រប់គ្រងដោយអ្នកថែទាំ
- ការអាប់ដេតបកប្រែដោយស្វ័យប្រវត្តិជាមួយ GitHub Actions - ការអាប់ដេតបកប្រែធ្វើដោយស្វ័យប្រវត្តិតាម GitHub Actions
### ធនធានដែលទាក់ទង ### ធនធានដែលពាក់ព័ន្ធ
- [Microsoft Learn modules](https://docs.microsoft.com/learn/) - [Microsoft Learn modules](https://docs.microsoft.com/learn/)
- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/) - [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ដែលផ្តល់អនុសាសន៍សម្រាប់អ្នករៀន - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ផ្ដល់អនុសាសន៍សម្រាប់អ្នករៀន
- វគ្គបន្ថែម៖ Generative AI, Data Science, ML, IoT ផ្ដល់ជូន - គរូបិសេសផ្សេងៗ: Generative AI, Data Science, ML, IoT បណ្ដុះបណ្ដាលមាន
### ការធ្វើការជាមួយគម្រោងជាក់លាក់ ### ធ្វើការជាមួយគម្រោងពិសេស
សម្រាប់ការណែនាំលម្អិតលើគម្រោងជាក់លាក់ សូមយោងឯកសារ README នៅក្នុង: សម្រាប់ការណែនាំលម្អិតនៃគម្រោងជាក់លាក់សូមមើលឯកសារ README នៅក្នុង៖
- `quiz-app/README.md` - កម្មវិធីប្រលង Vue 3 - `quiz-app/README.md` - កម្មវិធី quiz Vue 3
- `7-bank-project/README.md` - កម្មវិធីធនាគារប្រើប្រាស់ការផ្ទៀងផ្ទាត់ - `7-bank-project/README.md` - កម្មវិធីធនាគារជាមួយការផ្ទៀងផ្ទាត់
- `5-browser-extension/README.md` - ការអភិវឌ្ឍបន្ថែម Browser extension - `5-browser-extension/README.md` - ការអភិវឌ្ឍ browser extension
- `6-space-game/README.md` - ការផលិតហ្គេមផ្អែកលើ Canvas - `6-space-game/README.md` - ការបង្កើតហ្គេមប្លុក canvas
- `9-chat-project/README.md` - គម្រោងជជែកជាមួយ AI - `9-chat-project/README.md` - គម្រោងជំនួយការជជែក AI
### រចនាសម្ព័ន្ធ Monorepo ### រចនាសម្ព័ន្ធ Monorepo
ទោះបីមិនមែន Monorepo ត្បិតប៉ុន្មាននេះ គណនីនេះមានគម្រោងឯករាជ្យជាច្រើន៖ ទោះបីមិនមែនជាការប្រមូលគ្នារូបមន្តចម្រុះនោះ ក៏ឃ្លាំងនេះមានគម្រោងឯករាជ្យច្រើន៖
- មេរៀនមួយៗមានភាពឯករាជ្ជ - មេរៀននីមួយៗមានជាពិសេស
- គម្រោងមិនចែករំលែកមុខងារ - គម្រោងមិនចែករំលែក dependencies
- អ្នកអាចធ្វើការនៅលើគម្រោងមួយដោយមិនប៉ះពាល់គម្រោងផ្សេងទៀត - អាចធ្វើការងារជាមួយគម្រោងឯកត្តដោយមិនប៉ះពាល់គ្នា
- Clone គណនីទាំងមូលសម្រាប់បទពិសោធការសិក្សាពេញលេញ - ចម្លងឃ្លាំងទាំងមូលសម្រាប់បទពិសោធទាំងមូលនៃកម្មវិធីសិក្សា
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**បដិសេធ** ៖ **ការបដិសេធ**៖
ឯកសារនេះត្រូវបានបកប្រែដោយប្រើសេវាកម្មបកប្រែ AI [Co-op Translator](https://github.com/Azure/co-op-translator)។ ខណៈពេលយើងខំប្រឹងប្រែងដើម្បីភាពត្រឹមត្រូវ សូមកត់សម្គាល់ថាការបកប្រែដោយស្វ័យប្រវត្តិអាចមានកំហុស ឬភាពមិនត្រឹមត្រូវ។ ឯកសារដើមដែលមានភាសាដើមគួរត្រូវបានគិតថាជាតំបន់យោងសម្រាប់ភាពត្រឹមត្រូវ។ សម្រាប់ព័ត៌មានសំខាន់ៗ ការបកប្រែដោយអ្នកជំនាញមនុស្សត្រូវបានណែនាំ។ យើងមិនទទួលខុសត្រូវចំពោះការយល់ខុស ឬការប្រែប្រួលនៃអត្ថន័យដែលកើតមានពីការប្រើប្រាស់ការបកប្រែនេះទេ។ ឯកសារនេះត្រូវបានបកប្រែដោយប្រើសេវាបកប្រែ AI [Co-op Translator](https://github.com/Azure/co-op-translator)។ ទោះបីយើងខំប្រឹងសម្រាប់ភាពត្រឹមត្រូវ ក៏សូមយល់ថាការបកប្រែដោយស្វ័យប្រវត្តិនេះអាចមានកំហុសឬភាពមិនត្រឹមត្រូវ។ ឯកសារដើមក្នុងភាសាដែលវាត្រូវបានគេប្រើជាភាសាមូលដ្ឋានគួរត្រូវបានគេចាត់ទុកជាធាតុយោងដែលមានសុពលភាព។ សម្រាប់ព័ត៌មានសំខាន់ៗ ការបកប្រែដោយអ្នកជំនាញមនុស្សគឺល្អជាង។ យើងមិនទទួលខុសត្រូវចំពោះការយល់ច្រឡំ ឬការបកប្រែខុសពីការប្រើប្រាស់បកប្រែនេះឡើយ។
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->
Write Preview
Loading…
Cancel
Save