You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Data-Science-For-Beginners/translations/km/INSTALLATION.md

254 lines
12 KiB

# កម្មវិធីដំឡើង
មគ្គុទេសក៍នេះនឹងជួយអ្នកដំឡើងបរិបទសម្រាប់ធ្វើការជាមួយមេរៀន Data Science សម្រាប់អ្នកចាប់ផ្ដើម។
## តារាងមាតិកា
- [លក្ខខណ្ឌដំបូង](#លក្ខខណ្ឌដំបូង)
- [ជម្រើសចាប់ផ្ដើមយ៉ាងលឿន](#ជម្រើសចាប់ផ្ដើមយ៉ាងលឿន)
- [ការដំឡើងក្នុងផ្ទៃ](#ការដំឡើងក្នុងផ្ទៃ)
- [ពិនិត្យការដំឡើងរបស់អ្នក](#ពិនិត្យការដំឡើងរបស់អ្នក)
## លក្ខខណ្ឌដំបូង
មុនពេលអ្នកចាប់ផ្ដើម អ្នកគួរតែមាន៖
- ការជ្រាបខ្លះអំពីបន្ទាត់បញ្ជា/ទំរង់បញ្ជា
- គណនី GitHub (ឥតគិតថ្លៃ)
- ការតភ្ជាប់អ៊ីនធឺណិតមានស្ថិរភាពសម្រាប់ការដំឡើងដំបូង
## ជម្រើសចាប់ផ្ដើមយ៉ាងលឿន
### ជម្រើស 1: GitHub Codespaces (ផ្ញើសម្រាប់អ្នកចាប់ផ្ដើម)
វិធីងាយស្រួលបំផុតក្នុងការចាប់ផ្ដើមគឺប្រើ GitHub Codespaces ដែលផ្ដល់បរិយាកាសអភិវឌ្ឍន៍ពេញលេញនៅក្នុងកម្មវិធីរុករករបស់អ្នក។
1. ទៅកាន់ [repository](https://github.com/microsoft/Data-Science-For-Beginners)
2. ចុចម៉ឺនុយបាញ់ចុច **Code**
3. ជ្រើសរើសផ្ទាំង **Codespaces**
4. ចុច **Create codespace on main**
5. រង់ចាំបរិយាកាសឱ្យចាប់ផ្ដើម (2-3 នាទី)
បរិយាកាសរបស់អ្នកបានរួចរាល់ជាមួយគ្រឿងចម្អិនទាំងអស់ដែលបានដំឡើងមុនហើយ!
### ជម្រើស 2: ការអភិវឌ្ឍក្នុងផ្ទៃ
សម្រាប់ធ្វើការដោយកុំព្យូទ័រផ្ទាល់ខ្លួន សូមអនុវត្តការណែនាំលម្អិតខាងក្រោម។
## ការដំឡើងក្នុងផ្ទៃ
### ជំហាន 1: ដំឡើង Git
Git ត្រូវការដើម្បីបម្លែង repository និងតាមដានការផ្លាស់ប្តូររបស់អ្នក។
**Windows:**
- ទាញយកពី [git-scm.com](https://git-scm.com/download/win)
- ប្រតិបត្តិកម្មវិធីដំឡើងដោយប្រើការកំណត់លំនាំដើម
**macOS:**
- ដំឡើងតាមរយៈ Homebrew: `brew install git`
- ឬទាញយកពី [git-scm.com](https://git-scm.com/download/mac)
**Linux:**
```bash
# Debian/Ubuntu
sudo apt-get update
sudo apt-get install git
# Fedora
sudo dnf install git
# Arch
sudo pacman -S git
```
### ជំហាន 2: បម្លែង Repository
```bash
# ចម្លងហាងទំនិញ
git clone https://github.com/microsoft/Data-Science-For-Beginners.git
# ទៅកាន់ថតឯកសារ
cd Data-Science-For-Beginners
```
### ជំហាន 3: ដំឡើង Python និង Jupyter
Python 3.7 ឬខ្ពស់ជាងនេះ ត្រូវការសម្រាប់មេរៀនវិទ្យាសាស្ត្រទិន្នន័យ។
**Windows:**
1. ទាញយក Python ពី [python.org](https://www.python.org/downloads/)
2. ក្នុងអំឡុងដំឡើង សូមពិនិត្យ "Add Python to PATH"
3. ពិនិត្យការដំឡើង:
```bash
python --version
```
**macOS:**
```bash
# ការប្រើប្រាស់ Homebrew
brew install python3
# បញ្ជាក់ការដំឡើង
python3 --version
```
**Linux:**
```bash
# បំពាក់ Python រួចជាលំនាំនៅក្នុងច្រើនចេញផ្សាយលីនុចទាំងអស់
python3 --version
# ប្រសិនបើមិនបានដំឡើង៖
# Debian/Ubuntu
sudo apt-get install python3 python3-pip
# Fedora
sudo dnf install python3 python3-pip
```
### ជំហាន 4: កំណត់បរិយាកាស Python
ផ្ដល់អធិប្បាយឲ្យប្រើបរិយាកាសវិនិយោគផ្ទាល់ខ្លួនដើម្បីរក្សាគ្រឿងចម្អិនឲ្យឡែកពីគ្នា។
```bash
# បង្កើតបរិយាកាសវត្ថុតំណាង
python -m venv venv
# បើកបរិយាកាសវត្ថុតំណាង
# នៅលើ Windows:
venv\Scripts\activate
# នៅលើ macOS/Linux:
source venv/bin/activate
```
### ជំហាន 5: ដំឡើងកញ្ចប់ Python
ដំឡើងបណ្ណាល័យទិន្នន័យដែលត្រូវការ៖
```bash
pip install jupyter pandas numpy matplotlib seaborn scikit-learn
```
### ជំហាន 6: ដំឡើង Node.js និង npm (សម្រាប់កម្មវិធី Quiz)
កម្មវិធីសំនួរឡើងចាំបាច់ត្រូវការដំឡើង Node.js និង npm។
**Windows/macOS:**
- ទាញយកពី [nodejs.org](https://nodejs.org/) (ជ្រើសរើស LTS សម្រាប់អ្នកចាប់ផ្ដើម)
- ប្រតិបត្តិកម្មវិធីដំឡើង
**Linux:**
```bash
# Debian/Ubuntu
# ការព្រមាន៖ ការធ្វើបាញ់ script ពីអ៊ីនធើណិតចូលនៅក្នុង bash ប្លែកៗអាចមានហានិភ័យសុវត្ថិភាព។
# គួរតែពិនិត្យ script មុននឹងដំណើរការ៖
# curl -fsSL https://deb.nodesource.com/setup_lts.x -o setup_lts.x
# less setup_lts.x
# បន្ទាប់មករត់៖
# sudo -E bash setup_lts.x
#
# ជាជម្រើសមួយ អ្នកអាចប្រើបន្ទាត់តែមួយខាងក្រោមដោយហានិភ័យផ្ទាល់ខ្លួន៖
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# Fedora
sudo dnf install nodejs
# បញ្ជាក់ការដំឡើង
node --version
npm --version
```
### ជំហាន 7: ដំឡើងចំណាំផ្នែក Quiz App
```bash
# ទៅកាន់ថតកម្មវិធីវាយបញ្ចូល
cd quiz-app
# ដំឡើងឧបករណ៍បន្ទាប់
npm install
# ត្រឡប់ទៅថតឫស
cd ..
```
### ជំហាន 8: ដំឡើង Docsify (ទៅលើវិធីបំពាះ)
សម្រាប់ចូលប្រើឯកសារបានក្រៅបណ្តាញ៖
```bash
npm install -g docsify-cli
```
## ពិនិត្យការដំឡើងរបស់អ្នក
### សាកល្បង Python និង Jupyter
```bash
# បើកបរិស្ថានវេររ៉ូរបស់អ្នក ប្រសិនបើមិនទាន់បើក
# នៅលើ Windows:
venv\Scripts\activate
# នៅលើ macOS/Linux:
source venv/bin/activate
# ចាប់ផ្តើម Jupyter Notebook
jupyter notebook
```
កម្មវិធីរុករករបស់អ្នកគួរតែបើកនូវចំណុចចូល Jupyter។ អ្នកអាចរុករកទៅឯកសារ `.ipynb` នៃម៉ូដែលណាមួយ។
### សាកល្បងកម្មវិធី Quiz
```bash
# បើកទៅកម្មវិធីសំណួរ
cd quiz-app
# ចាប់ផ្តើមម៉ាស៊ីនមេអភិវឌ្ឍន៍
npm run serve
```
កម្មវិធី Quiz គ្រាន់តែមាននៅ `http://localhost:8080` (ឬថែមទៀតដោយច្រកផ្សេងប្រសិនបើ 8080 ត្រូវបានប្រើប្រាស់)។
### សាកល្បងម៉ាស៊ីនបម្រើឯកសារ
```bash
# ចាប់ពីថតដើមនៃឃ្លាំងកូដ
docsify serve
```
ឯកសារគួរតែអាចប្រើបាននៅ `http://localhost:3000`
## ប្រើ VS Code Dev Containers
ប្រសិនបើអ្នកមានការដំឡើង Docker អ្នកអាចប្រើ VS Code Dev Containers ដូចខាងក្រោម៖
1. ដំឡើង [Docker Desktop](https://www.docker.com/products/docker-desktop)
2. ដំឡើង [Visual Studio Code](https://code.visualstudio.com/)
3. ដំឡើងកម្មវិធីបន្ថែម [Remote - Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
4. បើក repository ក្នុង VS Code
5. ចុច `F1` ហើយជ្រើស "Remote-Containers: Reopen in Container"
6. រង់ចាំឲ្យកម្មវិធីកោនតឺន័របង្កើតចប់ (គ្រាន់តែដំណើរការក្នុងលើកដំបូងប៉ុណ្ណោះ)
## ជំហានបន្ទាប់
- ស្វែងយល់ពី [README.md](README.md) សម្រាប់មើលទិដ្ឋភាពទូទៅរបស់មេរៀន
- អាន [USAGE.md](USAGE.md) សម្រាប់ច្បាប់ប្រើប្រាស់ទូទៅ និងឧទាហរណ៍
- ពិនិត្យ [TROUBLESHOOTING.md](TROUBLESHOOTING.md) ប្រសិនបើអ្នកជួបបញ្ហា
- សំរាប់តំរូវចង់ចូលរួម អាន [CONTRIBUTING.md](CONTRIBUTING.md)
## ស្វែងរកជំនួយ
ប្រសិនបើអ្នកជួបបញ្ហា៖
1. ពិនិត្យមើលមគ្គុទេសក៍ [TROUBLESHOOTING.md](TROUBLESHOOTING.md)
2. ស្វែងរកបញ្ហាមានស្រាប់នៅ [GitHub Issues](https://github.com/microsoft/Data-Science-For-Beginners/issues)
3. ចូលរួមក្នុងសហគមន៍ [Discord](https://aka.ms/ds4beginners/discord)
4. បង្កើតបញ្ហាថ្មីដោយមានព័ត៌មានលម្អិតអំពីបញ្ហារបស់អ្នក
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**ការបដិសេធ**៖
ឯកសារនេះត្រូវបានបកប្រែដោយប្រើសេវាកម្មបកប្រែ AI [Co-op Translator](https://github.com/Azure/co-op-translator)។ ខណៈពេលដែលយើងខិតខំរកភាពត្រឹមត្រូវ សូមយល់ថាការបកប្រែដោយស្វ័យប្រវត្តិក្នុងខ្លះអាចមានកំហុស ឬការខ្វះត្រូវបានខ្លះ។ ឯកសារដើមក្នុងភាសាដើមគួរត្រូវបានគេសម្លឹងជារុក្ខជាតិឯកសារដ៏មានសុពលភាព។ សម្រាប់ព័ត៌មានសំខាន់ៗ ការបកប្រែនៅដោយមនុស្សជំនាញគឺត្រូវបានផ្ដល់អនុសាសន៍។ យើងមិនទទួលខុសត្រូវចំពោះការយល់ច្រឡំ ឬការបកប្រែបញ្ហាដែលកើតឡើងពីការប្រើប្រាស់ការបកប្រែនេះទេ។
<!-- CO-OP TRANSLATOR DISCLAIMER END -->