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

pull/1793/head
localizeflow[bot] 3 weeks ago
parent ecd784c7ff
commit fcd22d3e7e

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T16:49:02+00:00",
"translation_date": "2026-04-20T16:43:50+00:00",
"source_file": "AGENTS.md",
"language_code": "id"
},

@ -1,28 +1,28 @@
# AGENTS.md
## Ikhtisar Proyek
## Gambaran Proyek
Ini adalah repositori kurikulum edukasi untuk mengajarkan dasar-dasar pengembangan web kepada pemula. Kurikulumnya adalah kursus komprehensif selama 12 minggu yang dikembangkan oleh Microsoft Cloud Advocates, menampilkan 24 pelajaran praktis yang mencakup JavaScript, CSS, dan HTML.
Ini adalah repositori kurikulum edukasi untuk mengajarkan dasar-dasar pengembangan web kepada pemula. Kurikulum ini merupakan kursus komprehensif selama 12 minggu yang dikembangkan oleh Microsoft Cloud Advocates, menampilkan 24 pelajaran praktis yang mencakup JavaScript, CSS, dan HTML.
### Komponen Utama
- **Konten Edukasi**: 24 pelajaran terstruktur yang diorganisasi dalam modul berbasis proyek
- **Proyek Praktis**: Terrarium, Permainan Mengetik, Ekstensi Browser, Permainan Luar Angkasa, Aplikasi Perbankan, Editor Kode, dan Asisten Obrolan AI
- **Kuis Interaktif**: 48 kuis dengan 3 pertanyaan setiap kuis (penilaian sebelum dan sesudah pelajaran)
- **Dukungan Multi-bahasa**: Terjemahan otomatis untuk 50+ bahasa melalui GitHub Actions
- **Proyek Praktis**: Terrarium, Permainan Mengetik, Ekstensi Browser, Permainan Luar Angkasa, Aplikasi Perbankan, Editor Kode, dan Asisten Chat AI
- **Kuis Interaktif**: 48 kuis dengan 3 pertanyaan tiap kuis (penilaian sebelum/sesudah pelajaran)
- **Dukungan Multi-bahasa**: Terjemahan otomatis untuk lebih dari 50 bahasa melalui GitHub Actions
- **Teknologi**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (untuk proyek AI)
### Arsitektur
- Repositori edukasi dengan struktur berbasis pelajaran
- Setiap folder pelajaran memuat README, contoh kode, dan solusi
- Proyek mandiri dalam direktori terpisah (quiz-app, berbagai proyek pelajaran)
- Setiap folder pelajaran berisi README, contoh kode, dan solusi
- Proyek mandiri di direktori terpisah (quiz-app, berbagai proyek pelajaran)
- Sistem terjemahan menggunakan GitHub Actions (co-op-translator)
- Dokumentasi disajikan melalui Docsify dan tersedia dalam format PDF
## Perintah Setup
Repositori ini terutama untuk konsumsi konten edukasi. Untuk bekerja dengan proyek spesifik:
Repositori ini terutama untuk konsumsi konten edukasi. Untuk bekerja dengan proyek khusus:
### Setup Repositori Utama
@ -56,7 +56,7 @@ npm run format # Format dengan Prettier
```bash
cd 5-browser-extension/solution
npm install
# Ikuti instruksi pemuatan ekstensi khusus browser
# Ikuti petunjuk pemuatan ekstensi spesifik browser
```
### Proyek Permainan Luar Angkasa
@ -67,12 +67,12 @@ npm install
# Buka index.html di browser atau gunakan Live Server
```
### Proyek Obrolan (Backend Python)
### Proyek Chat (Backend Python)
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# Atur variabel lingkungan GITHUB_TOKEN
# Tetapkan variabel lingkungan GITHUB_TOKEN
python api.py
```
@ -81,28 +81,28 @@ python api.py
### Untuk Kontributor Konten
1. **Fork repositori** ke akun GitHub Anda
2. **Clone hasil fork** secara lokal
2. **Clone fork Anda** secara lokal
3. **Buat cabang baru** untuk perubahan Anda
4. Buat perubahan pada konten pelajaran atau contoh kode
4. Lakukan perubahan pada konten pelajaran atau contoh kode
5. Uji perubahan kode di direktori proyek terkait
6. Ajukan pull request sesuai pedoman kontribusi
6. Ajukan pull request sesuai panduan kontribusi
### Untuk Pembelajar
1. Fork atau clone repositori
2. Navigasi ke direktori pelajaran secara berurutan
3. Baca file README untuk setiap pelajaran
4. Kerjakan kuis pra-pelajaran di https://ff-quizzes.netlify.app/web/
5. Kerjakan contoh kode dalam folder pelajaran
3. Baca file README di setiap pelajaran
4. Selesaikan kuis sebelum pelajaran di https://ff-quizzes.netlify.app/web/
5. Kerjakan contoh kode di folder pelajaran
6. Selesaikan tugas dan tantangan
7. Kerjakan kuis pasca-pelajaran
7. Ikuti kuis sesudah pelajaran
### Pengembangan Langsung
- **Dokumentasi**: Jalankan `docsify serve` di root (port 3000)
- **Aplikasi Kuis**: Jalankan `npm run dev` di direktori quiz-app
- **Proyek**: Gunakan ekstensi VS Code Live Server untuk proyek HTML
- **Proyek API**: Jalankan `npm start` di direktori API masing-masing
- **Proyek-proyek**: Gunakan ekstensi Live Server VS Code untuk proyek HTML
- **Proyek API**: Jalankan `npm start` di direktori API terkait
## Instruksi Pengujian
@ -111,7 +111,7 @@ python api.py
```bash
cd quiz-app
npm run lint # Periksa masalah gaya kode
npm run build # Verifikasi build berhasil
npm run build # Verifikasi keberhasilan build
```
### Pengujian API Bank
@ -124,57 +124,57 @@ node server.js # Verifikasi server mulai tanpa kesalahan
### Pendekatan Pengujian Umum
- Ini adalah repositori edukasi tanpa pengujian otomatis yang lengkap
- Pengujian manual difokuskan pada:
- Ini adalah repositori edukasi tanpa pengujian otomatis lengkap
- Pengujian manual fokus pada:
- Contoh kode berjalan tanpa error
- Tautan di dokumentasi berfungsi dengan baik
- Build proyek selesai dengan sukses
- Contoh mengikuti praktik terbaik
- Link di dokumentasi berfungsi dengan baik
- Proses build proyek berjalan sukses
- Contoh sesuai praktik terbaik
### Pemeriksaan Sebelum Pengajuan
### Pemeriksaan Sebelum Pengiriman
- Jalankan `npm run lint` di direktori dengan package.json
- Verifikasi tautan markdown valid
- Verifikasi link markdown valid
- Uji contoh kode di browser atau Node.js
- Pastikan terjemahan mempertahankan struktur yang benar
- Pastikan terjemahan mempertahankan struktur yang tepat
## Pedoman Gaya Kode
### JavaScript
- Gunakan sintaks ES6+ modern
- Ikuti konfigurasi ESLint standar yang disediakan di proyek
- Ikuti konfigurasi ESLint standar di proyek
- Gunakan nama variabel dan fungsi yang bermakna untuk kejelasan edukasi
- Tambahkan komentar untuk menjelaskan konsep kepada pembelajar
- Format menggunakan Prettier jika sudah dikonfigurasi
- Tambahkan komentar penjelasan konsep untuk pembelajar
- Format menggunakan Prettier jika dikonfigurasi
### HTML/CSS
- Elemen HTML5 semantik
- Prinsip desain responsif
- Konvensi penamaan kelas yang jelas
- Komentar yang menjelaskan teknik CSS untuk pembelajaran
- Penamaan kelas yang jelas
- Komentar menjelaskan teknik CSS untuk pembelajar
### Python
- Pedoman gaya PEP 8
- Contoh kode yang jelas dan edukatif
- Tambahkan tipe (type hints) jika membantu proses belajar
- Panduan gaya PEP 8
- Contoh kode jelas dan edukatif
- Gunakan type hint bila membantu pembelajaran
### Dokumentasi Markdown
- Hirarki judul yang jelas
- Blok kode dengan spesifikasi bahasa
- Tautan ke sumber daya tambahan
- Hierarki judul yang jelas
- Blok kode dengan penentuan bahasa
- Link ke sumber daya tambahan
- Screenshot dan gambar di direktori `images/`
- Teks alt untuk gambar demi aksesibilitas
- Teks alternatif untuk gambar demi aksesibilitas
### Organisasi File
- Pelajaran diberi nomor berurutan (1-getting-started-lessons, 2-js-basics, dll.)
- Setiap proyek memiliki direktori `solution/` dan sering `start/` atau `your-work/`
- Gambar disimpan dalam folder `images/` khusus pelajaran
- Terjemahan di struktur `translations/{kode-bahasa}/`
- Setiap proyek memiliki direktori `solution/` dan sering juga `start/` atau `your-work/`
- Gambar disimpan di folder `images/` khusus pelajaran
- Terjemahan disimpan dalam struktur `translations/{language-code}/`
## Build dan Deployment
@ -193,7 +193,7 @@ Konfigurasi Azure Static Web Apps:
- **Lokasi output**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Pembuatan PDF Dokumentasi
### Generasi PDF Dokumentasi
```bash
npm install # Pasang docsify-to-pdf
@ -203,22 +203,22 @@ npm run convert # Hasilkan PDF dari docs
### Dokumentasi Docsify
```bash
npm install -g docsify-cli # Instal Docsify secara global
docsify serve # Jalankan di localhost:3000
npm install -g docsify-cli # Pasang Docsify secara global
docsify serve # Layani di localhost:3000
```
### Build Spesifik Proyek
Setiap direktori proyek dapat memiliki proses build sendiri:
- Proyek Vue: `npm run build` membuat bundle produksi
- Proyek statis: Tidak ada langkah build, file disajikan langsung
Setiap direktori proyek mungkin memiliki proses build sendiri:
- Proyek Vue: `npm run build` untuk membuat bundel produksi
- Proyek statis: Tidak ada langkah build, layani file langsung
## Pedoman Pull Request
## Panduan Pull Request
### Format Judul
Gunakan judul yang jelas dan deskriptif menunjukkan area perubahan:
- `[Quiz-app] Tambah kuis baru untuk pelajaran X`
Gunakan judul jelas yang menggambarkan area perubahan:
- `[Quiz-app] Tambahkan kuis baru untuk pelajaran X`
- `[Lesson-3] Perbaiki typo di proyek terrarium`
- `[Translation] Tambah terjemahan Spanyol untuk pelajaran 5`
- `[Docs] Perbarui instruksi setup`
@ -228,33 +228,33 @@ Gunakan judul yang jelas dan deskriptif menunjukkan area perubahan:
Sebelum mengirim PR:
1. **Kualitas Kode**:
- Jalankan `npm run lint` di direktori proyek yang terpengaruh
- Perbaiki semua error dan peringatan linting
- Jalankan `npm run lint` di direktori proyek terkait
- Perbaiki semua error dan peringatan lint
2. **Verifikasi Build**:
- Jalankan `npm run build` jika diperlukan
- Jalankan `npm run build` jika berlaku
- Pastikan tidak ada error build
3. **Validasi Tautan**:
- Uji semua tautan markdown
3. **Validasi Link**:
- Uji semua link markdown
- Verifikasi referensi gambar berfungsi
4. **Review Konten**:
- Baca ulang pengejaan dan tata bahasa
4. **Tinjau Konten**:
- Proofreading tata bahasa dan ejaan
- Pastikan contoh kode benar dan edukatif
- Verifikasi terjemahan mempertahankan makna asli
### Persyaratan Kontribusi
- Setuju dengan Microsoft CLA (cek otomatis pada PR pertama)
- Ikuti [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Lihat [CONTRIBUTING.md](./CONTRIBUTING.md) untuk pedoman rinci
- Cantumkan nomor isu dalam deskripsi PR jika ada
- Setujui Microsoft CLA (pemeriksaan otomatis pada PR pertama)
- Ikuti [Kode Etik Open Source Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Lihat [CONTRIBUTING.md](./CONTRIBUTING.md) untuk panduan rinci
- Referensikan nomor isu dalam deskripsi PR jika ada
### Proses Review
- PR direview oleh maintainer dan komunitas
- Kejelasan edukasi diprioritaskan
- PR direview oleh pemelihara dan komunitas
- Prioritaskan kejelasan edukasi
- Contoh kode harus mengikuti praktik terbaik saat ini
- Terjemahan direview untuk akurasi dan kesesuaian budaya
@ -263,20 +263,20 @@ Sebelum mengirim PR:
### Terjemahan Otomatis
- Menggunakan GitHub Actions dengan workflow co-op-translator
- Menerjemahkan otomatis ke 50+ bahasa
- Menerjemahkan ke lebih dari 50 bahasa secara otomatis
- File sumber di direktori utama
- File terjemahan di direktori `translations/{kode-bahasa}/`
- File terjemahan di direktori `translations/{language-code}/`
### Menambahkan Perbaikan Terjemahan Manual
### Menambah Perbaikan Terjemahan Manual
1. Temukan file di `translations/{kode-bahasa}/`
2. Lakukan perbaikan sambil mempertahankan struktur
1. Cari file di `translations/{language-code}/`
2. Buat perbaikan sambil mempertahankan struktur
3. Pastikan contoh kode tetap berfungsi
4. Uji konten kuis yang sudah dilokalkan
4. Uji konten kuis yang sudah diterjemahkan
### Metadata Terjemahan
File terjemahan menyertakan header metadata:
File terjemahan termasuk header metadata:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -298,57 +298,57 @@ CO_OP_TRANSLATOR_METADATA:
- Hapus `node_modules` dan `package-lock.json`, jalankan `npm install` lagi
- Periksa konflik port (default: Vite menggunakan port 5173)
**Server API tidak mau mulai**:
- Verifikasi versi Node.js minimal (node >=10)
- Cek apakah port sedang digunakan
**Server API tidak mulai**:
- Periksa versi Node.js minimal (node >=10)
- Periksa apakah port sudah digunakan
- Pastikan semua dependensi terinstall dengan `npm install`
**Ekstensi browser tidak termuat**:
- Pastikan manifest.json diformat dengan benar
- Cek console browser untuk error
- Ikuti instruksi instalasi ekstensi spesifik browser
**Ekstensi browser tidak dimuat**:
- Periksa format manifest.json sudah benar
- Periksa konsol browser untuk error
- Ikuti instruksi instalasi ekstensi khusus browser
**Masalah proyek obrolan Python**:
**Masalah proyek chat Python**:
- Pastikan paket OpenAI terinstall: `pip install openai`
- Verifikasi variabel lingkungan GITHUB_TOKEN disetel
- Periksa izin akses model GitHub
- Verifikasi variabel lingkungan GITHUB_TOKEN sudah diset
- Cek izin akses GitHub Models
**Docsify tidak menyajikan dokumentasi**:
- Install docsify-cli global: `npm install -g docsify-cli`
- Jalankan dari root repositori
- Pastikan `docs/_sidebar.md` ada
- Instal docsify-cli secara global: `npm install -g docsify-cli`
- Jalankan dari direktori root repositori
- Pastikan `docs/_sidebar.md` tersedia
### Tips Lingkungan Pengembangan
- Gunakan VS Code dengan ekstensi Live Server untuk proyek HTML
- Pasang ekstensi ESLint dan Prettier untuk konsistensi format
- Instal ekstensi ESLint dan Prettier untuk format konsisten
- Gunakan DevTools browser untuk debugging JavaScript
- Untuk proyek Vue, pasang ekstensi Vue DevTools di browser
- Untuk proyek Vue, pasang ekstensi Vue DevTools browser
### Pertimbangan Performa
- Banyaknya file terjemahan (50+ bahasa) berarti clone penuh cukup besar
- Gunakan clone shallow jika hanya mengerjakan konten: `git clone --depth 1`
- Kecualikan terjemahan dari pencarian saat mengerjakan konten bahasa Inggris
- Proses build mungkin lambat pada pertama kali (npm install, build Vite)
- Jumlah file terjemahan besar (50+ bahasa) membuat clone penuh besar
- Gunakan clone shallow jika hanya bekerja dengan konten: `git clone --depth 1`
- Kecualikan terjemahan dari pencarian saat bekerja dengan konten bahasa Inggris
- Proses build mungkin lambat pada run pertama (npm install, build Vite)
## Pertimbangan Keamanan
### Variabel Lingkungan
- Kunci API tidak boleh di-commit ke repositori
- Gunakan file `.env` (sudah dalam `.gitignore`)
- Dokumentasikan variabel lingkungan yang dibutuhkan pada README proyek
- API key tidak boleh disimpan di repositori
- Gunakan file `.env` (sudah ada di `.gitignore`)
- Dokumentasikan variabel lingkungan yang diperlukan di README proyek
### Proyek Python
- Gunakan virtual environment: `python -m venv venv`
- Jaga dependensi tetap terbarui
- Token GitHub harus memiliki izin minimal yang diperlukan
- Jaga dependensi tetap terupdate
- Token GitHub harus punya izin minimal yang dibutuhkan
### Akses Model GitHub
### Akses GitHub Models
- Personal Access Tokens (PAT) diperlukan untuk model GitHub
- Token Akses Pribadi (PAT) diperlukan untuk GitHub Models
- Token harus disimpan sebagai variabel lingkungan
- Jangan pernah commit token atau kredensial
@ -356,53 +356,53 @@ CO_OP_TRANSLATOR_METADATA:
### Sasaran Audiens
- Pemula lengkap dalam pengembangan web
- Pemula lengkap di pengembangan web
- Pelajar dan pembelajar mandiri
- Guru yang menggunakan kurikulum di kelas
- Konten dirancang untuk aksesibilitas dan pembangunan keterampilan bertahap
- Konten dirancang untuk aksesibilitas dan peningkatan kemampuan bertahap
### Filosofi Edukasi
- Pendekatan pembelajaran berbasis proyek
- Pemeriksaan pengetahuan sering (kuis)
- Latihan coding praktis
- Contoh aplikasi dunia nyata
- Pemeriksaan pengetahuan yang sering (kuis)
- Latihan coding langsung
- Contoh penerapan dunia nyata
- Fokus pada dasar sebelum framework
### Pemeliharaan Repositori
- Komunitas pembelajar dan kontributor yang aktif
- Pembaruan rutin pada dependensi dan konten
- Isu dan diskusi diawasi oleh maintainer
- Pembaruan terjemahan otomatis melalui GitHub Actions
- Masalah dan diskusi dipantau oleh pemelihara
- Update terjemahan otomatis melalui GitHub Actions
### Sumber Daya Terkait
- [Microsoft Learn modules](https://docs.microsoft.com/learn/)
- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
- [Modul Microsoft Learn](https://docs.microsoft.com/learn/)
- [Sumber Daya Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) direkomendasikan untuk pembelajar
- Kursus tambahan: Generative AI, Data Science, ML, IoT tersedia
- Kursus tambahan: Generative AI, Data Science, ML, kurikulum IoT tersedia
### Bekerja dengan Proyek Spesifik
Untuk instruksi detail proyek individual, lihat file README di:
Untuk instruksi rinci proyek individual, lihat README di:
- `quiz-app/README.md` - aplikasi kuis Vue 3
- `7-bank-project/README.md` - aplikasi perbankan dengan autentikasi
- `5-browser-extension/README.md` - pengembangan ekstensi browser
- `6-space-game/README.md` - pengembangan permainan canvas
- `9-chat-project/README.md` - proyek asisten obrolan AI
- `6-space-game/README.md` - pengembangan game berbasis canvas
- `9-chat-project/README.md` - proyek asisten chat AI
### Struktur Monorepo
Walaupun bukan monorepo tradisional, repositori ini berisi beberapa proyek independen:
- Setiap pelajaran berdiri sendiri
Meski bukan monorepo tradisional, repositori ini berisi beberapa proyek independen:
- Setiap pelajaran bersifat mandiri
- Proyek tidak berbagi dependensi
- Kerjakan proyek individual tanpa memengaruhi yang lain
- Kerjakan proyek individual tanpa memengaruhi proyek lain
- Clone seluruh repo untuk pengalaman kurikulum lengkap
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Penafian**:
Dokumen ini telah diterjemahkan menggunakan layanan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Meskipun kami berusaha untuk akurasi, harap diingat bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidakakuratan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang sahih. Untuk informasi penting, disarankan menggunakan terjemahan profesional oleh manusia. Kami tidak bertanggung jawab atas kesalahpahaman atau salah tafsir yang timbul dari penggunaan terjemahan ini.
Dokumen ini telah diterjemahkan menggunakan layanan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Meskipun kami berusaha untuk akurasi, harap diingat bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidakakuratan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang sah. Untuk informasi yang penting, disarankan untuk menggunakan terjemahan profesional oleh manusia. Kami tidak bertanggung jawab atas kesalahpahaman atau penafsiran yang salah yang timbul dari penggunaan terjemahan ini.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T16:50:07+00:00",
"translation_date": "2026-04-20T16:45:17+00:00",
"source_file": "AGENTS.md",
"language_code": "ms"
},

@ -2,23 +2,23 @@
## Gambaran Projek
Ini adalah repositori kurikulum pendidikan untuk mengajar asas pembangunan web kepada pemula. Kurikulum ini adalah kursus lengkap selama 12 minggu yang dibangunkan oleh Microsoft Cloud Advocates, menampilkan 24 pelajaran amali yang merangkumi JavaScript, CSS, dan HTML.
Ini adalah repositori kurikulum pendidikan untuk mengajar asas pembangunan web kepada pemula. Kurikulum ini merupakan kursus menyeluruh selama 12 minggu yang dibangunkan oleh Microsoft Cloud Advocates, menampilkan 24 pelajaran praktikal yang merangkumi JavaScript, CSS, dan HTML.
### Komponen Utama
- **Kandungan Pendidikan**: 24 pelajaran berstruktur yang disusun dalam modul berasaskan projek
- **Projek Praktikal**: Terrarium, Permainan Mengetik, Sambungan Pelayar, Permainan Angkasa, Aplikasi Perbankan, Penyunting Kod, dan Pembantu Sembang AI
- **Kuis Interaktif**: 48 kuis dengan 3 soalan setiap satu (penilaian pra/pasca pelajaran)
- **Sokongan Pelbagai Bahasa**: Terjemahan automatik untuk lebih 50+ bahasa melalui GitHub Actions
- **Teknologi**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (untuk projek AI)
- **Kandungan Pendidikan**: 24 pelajaran tersusun yang dianjurkan dalam modul berasaskan projek
- **Projek Praktikal**: Terrarium, Permainan Mengetik, Sambungan Pelayar, Permainan Angkasa, Aplikasi Perbankan, Penyunting Kod, dan Pembantu Chat AI
- **Kuis Interaktif**: 48 kuiz dengan 3 soalan setiap satu (penilaian sebelum/selepas pelajaran)
- **Sokongan Pelbagai Bahasa**: Terjemahan automatik untuk lebih 50 bahasa melalui GitHub Actions
- **Teknologi**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (untuk projek AI)
### Senibina
### Seni Bina
- Repositori pendidikan dengan struktur berasaskan pelajaran
- Setiap folder pelajaran mengandungi README, contoh kod, dan penyelesaian
- Projek berdikari di direktori berasingan (quiz-app, pelbagai projek pelajaran)
- Sistem terjemahan menggunakan GitHub Actions (co-op-translator)
- Dokumentasi dihidangkan melalui Docsify dan tersedia sebagai PDF
- Repositori pendidikan dengan struktur berasaskan pelajaran
- Setiap folder pelajaran mengandungi README, contoh kod, dan penyelesaian
- Projek bebas di direktori berasingan (quiz-app, pelbagai projek pelajaran)
- Sistem terjemahan menggunakan GitHub Actions (co-op-translator)
- Dokumentasi disajikan melalui Docsify dan tersedia dalam format PDF
## Perintah Persediaan
@ -30,7 +30,7 @@ Repositori ini terutamanya untuk penggunaan kandungan pendidikan. Untuk bekerja
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Persediaan Aplikasi Kuis (Vue 3 + Vite)
```bash
@ -40,7 +40,7 @@ npm run dev # Mula pelayan pembangunan
npm run build # Bina untuk pengeluaran
npm run lint # Jalankan ESLint
```
### API Projek Bank (Node.js + Express)
```bash
@ -50,24 +50,24 @@ npm start # Mula pelayan API
npm run lint # Jalankan ESLint
npm run format # Format dengan Prettier
```
### Projek Sambungan Pelayar
```bash
cd 5-browser-extension/solution
npm install
# Ikuti arahan muat naik pelanjutan khusus pelayar
# Ikuti arahan pemuatan pelanjutan khusus pelayar
```
### Projek Permainan Angkasa
```bash
cd 6-space-game/solution
npm install
# Buka index.html dalam pelayar atau gunakan Live Server
# Buka index.html dalam pelayar atau guna Live Server
```
### Projek Sembang (Backend Python)
### Projek Chat (Backend Python)
```bash
cd 9-chat-project/solution/backend/python
@ -75,34 +75,34 @@ pip install openai
# Tetapkan pembolehubah persekitaran GITHUB_TOKEN
python api.py
```
## Aliran Kerja Pembangunan
### Untuk Penyumbang Kandungan
1. **Fork repositori** ke akaun GitHub anda
2. **Clone fork anda** secara lokal
3. **Buat cawangan baru** untuk perubahan anda
4. Buat perubahan pada kandungan pelajaran atau contoh kod
5. Uji sebarang perubahan kod dalam direktori projek berkaitan
6. Hantar pull request mengikut panduan sumbangan
1. **Fork repositori** ke akaun GitHub anda
2. **Clone fork anda** secara lokal
3. **Buat cawangan baru** untuk perubahan anda
4. Lakukan perubahan pada kandungan pelajaran atau contoh kod
5. Uji sebarang perubahan kod dalam direktori projek berkaitan
6. Hantar pull request mengikut garis panduan sumbangan
### Untuk Pelajar
1. Fork atau clone repositori
2. Navigasi ke direktori pelajaran secara berurutan
3. Baca fail README untuk setiap pelajaran
4. Selesaikan kuis pra-pelajaran di https://ff-quizzes.netlify.app/web/
5. Kerjakan contoh kod dalam folder pelajaran
6. Lengkapkan tugasan dan cabaran
7. Ambil kuis pasca-pelajaran
1. Fork atau clone repositori
2. Navigasi ke direktori pelajaran secara berurutan
3. Baca fail README untuk setiap pelajaran
4. Selesaikan kuiz pra-pelajaran di https://ff-quizzes.netlify.app/web/
5. Kerjakan contoh kod dalam folder pelajaran
6. Selesaikan tugasan dan cabaran
7. Ambil kuiz pasca-pelajaran
### Pembangunan Langsung
- **Dokumentasi**: Jalankan `docsify serve` di root (port 3000)
- **Aplikasi Kuis**: Jalankan `npm run dev` di direktori quiz-app
- **Projek**: Gunakan sambungan Live Server VS Code untuk projek HTML
- **Projek API**: Jalankan `npm start` dalam direktori API masing-masing
- **Dokumentasi**: Jalankan `docsify serve` di root (port 3000)
- **Aplikasi Kuis**: Jalankan `npm run dev` di direktori quiz-app
- **Projek**: Gunakan sambungan VS Code Live Server untuk projek HTML
- **Projek API**: Jalankan `npm start` di direktori API berkaitan
## Arahan Ujian
@ -110,173 +110,173 @@ python api.py
```bash
cd quiz-app
npm run lint # Semak untuk isu gaya kod
npm run build # Sahkan binaan berjaya
npm run lint # Periksa isu gaya kod
npm run build # Sahkan pembinaan berjaya
```
### Ujian API Bank
```bash
cd 7-bank-project/api
npm run lint # Periksa masalah gaya kod
npm run lint # Periksa isu gaya kod
node server.js # Sahkan pelayan bermula tanpa ralat
```
### Pendekatan Ujian Umum
- Ini adalah repositori pendidikan tanpa ujian automatik menyeluruh
- Ujian manual memberi fokus kepada:
- Contoh kod berjalan tanpa ralat
- Pautan dalam dokumentasi berfungsi dengan betul
- Projek membina dengan jayanya
- Contoh mengikut amalan terbaik
- Ini adalah repositori pendidikan tanpa ujian automatik menyeluruh
- Ujian manual fokus pada:
- Contoh kod berjalan tanpa ralat
- Pautan dalam dokumentasi berfungsi dengan betul
- Pembinaan projek selesai dengan jayanya
- Contoh mengikuti amalan terbaik
### Semakan Pra-penyerahan
### Semakan Pra-penghantaran
- Jalankan `npm run lint` di direktori dengan package.json
- Sahkan pautan markdown adalah sah
- Uji contoh kod dalam pelayar atau Node.js
- Semak terjemahan mengekalkan struktur betul
- Jalankan `npm run lint` di direktori yang mengandungi package.json
- Sahkan pautan markdown sah
- Uji contoh kod dalam pelayar atau Node.js
- Periksa terjemahan mengekalkan struktur betul
## Garis Panduan Gaya Kod
### JavaScript
- Gunakan sintaks ES6+ moden
- Ikuti konfigurasi ESLint standard yang disediakan dalam projek
- Gunakan nama pembolehubah dan fungsi bermakna untuk kejelasan pendidikan
- Tambah komen yang menerangkan konsep untuk pelajar
- Format menggunakan Prettier apabila dikonfigurasi
- Gunakan sintaks ES6+ moden
- Ikuti konfigurasi ESLint standard yang disediakan dalam projek
- Gunakan nama pemboleh ubah dan fungsi yang bermakna untuk kejelasan pendidikan
- Tambah komen yang menerangkan konsep untuk pelajar
- Format menggunakan Prettier di mana dikonfigurasi
### HTML/CSS
- Elemen semantic HTML5
- Prinsip reka bentuk responsif
- Konvensyen nama kelas yang jelas
- Komen menerangkan teknik CSS untuk pelajar
- Elemen HTML5 semantik
- Prinsip reka bentuk responsif
- Konvensyen penamaan kelas yang jelas
- Komen menerangkan teknik CSS untuk pelajar
### Python
- Garis panduan gaya PEP 8
- Contoh kod jelas dan pendidikan
- Petunjuk jenis jika membantu pembelajaran
- Garis panduan gaya PEP 8
- Contoh kod yang jelas dan pendidikan
- Petunjuk jenis di mana berguna untuk pembelajaran
### Dokumentasi Markdown
- Hierarki tajuk yang jelas
- Blok kod dengan spesifikasi bahasa
- Pautan ke sumber tambahan
- Tangkapan skrin dan imej dalam direktori `images/`
- Teks alt untuk imej demi aksesibiliti
- Hirarki tajuk yang jelas
- Blok kod dengan spesifikasi bahasa
- Pautan ke sumber tambahan
- Tangkapan skrin dan imej dalam direktori `images/`
- Teks alt untuk imej bagi kebolehcapaian
### Pengurusan Fail
- Pelajaran bernombor secara berurutan (1-getting-started-lessons, 2-js-basics, dan lain-lain)
- Setiap projek ada `solution/` dan biasanya `start/` atau `your-work/` direktori
- Imej disimpan dalam folder `images/` khusus pelajaran
- Terjemahan dalam struktur `translations/{language-code}/`
- Pelajaran dinomborkan secara berurutan (1-getting-started-lessons, 2-js-basics, dll.)
- Setiap projek mempunyai direktori `solution/` dan sering `start/` atau `your-work/`
- Imej disimpan dalam folder `images/` khusus pelajaran
- Terjemahan dalam struktur `translations/{language-code}/`
## Pembinaan dan Penyebaran
## Pembinaan dan Penghantaran
### Penyebaran Aplikasi Kuis (Azure Static Web Apps)
### Penghantaran Aplikasi Kuis (Azure Static Web Apps)
quiz-app dikonfigurasi untuk penyebaran Azure Static Web Apps:
quiz-app dikonfigurasi untuk penghantaran Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Mewujudkan folder dist/
# Melaksanakan melalui alur kerja GitHub Actions apabila push ke main
npm run build # Membuat folder dist/
# Melakukan deploy melalui workflow GitHub Actions apabila ada push ke main
```
Konfigurasi Azure Static Web Apps:
- **Lokasi app**: `/quiz-app`
- **Lokasi output**: `dist`
- **Aliran kerja**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
Konfigurasi Azure Static Web Apps:
- **Lokasi aplikasi**: `/quiz-app`
- **Lokasi output**: `dist`
- **Aliran kerja**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Penjanaan PDF Dokumentasi
```bash
npm install # Pasang docsify-to-pdf
npm run convert # Jana PDF daripada docs
npm run convert # Hasilkan PDF daripada docs
```
### Dokumentasi Docsify
```bash
npm install -g docsify-cli # Pasang Docsify secara global
docsify serve # Hidangkan pada localhost:3000
```
### Pembinaan Khusus Projek
Setiap direktori projek mungkin mempunyai proses binaan sendiri:
- Projek Vue: `npm run build` menghasilkan bundel produksi
- Projek statik: Tiada langkah binaan, hidangkan fail secara langsung
Setiap direktori projek mungkin mempunyai proses binaan sendiri:
- Projek Vue: `npm run build` menghasilkan bundle pengeluaran
- Projek statik: Tiada langkah binaan, hidangkan fail secara langsung
## Garis Panduan Pull Request
### Format Tajuk
Gunakan tajuk jelas dan deskriptif yang menunjukkan kawasan perubahan:
- `[Quiz-app] Tambah kuiz baru untuk pelajaran X`
- `[Pelajaran-3] Betulkan kesilapan ejaan dalam projek terrarium`
- `[Terjemahan] Tambah terjemahan Sepanyol untuk pelajaran 5`
- `[Docs] Kemas kini arahan persediaan`
Gunakan tajuk jelas dan deskriptif yang menunjukkan bidang perubahan:
- `[Quiz-app] Tambah kuiz baru untuk pelajaran X`
- `[Lesson-3] Betulkan ejaan dalam projek terrarium`
- `[Translation] Tambah terjemahan Sepanyol untuk pelajaran 5`
- `[Docs] Kemas kini arahan persediaan`
### Semakan Wajib
### Semakan Diperlukan
Sebelum menghantar PR:
Sebelum menghantar PR:
1. **Kualiti Kod**:
- Jalankan `npm run lint` di direktori projek terlibat
- Betulkan semua ralat dan amaran linting
1. **Kualiti Kod**:
- Jalankan `npm run lint` di direktori projek terjejas
- Betulkan semua ralat dan amaran linting
2. **Pengesahan Binaan**:
- Jalankan `npm run build` jika berkenaan
- Pastikan tiada ralat binaan
2. **Pengesahan Pembinaan**:
- Jalankan `npm run build` jika berkaitan
- Pastikan tiada ralat binaan
3. **Pengesahan Pautan**:
- Uji semua pautan markdown
- Sahkan rujukan imej berfungsi
3. **Pengesahan Pautan**:
- Uji semua pautan markdown
- Sahkan rujukan imej berfungsi
4. **Semakan Kandungan**:
- Semak ejaan dan tatabahasa
- Pastikan contoh kod betul dan pendidikan
- Sahkan terjemahan mengekalkan maksud asal
4. **Semakan Kandungan**:
- Semak ejaan dan tatabahasa
- Pastikan contoh kod tepat dan pendidikan
- Sahkan terjemahan mengekalkan maksud asal
### Keperluan Penyumbangan
- Setuju dengan Microsoft CLA (semakan automatik pada PR pertama)
- Ikuti [Kod Etika Sumber Terbuka Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Rujuk [CONTRIBUTING.md](./CONTRIBUTING.md) untuk panduan terperinci
- Rujuk nombor isu dalam penerangan PR jika berkenaan
- Setuju dengan Microsoft CLA (semakan automatik pada PR pertama)
- Ikuti [Kod Etika Sumber Terbuka Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Lihat [CONTRIBUTING.md](./CONTRIBUTING.md) untuk garis panduan terperinci
- Rujuk nombor isu dalam penerangan PR jika berkenaan
### Proses Semakan
- PR disemak oleh penyelenggara dan komuniti
- Kejelasan pendidikan diberi keutamaan
- Contoh kod harus mengikut amalan terbaik semasa
- Terjemahan disemak dari segi ketepatan dan kesesuaian budaya
- PR disemak oleh penyelenggara dan komuniti
- Kejelasan pendidikan diutamakan
- Contoh kod harus mengikuti amalan terbaik terkini
- Terjemahan disemak ketepatan dan kesesuaian budaya
## Sistem Terjemahan
### Terjemahan Automatik
- Menggunakan GitHub Actions dengan workflow co-op-translator
- Menerjemah ke 50+ bahasa secara automatik
- Fail sumber dalam direktori utama
- Fail terjemahan dalam `translations/{language-code}/` direktori
- Menggunakan GitHub Actions dengan aliran kerja co-op-translator
- Menterjemah ke 50+ bahasa secara automatik
- Fail sumber dalam direktori utama
- Fail terjemahan dalam direktori `translations/{language-code}/`
### Menambah Penambahbaikan Terjemahan Manual
1. Cari fail dalam `translations/{language-code}/`
2. Lakukan penambahbaikan sambil mengekalkan struktur
3. Pastikan contoh kod masih berfungsi
4. Uji sebarang kandungan kuiz yang dilokalkan
1. Cari fail dalam `translations/{language-code}/`
2. Lakukan penambahbaikan sambil mengekalkan struktur
3. Pastikan contoh kod kekal berfungsi
4. Uji sebarang kandungan kuiz yang dialih bahasa
### Metadata Terjemahan
Fail terjemahan termasuk pengepala metadata:
Fail terjemahan termasuk tajuk metadata:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -288,121 +288,121 @@ CO_OP_TRANSLATOR_METADATA:
}
-->
```
## Pengesanan Masalah dan Penyelesaian Masalah
### Isu Lazim
## Pengesanan dan Penyelesaian Masalah
### Isu Biasa
**Aplikasi kuis gagal mula**:
- Semak versi Node.js (disyorkan v14+)
- Padam `node_modules` dan `package-lock.json`, jalankan `npm install` semula
- Semak konflik port (default: Vite menggunakan port 5173)
**Aplikasi kuiz gagal dimulakan**:
- Periksa versi Node.js (disyorkan v14+)
- Padamkan `node_modules` dan `package-lock.json`, jalankan `npm install` semula
- Semak konflik port (lalai: Vite guna port 5173)
**Server API tidak mula**:
- Sahkan versi Node.js memenuhi minimum (node >=10)
- Semak sama ada port sudah digunakan
- Pastikan semua kebergantungan dipasang dengan `npm install`
**Pelayan API tidak mula**:
- Sahkan versi Node.js memenuhi minimum (node >=10)
- Periksa jika port sudah digunakan
- Pastikan semua kebergantungan dipasang dengan `npm install`
**Sambungan pelayar tidak dimuatkan**:
- Sahkan manifest.json diformat dengan betul
- Semak konsol pelayar untuk ralat
- Ikut arahan pemasangan sambungan khusus pelayar
**Sambungan pelayar tidak dimuat**:
- Periksa manifest.json diformat dengan betul
- Semak konsol pelayar untuk ralat
- Ikuti arahan pemasangan sambungan khusus pelayar
**Isu projek chat Python**:
- Pastikan pakej OpenAI dipasang: `pip install openai`
- Sahkan pembolehubah persekitaran GITHUB_TOKEN diset
- Semak kebenaran akses Model GitHub
**Isu projek chat Python**:
- Pastikan pakej OpenAI dipasang: `pip install openai`
- Sahkan pembolehubah persekitaran GITHUB_TOKEN diset
- Periksa kebenaran akses GitHub Models
**Docsify tidak menghidang dokumentasi**:
- Pasang docsify-cli secara global: `npm install -g docsify-cli`
- Jalankan dari direktori root repositori
- Semak bahawa `docs/_sidebar.md` wujud
**Docsify tidak menyajikan dokumen**:
- Pasang docsify-cli secara global: `npm install -g docsify-cli`
- Jalankan dari direktori root repositori
- Semak bahawa `docs/_sidebar.md` wujud
### Petua Persekitaran Pembangunan
### Tips Persekitaran Pembangunan
- Gunakan VS Code dengan sambungan Live Server untuk projek HTML
- Pasang sambungan ESLint dan Prettier untuk format konsisten
- Gunakan DevTools pelayar untuk pengesanan JavaScript
- Untuk projek Vue, pasang sambungan Vue DevTools pelayar
- Gunakan VS Code dengan sambungan Live Server untuk projek HTML
- Pasang sambungan ESLint dan Prettier untuk format konsisten
- Gunakan DevTools pelayar untuk debug JavaScript
- Untuk projek Vue, pasang sambungan Vue DevTools pelayar
### Pertimbangan Prestasi
- Bilangan fail terjemahan yang banyak (50+ bahasa) bermakna klon penuh adalah besar
- Gunakan shallow clone jika hanya bekerja pada kandungan: `git clone --depth 1`
- Kecualikan terjemahan daripada carian apabila bekerja pada kandungan Bahasa Inggeris
- Proses binaan mungkin lambat pada larian pertama (npm install, binaan Vite)
- Bilangan fail terjemahan yang banyak (50+ bahasa) menyebabkan klon penuh besar
- Gunakan clone cetek jika hanya bekerja dengan kandungan: `git clone --depth 1`
- Kecualikan terjemahan dari carian ketika bekerja pada kandungan Inggeris
- Proses binaan mungkin perlahan pada kali pertama (npm install, binaan Vite)
## Pertimbangan Keselamatan
### Pembolehubah Persekitaran
- Kekunci API tidak harus pernah dikomit ke repositori
- Gunakan fail `.env` (sudah dalam `.gitignore`)
- Dokumentasikan pembolehubah persekitaran diperlukan dalam README projek
- Kunci API tidak boleh dimuat naik ke repositori
- Gunakan fail `.env` (sudah disenarai dalam `.gitignore`)
- Dokumentasikan pembolehubah persekitaran yang diperlukan dalam README projek
### Projek Python
- Gunakan persekitaran maya: `python -m venv venv`
- Pastikan kebergantungan dikemas kini
- Token GitHub harus mempunyai kebenaran minimum diperlukan
- Gunakan persekitaran maya: `python -m venv venv`
- Kemas kini kebergantungan secara berkala
- Token GitHub hendaklah mempunyai kebenaran minimum diperlukan
### Akses Model GitHub
### Akses GitHub Models
- Token Akses Peribadi (PAT) diperlukan untuk Model GitHub
- Token harus disimpan sebagai pembolehubah persekitaran
- Jangan sekali-kali komit token atau kelayakan
- Token Akses Peribadi (PAT) diperlukan untuk GitHub Models
- Token disimpan sebagai pembolehubah persekitaran
- Jangan sesekali memuat naik token atau kelayakan
## Nota Tambahan
### Audiens Sasaran
### Sasaran Pengguna
- Pemula lengkap dalam pembangunan web
- Pelajar dan pembelajar kendiri
- Guru yang menggunakan kurikulum dalam bilik darjah
- Kandungan direka untuk aksesibiliti dan pembinaan kemahiran secara berperingkat
- Pemula lengkap dalam pembangunan web
- Pelajar dan pembelajar kendiri
- Guru yang menggunakan kurikulum dalam bilik darjah
- Kandungan direka untuk kebolehcapaian dan pembinaan kemahiran secara berperingkat
### Falsafah Pendidikan
- Pendekatan pembelajaran berasaskan projek
- Pemeriksaan ilmu yang kerap (kuis)
- Latihan pengkodan amali
- Contoh aplikasi dunia nyata
- Fokus pada asas sebelum kerangka kerja
- Pendekatan pembelajaran berasaskan projek
- Pemeriksaan pengetahuan kerap (kuiz)
- Latihan amali pengkodan
- Contoh aplikasi dunia sebenar
- Fokus pada asas sebelum kerangka kerja
### Penyelenggaraan Repositori
- Komuniti pembelajar dan penyumbang yang aktif
- Kemas kini berkala ke kebergantungan dan kandungan
- Isu dan perbincangan dipantau oleh penyelenggara
- Kemas kini terjemahan automatik melalui GitHub Actions
- Komuniti pelajar dan penyumbang aktif
- Kemas kini kandungan dan kebergantungan secara berkala
- Isu dan perbincangan dipantau oleh penyelenggara
- Kemas kini terjemahan automatik melalui GitHub Actions
### Sumber Berkaitan
- [Modul Microsoft Learn](https://docs.microsoft.com/learn/)
- [Sumber Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) disyorkan untuk pelajar
- Kursus tambahan: AI Generatif, Sains Data, ML, kurikulum IoT tersedia
- [Modul Microsoft Learn](https://docs.microsoft.com/learn/)
- [Sumber Pelajar Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) disyorkan untuk pelajar
- Kursus tambahan: AI Generatif, Sains Data, ML, kurikulum IoT tersedia
### Bekerja dengan Projek Tertentu
Untuk arahan terperinci mengenai projek individu, rujuk fail README dalam:
- `quiz-app/README.md` - aplikasi kuis Vue 3
- `7-bank-project/README.md` - aplikasi perbankan dengan pengesahan
- `5-browser-extension/README.md` - pembangunan sambungan pelayar
- `6-space-game/README.md` - pembangunan permainan berasaskan canvas
- `9-chat-project/README.md` - projek pembantu sembang AI
Untuk arahan terperinci projek individu, rujuk fail README di:
- `quiz-app/README.md` - aplikasi kuiz Vue 3
- `7-bank-project/README.md` - aplikasi perbankan dengan pengesahan
- `5-browser-extension/README.md` - pembangunan sambungan pelayar
- `6-space-game/README.md` - pembangunan permainan berasaskan canvas
- `9-chat-project/README.md` - projek pembantu chat AI
### Struktur Monorepo
Walaupun bukan monorepo tradisional, repositori ini mengandungi pelbagai projek bebas:
- Setiap pelajaran adalah berdikari
- Projek tidak berkongsi kebergantungan
- Bekerja pada projek individu tanpa menjejaskan projek lain
- Klon keseluruhan repo untuk pengalaman kurikulum penuh
Walaupun bukan monorepo tradisional, repositori ini mengandungi pelbagai projek bebas:
- Setiap pelajaran berdiri sendiri
- Projek tidak berkongsi kebergantungan
- Kerja pada projek individu tanpa menjejaskan yang lain
- Clone keseluruhan repositori untuk pengalaman kurikulum penuh
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Penafian**:
Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Walaupun kami berusaha untuk ketepatan, sila diberi perhatian bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidakakuratan. Dokumen asal dalam bahasa asalnya hendaklah dianggap sebagai sumber yang sahih. Untuk maklumat kritikal, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab terhadap sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini.
Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Walaupun kami berusaha untuk ketepatan, sila maklum bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang sahih. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab terhadap sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T16:51:17+00:00",
"translation_date": "2026-04-20T16:46:27+00:00",
"source_file": "AGENTS.md",
"language_code": "tl"
},

@ -2,27 +2,27 @@
## Project Overview
Ito ay isang edukasyonal na repositoryo ng kurikulum para sa pagtuturo ng mga pundasyon ng web development sa mga nagsisimula. Ang kurikulum ay isang komprehensibong 12-linggong kurso na binuo ng Microsoft Cloud Advocates, na may 24 na hands-on na aralin na sumasaklaw sa JavaScript, CSS, at HTML.
Ito ay isang edukasyonal na repositoryo ng kurikulum para sa pagtuturo ng mga pangunahing kaalaman sa web development sa mga nagsisimula. Ang kurikulum ay isang komprehensibong 12-linggong kurso na binuo ng Microsoft Cloud Advocates, na nagtatampok ng 24 na hands-on na aralin na sumasaklaw sa JavaScript, CSS, at HTML.
### Key Components
- **Nilalamang Pang-edukasyon**: 24 na istrukturadong aralin na inayos sa mga module batay sa proyekto
- **Mga Praktikal na Proyekto**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, at AI Chat Assistant
- **Mga Interactive na Quiz**: 48 na quiz na may tig-3 tanong bawat isa (pre/post-lesson assessments)
- **Suporta sa Maramihang Wika**: Awtomatikong pagsasalin para sa 50+ na wika gamit ang GitHub Actions
- **Nilalaman Pang-edukasyon**: 24 na istrukturadong aralin na inayos sa mga proyekto bilang mga modulo
- **Praktikal na Mga Proyekto**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, at AI Chat Assistant
- **Interaktibong Mga Quiz**: 48 na quiz na may tig-3 tanong bawat isa (pagsusulit bago/pagkatapos ng aralin)
- **Suporta sa Maraming Wika**: Awtomatikong pagsasalin para sa 50+ na wika gamit ang GitHub Actions
- **Mga Teknolohiya**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para sa mga AI na proyekto)
### Architecture
- Edukasyonal na repositoryo na may lesson-based na estruktura
- Bawat folder ng aralin ay naglalaman ng README, mga halimbawa ng code, at mga solusyon
- Mga standalone na proyekto sa hiwalay na mga direktoryo (quiz-app, iba't ibang proyekto ng aralin)
- Edukasyonal na repositoryo na may istruktura batay sa mga aralin
- Ang bawat folder ng aralin ay naglalaman ng README, mga halimbawa ng code, at mga solusyon
- Mga standalone na proyekto sa hiwalay na mga direktoryo (quiz-app, iba't ibang mga proyekto sa aralin)
- Sistema ng pagsasalin gamit ang GitHub Actions (co-op-translator)
- Dokumentasyon na ipinapakita sa pamamagitan ng Docsify at available bilang PDF
- Dokumentasyon na ibinibigay sa pamamagitan ng Docsify at available bilang PDF
## Setup Commands
Ang repositoryong ito ay pangunahing para sa pagkonsumo ng edukasyonal na nilalaman. Para sa pagtatrabaho sa mga partikular na proyekto:
Ang repositoryong ito ay pangunahing para sa konsumpsyon ng edukasyonal na nilalaman. Para sa pagtatrabaho sa mga partikular na proyekto:
### Main Repository Setup
@ -37,7 +37,7 @@ cd Web-Dev-For-Beginners
cd quiz-app
npm install
npm run dev # Simulan ang development server
npm run build # Bumuo para sa produksyon
npm run build # I-build para sa produksyon
npm run lint # Patakbuhin ang ESLint
```
@ -56,7 +56,7 @@ npm run format # I-format gamit ang Prettier
```bash
cd 5-browser-extension/solution
npm install
# Sundin ang mga tagubilin para sa pag-load ng extension na tiyak sa browser
# Sundin ang mga tagubilin sa pag-load ng extension na partikular sa browser
```
### Space Game Projects
@ -72,37 +72,37 @@ npm install
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# Itakda ang environment variable na GITHUB_TOKEN
# Itakda ang GITHUB_TOKEN na variable ng kapaligiran
python api.py
```
## Development Workflow
### Para sa mga Content Contributors
### Para sa mga Contributor ng Nilalaman
1. **I-fork ang repository** sa iyong GitHub account
1. **I-fork ang repositoryo** sa iyong GitHub account
2. **I-clone ang iyong fork** nang lokal
3. **Gumawa ng bagong branch** para sa iyong mga pagbabago
4. Gumawa ng mga pagbabago sa nilalaman ng aralin o mga halimbawa ng code
5. Subukan ang anumang mga pagbabago sa code sa mga kaukulang direktoryo ng proyekto
6. Mag-submit ng pull request alinsunod sa mga panuntunan ng kontribusyon
3. **Gumawa ng bagong sanga** para sa iyong mga pagbabago
4. Gawin ang mga pagbabago sa nilalaman ng aralin o mga halimbawa ng code
5. Subukan ang anumang pagbabago sa code sa mga kaukulang direktoryo ng proyekto
6. Mag-submit ng pull requests alinsunod sa mga gabay sa kontribusyon
### Para sa mga Learners
### Para sa mga Nag-aaral
1. Mag-fork o mag-clone ng repositoryo
2. Pumunta sa mga direktoryo ng aralin nang sunud-sunod
3. Basahin ang mga README na file para sa bawat aralin
4. Kumpletuhin ang mga pre-lesson quiz sa https://ff-quizzes.netlify.app/web/
5. Gawing ang mga halimbawa ng code sa mga folder ng aralin
6. Tapusin ang mga assignment at hamon
7. Kunin ang mga post-lesson quiz
1. I-fork o i-clone ang repositoryo
2. Mag-navigate sa mga direktoryo ng aralin sunod-sunod
3. Basahin ang mga README file para sa bawat aralin
4. Kumpletuhin ang mga pre-lesson quizzes sa https://ff-quizzes.netlify.app/web/
5. Trabahuhin ang mga halimbawa ng code sa mga folder ng aralin
6. Kumpletuhin ang mga takdang-aralin at hamon
7. Sagutan ang mga post-lesson quizzes
### Live Development
- **Dokumentasyon**: Patakbuhin ang `docsify serve` sa root (port 3000)
- **Quiz App**: Patakbuhin ang `npm run dev` sa direktoryo ng quiz-app
- **Quiz App**: Patakbuhin ang `npm run dev` sa folder ng quiz-app
- **Mga Proyekto**: Gamitin ang VS Code Live Server extension para sa mga HTML na proyekto
- **API Projects**: Patakbuhin ang `npm start` sa kaukulang mga direktoryo ng API
- **API Projects**: Patakbuhin ang `npm start` sa mga kaukulang API na direktoryo
## Testing Instructions
@ -110,71 +110,71 @@ python api.py
```bash
cd quiz-app
npm run lint # Suriin ang mga isyu sa estilo ng code
npm run build # Tiyakin na matagumpay ang build
npm run lint # Suriin kung may mga isyu sa istilo ng kodigo
npm run build # Tiyakin na matagumpay ang pagbuo
```
### Bank API Testing
```bash
cd 7-bank-project/api
npm run lint # Suriin ang mga isyu sa istilo ng code
node server.js # Tiyakin na nagsisimula ang server nang walang mga error
npm run lint # Suriin ang mga isyu sa estilo ng code
node server.js # Tiyaking nagsisimula ang server nang walang mga error
```
### General Testing Approach
### Pangkalahatang Paraan ng Pagsusuri
- Ito ay isang edukasyonal na repositoryo na walang kumpletong automated tests
- Manual testing ay nakatuon sa:
- Mga halimbawa ng code na tumatakbo nang walang error
- Mga link sa dokumentasyon ay gumagana nang tama
- Proyekto ay matagumpay na na-build
- Mga halimbawa ay sumusunod sa pinakamahusay na kasanayan
- Ito ay isang edukasyonal na repositoryo na walang komprehensibong automated tests
- Ang manual na pagsusuri ay nakatuon sa:
- Hindi nagkakaroon ng error ang mga halimbawa ng code kapag pinatakbo
- Gumagana nang maayos ang mga links sa dokumentasyon
- Matagumpay ang pagbuo ng mga proyekto
- Sumusunod ang mga halimbawa sa pinakamahusay na mga kasanayan
### Pre-submission Checks
### Mga Pre-submission Checks
- Patakbuhin ang `npm run lint` sa mga direktoryo na may package.json
- Siguraduhing ang mga markdown link ay valid
- Patakbuhin ang `npm run lint` sa mga direktoryong may package.json
- Tiyakin na wasto ang mga markdown links
- Subukan ang mga halimbawa ng code sa browser o Node.js
- Suriin na ang mga pagsasalin ay nagpapanatili ng tamang estruktura
- Suriin na ang mga pagsasalin ay nananatiling maayos ang istruktura
## Code Style Guidelines
### JavaScript
- Gumamit ng modernong ES6+ na sintaks
- Sundan ang standard na ESLint configurations na ibinigay sa mga proyekto
- Gumamit ng makahulugang pangalan ng mga variable at function para sa kalinawan sa edukasyon
- Magdagdag ng mga komento na nagpapaliwanag ng mga konsepto para sa mga nag-aaral
- Gumamit ng makabagong ES6+ na syntax
- Sundin ang mga standard ESLint na konfigurasyon na ibinigay sa mga proyekto
- Gumamit ng makabuluhang mga pangalan ng variable at function para sa kalinawan sa edukasyon
- Magdagdag ng mga paliwanag na komentaryo tungkol sa mga konsepto para sa mga nag-aaral
- I-format gamit ang Prettier kung saan naka-configure
### HTML/CSS
- Semantic na HTML5 na mga elemento
- Semantic HTML5 elements
- Mga prinsipyo ng responsive design
- Malinaw na klaseng pagnenaming mga kombensiyon
- Mga komento na nagpapaliwanag ng mga teknik sa CSS para sa mga nag-aaral
- Malinaw na conventions sa pagbibigay ng pangalan sa mga klase
- Mga komentaryo na nagpapaliwanag ng mga teknik sa CSS para sa mga nag-aaral
### Python
- PEP 8 na mga gabay sa estilo
- Malinaw, edukasyonal na mga halimbawa ng code
- Mga type hint kung makakatulong sa pag-aaral
- Mga patnubay sa estilo ayon sa PEP 8
- Malinaw, pang-edukasyonal na mga halimbawa ng code
- Mga type hint kung nakakatulong sa pag-aaral
### Markdown Documentation
- Malinaw na hierarchy ng mga heading
- Mga code block na may pagtukoy ng wika
- Mga code block na may pagspecify ng wika
- Mga link sa karagdagang mga mapagkukunan
- Mga screenshot at mga larawan sa `images/` na mga direktoryo
- Mga screenshot at larawan sa mga `images/` na mga direktoryo
- Alt text para sa mga larawan para sa accessibility
### File Organization
- Mga aralin na naka-numero nang sunud-sunod (1-getting-started-lessons, 2-js-basics, atbp.)
- Bawat proyekto ay may `solution/` at madalas ay `start/` o `your-work/` na mga direktoryo
- Mga larawan na nakaimbak sa aralin-nakatuong mga folder na `images/`
- Mga pagsasalin sa `translations/{language-code}/` na istruktura
- Ang mga aralin ay may sunud-sunod na bilang (1-getting-started-lessons, 2-js-basics, atbp.)
- Ang bawat proyekto ay may `solution/` at madalas `start/` o `your-work/` na mga direktoryo
- Ang mga larawan ay naka-imbak sa mga lesson-specific na `images/` folder
- Mga pagsasalin sa istrukturang `translations/{language-code}/`
## Build and Deployment
@ -184,11 +184,11 @@ Ang quiz-app ay naka-configure para sa Azure Static Web Apps deployment:
```bash
cd quiz-app
npm run build # Lumilikha ng folder na dist/
# Nagde-deploy gamit ang GitHub Actions workflow sa push sa main
npm run build # Lumilikha ng dist/ folder
# Nagde-deploy gamit ang GitHub Actions workflow kapag may push sa main
```
Azure Static Web Apps configuration:
Azure Static Web Apps na konfigurasyon:
- **App location**: `/quiz-app`
- **Output location**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
@ -207,76 +207,76 @@ npm install -g docsify-cli # I-install ang Docsify nang globally
docsify serve # I-serve sa localhost:3000
```
### Project-specific Builds
### Mga Build na Nakatuon sa Proyekto
Bawat direktoryo ng proyekto ay maaaring may sarili nitong proseso ng pag-build:
- Vue projects: `npm run build` ay lumilikha ng production bundles
- Static projects: Walang build step, direktang nagseserbisyo ng mga file
Ang bawat direktoryo ng proyekto ay maaaring may sariling proseso ng build:
- Vue projects: `npm run build` na lumilikha ng mga production bundles
- Static projects: Walang build step, direktang pag-serbisyo ng mga file
## Pull Request Guidelines
### Title Format
### Format ng Pamagat
Gumamit ng malinaw, deskriptibong mga titulo na nagpapakita ng bahagi ng pagbabago:
- `[Quiz-app] Magdagdag ng bagong quiz para sa aralin X`
- `[Lesson-3] Ayusin ang typo sa terrarium na proyekto`
- `[Translation] Magdagdag ng pagsasalin sa Spanish para sa aralin 5`
- `[Docs] I-update ang mga tagubilin sa setup`
Gumamit ng malinaw, deskriptibong mga pamagat na nagpapakita ng bahagi ng pagbabago:
- `[Quiz-app] Add new quiz for lesson X`
- `[Lesson-3] Fix typo in terrarium project`
- `[Translation] Add Spanish translation for lesson 5`
- `[Docs] Update setup instructions`
### Required Checks
### Mga Kinakailangang Pag-check
Bago magsumite ng PR:
1. **Kalidad ng Code**:
- Patakbuhin ang `npm run lint` sa mga naapektuhang direktoryo ng proyekto
- Ayusin lahat ng linting errors at warnings
- Patakbuhin ang `npm run lint` sa mga apektadong proyekto
- Ayusin ang lahat ng linting error at babala
2. **Build Verification**:
- Patakbuhin ang `npm run build` kung naaangkop
2. **Pag-verify ng Build**:
- Patakbuhin ang `npm run build` kung kinakailangan
- Siguraduhing walang error sa build
3. **Link Validation**:
- Subukan ang lahat ng markdown links
- Siguraduhing gumagana ang mga image references
3. **Pag-validate ng Link**:
- Subukan ang lahat ng markdown link
- Siguraduhing gumagana ang mga reference ng larawan
4. **Content Review**:
- Proofread para sa spelling at grammar
- Siguraduhin na ang mga halimbawa ng code ay tama at edukasyonal
- Suriin na ang mga pagsasalin ay nananatili ang orihinal na kahulugan
4. **Pagsusuri ng Nilalaman**:
- Proofread para sa baybay at gramatika
- Siguraduhing tama at edukasyonal ang mga halimbawa ng code
- I-verify ang mga pagsasalin ay nananatili ang orihinal na kahulugan
### Contribution Requirements
### Mga Kinakailangan sa Kontribusyon
- Sumasang-ayon sa Microsoft CLA (awtomatikong tseke sa unang PR)
- Sundan ang [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Tingnan ang [CONTRIBUTING.md](./CONTRIBUTING.md) para sa detalyadong mga panuntunan
- Banggitin ang mga numero ng isyu sa deskripsiyon ng PR kung naaangkop
- Sumang-ayon sa Microsoft CLA (automated check sa unang PR)
- Sundin ang [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Tumingin sa [CONTRIBUTING.md](./CONTRIBUTING.md) para sa mga detalyadong gabay
- Banggitin ang mga numero ng isyu sa paglalarawan ng PR kung angkop
### Review Process
### Proseso ng Review
- Ang mga PR ay nire-review ng mga maintainers at komunidad
- Ang mga PR ay sinusuri ng mga maintainer at komunidad
- Pinapahalagahan ang kalinawan sa edukasyon
- Ang mga halimbawa ng code ay dapat sumunod sa kasalukuyang pinakamahusay na mga kasanayan
- Ang mga pagsasalin ay nire-review para sa katumpakan at angkop sa kultura
- Dapat sundin ng mga halimbawa ng code ang kasalukuyang best practices
- Sinusuri ang mga pagsasalin para sa katumpakan at angkop na kultura
## Translation System
### Automated Translation
- Gumagamit ng GitHub Actions sa co-op-translator workflow
- Awtomatikong nagsasalin sa 50+ na mga wika
- Source files ay nasa main directories
- Mga isinaling file ay nasa `translations/{language-code}/` na mga direktoryo
- Gumagamit ng GitHub Actions na may co-op-translator workflow
- Nagsasalin sa 50+ na wika nang awtomatiko
- Mga source file sa mga pangunahing direktoryo
- Mga naisaling file sa `translations/{language-code}/` na mga direktoryo
### Adding Manual Translation Improvements
### Pagdaragdag ng Manual na Pagpapabuti sa Pagsasalin
1. Hanapin ang file sa `translations/{language-code}/`
2. Gumawa ng mga pagpapabuti habang pinapanatili ang estruktura
3. Siguraduhin na ang mga halimbawa ng code ay nananatiling gumagana
4. Subukan ang anumang lokal na nilalaman ng quiz
2. Gawin ang mga pagpapabuti nang pinananatili ang istruktura
3. Siguraduhing nananatiling gumagana ang mga halimbawa ng code
4. Subukan ang anumang lokal na nilalamang quiz
### Translation Metadata
### Metadata ng Pagsasalin
Ang mga isinaling file ay may kasama na metadata header:
Ang mga naisaling file ay may kasamang metadata header:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -291,118 +291,118 @@ CO_OP_TRANSLATOR_METADATA:
## Debugging and Troubleshooting
### Common Issues
### Mga Karaniwang Isyu
**Quiz app ay hindi nagsisimula**:
- Suriin ang Node.js na bersyon (v14+ ang inirerekomenda)
- Tanggalin ang `node_modules` at `package-lock.json`, patakbuhin muli ang `npm install`
- Suriin ang mga port conflicts (default: Vite gumagamit ng port 5173)
**Hindi nagsisimula ang quiz app**:
- Suriin ang bersyon ng Node.js (inirekomenda v14+)
- Burahin ang `node_modules` at `package-lock.json`, patakbuhin muli ang `npm install`
- Suriin kung may conflict sa port (default: Vite gumagamit ng port 5173)
**API server ay hindi nagsisimula**:
- Siguraduhin ang Node.js na bersyon ay naaabot ang minimum (node >=10)
- Suriin kung ang port ay ginagamit na
- Siguraduhin lahat ng dependencies ay na-install gamit ang `npm install`
**Hindi nagsisimula ang API server**:
- Tiyakin ang bersyon ng Node.js ay sapat (node >=10)
- Suriin kung ginagamit na ng iba ang port
- Siguraduhing naka-install lahat ng dependencies gamit ang `npm install`
**Browser extension ay hindi naglo-load**:
- Siguraduhin ang manifest.json ay tama ang format
- Suriin ang browser console para sa mga error
- Sundin ang mga tagubilin sa pag-install ng extension na nakabatay sa browser
**Hindi naglo-load ang browser extension**:
- Siguraduhing tama ang format ng manifest.json
- Tingnan ang browser console para sa mga error
- Sundin ang mga instruksyon sa pag-install ng extension para sa partikular na browser
**Mga isyu sa Python chat project**:
- Siguraduhin na naka-install ang OpenAI package: `pip install openai`
- Siguraduhin ang environment variable na GITHUB_TOKEN ay nakaset
- Suriin ang mga permiso sa GitHub Models access
- Siguraduhing naka-install ang OpenAI package: `pip install openai`
- Tiyakin na nakaset ang GITHUB_TOKEN environment variable
- Suriin ang mga permiso sa access ng GitHub Models
**Docsify ay hindi nagseserbisyo ng docs**:
**Hindi nagseserbisyo ang Docsify ng docs**:
- I-install ang docsify-cli globally: `npm install -g docsify-cli`
- Patakbuhin mula sa root directory ng repositoryo
- Siguraduhing ang `docs/_sidebar.md` ay naroon
- Siguraduhing may `docs/_sidebar.md`
### Development Environment Tips
### Mga Tip para sa Development Environment
- Gamitin ang VS Code na may Live Server extension para sa mga HTML na proyekto
- Gumamit ng VS Code kasama ang Live Server extension para sa mga HTML na proyekto
- Mag-install ng ESLint at Prettier extensions para sa konsistenteng pag-format
- Gamitin ang browser DevTools para sa debugging ng JavaScript
- Para sa Vue projects, mag-install ng Vue DevTools browser extension
- Gamitin ang browser DevTools para i-debug ang JavaScript
- Para sa mga Vue na proyekto, mag-install ng Vue DevTools browser extension
### Performance Considerations
### Mga Pagsasaalang-alang sa Performance
- Maraming bilang ng mga isinaling file (50+ wika) kaya malaki ang buong clone
- Gumamit ng shallow clone kung content lang ang oobrahon: `git clone --depth 1`
- I-exclude ang mga pagsasalin sa paghahanap kapag nagtatrabaho sa English na nilalaman
- Ang mga build process ay maaaring mabagal sa unang takbo (npm install, Vite build)
- Malaki ang bilang ng naisaling mga file (50+ na wika) kaya malaki ang buong clone
- Gumamit ng shallow clone kung nilalaman lang ang kanilang tinatrabaho: `git clone --depth 1`
- I-exclude ang mga pagsasalin sa mga paghahanap kapag nagtatrabaho sa English na nilalaman
- Maaaring mabagal ang build processes sa unang takbo (npm install, Vite build)
## Security Considerations
### Environment Variables
### Mga Environment Variable
- Ang mga API key ay hindi dapat i-commit sa repositoryo
- Gumamit ng `.env` files (naka-include na sa `.gitignore`)
- Huwag kailanman i-commit ang API keys sa repositoryo
- Gumamit ng `.env` files (nasa `.gitignore` na)
- I-dokumento ang kinakailangang environment variables sa mga README ng proyekto
### Python Projects
- Gumamit ng virtual environments: `python -m venv venv`
- Panatilihing updated ang mga dependencies
- Ang mga GitHub tokens ay dapat may minimal na mga kinakailangang permiso
- Dapat may minimal na permiso lamang ang mga GitHub token
### GitHub Models Access
- Kailangan ng Personal Access Tokens (PAT) para sa GitHub Models
- Itago ang tokens bilang mga environment variables
- Huwag i-commit ang mga tokens o credentials
- Kinakailangan ang Personal Access Tokens (PAT) para sa GitHub Models
- Itago ang mga token bilang environment variables
- Huwag kailanman i-commit ang mga token o kredensyal
## Additional Notes
### Target Audience
- Ganap na mga nagsisimula sa web development
- Mga estudyante at mga self-learners
- Mga ganap na nagsisimula sa web development
- Mga estudyante at self-learners
- Mga guro na gumagamit ng kurikulum sa mga silid-aralan
- Nilalaman ay idinisenyo para sa accessibility at unti-unting pagbuo ng kasanayan
- Ang nilalaman ay dinisenyo para sa accessibility at unti-unting pagbuo ng kakayahan
### Educational Philosophy
- Paraan ng pag-aaral na nakabatay sa proyekto
- Madalas na pagsusuri ng kaalaman (quizzes)
- Hands-on na mga ehersisyo sa pagko-code
- Mga halimbawa ng aplikasyon sa totoong mundo
- Pokus sa mga pundasyon bago ang mga framework
- Pagsasanay sa pag-aaral batay sa proyekto
- Madalas na pagsusuri sa kaalaman (mga quiz)
- Hands-on na coding exercises
- Mga halimbawa ng aplikasyon sa tunay na mundo
- Pagtuon sa mga pundasyon bago ang mga framework
### Repository Maintenance
- Aktibong komunidad ng mga nag-aaral at mga contributor
- Regular na pag-update sa dependencies at nilalaman
- Mga isyu at diskusyon ay minomonitor ng mga maintainers
- Ang mga update sa pagsasalin ay awtomatiko gamit ang GitHub Actions
- Aktibong komunidad ng mga nag-aaral at contributor
- Regular na pag-update ng dependencies at nilalaman
- Sina-subsaybayan ang mga isyu at talakayan ng mga maintainer
- Awtomatikong pag-update ng pagsasalin gamit ang GitHub Actions
### Related Resources
- [Microsoft Learn modules](https://docs.microsoft.com/learn/)
- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
- Inirerekomenda ang [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) para sa mga nag-aaral
- Mga karagdagang kurso: Generative AI, Data Science, ML, IoT curricula ay available
- Karagdagang mga kurso: Generative AI, Data Science, ML, IoT curricula ang available
### Working with Specific Projects
### Pagtatrabaho sa Partikular na Mga Proyekto
Para sa detalyadong mga tagubilin sa mga indibidwal na proyekto, sumangguni sa README files sa:
Para sa detalyadong mga instruksyon sa mga indibidwal na proyekto, tingnan ang mga README file sa:
- `quiz-app/README.md` - Vue 3 quiz application
- `7-bank-project/README.md` - Banking application na may authentication
- `5-browser-extension/README.md` - Pag-develop ng browser extension
- `6-space-game/README.md` - Canvas-based na pag-develop ng laro
- `9-chat-project/README.md` - AI chat assistant na proyekto
- `6-space-game/README.md` - Pag-develop ng game gamit ang canvas
- `9-chat-project/README.md` - AI chat assistant project
### Monorepo Structure
Bagaman hindi isang tradisyunal na monorepo, ang repositoryong ito ay naglalaman ng maraming independyenteng proyekto:
- Bawat aralin ay self-contained
- Ang mga proyekto ay hindi nagbabahagi ng mga dependencies
- Magtrabaho sa mga indibidwal na proyekto nang hindi naaapektuhan ang iba
Bagamat hindi tradisyunal na monorepo, ang repositoryong ito ay naglalaman ng maraming independiyenteng proyekto:
- Ang bawat aralin ay nakahiwalay
- Hindi nagbabahagi ng dependencies ang mga proyekto
- Puwedeng magtrabaho sa bawat proyekto nang hindi naaapektuhan ang iba
- I-clone ang buong repo para sa buong karanasan ng kurikulum
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Pagsasanggalang**:
Ang dokumentong ito ay isinalin gamit ang AI translation service na [Co-op Translator](https://github.com/Azure/co-op-translator). Habang nagsusumikap kami para sa katumpakan, pakatandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga error o kamalian. Ang orihinal na dokumento sa katutubong wika nito ang dapat ituring na opisyal na sanggunian. Para sa mahahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot sa anumang hindi pagkakaintindihan o maling interpretasyon na nagmula sa paggamit ng pagsasaling ito.
**Paunawa**:
Ang dokumentong ito ay isinalin gamit ang AI translation service na [Co-op Translator](https://github.com/Azure/co-op-translator). Bagaman nagsusumikap kami para sa katuparan, pakatandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o hindi pagkakatugma. Ang orihinal na dokumento sa orihinal nitong wika ang dapat ituring na pangunahing sanggunian. Para sa mga mahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot para sa anumang hindi pagkakaunawaan o maling interpretasyon na nagmumula sa paggamit ng pagsasaling ito.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
Loading…
Cancel
Save