From 3f34004ec05ad50d682a3b13649a49873634be72 Mon Sep 17 00:00:00 2001 From: "localizeflow[bot]" Date: Fri, 6 Feb 2026 18:05:52 +0000 Subject: [PATCH] chore(i18n): sync translations with latest source changes (chunk 1/1, 12 changes) --- translations/ms/.co-op-translator.json | 12 +- translations/ms/AGENTS.md | 416 +++++++++++++------------ translations/ms/README.md | 186 +++++------ translations/ms/Roadmap.md | 53 ++++ translations/sw/.co-op-translator.json | 12 +- translations/sw/AGENTS.md | 382 ++++++++++++----------- translations/sw/README.md | 249 ++++++++------- translations/sw/Roadmap.md | 53 ++++ translations/tl/.co-op-translator.json | 12 +- translations/tl/AGENTS.md | 406 ++++++++++++------------ translations/tl/README.md | 210 ++++++------- translations/tl/Roadmap.md | 53 ++++ 12 files changed, 1102 insertions(+), 942 deletions(-) create mode 100644 translations/ms/Roadmap.md create mode 100644 translations/sw/Roadmap.md create mode 100644 translations/tl/Roadmap.md diff --git a/translations/ms/.co-op-translator.json b/translations/ms/.co-op-translator.json index e6f280d29..b386e3ed8 100644 --- a/translations/ms/.co-op-translator.json +++ b/translations/ms/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2025-10-03T11:34:42+00:00", + "translation_date": "2026-02-06T18:03:26+00:00", "source_file": "AGENTS.md", "language_code": "ms" }, @@ -516,11 +516,17 @@ "language_code": "ms" }, "README.md": { - "original_hash": "490c83786552d7fab6390991517bef09", - "translation_date": "2026-01-29T18:49:29+00:00", + "original_hash": "6d6385fd098088cb2d690fb0a6cdaedc", + "translation_date": "2026-02-06T17:54:17+00:00", "source_file": "README.md", "language_code": "ms" }, + "Roadmap.md": { + "original_hash": "28bf6185fd7f27b62ddc210514366192", + "translation_date": "2026-02-06T18:01:52+00:00", + "source_file": "Roadmap.md", + "language_code": "ms" + }, "SECURITY.md": { "original_hash": "4ecc3bf2e27983d4c780be6f26ee6228", "translation_date": "2025-08-27T21:58:54+00:00", diff --git a/translations/ms/AGENTS.md b/translations/ms/AGENTS.md index ee41017a3..a251e98a5 100644 --- a/translations/ms/AGENTS.md +++ b/translations/ms/AGENTS.md @@ -2,61 +2,61 @@ ## Gambaran Projek -Ini adalah repositori kurikulum pendidikan untuk mengajar asas pembangunan web kepada pemula. Kurikulum ini merupakan kursus komprehensif selama 12 minggu yang dibangunkan oleh Microsoft Cloud Advocates, dengan 24 pelajaran praktikal yang merangkumi JavaScript, CSS, dan HTML. +Ini adalah repositori kurikulum pendidikan untuk mengajar asas pembangunan web kepada pemula. Kurikulum ini adalah kursus komprehensif 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 yang disusun secara berstruktur dalam modul berasaskan projek -- **Projek Praktikal**: Terrarium, Permainan Menaip, Sambungan Penyemak Imbas, Permainan Angkasa, Aplikasi Perbankan, Penyunting Kod, dan Pembantu Chat AI -- **Kuiz 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) +- **Kandungan Pendidikan**: 24 pelajaran tersusun yang diatur dalam modul berasaskan projek +- **Projek Praktikal**: Terrarium, Permainan Mengetik, Sambungan Pelayar, Permainan Angkasa, Aplikasi Perbankan, Penyunting Kod, dan Pembantu Sembang AI +- **Kuiz 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) ### Seni Bina -- Repositori pendidikan dengan struktur berasaskan pelajaran -- Setiap folder pelajaran mengandungi README, contoh kod, dan penyelesaian -- Projek berdiri sendiri dalam direktori berasingan (quiz-app, pelbagai projek pelajaran) -- Sistem terjemahan menggunakan GitHub Actions (co-op-translator) -- Dokumentasi disediakan melalui Docsify dan tersedia dalam bentuk PDF +- Repositori pendidikan dengan struktur berasaskan pelajaran +- Setiap folder pelajaran mengandungi README, contoh kod, dan penyelesaian +- Projek berdiri sendiri dalam direktori berasingan (quiz-app, pelbagai projek pelajaran) +- Sistem terjemahan menggunakan GitHub Actions (co-op-translator) +- Dokumentasi disediakan melalui Docsify dan tersedia dalam format PDF -## Perintah Persediaan +## Perintah Penyediaan -Repositori ini terutamanya untuk penggunaan kandungan pendidikan. Untuk bekerja dengan projek tertentu: +Repositori ini utamanya untuk penggunaan kandungan pendidikan. Untuk bekerja dengan projek tertentu: -### Persediaan Repositori Utama +### Penyediaan Repositori Utama ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Persediaan Aplikasi Kuiz (Vue 3 + Vite) +### Penyediaan Aplikasi Kuiz (Vue 3 + Vite) ```bash cd quiz-app npm install -npm run dev # Start development server -npm run build # Build for production -npm run lint # Run ESLint +npm run dev # Mula pelayan pembangunan +npm run build # Bina untuk pengeluaran +npm run lint # Jalankan ESLint ``` -### API Projek Bank (Node.js + Express) +### API Projek Perbankan (Node.js + Express) ```bash cd 7-bank-project/api npm install -npm start # Start API server -npm run lint # Run ESLint -npm run format # Format with Prettier +npm start # Mula pelayan API +npm run lint # Jalankan ESLint +npm run format # Format dengan Prettier ``` -### Projek Sambungan Penyemak Imbas +### Projek Sambungan Pelayar ```bash cd 5-browser-extension/solution npm install -# Follow browser-specific extension loading instructions +# Ikuti arahan pemuatan sambungan khusus pelayar ``` ### Projek Permainan Angkasa @@ -64,15 +64,15 @@ npm install ```bash cd 6-space-game/solution npm install -# Open index.html in browser or use Live Server +# Buka index.html dalam pelayar atau gunakan Live Server ``` -### Projek Chat (Backend Python) +### Projek Sembang (Backend Python) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Set GITHUB_TOKEN environment variable +# Tetapkan pembolehubah persekitaran GITHUB_TOKEN python api.py ``` @@ -80,101 +80,101 @@ python api.py ### Untuk Penyumbang Kandungan -1. **Fork repositori** ke akaun GitHub anda -2. **Clone fork anda** secara tempatan -3. **Buat cawangan baru** untuk perubahan anda -4. Lakukan perubahan pada kandungan pelajaran atau contoh kod -5. Uji sebarang perubahan kod dalam direktori projek yang relevan -6. Hantar pull request mengikut garis panduan sumbangan +1. **Fork repositori** ke akaun GitHub anda +2. **Clone fork anda** secara tempatan +3. **Cipta 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 permintaan tarik 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. Lengkapkan kuiz sebelum pelajaran di https://ff-quizzes.netlify.app/web/ -5. Kerjakan contoh kod dalam folder pelajaran -6. Lengkapkan tugasan dan cabaran -7. Ambil kuiz selepas pelajaran +1. Fork atau clone repositori +2. Navigasi ke direktori pelajaran secara berurutan +3. Baca fail README untuk setiap pelajaran +4. Lengkapkan kuiz pra-pelajaran di https://ff-quizzes.netlify.app/web/ +5. Ikuti contoh kod dalam folder pelajaran +6. Selesaikan tugasan dan cabaran +7. Ambil kuiz pasca-pelajaran ### Pembangunan Secara Langsung -- **Dokumentasi**: Jalankan `docsify serve` di root (port 3000) -- **Aplikasi Kuiz**: Jalankan `npm run dev` di direktori quiz-app -- **Projek**: Gunakan sambungan Live Server VS Code untuk projek HTML -- **Projek API**: Jalankan `npm start` di direktori API masing-masing +- **Dokumentasi**: Jalankan `docsify serve` di root (port 3000) +- **Aplikasi Kuiz**: Jalankan `npm run dev` dalam direktori quiz-app +- **Projek**: Gunakan sambungan VS Code Live Server untuk projek HTML +- **Projek API**: Jalankan `npm start` dalam direktori API yang sesuai -## Arahan Pengujian +## Arahan Ujian -### Pengujian Aplikasi Kuiz +### Ujian Aplikasi Kuiz ```bash cd quiz-app -npm run lint # Check for code style issues -npm run build # Verify build succeeds +npm run lint # Periksa isu gaya kod +npm run build # Sahkan binaan berjaya ``` -### Pengujian API Bank +### Ujian API Bank ```bash cd 7-bank-project/api -npm run lint # Check for code style issues -node server.js # Verify server starts without errors +npm run lint # Periksa isu gaya kod +node server.js # Sahkan server bermula tanpa ralat ``` -### Pendekatan Pengujian Umum +### Pendekatan Ujian Am -- Ini adalah repositori pendidikan tanpa ujian automatik yang komprehensif -- Pengujian manual memberi tumpuan kepada: - - Contoh kod berjalan tanpa ralat - - Pautan dalam dokumentasi berfungsi dengan betul - - Pembinaan projek selesai dengan berjaya - - Contoh mengikuti 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 -### Pemeriksaan Sebelum Penyerahan +### Semakan Pra-Hantar -- Jalankan `npm run lint` di direktori dengan package.json -- Sahkan pautan markdown adalah sah -- Uji contoh kod dalam penyemak imbas atau Node.js -- Pastikan terjemahan mengekalkan struktur yang betul +- Jalankan `npm run lint` dalam direktori yang mempunyai package.json +- Sahkan pautan markdown sah +- Uji contoh kod dalam pelayar atau Node.js +- Periksa bahawa terjemahan mengekalkan struktur yang betul ## Garis Panduan Gaya Kod ### JavaScript -- Gunakan sintaks ES6+ moden -- Ikuti konfigurasi ESLint standard yang disediakan dalam projek -- Gunakan nama pemboleh ubah dan fungsi yang bermakna untuk kejelasan pendidikan -- Tambahkan komen yang menerangkan konsep untuk pelajar -- Format menggunakan Prettier di mana dikonfigurasikan +- Gunakan sintaks moden ES6+ +- 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 jika dikonfigurasikan ### HTML/CSS -- Elemen HTML5 semantik -- Prinsip reka bentuk responsif -- Konvensyen penamaan kelas yang jelas -- Komen yang menerangkan teknik CSS untuk pelajar +- Elemen semantic HTML5 +- Prinsip reka bentuk responsif +- Konvensyen penamaan kelas yang jelas +- Komen yang menerangkan teknik CSS untuk pelajar ### Python -- Garis panduan gaya PEP 8 -- Contoh kod yang jelas dan pendidikan -- Petunjuk jenis di mana berguna untuk pembelajaran +- Garis panduan gaya PEP 8 +- Contoh kod yang jelas dan pendidikan +- Petunjuk jenis (type hints) 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 untuk kebolehaksesan +- Hierarki tajuk yang jelas +- Blok kod dengan spesifikasi bahasa +- Pautan kepada sumber tambahan +- Tangkapan layar dan imej dalam direktori `images/` +- Teks alt untuk imej bagi aksesibiliti -### Pengorganisasian Fail +### Penyusunan Fail -- Pelajaran bernombor 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}/` +- Pelajaran dinomborkan secara berurutan (1-getting-started-lessons, 2-js-basics, dll.) +- Setiap projek ada direktori `solution/` dan sering `start/` atau `your-work/` +- Imej disimpan dalam folder `images/` khusus pelajaran +- Terjemahan dalam struktur `translations/{language-code}/` ## Pembinaan dan Penghantaran @@ -184,99 +184,99 @@ Aplikasi kuiz dikonfigurasikan untuk penghantaran Azure Static Web Apps: ```bash cd quiz-app -npm run build # Creates dist/ folder -# Deploys via GitHub Actions workflow on push to main +npm run build # Membuat folder dist/ +# Melakukan penyebaran melalui aliran kerja GitHub Actions apabila tolak ke main ``` -Konfigurasi Azure Static Web Apps: -- **Lokasi Aplikasi**: `/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 # Install docsify-to-pdf -npm run convert # Generate PDF from docs +npm install # Pasang docsify-to-pdf +npm run convert # Hasilkan PDF daripada docs ``` ### Dokumentasi Docsify ```bash -npm install -g docsify-cli # Install Docsify globally -docsify serve # Serve on localhost:3000 +npm install -g docsify-cli # Pasang Docsify secara global +docsify serve # Hidangkan pada localhost:3000 ``` -### Pembinaan Khusus Projek +### Pembinaan Projek-Spesifik -Setiap direktori projek mungkin mempunyai proses pembinaan sendiri: -- Projek Vue: `npm run build` mencipta bundle pengeluaran -- Projek statik: Tiada langkah pembinaan, teruskan fail +Setiap direktori projek mungkin mempunyai proses pembinaan sendiri: +- Projek Vue: `npm run build` menghasilkan bundel untuk pengeluaran +- Projek statik: Tiada langkah pembinaan, fail dihidangkan terus -## Garis Panduan Pull Request +## Garis Panduan Permintaan Tarik ### Format Tajuk -Gunakan tajuk yang jelas dan deskriptif yang menunjukkan kawasan perubahan: -- `[Quiz-app] Tambah kuiz baru untuk pelajaran X` -- `[Lesson-3] Betulkan kesalahan ejaan dalam projek terrarium` -- `[Translation] Tambah terjemahan bahasa Sepanyol untuk pelajaran 5` -- `[Docs] Kemas kini arahan persediaan` +Gunakan tajuk yang jelas dan deskriptif yang menunjukkan bidang perubahan: +- `[Quiz-app] Tambah kuiz baru untuk pelajaran X` +- `[Lesson-3] Betulkan kesalahan taip dalam projek terrarium` +- `[Translation] Tambah terjemahan Sepanyol untuk pelajaran 5` +- `[Docs] Kemas kini arahan penyediaan` -### Pemeriksaan Diperlukan +### Semakan Wajib Sebelum menghantar PR: -1. **Kualiti Kod**: - - Jalankan `npm run lint` di direktori projek yang terjejas - - Betulkan semua ralat dan amaran linting +1. **Kualiti Kod**: + - Jalankan `npm run lint` dalam direktori projek berkaitan + - Betulkan semua ralat dan amaran linting -2. **Pengesahan Pembinaan**: - - Jalankan `npm run build` jika berkenaan - - Pastikan tiada ralat pembinaan +2. **Pengesahan Pembinaan**: + - Jalankan `npm run build` jika berkenaan + - Pastikan tiada ralat pembinaan -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 adalah betul dan pendidikan - - Sahkan terjemahan mengekalkan maksud asal +4. **Semakan Kandungan**: + - Semak ejaan dan tatabahasa + - Pastikan contoh kod betul dan pendidikan + - Sahkan terjemahan mengekalkan makna asal ### Keperluan Sumbangan -- Setuju dengan Microsoft CLA (pemeriksaan automatik pada PR pertama) -- Ikuti [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- Lihat [CONTRIBUTING.md](./CONTRIBUTING.md) untuk garis panduan terperinci -- Rujuk nombor isu dalam deskripsi PR jika berkenaan +- 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 garis panduan terperinci +- Rujukkan nombor isu dalam penerangan PR jika sesuai ### Proses Semakan -- PR disemak oleh penyelenggara dan komuniti -- Kejelasan pendidikan diutamakan -- Contoh kod harus mengikuti amalan terbaik semasa -- Terjemahan disemak untuk ketepatan dan kesesuaian budaya +- PR disemak oleh penyelenggara dan komuniti +- Kejelasan pendidikan diutamakan +- Contoh kod harus mengikuti amalan terbaik semasa +- Terjemahan disemak untuk ketepatan dan kesesuaian budaya ## Sistem Terjemahan ### Terjemahan Automatik -- Menggunakan GitHub Actions dengan aliran kerja co-op-translator -- Menterjemah ke lebih 50 bahasa secara automatik -- Fail sumber dalam direktori utama -- Fail terjemahan dalam direktori `translations/{language-code}/` +- Menggunakan GitHub Actions dengan aliran kerja co-op-translator +- Menerjemah ke 50+ bahasa secara automatik +- Fail sumber dalam direktori utama +- Fail terjemahan dalam direktori `translations/{language-code}/` -### Penambahbaikan Terjemahan Manual +### Menambah Penambahbaikan Terjemahan Manual -1. Cari fail dalam `translations/{language-code}/` -2. Lakukan penambahbaikan sambil mengekalkan struktur -3. Pastikan contoh kod tetap berfungsi -4. Uji sebarang kandungan kuiz yang dilokalkan +1. Cari fail dalam `translations/{language-code}/` +2. Buat penambahbaikan sambil mengekalkan struktur +3. Pastikan contoh kod kekal berfungsi +4. Uji sebarang kandungan kuiz berlokalisasi ### Metadata Terjemahan -Fail terjemahan termasuk header metadata: +Fail terjemahan termasuk pengepala metadata: ```markdown ``` -## Penyahpepijatan dan Penyelesaian Masalah +## Pengesanan Ralat dan Penyelesaian Masalah -### Isu Biasa +### Isu Lazim -**Aplikasi kuiz gagal dimulakan**: -- Periksa versi Node.js (disyorkan v14+) -- Padamkan `node_modules` dan `package-lock.json`, jalankan `npm install` semula -- Periksa konflik port (lalai: Vite menggunakan port 5173) +**Aplikasi kuiz gagal bermula**: +- Semak versi Node.js (disarankan v14+) +- Padam `node_modules` dan `package-lock.json`, jalankan `npm install` lagi +- Semak konflik port (default: Vite guna port 5173) -**Pelayan API tidak dapat dimulakan**: -- Sahkan versi Node.js memenuhi minimum (node >=10) -- Periksa jika port sudah digunakan -- Pastikan semua kebergantungan dipasang dengan `npm install` +**Pelayan API tidak bermula**: +- Sahkan versi Node.js memenuhi minimum (node >=10) +- Semak jika port sudah digunakan +- Pastikan semua kebergantungan dipasang dengan `npm install` -**Sambungan penyemak imbas tidak dapat dimuat**: -- Sahkan manifest.json diformat dengan betul -- Periksa konsol penyemak imbas untuk ralat -- Ikuti arahan pemasangan sambungan khusus penyemak imbas +**Sambungan pelayar tidak dimuat**: +- Sahkan manifest.json diformat dengan betul +- Periksa 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 telah ditetapkan -- Periksa kebenaran akses GitHub Models +**Isu projek sembang Python**: +- Pastikan pakej OpenAI dipasang: `pip install openai` +- Sahkan pembolehubah persekitaran GITHUB_TOKEN diset +- Semak kebenaran akses Model GitHub -**Docsify tidak menyajikan dokumen**: -- Pasang docsify-cli secara global: `npm install -g docsify-cli` -- Jalankan dari direktori root repositori -- Periksa bahawa `docs/_sidebar.md` wujud +**Docsify tidak menghidangkan dokumen**: +- Pasang docsify-cli secara global: `npm install -g docsify-cli` +- Jalankan dari direktori root repositori +- Pastikan `docs/_sidebar.md` wujud ### Petua Persekitaran Pembangunan -- Gunakan VS Code dengan sambungan Live Server untuk projek HTML -- Pasang sambungan ESLint dan Prettier untuk format yang konsisten -- Gunakan DevTools penyemak imbas untuk penyahpepijatan JavaScript -- Untuk projek Vue, pasang sambungan Vue DevTools penyemak imbas +- 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 -- Jumlah fail terjemahan yang besar (50+ bahasa) bermakna klon penuh adalah besar -- Gunakan klon cetek jika hanya bekerja pada kandungan: `git clone --depth 1` -- Kecualikan terjemahan daripada carian apabila bekerja pada kandungan bahasa Inggeris -- Proses pembinaan mungkin lambat pada kali pertama (npm install, Vite build) +- Bilangan fail terjemahan besar (50+ bahasa) menjadikan klon penuh besar +- Gunakan klon cetek jika hanya bekerja pada kandungan: `git clone --depth 1` +- Kecualikan terjemahan dari carian semasa bekerja pada kandungan Bahasa Inggeris +- Proses pembinaan mungkin lambat pada run pertama (npm install, bina Vite) ## Pertimbangan Keselamatan ### Pembolehubah Persekitaran -- Kunci API tidak boleh pernah dikomit ke repositori -- Gunakan fail `.env` (sudah dalam `.gitignore`) -- Dokumentasikan pembolehubah persekitaran yang diperlukan dalam README projek +- Kunci API tidak harus dikomit ke repositori +- Gunakan fail `.env` (sudah ada dalam `.gitignore`) +- Dokumentasikan pembolehubah persekitaran yang diperlukan dalam README projek ### Projek Python -- Gunakan persekitaran maya: `python -m venv venv` -- Kekalkan kebergantungan terkini -- Token GitHub harus mempunyai kebenaran minimum yang diperlukan +- Gunakan persekitaran maya: `python -m venv venv` +- Kekalkan kebergantungan dikemas kini +- Token GitHub harus mempunyai kebenaran minimum yang diperlukan -### Akses GitHub Models +### Akses Model GitHub -- Token Akses Peribadi (PAT) diperlukan untuk GitHub Models -- Token harus disimpan sebagai pembolehubah persekitaran -- Jangan pernah komit token atau kelayakan +- Personal Access Tokens (PAT) diperlukan untuk Model GitHub +- Token perlu disimpan sebagai pembolehubah persekitaran +- Jangan sekali-kali komit token atau kelayakan ## Nota Tambahan ### Sasaran Audiens -- Pemula sepenuhnya dalam pembangunan web -- Pelajar dan pembelajar sendiri -- Guru yang menggunakan kurikulum dalam bilik darjah -- Kandungan direka untuk kebolehaksesan dan pembinaan kemahiran secara beransur-ansur +- Pemula sepenuhnya dalam pembangunan web +- Pelajar dan pembelajar kendiri +- Guru menggunakan kurikulum dalam bilik darjah +- Kandungan direka untuk kebolehaksesan dan pembinaan kemahiran secara berperingkat ### Falsafah Pendidikan -- Pendekatan pembelajaran berasaskan projek -- Pemeriksaan pengetahuan yang kerap (kuiz) -- Latihan pengekodan secara langsung -- Contoh aplikasi dunia sebenar -- Fokus pada asas sebelum kerangka kerja +- Pendekatan pembelajaran berasaskan projek +- Pemeriksaan ilmu kerap (kuiz) +- Latihan pengkodan secara praktikal +- Contoh aplikasi dunia sebenar +- Tumpuan pada asas sebelum kerangka ### Penyelenggaraan Repositori -- Komuniti pelajar dan penyumbang yang aktif -- Kemas kini berkala untuk kebergantungan dan kandungan -- Isu dan perbincangan dipantau oleh penyelenggara -- Kemas kini terjemahan automatik melalui GitHub Actions +- Komuniti aktif pelajar dan penyumbang +- Kemas kini berkala ke kebergantungan dan kandungan +- 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: Generative AI, Sains Data, ML, kurikulum IoT tersedia +- [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 -### Bekerja dengan Projek Khusus +### Bekerja Dengan Projek Spesifik -Untuk arahan terperinci mengenai projek individu, rujuk fail README dalam: -- `quiz-app/README.md` - Aplikasi kuiz Vue 3 -- `7-bank-project/README.md` - Aplikasi perbankan dengan pengesahan -- `5-browser-extension/README.md` - Pembangunan sambungan penyemak imbas -- `6-space-game/README.md` - Pembangunan permainan berasaskan kanvas -- `9-chat-project/README.md` - Projek pembantu chat AI +Untuk arahan terperinci mengenai projek individu, lihat fail README dalam: +- `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 sembang AI ### Struktur Monorepo -Walaupun bukan monorepo tradisional, repositori ini mengandungi pelbagai projek bebas: -- Setiap pelajaran adalah berdiri sendiri -- Projek tidak berkongsi kebergantungan -- Bekerja pada projek individu tanpa menjejaskan yang lain -- Klon keseluruhan repositori untuk pengalaman kurikulum penuh +Walaupun bukan monorepo tradisional, repositori ini mengandungi beberapa projek bebas: +- Setiap pelajaran berdiri sendiri +- Projek tidak berkongsi kebergantungan +- Bekerja pada projek individu tanpa menjejaskan yang lain +- Klon keseluruhan repo untuk pengalaman kurikulum penuh --- + **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 ambil perhatian bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang berwibawa. Untuk maklumat kritikal, terjemahan manusia profesional adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini. \ No newline at end of file +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 rujukan yang sah. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini. + \ No newline at end of file diff --git a/translations/ms/README.md b/translations/ms/README.md index 1432c05d8..11093ca0d 100644 --- a/translations/ms/README.md +++ b/translations/ms/README.md @@ -2,7 +2,7 @@ [![GitHub contributors](https://img.shields.io/github/contributors/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/graphs/contributors/) [![GitHub issues](https://img.shields.io/github/issues/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/issues/) [![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/pulls/) -[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) +[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) [![GitHub watchers](https://img.shields.io/github/watchers/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Watch&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/watchers/) [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Fork&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/network/) @@ -12,211 +12,211 @@ # Pembangunan Web untuk Pemula - Kurikulum -Belajar asas pembangunan web dengan kursus menyeluruh selama 12 minggu oleh Microsoft Cloud Advocates. Setiap 24 pelajaran mengupas JavaScript, CSS, dan HTML melalui projek praktikal seperti terarium, sambungan pelayar, dan permainan angkasa lepas. Sertai kuiz, perbincangan, dan tugasan praktikal. Tingkatkan kemahiran anda dan optimakan pengekalan ilmu dengan pedagogi berasaskan projek yang berkesan. Mulakan perjalanan pengkodan anda hari ini! +Pelajari asas-asas pembangunan web dengan kursus komprehensif 12 minggu kami oleh Microsoft Cloud Advocates. Setiap 24 pelajaran menelusuri JavaScript, CSS, dan HTML melalui projek praktikal seperti terrarium, peluasan pelayar, dan permainan angkasa lepas. Sertai kuiz, perbincangan, dan tugasan praktikal. Tingkatkan kemahiran anda dan optimakan pengekalan ilmu dengan pedagogi berasaskan projek yang berkesan. Mulakan perjalanan pengkodan anda hari ini! Sertai Komuniti Discord Azure AI Foundry [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Ikuti langkah-langkah ini untuk mula menggunakan sumber ini: -1. **Fork Repositori**: Klik [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork) -2. **Klon Repositori**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` -3. [**Sertai Azure AI Foundry Discord dan bertemu dengan pakar serta pembangun lain**](https://discord.com/invite/ByRwuEEgH4) +Ikuti langkah ini untuk mula menggunakan sumber ini: +1. **Fork Repositori**: Klik [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork) +2. **Clone Repositori**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +3. [**Sertai Azure AI Foundry Discord dan temui pakar serta pembangun rakan sebaya**](https://discord.com/invite/ByRwuEEgH4) ### 🌐 Sokongan Pelbagai Bahasa -#### Disokong melalui GitHub Action (Automatik & Sentiasa Dikemaskini) +#### Disokong melalui GitHub Action (Automatik & Sentiasa Dikemas Kini) [Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](./README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) -> **Lebih Suka Melakukan Klon secara Tempatan?** +> **Lebih Suka Clone Secara Tempatan?** -> Repositori ini mengandungi lebih 50 terjemahan bahasa yang meningkatkan saiz muat turun dengan ketara. Untuk klon tanpa terjemahan, gunakan sparse checkout: +> Repositori ini merangkumi lebih 50 terjemahan bahasa yang secara signifikan menambah saiz muat turun. Untuk clone tanpa terjemahan, gunakan sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Web-Dev-For-Beginners.git > cd Web-Dev-For-Beginners > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Ini memberikan anda segala yang anda perlukan untuk menyelesaikan kursus dengan muat turun yang jauh lebih pantas. +> Ini memberikan anda segala yang diperlukan untuk menamatkan kursus dengan muat turun yang lebih pantas. -**Jika anda ingin mendapatkan sokongan bahasa terjemahan tambahan yang disenaraikan [di sini](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)** +**Jika anda ingin mempunyai bahasa terjemahan tambahan yang disokong, senarai terdapat [di sini](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)** [![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners) #### 🧑‍🎓 _Adakah anda seorang pelajar?_ -Lawati [**halaman Pusat Pelajar**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) di mana anda akan menemui sumber untuk pemula, Pakej Pelajar dan juga cara untuk mendapatkan baucar sijil percuma. Ini adalah halaman yang ingin anda tandai dan periksa dari masa ke masa kerana kami menukar kandungan setiap bulan. +Lawati [**halaman Student Hub**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) di mana anda akan menemui sumber untuk pemula, pek Pelajar dan juga cara untuk mendapatkan baucar sijil percuma. Ini adalah halaman yang anda mahu tandakan dan semak dari masa ke masa kerana kami menukar kandungan setiap bulan. -### 📣 Pengumuman - Cabaran Mod Ejen GitHub Copilot baru untuk diselesaikan! +### 📣 Pengumuman - Cabaran Mod Agen GitHub Copilot Baru untuk disiapkan! -Cabaran Baru ditambah, cari "Cabaran Ejen GitHub Copilot 🚀" di kebanyakan bab. Itu adalah cabaran baru untuk anda selesaikan menggunakan GitHub Copilot dan mod Ejen. Jika anda belum pernah menggunakan mod Ejen sebelum ini, ia mampu bukan sahaja menjana teks tetapi juga boleh mencipta dan mengedit fail, menjalankan arahan dan banyak lagi. +Cabaran Baru ditambah, cari "GitHub Copilot Agent Challenge 🚀" di kebanyakan bab. Itu adalah cabaran baru untuk anda selesaikan menggunakan GitHub Copilot dan mod Agen. Jika anda belum pernah menggunakan mod Agen sebelum ini, ia bukan sahaja mampu menjana teks tetapi juga boleh membuat dan mengedit fail, menjalankan arahan dan banyak lagi. -### 📣 Pengumuman - _Projek Baru untuk dibina menggunakan Generative AI_ +### 📣 Pengumuman - _Projek Baharu untuk dibina menggunakan Generative AI_ -Projek Pembantu AI baru sahaja ditambah, lihat [projek](./9-chat-project/README.md) +Projek Pembantu AI baharu baru saja ditambah, lihat [projek](./9-chat-project/README.md) -### 📣 Pengumuman - _Kurikulum Baru_ untuk Generative AI bagi JavaScript baru sahaja dikeluarkan +### 📣 Pengumuman - _Kurikulum Baharu_ tentang Generative AI untuk JavaScript baru dikeluarkan -Jangan terlepas kurikulum Generative AI baru kami! +Jangan terlepas kurikulum Generative AI baharu kami! -Lawati [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) untuk bermula! +Lawati [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) untuk mula! ![Background](../../translated_images/ms/background.148a8d43afde5730.webp) -- Pelajaran merangkumi segalanya dari asas kepada RAG. -- Berinteraksi dengan watak sejarah menggunakan GenAI dan aplikasi pendamping kami. -- Naratif yang menyeronokkan dan menarik, anda akan menjelajah masa! +- Pelajaran merangkumi segala dari asas hingga RAG. +- Berinteraksi dengan watak sejarah menggunakan GenAI dan aplikasi teman kami. +- Naratif yang menyeronokkan dan menarik, anda akan mengembara masa! ![character](../../translated_images/ms/character.5c0dd8e067ffd693.webp) -Setiap pelajaran termasuk tugasan untuk diselesaikan, pemeriksaan pengetahuan dan cabaran untuk membimbing anda dalam pembelajaran topik seperti: -- Prompting dan kejuruteraan prompt -- Penjanaan aplikasi teks dan imej +Setiap pelajaran termasuk tugasan untuk disiapkan, pemeriksaan pengetahuan dan cabaran untuk membimbing anda dalam topik seperti: +- Prompting dan kejuruteraan prompt +- Penjanaan aplikasi teks dan gambar - Aplikasi carian -Lawati [https://aka.ms/genai-js-course](../../[https:/aka.ms/genai-js-course) untuk bermula! +Lawati [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) untuk mula! ## 🌱 Mula Bermula -> **Guru**, kami telah [menyertakan beberapa cadangan](for-teachers.md) tentang cara menggunakan kurikulum ini. Kami sangat mengalu-alukan maklum balas anda [di forum perbincangan kami](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)! +> **Guru**, kami telah [menyertakan beberapa cadangan](for-teachers.md) tentang bagaimana menggunakan kurikulum ini. Kami ingin menerima maklum balas anda [di forum perbincangan kami](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)! -**[Pelajar](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**, untuk setiap pelajaran, mulakan dengan kuiz pra-ceramah dan ikuti dengan membaca bahan kuliah, menyelesaikan pelbagai aktiviti dan periksa kefahaman anda dengan kuiz pasca-ceramah. +**[Pelajar](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**, untuk setiap pelajaran, mulakan dengan kuiz pra-ceramah dan teruskan dengan membaca bahan kuliah, menyelesaikan pelbagai aktiviti dan periksa pemahaman anda dengan kuiz pasca-ceramah. -Untuk meningkatkan pengalaman pembelajaran anda, berhubung dengan rakan sekelas untuk bekerjasama dalam projek! Perbincangan digalakkan di [forum perbincangan kami](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) di mana pasukan moderator kami akan bersedia untuk menjawab soalan anda. +Untuk meningkatkan pengalaman pembelajaran anda, berhubung dengan rakan sekelas anda untuk bekerja pada projek bersama! Perbincangan digalakkan di [forum perbincangan](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) kami di mana pasukan moderator kami akan tersedia untuk menjawab soalan anda. -Untuk memajukan pendidikan anda, kami sangat mengesyorkan meneroka [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) untuk bahan pembelajaran tambahan. +Untuk melanjutkan pendidikan anda, kami sangat mengesyorkan meneroka [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) untuk bahan kajian tambahan. ### 📋 Menyediakan persekitaran anda -Kurikulum ini mempunyai persekitaran pembangunan yang sedia digunakan! Apabila anda bermula anda boleh memilih untuk menjalankan kurikulum dalam [Codespace](https://github.com/features/codespaces/) (_persekitaran berasaskan pelayar tanpa perlu pemasangan_), atau secara tempatan di komputer anda menggunakan penyunting teks seperti [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). +Kurikulum ini mempunyai persekitaran pembangunan yang sudah siap! Semasa anda bermula, anda boleh memilih untuk menjalankan kurikulum dalam [Codespace](https://github.com/features/codespaces/) (_persekitaran berasaskan pelayar, tiada pemasangan diperlukan_), atau secara tempatan di komputer anda menggunakan penyunting teks seperti [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). -#### Cipta repositori anda -Untuk memudahkan anda menyimpan kerja anda, disyorkan anda membuat salinan anda sendiri repositori ini. Anda boleh melakukannya dengan mengklik butang **Use this template** di bahagian atas halaman. Ini akan mencipta repositori baru di akaun GitHub anda dengan salinan kurikulum. +#### Buat repositori anda +Untuk memudahkan anda menyimpan kerja anda, adalah disarankan agar anda membuat salinan repositori ini sendiri. Anda boleh melakukannya dengan mengklik butang **Use this template** di bahagian atas halaman. Ini akan membuat repositori baru dalam akaun GitHub anda dengan salinan kurikulum. -Ikuti langkah ini: -1. **Fork Repositori**: Klik pada butang "Fork" di penjuru atas kanan halaman ini. -2. **Klon Repositori**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +Ikuti langkah ini: +1. **Fork Repositori**: Klik pada butang "Fork" di sudut atas-kanan halaman ini. +2. **Clone Repositori**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` #### Menjalankan kurikulum dalam Codespace -Dalam salinan repositori ini yang telah anda cipta, klik butang **Code** dan pilih **Open with Codespaces**. Ini akan mencipta Codespace baru untuk anda bekerja. +Dalam salinan repositori yang anda buat, klik butang **Code** dan pilih **Open with Codespaces**. Ini akan mencipta Codespace baharu untuk anda bekerja. ![Codespace](../../translated_images/ms/createcodespace.0238bbf4d7a8d955.webp) #### Menjalankan kurikulum secara tempatan di komputer anda -Untuk menjalankan kurikulum ini secara tempatan di komputer anda, anda memerlukan penyunting teks, pelayar dan alat baris arahan. Pelajaran pertama kami, [Pengenalan kepada Bahasa Pengaturcaraan dan Alat Perdagangan](../../1-getting-started-lessons/1-intro-to-programming-languages), akan membimbing anda meneroka pelbagai pilihan untuk setiap alat ini supaya anda boleh memilih yang paling sesuai untuk anda. +Untuk menjalankan kurikulum ini secara tempatan di komputer anda, anda memerlukan penyunting teks, pelayar dan alat baris perintah. Pelajaran pertama kami, [Pengenalan kepada Bahasa Pengaturcaraan dan Alat Perdagangan](../../1-getting-started-lessons/1-intro-to-programming-languages), akan membimbing anda melalui pelbagai pilihan untuk setiap alat ini supaya anda boleh memilih yang paling sesuai untuk anda. -Cadangan kami adalah menggunakan [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) sebagai penyunting anda, yang juga mempunyai [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) terbina dalam. Anda boleh muat turun Visual Studio Code [di sini](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). +Cadangan kami ialah menggunakan [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) sebagai editor anda, yang juga memiliki [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) terbina dalam. Anda boleh muat turun Visual Studio Code [di sini](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). -1. Klon repositori anda ke komputer anda. Anda boleh melakukannya dengan mengklik butang **Code** dan menyalin URL: +1. Clone repositori anda ke komputer anda. Anda boleh melakukannya dengan mengklik butang **Code** dan menyalin URL: [CodeSpace](./images/createcodespace.png) - Kemudian, buka [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) dalam [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) dan jalankan arahan berikut, gantikan `` dengan URL yang baru anda salin: + Kemudian, buka [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) dalam [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) dan jalankan perintah berikut, gantikan `` dengan URL yang baru anda salin: ```bash git clone ``` -2. Buka folder dalam Visual Studio Code. Anda boleh melakukan ini dengan mengklik **Fail** > **Buka Folder** dan memilih folder yang baru sahaja anda klon. +2. Buka folder dalam Visual Studio Code. Anda boleh melakukan ini dengan mengklik **File** > **Open Folder** dan memilih folder yang baru anda klon. > Sambungan Visual Studio Code yang disyorkan: > > * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - untuk pratonton halaman HTML dalam Visual Studio Code -> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - untuk membantu anda menulis kod dengan lebih pantas +> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - untuk membantu anda menulis kod dengan lebih cepat -## 📂 Setiap pelajaran merangkumi: +## 📂 Setiap pelajaran termasuk: - sketchnote pilihan - video tambahan pilihan -- kuiz pemanasan pra-pelajaran +- kuiz pemanasan sebelum pelajaran - pelajaran bertulis -- untuk pelajaran berasaskan projek, panduan langkah demi langkah cara membina projek +- untuk pelajaran berasaskan projek, panduan langkah demi langkah untuk membina projek - pemeriksaan pengetahuan - cabaran - bacaan tambahan - tugasan -- [kuiz pasca-pelajaran](https://ff-quizzes.netlify.app/web/) +- [kuiz selepas pelajaran](https://ff-quizzes.netlify.app/web/) -> **Nota tentang kuiz**: Semua kuiz terkandung dalam folder Quiz-app, 48 kuiz dengan tiga soalan setiap satu. Mereka boleh didapati [di sini](https://ff-quizzes.netlify.app/web/) aplikasi kuiz boleh dijalankan secara tempatan atau dipasang ke Azure; ikut arahan di folder `quiz-app`. +> **Nota tentang kuiz**: Semua kuiz terkandung dalam folder Quiz-app, 48 kuiz keseluruhan dengan tiga soalan setiap satu. Ia tersedia [di sini](https://ff-quizzes.netlify.app/web/) aplikasi kuiz boleh dijalankan secara tempatan atau diterapkan ke Azure; ikuti arahan dalam folder `quiz-app`. ## 🗃️ Pelajaran -| | Nama Projek | Konsep yang Diajarkan | Objektif Pembelajaran | Pelajaran Berkaitan | Penulis | -| :-: | :------------------------------------------------------: | :--------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :---------------------: | -| 01 | Memulakan | Pengenalan kepada Pengaturcaraan dan Alat-alat Perdagangan | Belajar asas-asas di sebalik kebanyakan bahasa pengaturcaraan dan tentang perisian yang membantu pembangun profesional melakukan kerja mereka | [Pengenalan kepada Bahasa Pengaturcaraan dan Alat-alat Perdagangan](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | -| 02 | Memulakan | Asas GitHub, termasuk bekerja dengan pasukan | Cara menggunakan GitHub dalam projek anda, bagaimana untuk bekerjasama dengan orang lain dalam pangkalan kod | [Pengenalan kepada GitHub](./1-getting-started-lessons/2-github-basics/README.md) | Floor | -| 03 | Memulakan | Kebolehcapaian | Belajar asas-asas kebolehcapaian web | [Asas Kebolehcapaian](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | -| 04 | Asas JS | Jenis Data JavaScript | Asas-asas jenis data JavaScript | [Jenis Data](./2-js-basics/1-data-types/README.md) | Jasmine | -| 05 | Asas JS | Fungsi dan Kaedah | Belajar tentang fungsi dan kaedah untuk mengurus aliran logik aplikasi | [Fungsi dan Kaedah](./2-js-basics/2-functions-methods/README.md) | Jasmine dan Christopher | -| 06 | Asas JS | Membuat Keputusan dengan JS | Belajar bagaimana membuat syarat dalam kod anda menggunakan kaedah membuat keputusan | [Membuat Keputusan](./2-js-basics/3-making-decisions/README.md) | Jasmine | -| 07 | Asas JS | Array dan Gelung | Bekerja dengan data menggunakan array dan gelung dalam JavaScript | [Array dan Gelung](./2-js-basics/4-arrays-loops/README.md) | Jasmine | -| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTML dalam Praktik | Membina HTML untuk mencipta terrarium dalam talian, menumpukan pada pembinaan layout | [Pengenalan kepada HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | -| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSS dalam Praktik | Membina CSS untuk menata terrarium dalam talian, menumpukan pada asas CSS termasuk menjadikan halaman responsif | [Pengenalan kepada CSS](./3-terrarium/2-intro-to-css/README.md) | Jen | -| 10 | [Terrarium](./3-terrarium/solution/README.md) | Penutupan JavaScript, manipulasi DOM | Membina JavaScript untuk menjadikan terrarium berfungsi sebagai antara muka seret/jatuh, menumpukan pada penutupan dan manipulasi DOM | [Penutupan JavaScript, manipulasi DOM](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen | -| 11 | [Typing Game](./4-typing-game/solution/README.md) | Membina Permainan Mengetik | Belajar cara menggunakan acara papan kekunci untuk menggerakkan logik aplikasi JavaScript anda | [Pengaturcaraan Berpandukan Acara](./4-typing-game/typing-game/README.md) | Christopher | -| 12 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Bekerja dengan Pelayar | Belajar bagaimana pelayar berfungsi, sejarahnya, dan bagaimana untuk membina elemen pertama sambungan pelayar | [Mengenai Pelayar](./5-browser-extension/1-about-browsers/README.md) | Jen | -| 13 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Membina borang, memanggil API dan menyimpan pembolehubah dalam penyimpanan setempat | Membina elemen JavaScript sambungan pelayar anda untuk memanggil API menggunakan pembolehubah yang disimpan dalam penyimpanan setempat | [API, Borang, dan Penyimpanan Setempat](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen | -| 14 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Proses latar belakang dalam pelayar, prestasi web | Menggunakan proses latar belakang pelayar untuk mengurus ikon sambungan; belajar tentang prestasi web dan beberapa pengoptimuman untuk menjadikan | [Tugas Latar Belakang dan Prestasi](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen | -| 15 | [Space Game](./6-space-game/solution/README.md) | Pembangunan Permainan Lebih Lanjut dengan JavaScript | Belajar tentang Pewarisan menggunakan kedua-dua Kelas dan Komposisi serta corak Pub/Sub, sebagai persediaan untuk membina permainan | [Pengenalan kepada Pembangunan Permainan Lanjutan](./6-space-game/1-introduction/README.md) | Chris | -| 16 | [Space Game](./6-space-game/solution/README.md) | Melukis ke kanvas | Belajar tentang Canvas API, digunakan untuk melukis elemen ke skrin | [Melukis ke Kanvas](./6-space-game/2-drawing-to-canvas/README.md) | Chris | -| 17 | [Space Game](./6-space-game/solution/README.md) | Menggerakkan elemen di sekitar skrin | Menemui bagaimana elemen boleh mendapat pergerakan menggunakan koordinat kartesian dan Canvas API | [Menggerakkan Elemen](./6-space-game/3-moving-elements-around/README.md) | Chris | -| 18 | [Space Game](./6-space-game/solution/README.md) | Pengesanan perlanggaran | Membuat elemen bertembung dan bertindak balas antara satu sama lain menggunakan kekunci dan menyediakan fungsi penyejukan untuk memastikan prestasi permainan | [Pengesanan Perlanggaran](./6-space-game/4-collision-detection/README.md) | Chris | -| 19 | [Space Game](./6-space-game/solution/README.md) | Menjaga skor | Melakukan pengiraan matematik berdasarkan status dan prestasi permainan | [Menjaga Skor](./6-space-game/5-keeping-score/README.md) | Chris | -| 20 | [Space Game](./6-space-game/solution/README.md) | Menamatkan dan memulakan semula permainan | Belajar tentang menamatkan dan memulakan semula permainan, termasuk membersihkan aset dan menetapkan semula nilai pembolehubah | [Keadaan Penamatan](./6-space-game/6-end-condition/README.md) | Chris | -| 21 | [Banking App](./7-bank-project/solution/README.md) | Templat HTML dan Laluan dalam Aplikasi Web | Belajar bagaimana mencipta rangka seni sesebuah tapak web berbilang halaman menggunakan laluan dan templat HTML | [Templat HTML dan Laluan](./7-bank-project/1-template-route/README.md) | Yohan | -| 22 | [Banking App](./7-bank-project/solution/README.md) | Membina Borang Log Masuk dan Pendaftaran | Belajar tentang membina borang dan mengendalikan rutin pengesahan | [Borang](./7-bank-project/2-forms/README.md) | Yohan | -| 23 | [Banking App](./7-bank-project/solution/README.md) | Kaedah Mengambil dan Menggunakan Data | Bagaimana data mengalir masuk dan keluar dari aplikasi anda, bagaimana untuk mengambilnya, menyimpannya, dan membuangnya | [Data](./7-bank-project/3-data/README.md) | Yohan | -| 24 | [Banking App](./7-bank-project/solution/README.md) | Konsep Pengurusan Negeri | Belajar bagaimana aplikasi anda mengekalkan negeri dan bagaimana menguruskannya secara programatik | [Pengurusan Negeri](./7-bank-project/4-state-management/README.md) | Yohan | -| 25 | [Browser/VScode Code](../../8-code-editor) | Bekerja dengan VScode | Belajar cara menggunakan penyunting kod| [Gunakan Penyunting Kod VScode](./8-code-editor/1-using-a-code-editor/README.md) | Chris | -| 26 | [AI Assistants](./9-chat-project/README.md) | Bekerja dengan AI | Belajar cara membina pembantu AI anda sendiri | [Projek Pembantu AI](./9-chat-project/README.md) | Chris | +| | Nama Projek | Konsep Diajarkan | Objektif Pembelajaran | Pelajaran Berkaitan | Pengarang | +| :-: | :----------------------------------------------------: | :--------------------------------------------------------------------: | --------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :-----------------------: | +| 01 | Memulakan | Pengenalan kepada Pengaturcaraan dan Alat-alat Kerja | Pelajari asas di sebalik kebanyakan bahasa pengaturcaraan dan tentang perisian yang membantu pembangun profesional melakukan kerja mereka | [Pengenalan kepada Bahasa Pengaturcaraan dan Alat-alat Kerja](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | +| 02 | Memulakan | Asas GitHub, termasuk bekerjasama dalam kumpulan | Cara menggunakan GitHub dalam projek anda, cara berkolaborasi dengan orang lain dalam kod | [Pengenalan kepada GitHub](./1-getting-started-lessons/2-github-basics/README.md) | Floor | +| 03 | Memulakan | Kebolehcapaian | Pelajari asas kebolehcapaian web | [Asas Kebolehcapaian](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | +| 04 | Asas JS | Jenis Data JavaScript | Asas jenis data JavaScript | [Jenis Data](./2-js-basics/1-data-types/README.md) | Jasmine | +| 05 | Asas JS | Fungsi dan Kaedah | Pelajari tentang fungsi dan kaedah untuk mengurus aliran logik aplikasi | [Fungsi dan Kaedah](./2-js-basics/2-functions-methods/README.md) | Jasmine dan Christopher | +| 06 | Asas JS | Membuat Keputusan dengan JS | Pelajari cara membuat syarat dalam kod anda menggunakan kaedah membuat keputusan | [Membuat Keputusan](./2-js-basics/3-making-decisions/README.md) | Jasmine | +| 07 | Asas JS | Array dan Gelung | Bekerja dengan data menggunakan array dan gelung dalam JavaScript | [Array dan Gelung](./2-js-basics/4-arrays-loops/README.md) | Jasmine | +| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTML dalam Amalan | Bina HTML untuk membuat terrarium dalam talian, fokus pada membina susun atur | [Pengenalan kepada HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | +| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSS dalam Amalan | Bina CSS untuk menghias terrarium dalam talian, fokus pada asas CSS termasuk membuat halaman responsif | [Pengenalan kepada CSS](./3-terrarium/2-intro-to-css/README.md) | Jen | +| 10 | [Terrarium](./3-terrarium/solution/README.md) | Penutupan JavaScript, manipulasi DOM | Bina JavaScript untuk menjadikan terrarium berfungsi sebagai antara muka seret/jatuh, fokus pada penutupan dan manipulasi DOM | [Penutupan JavaScript, manipulasi DOM](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen | +| 11 | [Typing Game](./4-typing-game/solution/README.md) | Bina Permainan Mengetik | Pelajari cara menggunakan acara papan kekunci untuk mengendalikan logik aplikasi JavaScript anda | [Pengaturcaraan Berasaskan Acara](./4-typing-game/typing-game/README.md) | Christopher | +| 12 | [Sambungan Pelayar Hijau](./5-browser-extension/solution/README.md) | Bekerja dengan Pelayar | Pelajari cara pelayar berfungsi, sejarahnya, dan cara membina elemen pertama sambungan pelayar | [Mengenai Pelayar](./5-browser-extension/1-about-browsers/README.md) | Jen | +| 13 | [Sambungan Pelayar Hijau](./5-browser-extension/solution/README.md) | Membina borang, memanggil API dan menyimpan pemboleh ubah dalam storan tempatan | Bina elemen JavaScript sambungan pelayar anda untuk memanggil API menggunakan pemboleh ubah yang disimpan dalam storan tempatan | [API, Borang, dan Storan Tempatan](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen | +| 14 | [Sambungan Pelayar Hijau](./5-browser-extension/solution/README.md) | Proses latar belakang dalam pelayar, prestasi web | Gunakan proses latar belakang pelayar untuk mengurus ikon sambungan; pelajari tentang prestasi web dan beberapa pengoptimuman untuk meningkatkan | [Tugas Latar Belakang dan Prestasi](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen | +| 15 | [Permainan Angkasa](./6-space-game/solution/README.md) | Pembangunan Permainan Lanjutan dengan JavaScript | Pelajari tentang Pewarisan menggunakan kedua-dua Kelas dan Komposisi serta corak Pub/Sub, sebagai persediaan untuk membina permainan | [Pengenalan kepada Pembangunan Permainan Lanjutan](./6-space-game/1-introduction/README.md) | Chris | +| 16 | [Permainan Angkasa](./6-space-game/solution/README.md) | Melukis pada kanvas | Pelajari tentang API Canvas, yang digunakan untuk melukis elemen pada skrin | [Melukis pada Kanvas](./6-space-game/2-drawing-to-canvas/README.md) | Chris | +| 17 | [Permainan Angkasa](./6-space-game/solution/README.md) | Menggerakkan elemen di sekeliling skrin | Ketahui bagaimana elemen boleh bergerak menggunakan koordinat cartesian dan API Canvas | [Menggerakkan Elemen](./6-space-game/3-moving-elements-around/README.md) | Chris | +| 18 | [Permainan Angkasa](./6-space-game/solution/README.md) | Pengesanan perlanggaran | Buat elemen bertembung dan bertindak antara satu sama lain menggunakan tekan kekunci dan menyediakan fungsi cooldown untuk memastikan prestasi permainan | [Pengesanan Perlanggaran](./6-space-game/4-collision-detection/README.md) | Chris | +| 19 | [Permainan Angkasa](./6-space-game/solution/README.md) | Menjaga skor | Lakukan pengiraan matematik berdasarkan status dan prestasi permainan | [Menjaga Skor](./6-space-game/5-keeping-score/README.md) | Chris | +| 20 | [Permainan Angkasa](./6-space-game/solution/README.md) | Mengakhiri dan memulakan semula permainan | Pelajari tentang mengakhiri dan memulakan semula permainan, termasuk membersihkan aset dan menetapkan semula nilai pemboleh ubah | [Syarat Pengakhiran](./6-space-game/6-end-condition/README.md) | Chris | +| 21 | [Aplikasi Perbankan](./7-bank-project/solution/README.md) | Templat HTML dan Laluan dalam Aplikasi Web | Pelajari cara membuat struktur asas laman web berbilang halaman menggunakan laluan dan templat HTML | [Templat HTML dan Laluan](./7-bank-project/1-template-route/README.md) | Yohan | +| 22 | [Aplikasi Perbankan](./7-bank-project/solution/README.md) | Bina Borang Log Masuk dan Pendaftaran | Pelajari tentang membina borang dan mengendalikan rutin pengesahan | [Borang](./7-bank-project/2-forms/README.md) | Yohan | +| 23 | [Aplikasi Perbankan](./7-bank-project/solution/README.md) | Kaedah Mendapat dan Menggunakan Data | Cara data mengalir masuk dan keluar dari aplikasi anda, cara mendapatkannya, menyimpannya, dan memusnahkannya | [Data](./7-bank-project/3-data/README.md) | Yohan | +| 24 | [Aplikasi Perbankan](./7-bank-project/solution/README.md) | Konsep Pengurusan Keadaan | Pelajari cara aplikasi anda mengekalkan keadaan dan cara mengurusnya secara program | [Pengurusan Keadaan](./7-bank-project/4-state-management/README.md) | Yohan | +| 25 | [Kod Penyemak Imbas/VScode](../../8-code-editor) | Bekerja dengan VScode | Pelajari cara menggunakan penyunting kod| [Gunakan Penyunting Kod VScode](./8-code-editor/1-using-a-code-editor/README.md) | Chris | +| 26 | [Pembantu AI](./9-chat-project/README.md) | Bekerja dengan AI | Pelajari cara membina pembantu AI anda sendiri | [Projek Pembantu AI](./9-chat-project/README.md) | Chris | ## 🏫 Pedagogi -Kurikulum kami direka dengan dua prinsip pedagogi utama yang diambil kira: +Kurikulum kami direka dengan dua prinsip pedagogi utama dalam fikiran: * pembelajaran berasaskan projek -* kuiz yang kerap +* kuiz kerap -Program ini mengajar asas-asas JavaScript, HTML, dan CSS, serta alat dan teknik terkini yang digunakan oleh pembangun web hari ini. Pelajar akan berpeluang mengembangkan pengalaman praktikal dengan membina permainan menaip, terrarium maya, sambungan pelayar mesra alam, permainan gaya penyerang angkasa, dan aplikasi perbankan untuk perniagaan. Menjelang akhir siri ini, pelajar akan memperoleh pemahaman yang mantap tentang pembangunan web. +Program ini mengajar asas JavaScript, HTML, dan CSS, serta alat dan teknik terkini yang digunakan oleh pembangun web hari ini. Pelajar akan berpeluang mendapat pengalaman praktikal dengan membina permainan menaip, terrarium maya, sambungan pelayar mesra alam, permainan gaya penyerang angkasa, dan aplikasi perbankan untuk perniagaan. Pada akhir siri ini, pelajar akan mempunyai pemahaman yang kukuh tentang pembangunan web. > 🎓 Anda boleh mengambil beberapa pelajaran pertama dalam kurikulum ini sebagai [Jalur Pembelajaran](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon) di Microsoft Learn! -Dengan memastikan bahawa kandungan sejajar dengan projek, proses pembelajaran menjadi lebih menarik untuk pelajar dan pengekalan konsep akan meningkat. Kami juga menulis beberapa pelajaran permulaan dalam asas JavaScript untuk memperkenalkan konsep, dipasangkan dengan video dari koleksi tutorial video "[Siri Pemula kepada: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)," beberapa pengarangnya menyumbang kepada kurikulum ini. +Dengan memastikan kandungan selari dengan projek, proses menjadi lebih menarik untuk pelajar dan pemahaman konsep akan dipertingkatkan. Kami juga menulis beberapa pelajaran permulaan dalam asas JavaScript untuk memperkenalkan konsep, dipadankan dengan video dari koleksi tutorial video "[Siri Pemula kepada: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)", yang beberapa pengarangnya menyumbang kepada kurikulum ini. -Selain itu, kuiz berisiko rendah sebelum kelas menetapkan niat pelajar untuk mempelajari sesuatu topik, manakala kuiz kedua selepas kelas memastikan pengekalan lebih lanjut. Kurikulum ini direka supaya fleksibel dan menyeronokkan serta boleh diambil sepenuhnya atau sebahagiannya. Projek-projek bermula kecil dan menjadi semakin kompleks menjelang akhir kitaran 12 minggu. +Selain itu, kuiz berisiko rendah sebelum kelas menetapkan niat pelajar untuk mempelajari topik, manakala kuiz kedua selepas kelas memastikan pengekalan lanjut. Kurikulum ini direka untuk menjadi fleksibel dan menyeronokkan dan boleh diambil secara keseluruhan atau sebahagian. Projek bermula kecil dan menjadi semakin kompleks menjelang pengakhiran kitar 12 minggu. -Walaupun kami sengaja mengelakkan pengenalan rangka kerja JavaScript untuk memberi tumpuan pada kemahiran asas yang diperlukan sebagai pembangun web sebelum mengguna pakai rangka kerja, langkah seterusnya yang baik untuk melengkapkan kurikulum ini adalah mempelajari tentang Node.js melalui satu lagi koleksi video: "[Siri Pemula kepada: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". +Walaupun kami sengaja mengelakkan memperkenalkan rangka kerja JavaScript untuk menumpukan pada kemahiran asas yang diperlukan sebagai pembangun web sebelum mengadopsi rangka kerja, satu langkah seterusnya yang baik untuk melengkapkan kurikulum ini ialah belajar tentang Node.js melalui satu lagi koleksi video: "[Siri Pemula kepada: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". -> Lawati [Kod Etika](CODE_OF_CONDUCT.md) dan garis panduan [Sumbangan](CONTRIBUTING.md) kami. Kami mengalu-alukan maklum balas membina anda! +> Lawati [Kod Etika](CODE_OF_CONDUCT.md) dan garis panduan [Menyumbang](CONTRIBUTING.md) kami. Kami mengalu-alukan maklum balas membina anda! ## 🧭 Akses luar talian -Anda boleh menjalankan dokumentasi ini secara luar talian dengan menggunakan [Docsify](https://docsify.js.org/#/). Gariskan repo ini, [pasang Docsify](https://docsify.js.org/#/quickstart) pada mesin tempatan anda, dan kemudian dalam folder akar repo ini, taip `docsify serve`. Laman web akan disajikan pada port 3000 pada localhost anda: `localhost:3000`. +Anda boleh menjalankan dokumentasi ini secara luar talian dengan menggunakan [Docsify](https://docsify.js.org/#/). Fork repositori ini, [pasang Docsify](https://docsify.js.org/#/quickstart) pada mesin tempatan anda, dan kemudian di folder root repositori ini, taip `docsify serve`. Laman web akan dihidangkan pada port 3000 di localhost anda: `localhost:3000`. ## 📘 PDF -PDF bagi semua pelajaran boleh didapati [di sini](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf). +PDF untuk semua pelajaran boleh didapati [di sini](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf). ## 🎒 Kursus Lain -Pasukan kami menghasilkan kursus lain! Lihat: +Pasukan kami menghasilkan kursus lain! Lihatlah: ### LangChain [![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) [![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - +[![LangChain for Beginners](https://img.shields.io/badge/LangChain%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://github.com/microsoft/langchain-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / Edge / MCP / Agents +### Azure / Edge / MCP / Agen [![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) @@ -232,7 +232,7 @@ Pasukan kami menghasilkan kursus lain! Lihat: --- -### Pembelajaran Asas +### Pembelajaran Teras [![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) @@ -249,13 +249,13 @@ Pasukan kami menghasilkan kursus lain! Lihat: [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## Dapatkan Bantuan +## Mendapatkan Bantuan -Jika anda tersekat atau mempunyai sebarang pertanyaan tentang membina aplikasi AI. Sertai pelajar lain dan pembangun berpengalaman dalam perbincangan mengenai MCP. Ia adalah komuniti yang menyokong di mana soalan dialu-alukan dan pengetahuan dikongsi dengan bebas. +Jika anda tersekat atau mempunyai sebarang soalan tentang membina aplikasi AI. Sertai pelajar lain dan pemaju berpengalaman dalam perbincangan mengenai MCP. Ia adalah komuniti yang menyokong di mana soalan dialu-alukan dan pengetahuan dikongsi dengan bebas. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Jika anda mempunyai maklum balas produk atau ralat semasa membina lawati: +Jika anda mempunyai maklum balas produk atau kesilapan semasa membina, lawati: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -267,5 +267,5 @@ Repositori ini dilesenkan di bawah lesen MIT. Lihat fail [LICENSE](../../LICENSE **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 maklum bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang sahih. Untuk maklumat penting, terjemahan oleh profesional manusia adalah disyorkan. Kami tidak bertanggungjawab atas 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 ambil perhatian bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya hendaklah dianggap sebagai sumber yang sah. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini. \ No newline at end of file diff --git a/translations/ms/Roadmap.md b/translations/ms/Roadmap.md new file mode 100644 index 000000000..de115d30e --- /dev/null +++ b/translations/ms/Roadmap.md @@ -0,0 +1,53 @@ +# Peta Jalan untuk Repositori Web-Dev-For-Beginners Microsoft + +**Repositori ini menyediakan peta jalan untuk mempelajari asas pembangunan web dengan fokus pada JavaScript, HTML, dan CSS. Kurikulum ini fleksibel dan boleh diambil secara keseluruhan atau sebahagian, dengan 24 pelajaran yang tersebar sepanjang 12 minggu.** + +## Pencapaian Utama + +* **Minggu 1-3:** + * Pengenalan kepada bahasa pengaturcaraan dan alat perdagangan + * Asas GitHub + * Aksesibiliti + * Asas JS: jenis data, fungsi dan kaedah + * Membuat keputusan dengan JS +* **Minggu 4-6:** + * Array dan gelung + * Terrarium: HTML dalam praktik + * CSS dalam praktik + * Penutupan JavaScript + * Pengendalian DOM +* **Minggu 7-9:** + * Permainan Mengetik: Pengaturcaraan berasaskan acara + * Sambungan Pelayar Hijau: Bekerja dengan pelayar + * Membina borang, memanggil API dan menyimpan pemboleh ubah dalam storan tempatan + * Proses latar dalam pelayar + * Prestasi web +* **Minggu 10-12:** + * Permainan Angkasa: Pembangunan permainan lanjutan dengan JavaScript + * Melukis pada kanvas + * Menggerakkan elemen di sekitar skrin + * Pengesanan perlanggaran + * Menjaga skor, menamatkan dan memulakan semula permainan + * Aplikasi Perbankan: Templat HTML dan Laluan dalam Aplikasi Web + * Membina Borang Log Masuk dan Pendaftaran + * Kaedah Mengambil dan Menggunakan Data + * Konsep Pengurusan Keadaan + +## Hasil Pembelajaran + +**Dengan menamatkan peta jalan ini, pelajar akan memperoleh pengalaman praktikal membina permainan menaip, terrarium maya, sambungan pelayar mesra alam, permainan gaya penyerang angkasa, dan aplikasi perbankan untuk perniagaan. Mereka juga akan membina pemahaman kukuh tentang asas pembangunan web.** + +## Sumber Tambahan + +* Repositori ini menyediakan banyak sumber untuk pembelajaran selanjutnya, termasuk tutorial, contoh kod, dan cabaran. +* Platform Microsoft Learn menawarkan pelbagai kursus dan laluan pembelajaran pembangunan web. +* Komuniti dalam talian seperti Stack Overflow dan MDN Web Docs menyediakan sokongan dan sumber yang berharga untuk pembangun web. + +**Saya harap peta jalan ini membantu anda dalam perjalanan pembangunan web anda!** + +--- + + +**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 ambil perhatian bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asli dalam bahasa asalnya perlu dianggap sebagai sumber yang sahih. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini. + \ No newline at end of file diff --git a/translations/sw/.co-op-translator.json b/translations/sw/.co-op-translator.json index 0d223c739..e8b6a831a 100644 --- a/translations/sw/.co-op-translator.json +++ b/translations/sw/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2025-10-03T11:36:16+00:00", + "translation_date": "2026-02-06T18:05:48+00:00", "source_file": "AGENTS.md", "language_code": "sw" }, @@ -516,11 +516,17 @@ "language_code": "sw" }, "README.md": { - "original_hash": "490c83786552d7fab6390991517bef09", - "translation_date": "2026-01-29T18:55:31+00:00", + "original_hash": "6d6385fd098088cb2d690fb0a6cdaedc", + "translation_date": "2026-02-06T18:01:36+00:00", "source_file": "README.md", "language_code": "sw" }, + "Roadmap.md": { + "original_hash": "28bf6185fd7f27b62ddc210514366192", + "translation_date": "2026-02-06T18:02:20+00:00", + "source_file": "Roadmap.md", + "language_code": "sw" + }, "SECURITY.md": { "original_hash": "4ecc3bf2e27983d4c780be6f26ee6228", "translation_date": "2025-08-28T03:21:28+00:00", diff --git a/translations/sw/AGENTS.md b/translations/sw/AGENTS.md index a5e1a50cc..9bf550522 100644 --- a/translations/sw/AGENTS.md +++ b/translations/sw/AGENTS.md @@ -2,43 +2,43 @@ ## Muhtasari wa Mradi -Hii ni hifadhi ya mtaala wa elimu kwa ajili ya kufundisha misingi ya maendeleo ya wavuti kwa wanaoanza. Mtaala huu ni kozi ya kina ya wiki 12 iliyotengenezwa na Microsoft Cloud Advocates, yenye masomo 24 ya vitendo yanayofunika JavaScript, CSS, na HTML. +Hii ni hifadhidata ya mtaala wa elimu kwa kufundisha misingi ya maendeleo ya wavuti kwa wanaoanza. Mtaala ni kozi kamilifu ya wiki 12 iliyotengenezwa na Wakili wa Wingu wa Microsoft, ukiwa na masomo 24 ya vitendo yanayohusisha JavaScript, CSS, na HTML. ### Vipengele Muhimu -- **Yaliyomo ya Elimu**: Masomo 24 yaliyopangwa kwa utaratibu katika moduli za miradi -- **Miradi ya Vitendo**: Terrarium, Mchezo wa Kuandika, Kiendelezi cha Kivinjari, Mchezo wa Anga, Programu ya Benki, Mhariri wa Nambari, na Msaidizi wa Gumzo wa AI -- **Maswali ya Maingiliano**: Maswali 48 yenye maswali 3 kila moja (tathmini kabla/baada ya somo) -- **Msaada wa Lugha Nyingi**: Tafsiri za kiotomatiki kwa zaidi ya lugha 50 kupitia GitHub Actions +- **Yaliyomo ya Kielimu**: Masomo 24 yaliyoandaliwa kwa muundo wa miradi +- **Miradi ya Vitendo**: Terrarium, Mchezo wa Kuandika, Kiendelezi cha Kivinjari, Mchezo wa Anga, App ya Benki, Mhariri wa Nambari, na Msaidizi wa Chat wa AI +- **Mitihani ya Kuingiliana**: Mitihani 48 yenye maswali 3 kila moja (uchunguzi kabla/baada ya somo) +- **Msaada wa Lugha Nyingi**: Tafsiri za kiotomatiki kwa lugha 50+ kupitia GitHub Actions - **Teknolojia**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (kwa miradi ya AI) -### Miundombinu +### Muundo -- Hifadhi ya elimu yenye muundo wa msingi wa masomo -- Kila folda ya somo ina README, mifano ya nambari, na suluhisho -- Miradi huru katika saraka tofauti (quiz-app, miradi mbalimbali ya somo) +- Hifadhidata ya kielimu yenye muundo wa somo +- Kila folda ya somo ina README, mifano ya msimbo, na suluhisho +- Miradi huru katika folda tofauti (quiz-app, miradi mbalimbali ya somo) - Mfumo wa tafsiri ukitumia GitHub Actions (co-op-translator) -- Nyaraka zinatolewa kupitia Docsify na zinapatikana kama PDF +- Nyaraka hutolewa kupitia Docsify na zinapatikana kama PDF -## Amri za Usanidi +## Amri za Kuanzisha -Hifadhi hii ni hasa kwa ajili ya matumizi ya yaliyomo ya elimu. Kwa kufanya kazi na miradi maalum: +Hifadhidata hii ni kwa lengo la matumizi ya yaliyomo kielimu. Kwa kazi na miradi maalum: -### Usanidi wa Hifadhi Kuu +### Kuanzisha Hifadhidata Kuu ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Usanidi wa Programu ya Maswali (Vue 3 + Vite) +### Kuanzisha Quiz App (Vue 3 + Vite) ```bash cd quiz-app npm install -npm run dev # Start development server -npm run build # Build for production -npm run lint # Run ESLint +npm run dev # Anzisha seva ya maendeleo +npm run build # Tengeneza kwa ajili ya uzalishaji +npm run lint # Endesha ESLint ``` ### API ya Mradi wa Benki (Node.js + Express) @@ -46,9 +46,9 @@ npm run lint # Run ESLint ```bash cd 7-bank-project/api npm install -npm start # Start API server -npm run lint # Run ESLint -npm run format # Format with Prettier +npm start # Anza seva ya API +npm run lint # Endesha ESLint +npm run format # Panga kwa Prettier ``` ### Miradi ya Kiendelezi cha Kivinjari @@ -56,7 +56,7 @@ npm run format # Format with Prettier ```bash cd 5-browser-extension/solution npm install -# Follow browser-specific extension loading instructions +# Fuata maelekezo ya upakiaji wa programu-jalizi maalum za kivinjari ``` ### Miradi ya Mchezo wa Anga @@ -64,219 +64,219 @@ npm install ```bash cd 6-space-game/solution npm install -# Open index.html in browser or use Live Server +# Fungua index.html katika kivinjari au tumia Live Server ``` -### Mradi wa Gumzo (Python Backend) +### Mradi wa Chat (Python Backend) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Set GITHUB_TOKEN environment variable +# Weka variable ya mazingira ya GITHUB_TOKEN python api.py ``` ## Mtiririko wa Maendeleo -### Kwa Wanaochangia Yaliyomo +### Kwa Wasaidizi wa Maudhui -1. **Fork hifadhi** kwenye akaunti yako ya GitHub -2. **Clone fork yako** kwenye kompyuta yako -3. **Unda tawi jipya** kwa mabadiliko yako -4. Fanya mabadiliko kwenye yaliyomo ya somo au mifano ya nambari -5. Jaribu mabadiliko yoyote ya nambari katika saraka husika za mradi -6. Tuma maombi ya kuvuta ukifuata miongozo ya mchango +1. **Fungua 'fork' ya hifadhidata** kwenye akaunti yako ya GitHub +2. **Nakili fork yako** ndani ya kompyuta +3. **Tengeneza tawi jipya** kwa mabadiliko yako +4. Fanya mabadiliko kwa yaliyomo ya somo au mifano ya msimbo +5. Jaribu mabadiliko yoyote ya msimbo katika folda zinazohusiana za mradi +6. Wasilisha mahitaji ya kusukuma ikifuata miongozo ya michango ### Kwa Wanafunzi -1. Fork au clone hifadhi -2. Tembelea saraka za masomo kwa utaratibu +1. Fikia 'fork' au nakili hifadhidata +2. Tembea folda za masomo kwa mfuatano 3. Soma faili za README kwa kila somo -4. Kamilisha maswali ya kabla ya somo kwenye https://ff-quizzes.netlify.app/web/ -5. Fanya kazi kupitia mifano ya nambari katika folda za masomo -6. Kamilisha kazi na changamoto -7. Fanya maswali ya baada ya somo +4. Kamilisha mitihani ya kabla ya somo kwenye https://ff-quizzes.netlify.app/web/ +5. Fanya kazi kupitia mifano ya msimbo kwenye folda za masomo +6. Kamilisha majukumu na changamoto +7. Fanya mitihani ya baada ya somo ### Maendeleo ya Moja kwa Moja - **Nyaraka**: Endesha `docsify serve` kwenye mzizi (bandari 3000) -- **Programu ya Maswali**: Endesha `npm run dev` kwenye saraka ya quiz-app -- **Miradi**: Tumia kiendelezi cha Live Server cha VS Code kwa miradi ya HTML -- **Miradi ya API**: Endesha `npm start` kwenye saraka husika za API +- **Quiz App**: Endesha `npm run dev` kwenye folda ya quiz-app +- **Miradi**: Tumia VS Code Live Server kwa miradi ya HTML +- **Miradi ya API**: Endesha `npm start` kwenye folda husika za API -## Maelekezo ya Kupima +## Maelekezo ya Upimaji -### Upimaji wa Programu ya Maswali +### Upimaji wa Quiz App ```bash cd quiz-app -npm run lint # Check for code style issues -npm run build # Verify build succeeds +npm run lint # Angalia matatizo ya mtindo wa msimbo +npm run build # Thibitisha ujenzi unafanikiwa ``` ### Upimaji wa API ya Benki ```bash cd 7-bank-project/api -npm run lint # Check for code style issues -node server.js # Verify server starts without errors +npm run lint # Angalia matatizo ya mtindo wa msimbo +node server.js # Thibitisha server inaanza bila makosa ``` -### Njia ya Jumla ya Upimaji +### Mbinu ya Upimaji kwa Juu -- Hii ni hifadhi ya elimu bila majaribio ya kiotomatiki ya kina -- Upimaji wa mikono unalenga: - - Mifano ya nambari inaendeshwa bila makosa - - Viungo katika nyaraka vinafanya kazi ipasavyo - - Ujenzi wa mradi unakamilika kwa mafanikio +- Hii ni hifadhidata ya elimu bila majaribio ya kiotomatiki ya kina +- Upimaji wa mkono unazingatia: + - Mifano ya msimbo inatimia bila makosa + - Viungo kwenye nyaraka vinatumika ipasavyo + - Ujenzi wa mradi hufanyika kwa mafanikio - Mifano inafuata mbinu bora -### Ukaguzi Kabla ya Kuwasilisha +### Ukaguzi wa Kabla ya Kuwasilisha -- Endesha `npm run lint` katika saraka zilizo na package.json -- Hakikisha viungo vya markdown ni halali -- Jaribu mifano ya nambari kwenye kivinjari au Node.js -- Hakikisha tafsiri zinadumisha muundo sahihi +- Endesha `npm run lint` katika folda zenye package.json +- Hakiki viungo vya markdown ni sahihi +- Jaribu mifano ya msimbo katika kivinjari au Node.js +- Angalia tafsiri zinahifadhi muundo mzuri -## Miongozo ya Mtindo wa Nambari +## Miongozo ya Mtindo wa Msimbo ### JavaScript - Tumia sintaksia ya kisasa ya ES6+ -- Fuata usanidi wa kawaida wa ESLint uliotolewa katika miradi -- Tumia majina ya maana kwa vigezo na kazi kwa uwazi wa elimu -- Ongeza maelezo yanayofafanua dhana kwa wanafunzi -- Fomati ukitumia Prettier pale inapowekwa +- Fuata usanidi wa ESLint uliowekwa katika miradi +- Tumia majina ya maana kwa mabadiliko na kazi kwa ufafanuzi wa kielimu +- Ongeza maelezo kuelezea dhana kwa wanafunzi +- Panga kwa Prettier pale panapopangizwa ### HTML/CSS - Vipengele vya semantic vya HTML5 -- Kanuni za muundo wa msikivu -- Mipangilio ya wazi ya majina ya darasa -- Maelezo yanayofafanua mbinu za CSS kwa wanafunzi +- Kanuni za muundo unaobadilika (responsive) +- Mazingira ya majina ya darasa yaliyobainishwa wazi +- Maelezo ya mbinu za CSS kwa wanafunzi ### Python - Miongozo ya mtindo wa PEP 8 -- Mifano ya nambari iliyo wazi na ya kielimu -- Vidokezo vya aina pale vinaposaidia kujifunza +- Mifano wazi, ya kielimu +- Vidokezo vya aina walivyonufaika na kujifunza ### Nyaraka za Markdown -- Hierarkia ya wazi ya vichwa -- Vitalu vya nambari vilivyo na maelezo ya lugha -- Viungo kwa rasilimali za ziada -- Picha na michoro katika saraka za `images/` -- Maandishi mbadala kwa picha kwa upatikanaji +- Hieraki ya vichwa vya habari +- Sehemu za msimbo zenye lugha +- Viungo vya rasilimali za ziada +- Picha na manyumbulizo kwenye folda za `images/` +- Nyaraka za alt kwa picha kwa upatikanaji ### Mpangilio wa Faili -- Masomo yamepangwa kwa namba kwa utaratibu (1-getting-started-lessons, 2-js-basics, nk.) -- Kila mradi una `solution/` na mara nyingi `start/` au `your-work/` saraka -- Picha zimehifadhiwa katika folda maalum za `images/` za somo +- Masomo namba mfuatano (1-getting-started-lessons, 2-js-basics, n.k) +- Mradi wowote una folda za `solution/` na mara nyingi `start/` au `your-work/` +- Picha huhifadhiwa katika folda maalum za masomo `images/` - Tafsiri katika muundo wa `translations/{language-code}/` -## Ujenzi na Upelekaji +## Ujenzi na Uenezaji -### Upelekaji wa Programu ya Maswali (Azure Static Web Apps) +### Uenezaji wa Quiz App (Azure Static Web Apps) -Programu ya quiz-app imewekwa kwa ajili ya upelekaji wa Azure Static Web Apps: +quiz-app imepangiliwa kwa uenezaji wa Azure Static Web Apps: ```bash cd quiz-app -npm run build # Creates dist/ folder -# Deploys via GitHub Actions workflow on push to main +npm run build # Inaunda folda ya dist/ +# Inaweka kupitia mtiririko wa kazi wa GitHub Actions wakati wa kusukuma kwenye main ``` -Usanidi wa Azure Static Web Apps: -- **Mahali pa Programu**: `/quiz-app` +Mipangilio ya Azure Static Web Apps: +- **Mahali pa App**: `/quiz-app` - **Mahali pa Matokeo**: `dist` - **Mtiririko wa Kazi**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### Uzalishaji wa PDF wa Nyaraka +### Uundaji wa PDF za Nyaraka ```bash -npm install # Install docsify-to-pdf -npm run convert # Generate PDF from docs +npm install # Sanidi docsify-to-pdf +npm run convert # Tengeneza PDF kutoka kwa docs ``` ### Nyaraka za Docsify ```bash -npm install -g docsify-cli # Install Docsify globally -docsify serve # Serve on localhost:3000 +npm install -g docsify-cli # Sakinisha Docsify kwa ulimwengu mzima +docsify serve # Hudumia kwenye localhost:3000 ``` -### Ujenzi Maalum wa Mradi +### Ujenzi Maalum wa Miradi -Kila saraka ya mradi inaweza kuwa na mchakato wake wa ujenzi: +Kila folda ya mradi inaweza kuwa na mchakato wake wa ujenzi: - Miradi ya Vue: `npm run build` huunda vifurushi vya uzalishaji -- Miradi ya Stata: Hakuna hatua ya ujenzi, tumia faili moja kwa moja +- Miradi ya static: Hakuna hatua ya ujenzi, tengeneza faili moja kwa moja -## Miongozo ya Maombi ya Kuvuta +## Miongozo ya Ombi la Kujoshea (Pull Request) ### Muundo wa Kichwa -Tumia vichwa vya wazi, vya kuelezea vinavyoonyesha eneo la mabadiliko: -- `[Quiz-app] Ongeza maswali mapya kwa somo X` -- `[Lesson-3] Rekebisha hitilafu ya tahajia katika mradi wa terrarium` -- `[Translation] Ongeza tafsiri ya Kihispania kwa somo la 5` -- `[Docs] Sasisha maelekezo ya usanidi` +Tumia vichwa wazi na vinaonesha eneo la mabadiliko: +- `[Quiz-app] Ongeza mtihani mpya kwa somo X` +- `[Lesson-3] Rekebisha kosa la tahajia katika mradi wa terrarium` +- `[Translation] Ongeza tafsiri ya Kihispania kwa somo 5` +- `[Docs] Sasisha maelekezo ya kuanzisha` -### Ukaguzi Unaohitajika +### Uchunguzi Unaohitajika Kabla ya kuwasilisha PR: -1. **Ubora wa Nambari**: - - Endesha `npm run lint` katika saraka za mradi zilizoathirika - - Rekebisha makosa na onyo yote ya linting +1. **Ubora wa Msimbo**: + - Endesha `npm run lint` katika folda za miradi zilizohusika + - Rekebisha makosa na onyo zote za lint -2. **Uthibitishaji wa Ujenzi**: - - Endesha `npm run build` ikiwa inahitajika +2. **Uhakiki wa Ujenzi**: + - Endesha `npm run build` inapohitajika - Hakikisha hakuna makosa ya ujenzi -3. **Uthibitishaji wa Viungo**: +3. **Uhakiki wa Viungo**: - Jaribu viungo vyote vya markdown - - Hakikisha marejeleo ya picha yanafanya kazi + - Thibitisha marejeleo ya picha yanatumika -4. **Ukaguzi wa Yaliyomo**: - - Hakiki tahajia na sarufi - - Hakikisha mifano ya nambari ni sahihi na ya kielimu - - Hakikisha tafsiri zinadumisha maana ya awali +4. **Mapitio ya Maudhui**: + - Soma kwa usahihi ya tahajia na sarufi + - Hakikisha mifano ya msimbo ni sahihi na ya kielimu + - Hakikisha tafsiri zinahifadhi maana asili -### Mahitaji ya Mchango +### Mahitaji ya Michango - Kubali Microsoft CLA (ukaguzi wa kiotomatiki kwenye PR ya kwanza) - Fuata [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- Tazama [CONTRIBUTING.md](./CONTRIBUTING.md) kwa miongozo ya kina -- Rejelea namba za masuala katika maelezo ya PR ikiwa inahitajika +- Angalia [CONTRIBUTING.md](./CONTRIBUTING.md) kwa miongozo kamili +- Rejelea nambari za masuala katika maelezo ya PR kama zinahusika ### Mchakato wa Mapitio -- PRs hupitiwa na wasimamizi na jamii -- Uwiano wa elimu unapewa kipaumbele -- Mifano ya nambari inapaswa kufuata mbinu bora za sasa -- Tafsiri hupitiwa kwa usahihi na kufaa kwa kitamaduni +- PR hupitiwa na wasimamizi na jamii +- Uwazi wa elimu unaheshimiwa +- Mifano ya msimbo inapaswa kufuata mbinu bora za sasa +- Tafsiri hupitiwa kwa usahihi na utamaduni unaofaa ## Mfumo wa Tafsiri ### Tafsiri ya Kiotomatiki -- Inatumia GitHub Actions na mtiririko wa kazi wa co-op-translator -- Hutafsiri kwa zaidi ya lugha 50 kiotomatiki -- Faili za chanzo katika saraka kuu -- Faili zilizotafsiriwa katika muundo wa `translations/{language-code}/` +- Inatumia GitHub Actions na mtiririko wa co-op-translator +- Hutoa tafsiri kwa lugha zaidi ya 50 kiotomatiki +- Faili za asili ziko katika folda kuu +- Faili za tafsiri ziko `translations/{language-code}/` -### Kuongeza Maboresho ya Tafsiri ya Mwongozo +### Kuongeza Maboresho ya Tafsiri ya Mkono 1. Tafuta faili katika `translations/{language-code}/` -2. Fanya maboresho huku ukidumisha muundo -3. Hakikisha mifano ya nambari inabaki kufanya kazi -4. Jaribu maudhui yoyote ya maswali yaliyotafsiriwa +2. Fanya maboresho huku ukihifadhi muundo +3. Hakikisha mifano ya msimbo inabaki kazi +4. Jaribu maudhui ya mtihani uliobadilishwa kwa lugha husika ### Metadata ya Tafsiri -Faili zilizotafsiriwa zinajumuisha kichwa cha metadata: +Faili za tafsiri zina kiambatisho cha metadata: ```markdown ``` -## Usuluhishi wa Hitilafu na Utatuzi +## Ufungaji na Utatuzi wa Matatizo ### Masuala ya Kawaida -**Programu ya maswali haianzi**: -- Hakikisha toleo la Node.js (v14+ linapendekezwa) -- Futa `node_modules` na `package-lock.json`, kisha endesha `npm install` tena -- Angalia migongano ya bandari (chaguo-msingi: Vite hutumia bandari 5173) +**Quiz app haianzi**: +- Angalia toleo la Node.js (v14+ inashauriwa) +- Futa `node_modules` na `package-lock.json`, endesha tena `npm install` +- Angalia migongano ya bandari (kawaida: Vite hutumia bandari 5173) -**Seva ya API haianzi**: -- Hakikisha toleo la Node.js linakidhi kiwango cha chini (node >=10) +**Server ya API haianzi**: +- Thibitisha toleo la Node.js linakidhi (node >=10) - Angalia kama bandari tayari inatumika -- Hakikisha utegemezi wote umewekwa na `npm install` +- Hakikisha utegemezi wote umewekwa kwa `npm install` -**Kiendelezi cha kivinjari hakipakii**: -- Hakikisha manifest.json imeundwa ipasavyo -- Angalia makosa kwenye console ya kivinjari +**Kiendelezi cha kivinjari hakifungui**: +- Thibitisha manifest.json imeandikwa vizuri +- Angalia console ya kivinjari kwa makosa - Fuata maelekezo maalum ya usakinishaji wa kiendelezi cha kivinjari -**Masuala ya mradi wa gumzo la Python**: -- Hakikisha kifurushi cha OpenAI kimewekwa: `pip install openai` -- Hakikisha mazingira ya GITHUB_TOKEN yamewekwa -- Angalia ruhusa za ufikiaji wa GitHub Models +**Matatizo ya mradi wa chat wa Python**: +- Hakikisha kifurushi cha OpenAI kimesakinishwa: `pip install openai` +- Thibitisha GITHUB_TOKEN imewekwa kwa mazingira +- Angalia ruhusa za kupata GitHub Models -**Docsify haifanyi kazi**: +**Docsify haionyeshi nyaraka**: - Sakinisha docsify-cli kimataifa: `npm install -g docsify-cli` -- Endesha kutoka kwenye saraka ya mzizi ya hifadhi -- Hakikisha `docs/_sidebar.md` ipo +- Endesha kutoka folda ya mzizi ya hifadhidata +- Hakiki kuwepo kwa `docs/_sidebar.md` ### Vidokezo vya Mazingira ya Maendeleo -- Tumia VS Code na kiendelezi cha Live Server kwa miradi ya HTML -- Sakinisha viendelezi vya ESLint na Prettier kwa fomati thabiti -- Tumia DevTools za kivinjari kwa utatuzi wa nambari za JavaScript -- Kwa miradi ya Vue, sakinisha kiendelezi cha Vue DevTools kwenye kivinjari +- Tumia VS Code yenye upanuzi wa Live Server kwa miradi ya HTML +- Sakinisha upanuzi wa ESLint na Prettier kwa muundo thabiti +- Tumia zana za DevTools za kivinjari kutatua masuala ya JavaScript +- Kwa miradi ya Vue, sakinisha upanuzi wa Vue DevTools wa kivinjari -### Mazingatio ya Utendaji +### Mambo ya Kuangalia Utendaji -- Idadi kubwa ya faili zilizotafsiriwa (lugha 50+) inamaanisha clones kamili ni kubwa -- Tumia clone ya kina ikiwa unafanya kazi tu kwenye yaliyomo: `git clone --depth 1` -- Ondoa tafsiri kutoka kwa utafutaji unapofanya kazi kwenye yaliyomo ya Kiingereza -- Michakato ya ujenzi inaweza kuwa polepole kwenye uendeshaji wa kwanza (npm install, Vite build) +- Idadi kubwa ya faili za tafsiri (lugha 50+) maana clones kamili zina ukubwa mkubwa +- Tumia clone dhaifu ukifanya kazi tu na yaliyomo: `git clone --depth 1` +- Epuka tafutiza tafsiri unapotaka kufanya kazi na maudhui ya Kiingereza +- Mchakato wa ujenzi unaweza kuchukua muda kwenye mwanzoni (npm install, ujenzi Vite) -## Mazingatio ya Usalama +## Masuala ya Usalama ### Vigezo vya Mazingira -- Funguo za API hazipaswi kamwe kujitolea kwenye hifadhi -- Tumia faili za `.env` (tayari ziko kwenye `.gitignore`) -- Andika nyaraka za vigezo vya mazingira vinavyohitajika katika README za mradi +- Funguo za API hazipaswi kuwekwa kwenye hifadhidata +- Tumia faili za `.env` (zimenaswa katika `.gitignore`) +- Eleza vigezo vya mazingira vinavyohitajika katika README za miradi ### Miradi ya Python -- Tumia mazingira ya kawaida: `python -m venv venv` -- Weka utegemezi umesasishwa -- Tokeni za GitHub zinapaswa kuwa na ruhusa za chini zinazohitajika +- Tumia mazingira ya kudanganya (virtual environments): `python -m venv venv` +- Sasisha utegemezi mara kwa mara +- Tokeni za GitHub ziwe na ruhusa ndogo inayohitajika -### Ufikiaji wa GitHub Models +### Kufikia GitHub Models - Tokeni za Ufikiaji wa Kibinafsi (PAT) zinahitajika kwa GitHub Models -- Tokeni zinapaswa kuhifadhiwa kama vigezo vya mazingira -- Usijitolee kamwe tokeni au hati za siri +- Tokeni zihifadhiwe kama vigezo vya mazingira +- Usiwekee tokeni au nyaraka kwenye hifadhidata -## Vidokezo vya Ziada +## Vidokezo Zaidi -### Watazamaji Wanaolengwa +### Walengwa -- Wanaoanza kabisa katika maendeleo ya wavuti -- Wanafunzi na wanaojifunza wenyewe +- Wanaoanza kabisa kwenye maendeleo ya wavuti +- Wanafunzi na wanaojifunza peke yao - Walimu wanaotumia mtaala darasani -- Yaliyomo yameundwa kwa upatikanaji na ujenzi wa ujuzi wa hatua kwa hatua +- Yaliyomo yameundwa kwa njia inayofanikisha upatikanaji na kujifunza hatua kwa hatua ### Falsafa ya Elimu -- Njia ya kujifunza kwa msingi wa mradi -- Ukaguzi wa maarifa wa mara kwa mara (maswali) -- Mazoezi ya vitendo ya nambari -- Mifano ya matumizi ya ulimwengu halisi -- Kuzingatia misingi kabla ya mifumo +- Njia ya kujifunza kupitia miradi +- Mikakati ya mara kwa mara ya kukagua maarifa (mitihani) +- Mazoezi ya vitendo vya uandishi wa msimbo +- Mifano halisi ya matumizi +- Kuzingatia misingi kabla ya mifumo ya kazi (frameworks) -### Matengenezo ya Hifadhi +### Usimamizi wa Hifadhidata -- Jamii hai ya wanafunzi na wachangiaji -- Sasisho za mara kwa mara kwa utegemezi na yaliyomo -- Masuala na mijadala inafuatiliwa na wasimamizi -- Sasisho za tafsiri zinafanywa kiotomatiki kupitia GitHub Actions +- Jamii hai ya wanafunzi na wasaidizi +- Sasisho la mara kwa mara la utegemezi na yaliyomo +- Masuala na majadiliano yanadhibitiwa na wasimamizi +- Sasisho za tafsiri kwa kutumia GitHub Actions kiotomatiki ### Rasilimali Zinazohusiana -- [Moduli za Microsoft Learn](https://docs.microsoft.com/learn/) +- [Microsoft Learn modules](https://docs.microsoft.com/learn/) - [Rasilimali za Student Hub](https://docs.microsoft.com/learn/student-hub/) -- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) inapendekezwa kwa wanafunzi -- Kozi za ziada: Generative AI, Sayansi ya Takwimu, ML, mtaala wa IoT unapatikana +- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) inayopendekezwa kwa wanafunzi +- Kozi za ziada: AI ya Kutengeneza, Sayansi ya Data, ML, kozi za IoT zinapatikana -### Kufanya Kazi na Miradi Mahususi +### Kazi na Miradi Maalum -Kwa maelekezo ya kina juu ya miradi ya mtu binafsi, rejelea faili za README katika: -- `quiz-app/README.md` - Programu ya maswali ya Vue 3 +Kwa maelekezo ya kina kuhusu miradi binafsi, rejelea faili za README katika: +- `quiz-app/README.md` - Programu ya quiz ya Vue 3 - `7-bank-project/README.md` - Programu ya benki yenye uthibitishaji - `5-browser-extension/README.md` - Maendeleo ya kiendelezi cha kivinjari -- `6-space-game/README.md` - Maendeleo ya mchezo wa msingi wa Canvas -- `9-chat-project/README.md` - Mradi wa msaidizi wa gumzo la AI +- `6-space-game/README.md` - Maendeleo ya mchezo wa Canvas +- `9-chat-project/README.md` - Mradi wa msaidizi wa chat AI ### Muundo wa Monorepo -Ingawa si monorepo ya jadi, hifadhi hii ina miradi huru mingi: -- Kila somo ni huru +Ingawa sio monorepo ya kawaida, hifadhidata hii ina miradi kadhaa huru: +- Kila somo lina muundo wake - Miradi haishiriki utegemezi -- Fanya kazi kwenye miradi ya mtu binafsi bila kuathiri mingine -- Clone hifadhi nzima kwa uzoefu kamili wa mtaala +- Fanya kazi kwenye miradi binafsi bila kuathiri mingine +- Nakili hifadhidata nzima kwa uzoefu kamili wa mtaala --- -**Kanusho**: -Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi kuhakikisha usahihi, tafadhali fahamu kuwa tafsiri za kiotomatiki zinaweza kuwa na makosa au kutokuwa sahihi. Hati ya asili katika lugha yake ya awali inapaswa kuzingatiwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu ya binadamu inapendekezwa. Hatutawajibika kwa kutoelewana au tafsiri zisizo sahihi zinazotokana na matumizi ya tafsiri hii. \ No newline at end of file + +**Kipengele cha Kutolewa Wajibu**: +Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi kwa usahihi, tafadhali fahamu kwamba tafsiri za moja kwa moja zinaweza kuwa na makosa au usahihi mdogo. Hati ya asili katika lugha yake ya asili inapaswa kuchukuliwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya mtaalamu wa binadamu inapendekezwa. Hatuwezi kuwajibika kwa kutoelewana au tafsiri potovu zinazotokana na matumizi ya tafsiri hii. + \ No newline at end of file diff --git a/translations/sw/README.md b/translations/sw/README.md index 10affb10d..12a1025f5 100644 --- a/translations/sw/README.md +++ b/translations/sw/README.md @@ -1,205 +1,204 @@ -[![GitHub license](https://img.shields.io/github/license/microsoft/Web-Dev-For-Beginners.svg)](https://github.com/microsoft/Web-Dev-For-Beginners/blob/master/LICENSE) -[![GitHub contributors](https://img.shields.io/github/contributors/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/graphs/contributors/) -[![GitHub issues](https://img.shields.io/github/issues/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/issues/) -[![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/pulls/) -[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) +[![Leseni ya GitHub](https://img.shields.io/github/license/microsoft/Web-Dev-For-Beginners.svg)](https://github.com/microsoft/Web-Dev-For-Beginners/blob/master/LICENSE) +[![Wachangiaji wa GitHub](https://img.shields.io/github/contributors/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/graphs/contributors/) +[![Masuala ya GitHub](https://img.shields.io/github/issues/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/issues/) +[![Maombi ya pull ya GitHub](https://img.shields.io/github/issues-pr/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/pulls/) +[![Karibu PRs](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) -[![GitHub watchers](https://img.shields.io/github/watchers/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Watch&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/watchers/) -[![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Fork&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/network/) -[![GitHub stars](https://img.shields.io/github/stars/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Star&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/stargazers/) +[![Watazamaji wa GitHub](https://img.shields.io/github/watchers/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Watch&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/watchers/) +[![Machota ya GitHub](https://img.shields.io/github/forks/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Fork&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/network/) +[![Nyota za GitHub](https://img.shields.io/github/stars/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Star&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/stargazers/) [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -# Maendeleo ya Wavuti kwa Kompyuta wanaoanza - Mtaala +# Maendeleo ya Wavuti kwa Waanzilishi - Mtaala -Jifunze misingi ya maendeleo ya wavuti kupitia kozi yetu kamili ya wiki 12 inayotolewa na Wakili wa Wingu wa Microsoft. Kila somo kati ya 24 linachunguza JavaScript, CSS, na HTML kupitia miradi ya vitendo kama vile terrariums, nyongeza za kivinjari, na michezo ya nafasi. Shiriki katika majaribio, mijadala, na kazi za vitendo. Boresha ujuzi wako na boresha kumbukumbu yako kwa njia yetu madhubuti inayotegemea miradi. Anza safari yako ya uandishi wa programu leo! +Jifunze misingi ya maendeleo ya wavuti kupitia kozi yetu ya kina ya wiki 12 inayotolewa na Wakili wa Wingu wa Microsoft. Kila somo kati ya 24 linaingia kwa undani katika JavaScript, CSS, na HTML kwa mradi wa vitendo kama vile terrariums, nyongeza za kivinjari, na michezo ya anga. Shirikiana na maswali, mijadala, na kazi za vitendo. Boreshaji ujuzi wako na kuimarisha ufahamu wako kwa njia yetu bora ya kufundisha inayozingatia miradi. Anza safari yako ya kuprogramu leo! -Jiunge na Jamii ya Azure AI Foundry Discord +Jiunge na Jamii ya Discord ya Azure AI Foundry [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) Fuata hatua hizi kuanza kutumia rasilimali hizi: -1. **Fungua Nakala**: Bonyeza [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork) +1. **Chimba Hifadhi**: Bonyeza [![Machota ya GitHub](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork) 2. **Nakili Hifadhi**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` -3. [**Jiunge na Azure AI Foundry Discord na ukutane na wataalamu na wenzako wa maendeleo**](https://discord.com/invite/ByRwuEEgH4) +3. [**Jiunge na Discord ya Azure AI Foundry na ukutane na wataalamu na wapenzi wa maendeleo**](https://discord.com/invite/ByRwuEEgH4) -### 🌐 Usaidizi wa Lugha Mbalimbali +### 🌐 Msaada wa Lugha Nyingi -#### Unaungwa mkono kupitia Kitendo cha GitHub (Moja kwa Moja & Daima ya Kisasa) +#### Unaungwa mkono kupitia Kitendo cha GitHub (Kiotomatiki & Kila Mara Kisivyocha) -[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](./README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) +[Kiarabu](../ar/README.md) | [Kibengali](../bn/README.md) | [Kibulgaria](../bg/README.md) | [Kiburma (Myanmar)](../my/README.md) | [Kichina (Rahisi)](../zh-CN/README.md) | [Kichina (Marefu, Hong Kong)](../zh-HK/README.md) | [Kichina (Marefu, Macau)](../zh-MO/README.md) | [Kichina (Marefu, Taiwan)](../zh-TW/README.md) | [Kikroeshia](../hr/README.md) | [Kicheki](../cs/README.md) | [Kideni](../da/README.md) | [Kiholanzi](../nl/README.md) | [Kiestoniani](../et/README.md) | [Kifini](../fi/README.md) | [Kifaransa](../fr/README.md) | [Kijerumani](../de/README.md) | [Kigiriki](../el/README.md) | [Kiheberi](../he/README.md) | [Kihindi](../hi/README.md) | [Kihungari](../hu/README.md) | [Kiindonesia](../id/README.md) | [Kitaliano](../it/README.md) | [Kijapani](../ja/README.md) | [Kikannada](../kn/README.md) | [Kikorea](../ko/README.md) | [Kilithuania](../lt/README.md) | [Kimelayu](../ms/README.md) | [Kimalayalam](../ml/README.md) | [Kimarathi](../mr/README.md) | [Kinepali](../ne/README.md) | [Pidgin ya Nijeria](../pcm/README.md) | [Kinorwe](../no/README.md) | [Kiajemi (Farsi)](../fa/README.md) | [Kipolandi](../pl/README.md) | [Kireno (Brazil)](../pt-BR/README.md) | [Kireno (Ureno)](../pt-PT/README.md) | [Kipunabi (Gurmukhi)](../pa/README.md) | [Kiromania](../ro/README.md) | [Kirusi](../ru/README.md) | [Kiserbia (Sirilik)](../sr/README.md) | [Kislovakia](../sk/README.md) | [Kislovenia](../sl/README.md) | [Kihispania](../es/README.md) | [Kiswahili](./README.md) | [Kiswidi](../sv/README.md) | [Kitagalogi (Filipino)](../tl/README.md) | [Kitamili](../ta/README.md) | [Kitelugu](../te/README.md) | [Kithai](../th/README.md) | [Kituruki](../tr/README.md) | [Kiukrania](../uk/README.md) | [Kiurdu](../ur/README.md) | [Kivietinamu](../vi/README.md) -> **Unapendelea Nakili Mahali pa Mitaa?** +> **Unapendelea Kunakili Moja kwa Moja?** -> Hifadhi hii ina tafsiri za lugha zaidi ya 50 ambazo huongeza sana ukubwa wa kupakua. Ili nakili bila tafsiri, tumia sparse checkout: +> Hifadhi hii ina tafsiri za lugha zaidi ya 50 ambazo huongeza sana ukubwa wa kupakua. Ili kunakili bila tafsiri, tumia sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Web-Dev-For-Beginners.git > cd Web-Dev-For-Beginners > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Hii inakupa kila unachohitaji kukamilisha kozi kwa upakuaji wa kasi zaidi. +> Hii inakupa kila kitu unachohitaji kumaliza kozi kwa download ya kasi zaidi. -**Ikiwa unataka lugha zaidi za tafsiri zisaidiwe zinaorodheshwa [hapa](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)** +**Ikiwa unataka kuwa na lugha za tafsiri za ziada zinazoungwa mkono zimo [hapa](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)** -[![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners) +[![Fungua katika Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners) #### 🧑‍🎓 _Je, wewe ni mwanafunzi?_ -Tembelea [**ukurasa wa Student Hub**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) ambapo utapata rasilimali za wanaoanza, vifurushi vya wanafunzi na hata njia za kupata vocha ya cheti bure. Huu ni ukurasa unayetaka kuweka alama na kuangalia mara kwa mara kama tunabadilisha maudhui kila mwezi. +Tembelea [**ukurasa wa Kituo cha Wanafunzi**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) ambapo utapata rasilimali kwa wanaoanza, vifurushi vya Wanafunzi na hata njia za kupata vocha ya cheti bure. Huu ni ukurasa unayotaka kuweka alama na kuangalia mara kwa mara tunapo badilisha maudhui kila mwezi. -### 📣 Tangazo - Changamoto mpya za Mode ya GitHub Copilot Agent za kukamilisha! +### 📣 Tangazo - Changamoto mpya za Hali ya Wakala wa GitHub Copilot za kukamilisha! -Changamoto mpya imeongezwa, tafuta "GitHub Copilot Agent Challenge 🚀" katika sura nyingi. Hiyo ni changamoto mpya kwa kukamilisha ukitumia GitHub Copilot na mode ya Agent. Ikiwa bado hujatumia mode ya Agent, inaweza si tu kutengeneza maandishi bali pia kuunda na kuhariri mafaili, kuendesha amri na zaidi. +Changamoto mpya imeongezwa, tafuta "Changamoto ya Wakala wa GitHub Copilot 🚀" katika sura nyingi. Hii ni changamoto mpya kwako kumaliza ukitumia GitHub Copilot na hali ya Wakala. Ikiwa hujawahi kutumia hali ya Wakala hapo awali ina uwezo wa si tu kuandika maandishi bali pia kuunda na kuhariri faili, kuendesha amri na zaidi. -### 📣 Tangazo - _Mradi Mpya wa Kujenga ukitumia AI ya Kizazi_ +### 📣 Tangazo - _Mradi Mpya wa kujenga ukitumia AI ya Kizazi_ Mradi mpya wa Msaidizi wa AI umeongezwa hivi karibuni, angalia [mradi](./9-chat-project/README.md) -### 📣 Tangazo - _Mtaala Mpya_ juu ya AI ya Kizazi kwa JavaScript umeachiliwa hivi karibuni +### 📣 Tangazo - _Mtaala Mpya_ juu ya AI ya Kizazi kwa JavaScript umeachiliwa tu -Usikose mtaala wetu mpya wa AI ya kizazi! +Usikose mtaala wetu mpya wa AI ya Kizazi! Tembelea [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) kuanza! ![Background](../../translated_images/sw/background.148a8d43afde5730.webp) -- Masomo yanayojumuisha kila kitu kuanzia misingi hadi RAG. -- Shirikiana na wahusika wa kihistoria ukitumia GenAI na programu yetu ya mshirika. -- Hadithi za kufurahisha na za kuvutia, utasafiri kwa wakati! +- Masomo yanayogusa kila kitu kutoka mwanzo hadi RAG. +- Shirikiana na wahusika wa kihistoria ukitumia GenAI na programu yetu ya mwenzaji. +- Hadithi ya kufurahisha na yenye mvuto, utasafiri kwa wakati! ![character](../../translated_images/sw/character.5c0dd8e067ffd693.webp) -Kila somo lina kazi za kukamilisha, jaribio la maarifa na changamoto za kukuelekeza kujifunza mada kama: -- Kuendesha na uhandisi wa maelezo +Kila somo linajumuisha kazi ya kukamilisha, kipimo cha uelewa na changamoto ya kukuongoza katika mada kama: +- Kutoa maagizo na uhandisi wa maagizo - Uundaji wa programu za maandishi na picha - Programu za utafutaji -Tembelea [https://aka.ms/genai-js-course](../../[https:/aka.ms/genai-js-course) kuanza! +Tembelea [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) kuanza! ## 🌱 Kuanzia -> **Walimu**, tumetoa [mapendekezo](for-teachers.md) ya jinsi ya kutumia mtaala huu. Tunathamini maoni yako [katika jukwaa letu la mijadala](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)! +> **Walimu**, tumetoa [mapendekezo kadhaa](for-teachers.md) juu ya jinsi ya kutumia mtaala huu. Tunapenda maoni yako [katika jukwaa letu la mijadala](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)! -**[Wanafunzi](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**, kwa kila somo, anza na jaribio kabla ya mihadhara na fuata kwa kusoma vifaa vya mihadhara, kukamilisha shughuli mbalimbali, na hakiki uelewa wako na jaribio baada ya mihadhara. +**[Wajifunza](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**, kwa kila somo, anza kwa mtihani wa kabla ya somo na fuata kwa kusoma nyenzo za somo, kukamilisha shughuli mbalimbali na thibitisha uelewa wako kwa mtihani wa baada ya somo. -Ili kuboresha uzoefu wako wa kujifunza, unganisha na wenzako kufanya miradi pamoja! Mijadala inahimizwa katika [jukwaa letu la mijadala](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) ambapo timu yetu ya wakasimia itakuwa tayari kujibu maswali yako. +Ili kuboresha uzoefu wako wa kujifunza, ungana na wenzako kufanya miradi pamoja! Mijadala inahimizwa katika [jukwaa letu la mijadala](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) ambapo timu yetu ya wasimamizi itakuwa tayari kujibu maswali yako. -Ili kuongeza elimu yako, tunapendekeza sana kuvinjari [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) kwa vifaa vya ziada vya kusoma. +Ili kuendeleza elimu yako, tunapendekeza sana kuchunguza [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) kwa nyenzo za ziada za kujifunzia. ### 📋 Kuweka mazingira yako -Mtaala huu una mazingira ya maendeleo tayari! Unapoanza unaweza kuchagua kuendesha mtaala katika [Codespace](https://github.com/features/codespaces/) (_mazingira yanayotegemea kivinjari, hayahitaji usakinishaji_), au kwa ndani kwenye kompyuta yako ukitumia mhariri wa maandishi kama [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). +Mtaala huu una mazingira ya maendeleo tayari kwa matumizi! Unapoanza unaweza kuchagua kuendesha mtaala huu katika [Codespace](https://github.com/features/codespaces/) (_mazingira ya kivinjari, pasipo hitaji kufunga programu_), au kwa kompyuta yako mwenyewe ukitumia mhariri wa maandishi kama [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). -#### Unda hifadhi yako -Ili uhifadhi kazi yako kwa urahisi, inashauriwa kuunda nakala yako mwenyewe ya hifadhi hii. Unaweza kufanya hivi kwa kubonyeza kitufe cha **Use this template** katikati ya ukurasa. Hii itaunda hifadhi mpya katika akaunti yako ya GitHub yenye nakala ya mtaala. +#### Tengeneza hifadhi yako +Ili kuhifadhi kazi yako kwa urahisi, inashauriwa kutengeneza nakala yako ya hifadhi hii. Unaweza kufanya hivyo kwa kubonyeza kitufe cha **Tumia kiolezo hiki** juu ya ukurasa. Hii itaunda hifadhi mpya katika akaunti yako ya GitHub yenye nakala ya mtaala huu. Fuata hatua hizi: -1. **Fungua Nakala**: Bonyeza kitufe cha "Fork" juu-kulia wa ukurasa huu. +1. **Chimba Hifadhi**: Bonyeza kitufe cha "Fork" juu-kulia wa ukurasa huu. 2. **Nakili Hifadhi**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` -#### Kuendesha mtaala katika Codespace +#### Kuendesha mtaala huu katika Codespace -Katika nakala yako ya hifadhi uliyounda, bonyeza kitufe cha **Code** na chagua **Open with Codespaces**. Hii itaunda Codespace mpya kwa ajili yako kufanya kazi ndani yake. +Katika nakala yako ya hifadhi uliyotengeneza, bonyeza kitufe cha **Code** na chagua **Fungua na Codespaces**. Hii itaunda Codespace mpya kwako kufanya kazi. ![Codespace](../../translated_images/sw/createcodespace.0238bbf4d7a8d955.webp) -#### Kuendesha mtaala ndani ya kompyuta yako +#### Kuendesha mtaala huu kafaida ya kompyuta yako mwenyewe -Ili kuendesha mtaala huu ndani ya kompyuta yako, utahitaji mhariri wa maandishi, kivinjari na zana ya mstari wa amri. Somo letu la kwanza, [Utangulizi wa Lugha za Programu na Vifaa vya Biashara](../../1-getting-started-lessons/1-intro-to-programming-languages), litakupeleka kupitia chaguo mbalimbali za kila moja ya zana hizi ili uchague kinachokufaa zaidi. +Ili kuendesha mtaala huu kwenye kompyuta yako, utahitaji mhariri wa maandishi, kivinjari na zana ya amri. Somo letu la kwanza, [Utangulizi wa Lugha za Programu na Zana za Biashara](../../1-getting-started-lessons/1-intro-to-programming-languages), litakuongoza kupitia chaguzi mbalimbali za kila chombo ili uchague kinachokufaa zaidi. -Tunapendekeza kutumia [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) kama mhariri wako, ambaye pia ana [Terminali](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) iliyojumuishwa. Unaweza kupakua Visual Studio Code [hapa](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). +Tunapendekeza kutumia [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) kama mhariri wako, ambao pia una [Terminali](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) iliyojengwa ndani. Unaweza kupakua Visual Studio Code [hapa](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). -1. Nakili hifadhi yako kwenye kompyuta yako. Unaweza kufanya hivi kwa kubonyeza kitufe cha **Code** na kunakili URL: +1. Nakili hifadhi yako kwenye kompyuta yako. Unaweza kufanya hivyo kwa kubonyeza kitufe cha **Code** na kunakili URL: [CodeSpace](./images/createcodespace.png) -Kisha, fungua [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) ndani ya [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) na endesha amri ifuatayo, ukibadilisha `` na URL uliyokopa hivi punde: +Kisha, fungua [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) ndani ya [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) na endesha amri ifuatayo, ukibadilisha `` na URL uliyokuwa nayo: ```bash git clone ``` -2. Fungua folda katika Visual Studio Code. Unaweza kufanya hivi kwa kubofya **File** > **Open Folder** na kuchagua folda uliyokopa. - +2. Fungua folda ndani ya Visual Studio Code. Unaweza kufanya hivi kwa kubonyeza **File** > **Open Folder** na kuchagua folda uliyokuwa umeikopa. -> Upanuzi wa Visual Studio Code unaopendekezwa: +> Mapendekezo ya nyongeza za Visual Studio Code: > -> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - kutazama mapaji ya HTML ndani ya Visual Studio Code -> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - kusaidia kuandika msimbo haraka zaidi +> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - kuangalia ukurasa wa HTML ndani ya Visual Studio Code +> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - kusaidia kuandika msimbo kwa haraka ## 📂 Kila somo linajumuisha: -- sketchnote hiari -- video ya ziada hiari -- jaribio la maandalizi kabla ya somo +- sketchnote ya hiari +- video ya ziada ya hiari +- mtihani wa kuandaa kabla ya somo - somo lililoandikwa -- kwa masomo yanayotegemea mradi, miongozo ya hatua kwa hatua juu ya jinsi ya kujenga mradi +- kwa masomo ya mradi, mwongozo wa hatua kwa hatua wa jinsi ya kujenga mradi - ukaguzi wa maarifa - changamoto -- kusoma kwa ziada -- kazi -- [jaribio baada ya somo](https://ff-quizzes.netlify.app/web/) +- usomaji wa ziada +- kazi ya nyumbani +- [mtihani wa baada ya somo](https://ff-quizzes.netlify.app/web/) -> **Kumbuka kuhusu jaribio**: Jaribio zote zipo kwenye folda ya Quiz-app, jaribio 48 kwa jumla za maswali matatu kila moja. Zinapatikana [hapa](https://ff-quizzes.netlify.app/web/) app ya jaribio inaweza kuendeshwa kwa ndani au kuchapishwa kwenye Azure; fuata maelekezo kwenye folda ya `quiz-app`. +> **Kumbuka kuhusu mitihani**: Mitihani yote iko katika folda ya Quiz-app, mitihani 48 jumla ya maswali matatu kila moja. Inapatikana [hapa](https://ff-quizzes.netlify.app/web/), programu ya mtihani inaweza kuendeshwa kwa ndani au kusambazwa kwenye Azure; fuata maagizo katika folda ya `quiz-app`. ## 🗃️ Masomo -| | Jina la Mradi | Dhana Zinazofundishwa | Malengo ya Kujifunza | Somo Linalohusiana | Mwandishi | +| | Jina la Mradi | Dhana Zinazofundishwa | Malengo ya Kujifunza | Somo Linalohusiana | Mwandishi | | :-: | :------------------------------------------------------: | :--------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :---------------------: | -| 01 | Kuanza | Utangulizi wa Uprogramu na Vifaa vya Kazi | Jifunze misingi ya lugha nyingi za programu na kuhusu programu zinazosaidia watengenezaji kufanya kazi zao | [Utangulizi wa Lugha za Programu na Vifaa vya Kazi](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | -| 02 | Kuanza | Misingi ya GitHub, pamoja na kazi na timu | Jinsi ya kutumia GitHub kwenye mradi wako, jinsi ya kushirikiana na wengine kwenye msimbo | [Utangulizi wa GitHub](./1-getting-started-lessons/2-github-basics/README.md) | Floor | -| 03 | Kuanza | Upatikanaji | Jifunze misingi ya upatikanaji wa mtandao | [Misingi ya Upatikanaji](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | +| 01 | Kuanzisha | Utangulizi wa Uprogramu na Zana za Kazi | Jifunze misingi ya lugha nyingi za programu na kuhusu programu zinazosaidia waendelezaji wa kitaalamu kufanya kazi zao | [Utangulizi wa Lugha za Programu na Zana za Kazi](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | +| 02 | Kuanzisha | Misingi ya GitHub, ikiwa ni pamoja na kufanya kazi na timu | Jinsi ya kutumia GitHub katika mradi wako, jinsi ya kushirikiana na wengine kwenye msimbo wa chanzo | [Utangulizi wa GitHub](./1-getting-started-lessons/2-github-basics/README.md) | Floor | +| 03 | Kuanzisha | Ufikivu | Jifunze misingi ya ufikivu wa wavuti | [Misingi ya Ufikivu](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | | 04 | Misingi ya JS | Aina za Data za JavaScript | Misingi ya aina za data za JavaScript | [Aina za Data](./2-js-basics/1-data-types/README.md) | Jasmine | | 05 | Misingi ya JS | Kazi na Mbinu | Jifunze kuhusu kazi na mbinu za kusimamia mtiririko wa mantiki ya programu | [Kazi na Mbinu](./2-js-basics/2-functions-methods/README.md) | Jasmine na Christopher | -| 06 | Misingi ya JS | Kufanya Maamuzi na JS | Jifunze jinsi ya kuunda masharti kwenye msimbo wako kwa kutumia mbinu za kufanya maamuzi | [Kufanya Maamuzi](./2-js-basics/3-making-decisions/README.md) | Jasmine | -| 07 | Misingi ya JS | Mfululizo na Mizunguko | Fanya kazi na data kwa kutumia mfululizo na mizunguko katika JavaScript | [Mfululizo na Mizunguko](./2-js-basics/4-arrays-loops/README.md) | Jasmine | -| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTML Katika Vitendo | Jenga HTML kuunda terrarium mtandaoni, ukizingatia ujenzi wa mpangilio | [Utangulizi wa HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | -| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSS Katika Vitendo | Jenga CSS kupamba terrarium mtandaoni, ukizingatia misingi ya CSS ikiwa ni pamoja na kuruhusu ukurasa kujibadilisha | [Utangulizi wa CSS](./3-terrarium/2-intro-to-css/README.md) | Jen | -| 10 | [Terrarium](./3-terrarium/solution/README.md) | Kufunga JavaScript, udhibiti wa DOM | Jenga JavaScript ili kufanya terrarium ifanye kazi kama kiolesura cha buruta/achia, ukizingatia kufunga na udhibiti wa DOM | [Kufunga JavaScript, udhibiti wa DOM](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen | -| 11 | [Typing Game](./4-typing-game/solution/README.md) | Jenga Mchezo wa Kuandika | Jifunze jinsi ya kutumia matukio ya kibodi kuendesha mantiki ya app yako ya JavaScript | [Uprogramu unaotumia Matukio](./4-typing-game/typing-game/README.md) | Christopher | -| 12 | [Mnyongeza wa Kivinjari wa Kijani](./5-browser-extension/solution/README.md) | Kufanya kazi na Vivinjari | Jifunze jinsi vivinjari vinavyofanya kazi, historia yao, na jinsi ya kuunda vipengele vya kwanza vya kiongezi cha kivinjari | [Kuhusu Vivinjari](./5-browser-extension/1-about-browsers/README.md) | Jen | -| 13 | [Mnyongeza wa Kivinjari wa Kijani](./5-browser-extension/solution/README.md) | Kujenga fomu, kupiga API na kuhifadhi mabadiliko katika hifadhi ya ndani | Jenga vipengele vya JavaScript vya kiongezi chako cha kivinjari kupiga API kwa kutumia mabadiliko yaliyohifadhiwa kwenye hifadhi ya ndani | [APIs, Fomu, na Hifadhi ya Ndani](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen | -| 14 | [Mnyongeza wa Kivinjari wa Kijani](./5-browser-extension/solution/README.md) | Michakato ya nyuma katika kivinjari, utendaji wa wavuti | Tumia michakato ya nyuma ya kivinjari kusimamia ikoni ya kiongezi; jifunze kuhusu utendaji wa wavuti na baadhi ya uboreshaji wa kufanya kazi vizuri | [Mishahara ya Nyuma na Utendaji](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen | -| 15 | [Mchezo wa Anga](./6-space-game/solution/README.md) | Maendeleo ya Mchezo wa Juu kwa JavaScript | Jifunze kuhusu Urithi kwa kutumia Madarasa na Muundo pamoja na muundo wa Pub/Sub, kujiandaa kujenga mchezo | [Utangulizi wa Maendeleo ya Mchezo wa Juu](./6-space-game/1-introduction/README.md) | Chris | -| 16 | [Mchezo wa Anga](./6-space-game/solution/README.md) | Kuchora kwenye bati | Jifunze kuhusu API ya Canvas, inayotumika kuchora vipengele kwenye skrini | [Kuchora kwenye Canvas](./6-space-game/2-drawing-to-canvas/README.md) | Chris | -| 17 | [Mchezo wa Anga](./6-space-game/solution/README.md) | Kusogeza vipengele kuzunguka skrini | Gundua jinsi vipengele vinaweza kupata mwendo kwa kutumia kuratibu za Cartesian na API ya Canvas | [Kusogeza Vipengele Kuizunguka](./6-space-game/3-moving-elements-around/README.md) | Chris | -| 18 | [Mchezo wa Anga](./6-space-game/solution/README.md) | Kugundua Mgongano | Fanya vipengele kugongana na kuathiriana kwa kutumia vitufe vya kibodi na toa kazi ya kupumzika kuhakikisha utendaji wa mchezo | [Ugunduzi wa Mgongano](./6-space-game/4-collision-detection/README.md) | Chris | -| 19 | [Mchezo wa Anga](./6-space-game/solution/README.md) | Kuhesabu alama | Fanya hesabu za kihisabati kulingana na hali na utendaji wa mchezo | [Kuhesabu Alama](./6-space-game/5-keeping-score/README.md) | Chris | -| 20 | [Mchezo wa Anga](./6-space-game/solution/README.md) | Kumaliza na kuanzisha tena mchezo | Jifunze kuhusu kumaliza na kuanzisha tena mchezo, ikiwa ni pamoja na kusafisha rasilimali na kuweka upya thamani za mabadiliko | [Hali ya Kumalizia](./6-space-game/6-end-condition/README.md) | Chris | -| 21 | [App ya Benki](./7-bank-project/solution/README.md) | Violezo vya HTML na Njia katika Tovuti ya Wavuti | Jifunze jinsi ya kuunda mfumo wa muundo wa tovuti yenye kurasa nyingi kwa kutumia njia na violezo vya HTML | [Violezo vya HTML na Njia](./7-bank-project/1-template-route/README.md) | Yohan | -| 22 | [App ya Benki](./7-bank-project/solution/README.md) | Jenga Fomu ya Kuingia na Kujisajili | Jifunze kuhusu ujenzi wa fomu na kushughulikia utambuzi wa validi | [Fomu](./7-bank-project/2-forms/README.md) | Yohan | -| 23 | [App ya Benki](./7-bank-project/solution/README.md) | Mbinu za Kupata na Kutumia Data | Jinsi data inavyotiririka ndani na nje ya app yako, jinsi ya kuipata, kuihifadhi, na kuiondoa | [Data](./7-bank-project/3-data/README.md) | Yohan | -| 24 | [App ya Benki](./7-bank-project/solution/README.md) | Dhana za Usimamizi wa Hali | Jifunze jinsi app yako inavyohifadhi hali na jinsi ya kuisimamia kwa njia za programu | [Usimamizi wa Hali](./7-bank-project/4-state-management/README.md) | Yohan | -| 25 | [Msimbo wa Vivinjari/VScode](../../8-code-editor) | Kufanya kazi na VScode | Jifunze jinsi ya kutumia mhariri wa msimbo| [Tumia Mhariri wa Msimbo wa VScode](./8-code-editor/1-using-a-code-editor/README.md) | Chris | -| 26 | [Msaidizi wa AI](./9-chat-project/README.md) | Kufanya kazi na AI | Jifunze jinsi ya kujenga msaidizi binafsi wa AI | [Mradi wa Msaidizi wa AI](./9-chat-project/README.md) | Chris | - -## 🏫 Mbinu ya Kufundishia +| 06 | Misingi ya JS | Kufanya Maamuzi kwa JS | Jifunze jinsi ya kuunda masharti katika msimbo wako ukitumia mbinu za kufanya maamuzi | [Kufanya Maamuzi](./2-js-basics/3-making-decisions/README.md) | Jasmine | +| 07 | Misingi ya JS | Msururu na Mizunguko | Fanya kazi na data kupitia msururu na mizunguko katika JavaScript | [Msururu na Mizunguko](./2-js-basics/4-arrays-loops/README.md) | Jasmine | +| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTML Katika Vitendo | Jenga HTML kuunda terrarium ya mtandaoni, ukizingatia kujenga mpangilio | [Utangulizi wa HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | +| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSS Katika Vitendo | Jenga CSS kuibeba terrarium ya mtandaoni, ukizingatia misingi ya CSS ikiwa ni pamoja na kuifanya ukurasa uwe responsive | [Utangulizi wa CSS](./3-terrarium/2-intro-to-css/README.md) | Jen | +| 10 | [Terrarium](./3-terrarium/solution/README.md) | Funguo za JavaScript, uendeshaji wa DOM | Tengeneza JavaScript ili kufanya terrarium ifanye kazi kama kiolesura cha buruta/acha, ukizingatia funguo na uendeshaji wa DOM | [Funguo za JavaScript, uendeshaji wa DOM](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen | +| 11 | [Typing Game](./4-typing-game/solution/README.md) | Jenga Mchezo wa Kuandika | Jifunze jinsi ya kutumia matukio ya kibodi kuendesha mantiki ya programu yako ya JavaScript | [Uprogramu unaoendeshwa na Matukio](./4-typing-game/typing-game/README.md) | Christopher | +| 12 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Kufanya kazi na Vivinjari | Jifunze jinsi vinjari vinavyofanya kazi, historia yao, na jinsi ya kuanzisha vipengele vya kwanza vya kiendelezi cha kivinjari | [Kuhusu Vivinjari](./5-browser-extension/1-about-browsers/README.md) | Jen | +| 13 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Kujenga fomu, kuita API na kuhifadhi vigezo kwenye hifadhi ya ndani | Tengeneza vipengele vya JavaScript vya kiendelezi chako cha kivinjari kuitumia API kwa kutumia vigezo vilivyosubiriwa katika hifadhi ya ndani | [APIs, Fomu, na Hifadhi ya Ndani](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen | +| 14 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Mchakato wa nyuma katika kivinjari, utendaji wa wavuti | Tumia michakato ya kivinjari ya nyuma kusimamia ikoni ya kiendelezi; jifunze kuhusu utendaji wa wavuti na baadhi ya marekebisho ili kufanya | [Kazi za Nyuma na Utendaji](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen | +| 15 | [Space Game](./6-space-game/solution/README.md) | Maendeleo ya Juu zaidi ya Mchezo kwa JavaScript | Jifunze kuhusu Urithi ukitumia Madarasa na Muundo pamoja na mfano wa Pub/Sub, kama maandalizi ya kujenga mchezo | [Utangulizi wa Maendeleo ya Mchezo Cha Juu](./6-space-game/1-introduction/README.md) | Chris | +| 16 | [Space Game](./6-space-game/solution/README.md) | Kuchora kwenye turubai | Jifunze kuhusu API ya Canvas, inayotumika kuchora vipengele kwenye skrini | [Kuchora kwenye Canvas](./6-space-game/2-drawing-to-canvas/README.md) | Chris | +| 17 | [Space Game](./6-space-game/solution/README.md) | Kuweka vipengele kuzunguka kwenye skrini | Gundua jinsi vipengele vinaweza kupata mwendo kwa kutumia kuratibu za Cartesian na API ya Canvas | [Kusogeza Vipengele Kizunguka](./6-space-game/3-moving-elements-around/README.md) | Chris | +| 18 | [Space Game](./6-space-game/solution/README.md) | Kugundua mgongano | Fanya vipengele kuwa na mgongano na kutoa athari kwa kila mmoja kwa kutumia kufungia vitufe na toa kazi ya kupumzika ili kuhakikisha utendaji wa mchezo | [Ugunduzi wa Mgongano](./6-space-game/4-collision-detection/README.md) | Chris | +| 19 | [Space Game](./6-space-game/solution/README.md) | Kuhifadhi alama | Fanya hesabu za kijumla kulingana na hali na utendakazi wa mchezo | [Kuhifadhi Alama](./6-space-game/5-keeping-score/README.md) | Chris | +| 20 | [Space Game](./6-space-game/solution/README.md) | Kumaliza na kuanzisha upya mchezo | Jifunze kuhusu kumaliza na kuanzisha upya mchezo, ikiwa ni pamoja na kusafisha mali na kuweka upya thamani za vigezo | [Hali ya Kumaliza](./6-space-game/6-end-condition/README.md) | Chris | +| 21 | [Banking App](./7-bank-project/solution/README.md) | Violezo vya HTML na Njia katika App ya Wavuti | Jifunze jinsi ya kuunda muundo wa tovuti ya kurasa nyingi ukitumia uelekeaji na violezo vya HTML | [Violezo vya HTML na Njia](./7-bank-project/1-template-route/README.md) | Yohan | +| 22 | [Banking App](./7-bank-project/solution/README.md) | Jenga Fomu ya Kuingia na Kusajili | Jifunze kuhusu ujenzi wa fomu na kushughulikia utambuzi | [Fomu](./7-bank-project/2-forms/README.md) | Yohan | +| 23 | [Banking App](./7-bank-project/solution/README.md) | Mbinu za Kupata na Kutumia Data | Jinsi data inavyopita ndani na nje ya app yako, jinsi ya kuipata, kuhifadhi na kuiondoa | [Data](./7-bank-project/3-data/README.md) | Yohan | +| 24 | [Banking App](./7-bank-project/solution/README.md) | Dhana za Usimamizi wa Hali | Jifunze jinsi app yako inavyoshikilia hali na jinsi ya kuisimamia kitaalamu | [Usimamizi wa Hali](./7-bank-project/4-state-management/README.md) | Yohan | +| 25 | [Browser/VScode Code](../../8-code-editor) | Kufanya kazi na VScode | Jifunze jinsi ya kutumia mhariri wa msimbo | [Tumia mhariri wa msimbo wa VScode](./8-code-editor/1-using-a-code-editor/README.md) | Chris | +| 26 | [AI Assistants](./9-chat-project/README.md) | Kufanya kazi na AI | Jifunze jinsi ya kujenga msaidizi wako mwenye akili bandia | [Mradi wa Msaidizi wa AI](./9-chat-project/README.md) | Chris | + +## 🏫 Pedagogia Mtaala wetu umeundwa kwa misingi miwili muhimu ya kielimu: -* kujifunza kwa kutumia miradi +* kujifunza kwa mradi * mitihani ya mara kwa mara -Programu hii inafundisha misingi ya JavaScript, HTML, na CSS, pamoja na zana na mbinu za kisasa zinazotumika na waendelezaji wa wavuti wa leo. Wanafunzi watapata fursa ya kupata uzoefu wa vitendo kwa kujenga mchezo wa kuandika, terrarium pepe, kiongezi cha kivinjari kinachotunza mazingira, mchezo wa kuvamia anga, na app ya benki kwa biashara. Mwisho wa mfululizo huu, wanafunzi watakuwa na uelewa thabiti wa maendeleo ya wavuti. +Programu hii inafundisha misingi ya JavaScript, HTML, na CSS, pamoja na zana na mbinu za hivi karibuni zinazotumiwa na waendelezaji wa wavuti wa sasa. Wanafunzi watapata fursa ya kupata uzoefu wa vitendo kwa kujenga mchezo wa kuandika, terrarium ya kidijitali, kiendelezi cha kivinjari chenye uangalifu wa mazingira, mchezo wa kawaida wa wavamizi wa anga, na app ya benki kwa biashara. Mwisho wa mfululizo, wanafunzi watakuwa na ufahamu imara wa maendeleo ya wavuti. > 🎓 Unaweza kuchukua masomo machache ya kwanza katika mtaala huu kama [Njia ya Kujifunza](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon) kwenye Microsoft Learn! -Kwa kuhakikisha yaliyomo yanalingana na miradi, mchakato unakuwa wa kuvutia zaidi kwa wanafunzi na kukumbatia dhana kutakuwa kwa kina zaidi. Pia tumeandika masomo ya kuanzisha ya misingi ya JavaScript kuanzisha dhana, yakiwa na video kutoka katika mkusanyiko wa "[Mfululizo wa Waanzilishi kwa: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)", ambayo waandishi wake wengi walichangia kwenye mtaala huu. +Kwa kuhakikisha kuwa maudhui yanaendana na miradi, mchakato unakuwa wa kuvutia zaidi kwa wanafunzi na uhifadhi wa dhana utaimarishwa. Pia tuliandika masomo kadhaa ya kuanzisha misingi ya JavaScript ili kuanzisha dhana, yakiwa na video kutoka kwa mkusanyiko wa video wa "[Mfululizo wa Waanzilishi kwa: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)", baadhi ya waandishi wake walichangia mtaala huu. -Zaidi ya hayo, mtihani wa kawaida kabla ya darasa unaweka nia ya mwanafunzi kuelekea kujifunza mada fulani, huku mtihani wa pili baada ya darasa ukihakikisha kukumbatia zaidi. Mtaala huu umeundwa kuwa na ufanisi na furaha na unaweza kuchukuliwa kwa jumla au sehemu. Miradi huanza kwa ukubwa mdogo na kuwa ngumu zaidi kufikia mwisho wa mzunguko wa wiki 12. +Zaidi ya hayo, mtihani wa hali ya chini kabla ya darasa huweka nia ya mwanafunzi kuelekea kujifunza mada, wakati mtihani wa pili baada ya darasa huhakikisha uhifadhi zaidi. Mtaala huu uliundwa kuwa na ufanisi na furaha na unaweza kuchukuliwa kwa jumla au sehemu. Miradi inaanza ndogo na kuwa ngumu zaidi mwishoni mwa mzunguko wa wiki 12. -Ingawa tumekuwa makusudi kuepuka kuanzisha mifumo ya JavaScript ili kuzingatia ujuzi wa msingi unaohitajika kama mtaalamu wa wavuti kabla ya kutumia mfumo, hatua inayofuata bora kukamilisha mtaala huu ni kujifunza kuhusu Node.js kupitia mkusanyiko mwingine wa video: "[Mfululizo wa Waanzilishi kwa: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". +Ingawa tumejaribu kuepuka kuanzisha mifumo ya JavaScript badala yake tunalenga ujuzi wa msingi unaohitajika kama msanifu wa wavuti kabla ya kutumia mfumo, hatua inayofuata bora ya kumaliza mtaala huu itakuwa kujifunza kuhusu Node.js kupitia mkusanyiko mwingine wa video: "[Mfululizo wa Waanzilishi kwa: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". -> Tembelea miongozo yetu ya [Kanuni za Maadili](CODE_OF_CONDUCT.md) na [Kuchangia](CONTRIBUTING.md). Tunakaribisha maoni yako chanya! +> Tembelea [Kanuni zetu za Maadili](CODE_OF_CONDUCT.md) na miongozo ya [Michango](CONTRIBUTING.md). Tunakaribisha maoni yako yenye kujenga! -## 🧭 Ufikiaji wa Nje ya Mtandao +## 🧭 Ufikiaji wa Offline -Unaweza kuendesha nyaraka hizi nje ya mtandao kwa kutumia [Docsify](https://docsify.js.org/#/). Fanya fork ya repo hii, [weka Docsify](https://docsify.js.org/#/quickstart) kwenye mashine yako ya ndani, kisha katika folda kuu ya repo hii, andika `docsify serve`. Tovuti itapelekwa kwenye bandari 3000 kwenye localhost: `localhost:3000`. +Unaweza kuendesha nyaraka hizi bila mtandao kwa kutumia [Docsify](https://docsify.js.org/#/). Kopia hifadhi hii, [weka Docsify](https://docsify.js.org/#/quickstart) kwenye kompyuta yako ya karibu, kisha katika folda kuu ya hifadhi hii, andika `docsify serve`. Tovuti itakuwa ikihudumiwa kwenye bandari 3000 kwenye localhost yako: `localhost:3000`. ## 📘 PDF @@ -207,65 +206,65 @@ PDF ya masomo yote inaweza kupatikana [hapa](https://microsoft.github.io/Web-Dev ## 🎒 Kozi Nyingine -Timu yetu hutengeneza kozi nyingine! Angalia: +Timu yetu hutengeneza kozi zingine! Angalia: ### LangChain -[![LangChain4j kwa Waanzilishi](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js kwa Waanzilishi](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - +[![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +[![LangChain for Beginners](https://img.shields.io/badge/LangChain%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://github.com/microsoft/langchain-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / Edge / MCP / Maajenti -[![AZD kwa Waanzilishi](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI kwa Waanzilishi](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP kwa Waanzilishi](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Maajenti wa AI kwa Waanzilishi](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### Azure / Edge / MCP / Wakala +[![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Mfululizo wa AI Inayozalisha -[![AI Inayozalisha kwa Waanzilishi](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Inayozalisha (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![AI Inayozalisha (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![AI Inayozalisha (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### Mfululizo wa AI Inayotengeneza +[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- ### Kujifunza Msingi -[![ML kwa Waanzilishi](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Sayansi ya Data kwa Waanzilishi](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI kwa Waanzilishi](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Usalama wa Mtandao kwa Waanzilishi](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Uendelezaji wa Web kwa Waanzilishi](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT kwa Waanzilishi](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![Maendeleo ya XR kwa Waanzilishi](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Mfululizo wa Copilot -[![Copilot kwa Uandikishaji wa Pamoja wa AI](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot kwa C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Adventure ya Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Kupata Msaada -Kama utafungwa au una maswali yoyote kuhusu kujenga programu za AI. Jiunge na wapenzi wa kujifunza na waendelezaji wenye uzoefu katika mijadala kuhusu MCP. Ni jamii inayounga mkono ambapo maswali yanakaribishwa na maarifa hushirikiwa kwa uhuru. +Kama unashindwa au una maswali yoyote kuhusu kujenga programu za AI. Jiunge na wanafunzi wenzako na waendelezaji wenye uzoefu katika mijadala kuhusu MCP. Ni jamii inayounga mkono ambapo maswali yanakaribishwa na maarifa hushirikiwa kwa huru. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Kama una maoni kuhusu bidhaa au makosa wakati wa ujenzi tembelea: +Kama una maoni juu ya bidhaa au makosa wakati wa kujenga tembelea: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) ## Leseni -Hifadhi hii ina leseni chini ya leseni ya MIT. Angalia faili la [LICENSE](../../LICENSE) kwa maelezo zaidi. +Hifadhidata hii imelindwa chini ya leseni ya MIT. Angalia faili la [LICENSE](../../LICENSE) kwa maelezo zaidi. --- -**Hatia ya Majukumu**: -Nyaraka hii imefasiriwa kwa kutumia huduma ya utafsiri wa AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi kwa usahihi, tafadhali fahamu kuwa tafsiri za moja kwa moja zinaweza kuwa na makosa au kasoro. Nyaraka ya awali katika lugha yake ya asili inapaswa kuchukuliwa kama chanzo halali. Kwa taarifa muhimu, tafsiri ya kitaalamu inayofanywa na binadamu inapendekezwa. Hatuna dhamana kwa kutoelewana au tafsiri potofu zinazotokana na matumizi ya tafsiri hii. +**Kidokezo cha Kutokujali**: +Nyaraka hii imetafsiriwa kwa kutumia huduma ya utafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi kuwa sahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au kasoro. Nyaraka asilia katika lugha yake ya asili inapaswa kuzingatiwa kama chanzo cha mamlaka. Kwa taarifa muhimu, utafsiri wa kitaalamu wa binadamu unashauriwa. Hatutawajibika kwa kutoelewana au tafsiri za makosa zitokanazo na matumizi ya tafsiri hii. \ No newline at end of file diff --git a/translations/sw/Roadmap.md b/translations/sw/Roadmap.md new file mode 100644 index 000000000..6c5d6ab61 --- /dev/null +++ b/translations/sw/Roadmap.md @@ -0,0 +1,53 @@ +# Ramani ya Njia kwa ajili ya Hifadhi ya Microsoft Web-Dev-For-Beginners + +**Hifadhi hii inatoa ramani ya njia ya kujifunza misingi ya maendeleo ya wavuti kwa kuzingatia JavaScript, HTML, na CSS. Mtaala ni rahisi kubadilika na unaweza kuchukuliwa kwa jumla au sehemu, ukiwa na masomo 24 yaliyoenea kwa wiki 12.** + +## Mielekeo Muhimu + +* **Wiki 1-3:** + * Utangulizi wa lugha za programu na zana za kazi + * Misingi ya GitHub + * Ufikikaji + * Misingi ya JS: aina za data, kazi na mbinu + * Kufanya maamuzi kwa JS +* **Wiki 4-6:** + * Masswali na mizunguko + * Terrarium: HTML katika mazoezi + * CSS katika mazoezi + * Kufunga kwa JavaScript + * Ubadilishaji wa DOM +* **Wiki 7-9:** + * Mchezo wa Kubandika: Uendeshaji wa matukio + * Kiongezi cha Kivinjari cha Kijani: Kufanya kazi na vivinjari + * Kujenga fomu, kuita API na kuhifadhi vigezo katika hifadhi ya ndani + * Mchakato wa nyuma katika kivinjari + * Utendaji wa wavuti +* **Wiki 10-12:** + * Mchezo wa Anga: Maendeleo ya mchezo wa hali ya juu zaidi kwa JavaScript + * Kuchora kwenye canvas + * Kusogeza vipengele kwenye skrini + * Kugundua mgongano + * Kuhifadhi alama, kufunga na kuanza mchezo tena + * Programu ya Benki: Mifano ya HTML na Njia katika Programu ya Wavuti + * Kujenga Fomu ya Kuingia na Usajili + * Njia za Kupata na Kutumia Data + * Dhana za Usimamizi wa Hali + +## Matokeo ya Kujifunza + +**Kwa kumaliza ramani hii ya njia, wanafunzi watapata uzoefu wa vitendo katika kujenga mchezo wa kubandika, terrarium ya mtandaoni, kiongezi cha kivinjari rafiki kwa mazingira, mchezo wa mtindo wa mvivu wa anga, na programu ya benki kwa biashara. Pia wataendeleza uelewa thabiti wa misingi ya maendeleo ya wavuti.** + +## Rasilimali Zaidi + +* Hifadhi hii hutoa rasilimali nyingi za kujifunza zaidi, zikiwemo mafunzo, mifano ya msimbo, na changamoto. +* Jukwaa la Microsoft Learn linatoa kozi mbalimbali za maendeleo ya wavuti na njia za kujifunza. +* Jamii za mtandaoni kama Stack Overflow na MDN Web Docs hutoa msaada muhimu na rasilimali kwa watengenezaji wa wavuti. + +**Natumai ramani hii ya njia itakusaidia katika safari yako ya maendeleo ya wavuti!** + +--- + + +**Tangazo la Uwajibikaji**: +Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi kuhakikisha usahihi, tafadhali fahamu kwamba tafsiri zilizofanywa kwa njia ya kiotomatiki zinaweza kuwa na makosa au upungufu wa usahihi. Hati ya asili katika lugha yake ya asili inapaswa kuchukuliwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu na watu inashauriwa. Hatuelewi wajibu wowote kwa sababu ya kutoelewana au tafsiri za makosa zinazotokana na matumizi ya tafsiri hii. + \ No newline at end of file diff --git a/translations/tl/.co-op-translator.json b/translations/tl/.co-op-translator.json index 56a9387b1..2b12e297c 100644 --- a/translations/tl/.co-op-translator.json +++ b/translations/tl/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2025-10-03T11:35:32+00:00", + "translation_date": "2026-02-06T18:04:36+00:00", "source_file": "AGENTS.md", "language_code": "tl" }, @@ -516,11 +516,17 @@ "language_code": "tl" }, "README.md": { - "original_hash": "490c83786552d7fab6390991517bef09", - "translation_date": "2026-01-29T18:53:32+00:00", + "original_hash": "6d6385fd098088cb2d690fb0a6cdaedc", + "translation_date": "2026-02-06T17:57:47+00:00", "source_file": "README.md", "language_code": "tl" }, + "Roadmap.md": { + "original_hash": "28bf6185fd7f27b62ddc210514366192", + "translation_date": "2026-02-06T18:02:06+00:00", + "source_file": "Roadmap.md", + "language_code": "tl" + }, "SECURITY.md": { "original_hash": "4ecc3bf2e27983d4c780be6f26ee6228", "translation_date": "2025-08-27T21:59:06+00:00", diff --git a/translations/tl/AGENTS.md b/translations/tl/AGENTS.md index 1ed15aa56..8bb8b073c 100644 --- a/translations/tl/AGENTS.md +++ b/translations/tl/AGENTS.md @@ -1,282 +1,282 @@ # AGENTS.md -## Pangkalahatang-ideya ng Proyekto +## Project Overview -Ito ay isang repository ng kurikulum pang-edukasyon para sa pagtuturo ng mga pangunahing kaalaman sa web development sa mga baguhan. Ang kurikulum ay isang komprehensibong 12-linggong kurso na binuo ng Microsoft Cloud Advocates, na nagtatampok ng 24 na praktikal na aralin na sumasaklaw sa JavaScript, CSS, at HTML. +Ito ay isang repositoryo ng edukasyonal na kurikulum para sa pagtuturo ng mga pundasyon ng web development sa mga baguhan. Ang kurikulum ay isang komprehensibong 12-linggong kurso na binuo ng Microsoft Cloud Advocates, na nagtatampok ng 24 na praktikal na mga aralin na sumasaklaw sa JavaScript, CSS, at HTML. -### Pangunahing Bahagi +### Key Components -- **Nilalaman Pang-edukasyon**: 24 na organisadong aralin na nakabatay sa proyekto -- **Praktikal na Proyekto**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, at AI Chat Assistant -- **Mga Interaktibong Pagsusulit**: 48 na pagsusulit na may tig-3 tanong bawat isa (pre/post-lesson assessments) -- **Suporta sa Multi-language**: Awtomatikong pagsasalin sa mahigit 50 wika gamit ang GitHub Actions -- **Mga Teknolohiya**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para sa mga AI na proyekto) +- **Educational Content**: 24 na nakaayos na mga aralin na organisado sa mga module na nakabase sa proyekto +- **Practical Projects**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, at AI Chat Assistant +- **Interactive Quizzes**: 48 mga pagsusulit na may tig-3 tanong bawat isa (pagsusuri bago/pagkatapos ng aralin) +- **Multi-language Support**: Automated na pagsasalin para sa 50+ na mga wika gamit ang GitHub Actions +- **Technologies**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para sa mga AI na proyekto) -### Arkitektura +### Architecture -- Repository pang-edukasyon na may istrukturang nakabatay sa aralin -- Ang bawat folder ng aralin ay naglalaman ng README, mga halimbawa ng code, at mga solusyon -- Mga standalone na proyekto sa magkakahiwalay na direktoryo (quiz-app, iba't ibang proyekto ng aralin) +- Repositoryo ng edukasyonal na may istrukturang nakabase sa aralin +- Bawat folder ng aralin ay naglalaman ng README, mga halimbawa ng code, at mga solusyon +- Mga standalone na proyekto sa magkakahiwalay na direktoryo (quiz-app, iba't ibang mga proyekto ng aralin) - Sistema ng pagsasalin gamit ang GitHub Actions (co-op-translator) -- Dokumentasyon na ipinapakita sa pamamagitan ng Docsify at magagamit bilang PDF +- Dokumentasyon na sinuserve gamit ang Docsify at available bilang PDF -## Mga Command sa Setup +## Setup Commands -Ang repository na ito ay pangunahing para sa pagkonsumo ng nilalaman pang-edukasyon. Para sa pagtatrabaho sa mga partikular na proyekto: +Ang repositoryong ito ay pangunahing para sa pagkonsumo ng edukasyonal na nilalaman. Para magtrabaho sa mga partikular na proyekto: -### Pangunahing Setup ng Repository +### Main Repository Setup ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Setup ng Quiz App (Vue 3 + Vite) +### Quiz App Setup (Vue 3 + Vite) ```bash cd quiz-app npm install -npm run dev # Start development server -npm run build # Build for production -npm run lint # Run ESLint +npm run dev # Simulan ang development server +npm run build # I-build para sa produksyon +npm run lint # Patakbuhin ang ESLint ``` -### API ng Bank Project (Node.js + Express) +### Bank Project API (Node.js + Express) ```bash cd 7-bank-project/api npm install -npm start # Start API server -npm run lint # Run ESLint -npm run format # Format with Prettier +npm start # Simulan ang API server +npm run lint # Patakbuhin ang ESLint +npm run format # I-format gamit ang Prettier ``` -### Mga Proyekto ng Browser Extension +### Browser Extension Projects ```bash cd 5-browser-extension/solution npm install -# Follow browser-specific extension loading instructions +# Sundin ang mga partikular na tagubilin sa pag-load ng extension para sa browser ``` -### Mga Proyekto ng Space Game +### Space Game Projects ```bash cd 6-space-game/solution npm install -# Open index.html in browser or use Live Server +# Buksan ang index.html sa browser o gamitin ang Live Server ``` -### Proyekto ng Chat (Python Backend) +### Chat Project (Python Backend) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Set GITHUB_TOKEN environment variable +# Itakda ang GITHUB_TOKEN na variable ng kapaligiran python api.py ``` -## Workflow ng Pag-develop +## Development Workflow -### Para sa mga Contributor ng Nilalaman +### For Content Contributors -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 pagbabago sa code sa mga kaugnay na direktoryo ng proyekto -6. Mag-submit ng pull requests ayon sa mga gabay sa kontribusyon +4. Gawin ang 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 requests ayon sa mga panuntunan ng kontribusyon -### Para sa mga Nag-aaral +### For Learners -1. I-fork o i-clone ang repository -2. Mag-navigate sa mga direktoryo ng aralin nang sunod-sunod +1. I-fork o i-clone ang repositoryo +2. Pumunta sa mga direktoryo ng aralin nang sunud-sunod 3. Basahin ang mga README file para sa bawat aralin -4. Kumpletuhin ang mga pre-lesson quiz sa https://ff-quizzes.netlify.app/web/ -5. Trabahuin ang mga halimbawa ng code sa mga folder ng aralin -6. Kumpletuhin ang mga assignment at hamon -7. Sagutan ang mga post-lesson quiz +4. Kumpletuhin ang 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 assignments at challenges +7. Sagutan ang post-lesson quizzes ### Live Development - **Dokumentasyon**: Patakbuhin ang `docsify serve` sa root (port 3000) -- **Quiz App**: Patakbuhin ang `npm run dev` sa quiz-app directory +- **Quiz App**: Patakbuhin ang `npm run dev` sa direktoryo 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 mga kaugnay na direktoryo ng API +- **API Projects**: Patakbuhin ang `npm start` sa mga kaukulang API na direktoryo -## Mga Tagubilin sa Pagsusuri +## Testing Instructions -### Pagsusuri ng Quiz App +### Quiz App Testing ```bash cd quiz-app -npm run lint # Check for code style issues -npm run build # Verify build succeeds +npm run lint # Suriin ang mga isyu sa istilo ng code +npm run build # Tiyaking matagumpay ang build ``` -### Pagsusuri ng Bank API +### Bank API Testing ```bash cd 7-bank-project/api -npm run lint # Check for code style issues -node server.js # Verify server starts without errors +npm run lint # Suriin para sa mga isyu sa estilo ng code +node server.js # Tiyakin na nagsisimula ang server nang walang mga error ``` -### Pangkalahatang Diskarte sa Pagsusuri +### General Testing Approach -- Ito ay isang repository pang-edukasyon na walang komprehensibong automated tests -- Ang manual testing ay nakatuon sa: - - Ang mga halimbawa ng code ay tumatakbo nang walang error - - Ang mga link sa dokumentasyon ay gumagana nang tama - - Ang mga build ng proyekto ay matagumpay na nakukumpleto - - Ang mga halimbawa ay sumusunod sa pinakamahusay na kasanayan +- Ito ay isang edukasyonal na repositoryo na walang komprehensibong automated na mga pagsubok +- Ang manu-manong pagsusuri ay nakatuon sa: + - Ang mga halimbawa ng code ay tumatakbo nang walang mga error + - Gumagana nang tama ang mga link sa dokumentasyon + - Nakumpleto nang matagumpay ang build ng mga proyekto + - Sumusunod ang mga halimbawa sa mga pinakamahusay na kasanayan -### Mga Pre-submission Check +### Pre-submission Checks -- Patakbuhin ang `npm run lint` sa mga direktoryo na may package.json -- Siguraduhing valid ang mga markdown link +- Patakbuhin ang `npm run lint` sa mga direktoryong may package.json +- Suriin ang mga markdown link kung valid - Subukan ang mga halimbawa ng code sa browser o Node.js - Siguraduhing ang mga pagsasalin ay may tamang istruktura -## Mga Gabay sa Estilo ng Code +## Code Style Guidelines ### JavaScript -- Gumamit ng modernong ES6+ syntax -- Sundin ang standard na ESLint configurations na ibinigay sa mga proyekto -- Gumamit ng makabuluhang pangalan ng variable at function para sa edukasyonal na kalinawan +- Gumamit ng modernong ES6+ na sintaks +- Sundin ang mga karaniwang ESLint na configuration na ibinigay sa mga proyekto +- Gumamit ng makahulugang mga pangalan ng variable at function para sa kalinawan ng edukasyon - Magdagdag ng mga komento na nagpapaliwanag ng mga konsepto para sa mga nag-aaral -- I-format gamit ang Prettier kung naka-configure +- I-format gamit ang Prettier kung ito ay naka-configure ### HTML/CSS -- Semantic HTML5 elements -- Mga prinsipyo ng responsive design -- Malinaw na naming conventions para sa klase +- Mga semantikong HTML5 na elemento +- Mga prinsipyo ng responsive na disenyo +- Malinaw na mga konbensiyon sa pag-ninilay ng klase - Mga komento na nagpapaliwanag ng mga teknik sa CSS para sa mga nag-aaral ### Python -- PEP 8 style guidelines +- Mga patnubay sa istilo ng PEP 8 - Malinaw, edukasyonal na mga halimbawa ng code -- Mga type hint kung kapaki-pakinabang para sa pag-aaral +- Mga type hint kung nakakatulong sa pagkatuto -### Dokumentasyon ng Markdown +### Markdown Documentation -- Malinaw na hierarchy ng heading -- Mga code block na may language specification -- Mga link sa karagdagang resources -- Mga screenshot at imahe sa `images/` directories +- Malinaw na hierarkiya ng mga heading +- Mga code block na may pagtukoy ng wika +- Mga link sa karagdagang mga mapagkukunan +- Mga screenshot at mga imahe sa mga direktoryong `images/` - Alt text para sa mga imahe para sa accessibility -### Organisasyon ng File +### File Organization -- Ang mga aralin ay naka-number nang sunod-sunod (1-getting-started-lessons, 2-js-basics, atbp.) -- Ang bawat proyekto ay may `solution/` at madalas na `start/` o `your-work/` directories -- Ang mga imahe ay naka-imbak sa lesson-specific na `images/` folders -- Ang mga pagsasalin ay nasa `translations/{language-code}/` na istruktura +- Mga aralin na inanumero nang sunud-sunod (1-getting-started-lessons, 2-js-basics, atbp.) +- Bawat proyekto ay may `solution/` at kadalasang `start/` o `your-work/` na mga direktoryo +- Mga imahe na iniimbak sa mga lesson-specific na `images/` folder +- Mga pagsasalin sa istrukturang `translations/{language-code}/` -## Build at Deployment +## Build and Deployment -### Deployment ng Quiz App (Azure Static Web Apps) +### Quiz App Deployment (Azure Static Web Apps) -Ang quiz-app ay naka-configure para sa Azure Static Web Apps deployment: +Ang quiz-app ay naka-configure para sa Azure Static Web Apps na deployment: ```bash cd quiz-app -npm run build # Creates dist/ folder -# Deploys via GitHub Actions workflow on push to main +npm run build # Lumilikha ng dist/ na folder +# Nagde-deploy gamit ang GitHub Actions workflow sa push sa main ``` -Konfigurasyon ng Azure Static Web Apps: -- **Lokasyon ng App**: `/quiz-app` -- **Lokasyon ng Output**: `dist` +Azure Static Web Apps configuration: +- **App location**: `/quiz-app` +- **Output location**: `dist` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### Pagbuo ng PDF ng Dokumentasyon +### Documentation PDF Generation ```bash -npm install # Install docsify-to-pdf -npm run convert # Generate PDF from docs +npm install # I-install ang docsify-to-pdf +npm run convert # Gumawa ng PDF mula sa mga docs ``` -### Dokumentasyon ng Docsify +### Docsify Documentation ```bash -npm install -g docsify-cli # Install Docsify globally -docsify serve # Serve on localhost:3000 +npm install -g docsify-cli # I-install ang Docsify nang pangkalahatan +docsify serve # I-serve sa localhost:3000 ``` -### Mga Build na Partikular sa Proyekto +### Project-specific Builds -Ang bawat direktoryo ng proyekto ay maaaring may sariling proseso ng build: -- Mga proyekto ng Vue: `npm run build` ay lumilikha ng production bundles -- Mga static na proyekto: Walang build step, direktang i-serve ang mga file +Bawat direktoryo ng proyekto ay maaaring may sarili nitong build process: +- Mga Vue na proyekto: `npm run build` ay lumilikha ng production bundles +- Mga static na proyekto: Walang build step, direktang i-serve ang mga files -## Mga Gabay sa Pull Request +## Pull Request Guidelines -### Format ng Pamagat +### Title Format -Gumamit ng malinaw, deskriptibong pamagat na nagpapahiwatig ng lugar ng pagbabago: -- `[Quiz-app] Magdagdag ng bagong quiz para sa lesson X` +Gumamit ng malinaw, deskriptibong mga pamagat na naglalarawan sa bahagi ng pagbabago: +- `[Quiz-app] Magdagdag ng bagong quiz para sa aralin X` - `[Lesson-3] Ayusin ang typo sa terrarium project` -- `[Translation] Magdagdag ng pagsasalin sa Espanyol para sa lesson 5` +- `[Translation] Magdagdag ng pagsasalin sa Spanish para sa aralin 5` - `[Docs] I-update ang mga tagubilin sa setup` -### Mga Kinakailangang Pagsusuri +### Required Checks -Bago mag-submit ng PR: +Bago magsumite ng PR: 1. **Kalidad ng Code**: - - Patakbuhin ang `npm run lint` sa mga apektadong direktoryo ng proyekto - - Ayusin ang lahat ng linting errors at warnings + - Patakbuhin ang `npm run lint` sa mga naapektuhang direktoryo ng proyekto + - Ayusin lahat ng linting errors at warnings 2. **Pag-verify ng Build**: - Patakbuhin ang `npm run build` kung naaangkop - - Siguraduhing walang build errors + - Siguraduhin walang error sa build -3. **Pag-validate ng Link**: - - Subukan ang lahat ng markdown links - - Siguraduhing gumagana ang mga reference ng imahe +3. **Pagpapatunay ng Link**: + - Subukan lahat ng markdown links + - Siguraduhin gumagana ang mga image references -4. **Review ng Nilalaman**: - - I-proofread para sa spelling at grammar - - Siguraduhing tama at edukasyonal ang mga halimbawa ng code - - Siguraduhing ang mga pagsasalin ay nagpapanatili ng orihinal na kahulugan +4. **Pagsusuri ng Nilalaman**: + - Basahin para sa spelling at grammar + - Siguraduhin tama ang mga halimbawa ng code at edukasyonal + - I-verify na ang mga pagsasalin ay nagpapanatili ng orihinal na kahulugan -### Mga Kinakailangan sa Kontribusyon +### Contribution Requirements -- Sumang-ayon sa Microsoft CLA (automated check sa unang PR) +- Sumang-ayon sa Microsoft CLA (automated na tseke sa unang PR) - Sundin ang [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- Tingnan ang [CONTRIBUTING.md](./CONTRIBUTING.md) para sa detalyadong gabay +- Tingnan ang [CONTRIBUTING.md](./CONTRIBUTING.md) para sa detalyadong mga gabay - I-reference ang mga numero ng isyu sa PR description kung naaangkop -### Proseso ng Review +### Review Process -- Ang mga PR ay nire-review ng mga maintainer at komunidad -- Ang edukasyonal na kalinawan ang prayoridad -- Ang mga halimbawa ng code ay dapat sumunod sa kasalukuyang pinakamahusay na kasanayan -- Ang mga pagsasalin ay nire-review para sa katumpakan at pagiging angkop sa kultura +- Ang mga PR ay nirerebyu ng mga maintainer at komunidad +- Pinapangunahan ang kalinawan sa edukasyon +- Dapat sundin ng mga halimbawa ng code ang kasalukuyang mga pinakamahusay na kasanayan +- Ang mga pagsasalin ay sinusuri para sa katumpakan at angkop na kultura -## Sistema ng Pagsasalin +## Translation System -### Awtomatikong Pagsasalin +### Automated Translation -- Gumagamit ng GitHub Actions na may co-op-translator workflow -- Awtomatikong isinasalin sa mahigit 50 wika -- Ang mga source file ay nasa pangunahing direktoryo -- Ang mga isinaling file ay nasa `translations/{language-code}/` na direktoryo +- Gumagamit ng GitHub Actions kasama ang co-op-translator workflow +- Nagsasalin sa 50+ na mga wika nang awtomatiko +- Mga source file sa mga pangunahing direktoryo +- Mga naisaling file sa `translations/{language-code}/` na mga direktoryo -### Pagdaragdag ng Manu-manong Pagpapabuti sa Pagsasalin +### Adding Manual Translation Improvements 1. Hanapin ang file sa `translations/{language-code}/` -2. Gumawa ng mga pagpapabuti habang pinapanatili ang istruktura -3. Siguraduhing gumagana ang mga halimbawa ng code -4. Subukan ang anumang localized na nilalaman ng quiz +2. Gawin ang mga pagpapabuti habang pinapanatili ang istruktura +3. Siguraduhing gumagana pa rin ang mga halimbawa ng code +4. Subukan ang anumang lokal na content ng quiz -### Metadata ng Pagsasalin +### Translation Metadata -Ang mga isinaling file ay may kasamang metadata header: +Ang mga naisaling file ay may metadata header: ```markdown ``` -## Pag-debug at Pag-troubleshoot +## Debugging and Troubleshooting -### Karaniwang Isyu +### Common Issues -**Hindi gumagana ang quiz app**: -- Suriin ang bersyon ng Node.js (inirerekomenda: v14+) -- Tanggalin ang `node_modules` at `package-lock.json`, patakbuhin muli ang `npm install` -- Suriin ang mga port conflicts (default: Vite ay gumagamit ng port 5173) +**Hindi nagsisimula ang quiz app**: +- Suriin ang Node.js version (inirerekomenda v14+) +- I-delete ang `node_modules` at `package-lock.json`, patakbuhin muli ang `npm install` +- Suriin kung may conflict sa port (default: Vite gumagamit ng port 5173) -**Hindi gumagana ang API server**: -- Siguraduhing ang bersyon ng Node.js ay nakakatugon sa minimum (node >=10) -- Suriin kung ang port ay ginagamit na -- Siguraduhing lahat ng dependencies ay naka-install gamit ang `npm install` +**Hindi nagsisimula ang API server**: +- Siguraduhing ang Node.js version ay hindi bababa sa (node >=10) +- Suriin kung ginagamit na ang port +- Tiyaking naka-install lahat ng dependencies gamit ang `npm install` **Hindi naglo-load ang browser extension**: -- Siguraduhing ang manifest.json ay maayos na naka-format -- Suriin ang browser console para sa mga error -- Sundin ang mga partikular na tagubilin sa pag-install ng extension ng browser +- Suriin kung maayos ang format ng manifest.json +- Tingnan ang console ng browser para sa mga error +- Sundin ang mga tagubilin sa pag-install ng extension para sa partikular na browser **Mga isyu sa Python chat project**: - Siguraduhing naka-install ang OpenAI package: `pip install openai` -- Siguraduhing naka-set ang GITHUB_TOKEN environment variable -- Suriin ang access permissions ng GitHub Models +- Siguraduhing nakaset ang GITHUB_TOKEN environment variable +- Suriin ang mga pahintulot sa pag-access ng GitHub Models -**Hindi gumagana ang Docsify**: +**Hindi nagseserbisyo ang Docsify ng dokumento**: - I-install ang docsify-cli globally: `npm install -g docsify-cli` -- Patakbuhin mula sa root directory ng repository -- Suriin kung ang `docs/_sidebar.md` ay umiiral +- Patakbuhin mula sa root directory ng repositoryo +- Suriin kung umiiral ang `docs/_sidebar.md` -### Mga Tip sa Development Environment +### Development Environment Tips -- Gumamit ng VS Code na may Live Server extension para sa mga HTML na proyekto -- I-install ang ESLint at Prettier extensions para sa consistent na formatting -- Gumamit ng browser DevTools para sa pag-debug ng JavaScript -- Para sa mga proyekto ng Vue, i-install ang Vue DevTools browser extension +- Gamitin ang VS Code kasama ang Live Server extension para sa mga HTML na proyekto +- I-install ang ESLint at Prettier extensions para sa pare-parehong pag-format +- Gamitin ang browser DevTools para sa debugging ng JavaScript +- Para sa mga Vue na proyekto, i-install ang Vue DevTools na extension ng browser -### Mga Pagsasaalang-alang sa Performance +### Performance Considerations -- Ang malaking bilang ng mga isinaling file (50+ wika) ay nangangahulugang malaki ang full clones -- Gumamit ng shallow clone kung nagtatrabaho lamang sa nilalaman: `git clone --depth 1` -- I-exclude ang mga pagsasalin mula sa mga paghahanap kapag nagtatrabaho sa nilalaman sa Ingles -- Ang mga proseso ng build ay maaaring mabagal sa unang run (npm install, Vite build) +- Malaking bilang ng mga naisaling file (50+ na mga wika) ay nangangahulugan na malalaki ang mga full clone +- Gamitin ang shallow clone kung content lang ang pinagtatrabahuhan: `git clone --depth 1` +- I-exclude ang mga pagsasalin mula sa mga paghahanap kapag nagtatrabaho sa English content +- Maaaring mabagal ang build process sa unang patakbo (npm install, Vite build) -## Mga Pagsasaalang-alang sa Seguridad +## Security Considerations -### Mga Environment Variable +### Environment Variables -- Ang mga API key ay hindi dapat i-commit sa repository -- Gumamit ng `.env` files (nasa `.gitignore` na) -- I-dokumento ang mga kinakailangang environment variable sa mga README ng proyekto +- Hindi dapat i-commit ang API keys sa repositoryo +- Gumamit ng `.env` files (na nakalista na sa `.gitignore`) +- Idokumento ang mga kinakailangang environment variable sa mga README ng proyekto -### Mga Proyekto ng Python +### Python Projects - Gumamit ng virtual environments: `python -m venv venv` - Panatilihing updated ang mga dependencies -- Ang mga GitHub token ay dapat may minimal na kinakailangang permissions +- Ang mga GitHub token ay dapat may minimal na kinakailangang mga permiso -### Access ng GitHub Models +### GitHub Models Access - Kinakailangan ang Personal Access Tokens (PAT) para sa GitHub Models -- Ang mga token ay dapat itago bilang environment variables +- Dapat itago ang mga token bilang environment variables - Huwag kailanman i-commit ang mga token o credentials -## Karagdagang Tala +## Additional Notes -### Target na Audience +### Target Audience -- Mga baguhan sa web development +- Ganap na mga baguhan sa web development - Mga estudyante at self-learners - Mga guro na gumagamit ng kurikulum sa mga klase -- Ang nilalaman ay idinisenyo para sa accessibility at gradual na pagbuo ng kasanayan +- Ang nilalaman ay idinisenyo para sa accessibility at unti-unting pagbuo ng kasanayan -### Pilosopiya ng Edukasyon +### Educational Philosophy -- Diskarte sa pag-aaral na nakabatay sa proyekto +- Project-based learning approach - Madalas na pagsusuri ng kaalaman (quizzes) -- Mga praktikal na coding exercises -- Mga halimbawa ng aplikasyon sa totoong mundo -- Pokus sa mga pangunahing kaalaman bago ang mga framework +- Hands-on na ehersisyo sa pagsusulat ng code +- Mga halimbawa ng aplikasyon sa tunay na mundo +- Pokus sa mga pundasyon bago dumako sa mga frameworks -### Pagpapanatili ng Repository +### Repository Maintenance -- Aktibong komunidad ng mga nag-aaral at contributor -- Regular na pag-update sa mga dependencies at nilalaman -- Ang mga isyu at talakayan ay sinusubaybayan ng mga maintainer -- Ang mga update sa pagsasalin ay awtomatiko sa pamamagitan ng GitHub Actions +- Aktibong komunidad ng mga nag-aaral at kontribyutor +- Regular na update sa mga dependencies at nilalaman +- Mga isyu at diskusyon ay minomonitor ng mga maintainer +- Awtomatikong update sa pagsasalin sa pamamagitan ng GitHub Actions -### Mga Kaugnay na Resources +### Related Resources - [Microsoft Learn modules](https://docs.microsoft.com/learn/) - [Student Hub resources](https://docs.microsoft.com/learn/student-hub/) -- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) inirerekomenda para sa mga nag-aaral -- Karagdagang kurso: Generative AI, Data Science, ML, IoT curricula available +- Inirerekomenda para sa mga nag-aaral ang [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) +- Karagdagang mga kurso: Generative AI, Data Science, ML, IoT curricula available -### Pagtatrabaho sa Partikular na Mga Proyekto +### Working with Specific Projects -Para sa detalyadong tagubilin sa mga indibidwal na proyekto, tingnan ang README files sa: +Para sa mga detalyadong tagubilin 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` - Pag-develop ng game gamit ang Canvas -- `9-chat-project/README.md` - Proyekto ng AI chat assistant +- `6-space-game/README.md` - Pag-develop ng laro gamit ang Canvas +- `9-chat-project/README.md` - AI chat assistant project -### Istruktura ng Monorepo +### Monorepo Structure -Bagama't hindi tradisyunal na monorepo, ang repository na ito ay naglalaman ng maraming independiyenteng proyekto: +Bagaman hindi isang tradisyunal na monorepo, ang repositoryong ito ay naglalaman ng maraming independiyenteng proyekto: - Ang bawat aralin ay self-contained -- Ang mga proyekto ay hindi nagbabahagi ng dependencies -- Magtrabaho sa mga indibidwal na proyekto nang hindi naaapektuhan ang iba -- I-clone ang buong repo para sa kumpletong karanasan sa kurikulum +- Hindi nagbabahagi ng dependencies ang mga proyekto +- Maaaring magtrabaho sa mga indibidwal na proyekto nang hindi naaapektuhan ang iba +- I-clone ang buong repo para sa buong karanasan sa kurikulum --- -**Paunawa**: -Ang dokumentong ito ay isinalin gamit ang AI translation service na [Co-op Translator](https://github.com/Azure/co-op-translator). Bagama't sinisikap naming maging tumpak, mangyaring tandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o hindi pagkakatugma. Ang orihinal na dokumento sa kanyang katutubong wika ang dapat ituring na opisyal na sanggunian. Para sa mahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot sa anumang hindi pagkakaunawaan o maling interpretasyon na dulot ng paggamit ng pagsasaling ito. \ No newline at end of file + +**Paalala**: +Ang dokumentong ito ay isinalin gamit ang serbisyong AI na pagsasalin na [Co-op Translator](https://github.com/Azure/co-op-translator). Bagamat nagsusumikap kami para sa katumpakan, pakatandaan na ang awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o di-katumpakan. Ang orihinal na dokumento sa kanyang likas na wika ang dapat ituring na pangunahing sanggunian. Para sa mahahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot sa anumang hindi pagkakaunawaan o maling interpretasyon na maaaring magmula sa paggamit ng pagsasaling ito. + \ No newline at end of file diff --git a/translations/tl/README.md b/translations/tl/README.md index a8a90e7d3..8a7a38227 100644 --- a/translations/tl/README.md +++ b/translations/tl/README.md @@ -1,121 +1,99 @@ -[![GitHub license](https://img.shields.io/github/license/microsoft/Web-Dev-For-Beginners.svg)](https://github.com/microsoft/Web-Dev-For-Beginners/blob/master/LICENSE) -[![GitHub contributors](https://img.shields.io/github/contributors/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/graphs/contributors/) -[![GitHub issues](https://img.shields.io/github/issues/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/issues/) -[![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/pulls/) -[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) - -[![GitHub watchers](https://img.shields.io/github/watchers/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Watch&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/watchers/) -[![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Fork&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/network/) -[![GitHub stars](https://img.shields.io/github/stars/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Star&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/stargazers/) - -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - # Web Development para sa mga Nagsisimula - Isang Kurikulum -Alamin ang mga pangunahing kaalaman sa web development gamit ang aming 12-linggong komprehensibong kurso mula sa Microsoft Cloud Advocates. Bawat isa sa 24 na aralin ay sumisid sa JavaScript, CSS, at HTML sa pamamagitan ng mga hands-on na proyekto tulad ng mga terrarium, browser extension, at mga space game. Makilahok sa mga pagsusulit, talakayan, at praktikal na mga gawain. Palawakin ang iyong kasanayan at paghusayin ang iyong kaalaman gamit ang epektibong pedagogiya namin na batay sa proyekto. Simulan ang iyong paglalakbay sa coding ngayon! +Matutunan ang mga pangunahing kaalaman sa web development sa aming 12-linggong komprehensibong kurso mula sa Microsoft Cloud Advocates. Bawat isa sa 24 na aralin ay sumisid sa JavaScript, CSS, at HTML sa pamamagitan ng mga hands-on na proyekto tulad ng terrariums, browser extensions, at space games. Makilahok sa mga pagsusulit, talakayan, at praktikal na mga gawain. Pagbutihin ang iyong mga kasanayan at i-optimize ang iyong pagkatuto gamit ang aming epektibong project-based pedagogy. Simulan ang iyong paglalakbay sa coding ngayon! Sumali sa Azure AI Foundry Discord Community -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -Sundin ang mga hakbang na ito para makapagsimula gamit ang mga resources na ito: -1. **I-Fork ang Repository**: I-click ang [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork) -2. **I-Clone ang Repository**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` -3. [**Sumali sa Azure AI Foundry Discord at makilala ang mga eksperto at ibang mga developer**](https://discord.com/invite/ByRwuEEgH4) +Sundin ang mga hakbang na ito upang makapagsimula gamit ang mga resources na ito: +1. **I-fork ang Repositoryo**: I-click ang +2. **I-clone ang Repositoryo**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +3. [**Sumali sa Azure AI Foundry Discord at makipagkita sa mga eksperto at kapwa developer**](https://discord.com/invite/ByRwuEEgH4) -### 🌐 Suporta para sa Maramihang Wika +### 🌐 Multi-Language Support #### Sinusuportahan sa pamamagitan ng GitHub Action (Awtomatiko at Palaging Napapanahon) - [Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](./README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) -> **Mas gusto mo bang I-clone ito nang Lokal?** +> **Mas gusto mo bang Mag-clone Lokal?** -> Kasama sa repository na ito ang 50+ na mga pagsasalin sa wika na malaki ang dagdag sa laki ng pag-download. Para i-clone nang walang mga pagsasalin, gamitin ang sparse checkout: +> Kasama sa repositoryong ito ang 50+ na pagsasalin ng wika na malaki ang dagdag sa laki ng ida-download. Para mag-clone nang walang mga pagsasalin, gamitin ang sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Web-Dev-For-Beginners.git > cd Web-Dev-For-Beginners > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Bibigyan ka nito ng lahat ng kailangan mo para matapos ang kurso nang mas mabilis ang pag-download. - +> Bibigyan ka nito ng lahat ng kailangan mo upang matapos ang kurso nang mas mabilis ang pag-download. -**Kung nais mo ng karagdagang suportadong mga wika ng pagsasalin ay nakalistang [dito](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)** - -[![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners) +**Kung nais mong magkaroon ng karagdagang mga suportadong wika para sa pagsasalin, nakalista ito [dito](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)** #### 🧑‍🎓 _Estudyante ka ba?_ -Bisitahin ang [**Student Hub page**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) kung saan makakakita ka ng mga panimulang resources, Student packs at maging mga paraan para makakuha ng libreng voucher para sa sertipiko. Ito ang pahinang gusto mong i-bookmark at tingnan paminsan-minsan habang nagpapalit kami ng nilalaman buwan-buwan. +Bisitahin ang [**Student Hub page**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) kung saan makakahanap ka ng mga panimulang resources, Student packs, at pati mga paraan upang makakuha ng libreng voucher para sa sertipiko. Ito ang pahina na gusto mong i-bookmark at tingnan paminsan-minsan dahil nagpapalit-palit tayo ng nilalaman buwan-buwan. -### 📣 Anunsyo - Mga bagong hamon sa GitHub Copilot Agent mode na kailangang tapusin! +### 📣 Paunawa - Mga bagong hamon sa GitHub Copilot Agent mode na dapat tapusin! -May bagong Hamon na idinagdag, hanapin ang "GitHub Copilot Agent Challenge 🚀" sa karamihan ng mga kabanata. Isang bagong hamon para sa iyo na gamitin ang GitHub Copilot at Agent mode. Kung hindi mo pa nagagamit ang Agent mode, kaya nitong hindi lamang gumawa ng teksto kundi pati na maglikha at mag-edit ng mga file, magpatakbo ng mga utos, at marami pa. +May bagong hamon na idinagdag, hanapin ang "GitHub Copilot Agent Challenge 🚀" sa karamihan ng mga kabanata. Ito ay isang bagong hamon para sa iyo upang matapos gamit ang GitHub Copilot at Agent mode. Kung hindi mo pa nagamit ang Agent mode dati, kaya nitong hindi lang gumawa ng teksto kundi makatulong sa paggawa at pag-edit ng mga file, pagpapatakbo ng mga command, at marami pang iba. -### 📣 Anunsyo - _Bagong Proyekto na gagawin gamit ang Generative AI_ +### 📣 Paunawa - _Bagong Proyekto na gagawin gamit ang Generative AI_ -Bagong AI Assistant na proyekto lang ang idinagdag, tingnan ito [project](./9-chat-project/README.md) +May bagong AI Assistant project na idinagdag, tingnan ito sa [proyekto](./9-chat-project/README.md) -### 📣 Anunsyo - _Bagong Kurikulum_ sa Generative AI para sa JavaScript ay inilabas na +### 📣 Paunawa - _Bagong Kurikulum_ tungkol sa Generative AI para sa JavaScript ang bagong inilabas Huwag palampasin ang aming bagong Generative AI curriculum! -Bisitahin ang [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) para makapagsimula! +Bisitahin ang [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) upang makapagsimula! ![Background](../../translated_images/tl/background.148a8d43afde5730.webp) - Mga aralin na sumasaklaw mula sa mga batayan hanggang RAG. -- Makipag-ugnayan sa mga historikal na karakter gamit ang GenAI at aming kasamang app. -- Masaya at nakaka-enganyong kuwento, ikaw ay maglalakbay sa panahon! +- Makipag-ugnayan sa mga makasaysayang karakter gamit ang GenAI at ang aming companion app. +- Masaya at nakakatuwang naratibo, ikaw ay magta-time travel! ![character](../../translated_images/tl/character.5c0dd8e067ffd693.webp) - -Bawat aralin ay may kasamang takdang-aralin, pagsusulit sa kaalaman at hamon upang gabayan ka sa pag-aaral ng mga paksa gaya ng: +Bawat aralin ay may kasamang gawain na tapusin, isang knowledge check, at isang hamon upang gabayan ka sa pag-aaral ng mga paksang tulad ng: - Prompting at prompt engineering -- Pagbuo ng text at image app -- Mga search app - -Bisitahin ang [https://aka.ms/genai-js-course](../../[https:/aka.ms/genai-js-course) para makapagsimula! - +- Pagbuo ng mga text at image app +- Search apps +Bisitahin ang [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) upang makapagsimula! ## 🌱 Pagsisimula -> **Mga Guro**, nagbigay kami ng [ilang mga mungkahi](for-teachers.md) kung paano gamitin ang kurikulum na ito. Masaya kaming tanggapin ang inyong puna [sa aming discussion forum](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)! +> **Mga Guro**, mayroon kaming [ilang mga mungkahi](for-teachers.md) kung paano gamitin ang kurikulum na ito. Ikalulugod naming makatanggap ng inyong feedback [sa aming discussion forum](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)! -**[Mga Nag-aaral](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**, sa bawat aralin, magsimula sa isang pre-lecture quiz at sundan ito sa pagbasa ng materyal sa lektura, pagtapos sa iba't ibang gawain at pag-check ng iyong pagkaunawa gamit ang post-lecture quiz. +**[Mga Mag-aaral](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**, para sa bawat aralin, magsimula sa isang pre-lecture na pagsusulit at sundan ito sa pagbabasa ng materyal ng lektyur, pagtapos sa mga iba't ibang gawain, at pagsuri ng inyong pag-unawa sa post-lecture na pagsusulit. -Para mapabuti ang iyong karanasan sa pag-aaral, kumonekta sa iyong mga kapwa nag-aaral upang magtulungan sa mga proyekto! Hinihikayat ang mga talakayan sa aming [discussion forum](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) kung saan ang aming mga moderator ay handang sumagot sa iyong mga tanong. +Para palalimin ang iyong karanasan sa pag-aaral, makipag-ugnayan sa iyong mga kaklase para sabay na magtrabaho sa mga proyekto! Inaanyayahan ang mga talakayan sa aming [discussion forum](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) kung saan ang aming mga moderator ay handang sagutin ang iyong mga tanong. -Para lalong mapalawak ang iyong edukasyon, lubos naming inirerekomenda ang pag-explore sa [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) para sa mga karagdagang materyales sa pag-aaral. +Para palawigin pa ang iyong edukasyon, mariin naming inirerekomenda ang pagtuklas sa [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) para sa karagdagang mga materyales sa pag-aaral. -### 📋 Pag-setup ng iyong kapaligiran +### 📋 Pag-set up ng iyong kapaligiran -Ang kurikulum na ito ay may handang development environment! Sa pagsisimula mo, maaari mong piliin na patakbuhin ang kurikulum sa isang [Codespace](https://github.com/features/codespaces/) (_isang browser-based na kapaligiran na hindi na kailangan ng install_), o lokal sa iyong kompyuter gamit ang editor ng teksto tulad ng [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). +Handa na ang development environment para sa kurikulum na ito! Sa pagsisimula mo, maaari mong piliing patakbuhin ang kurikulum sa isang [Codespace](https://github.com/features/codespaces/) (_isang browser-based, hindi na kailangan mag-install na kapaligiran_), o local sa iyong computer gamit ang isang text editor tulad ng [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). #### Gumawa ng iyong repositoryo -Para madali mong masave ang iyong mga gawain, inirerekomenda na gumawa ka ng sariling kopya ng repositoryong ito. Magagawa mo ito sa pamamagitan ng pag-click ng button na **Use this template** sa itaas ng pahina. Ito ay lilikha ng bagong repositoryo sa iyong GitHub account na may kopya ng kurikulum. +Para madali mong maisave ang iyong trabaho, inirerekomenda na gumawa ka ng sarili mong kopya ng repositoryong ito. Magagawa mo ito sa pamamagitan ng pag-click sa button na **Use this template** sa itaas ng pahina. Lilikha ito ng bagong repositoryo sa iyong GitHub account na may kopya ng kurikulum. Sundin ang mga hakbang na ito: -1. **I-Fork ang Repository**: I-click ang button na "Fork" sa kanang-itaas na bahagi ng pahinang ito. -2. **I-Clone ang Repository**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +1. **I-fork ang Repositoryo**: I-click ang "Fork" button sa kanang itaas na bahagi ng pahinang ito. +2. **I-clone ang Repositoryo**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` -#### Pagpapatakbo ng kurikulum sa Codespace +#### Pagpapatakbo ng kurikulum sa isang Codespace -Sa kopya ng repositoryong ginawa mo, i-click ang button na **Code** at piliin ang **Open with Codespaces**. Ito ay lilikha ng bagong Codespace para sa iyong trabaho. +Sa iyong kopya ng repositoryong nilikha mo, i-click ang **Code** button at piliin ang **Open with Codespaces**. Lilikha ito ng bagong Codespace para sa iyong trabahuhin. ![Codespace](../../translated_images/tl/createcodespace.0238bbf4d7a8d955.webp) -#### Pagpapatakbo ng kurikulum lokal sa iyong kompyuter - -Para patakbuhin ang kurikulum na ito nang lokal sa iyong kompyuter, kakailanganin mo ng isang text editor, browser, at command line tool. Ang unang aralin namin, [Panimula sa Programming Languages at Tools of the Trade](../../1-getting-started-lessons/1-intro-to-programming-languages), ay gagabay sa iyo sa iba't ibang pagpipilian para sa bawat tool na ito upang mapili mo ang pinakaangkop sa iyo. +#### Pagpapatakbo ng kurikulum local sa iyong computer -Inirerekomenda namin ang paggamit ng [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) bilang iyong editor, na may kasamang built-in na [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon). Maaari mong i-download ang Visual Studio Code [dito](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). +Para patakbuhin ang kurikulum na ito sa iyong computer, kakailanganin mo ang isang text editor, browser, at command line tool. Ang aming unang aralin, [Introduction to Programming Languages and Tools of the Trade](../../1-getting-started-lessons/1-intro-to-programming-languages), ay gagabay sa'yo sa iba't ibang mga opsyon para sa bawat isa sa mga tool na ito upang makapili ka ng pinakaangkop para sa'yo. +Inirerekumenda namin ang paggamit ng [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) bilang iyong editor, na may built-in ding [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon). Maaari mong i-download ang Visual Studio Code [dito](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). -1. I-clone ang iyong repository sa iyong kompyuter. Magagawa mo ito sa pamamagitan ng pag-click sa button na **Code** at pagkopya ng URL: +1. I-clone ang iyong repositoryo sa iyong computer. Maaari mo itong gawin sa pamamagitan ng pag-click sa **Code** button at pagkopya ng URL: [CodeSpace](./images/createcodespace.png) Pagkatapos, buksan ang [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) sa loob ng [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) at patakbuhin ang sumusunod na utos, palitan ang `` ng URL na iyong kinopya: @@ -124,96 +102,96 @@ Inirerekomenda namin ang paggamit ng [Visual Studio Code](https://code.visualstu git clone ``` -2. Buksan ang folder sa Visual Studio Code. Magagawa mo ito sa pamamagitan ng pag-click sa **File** > **Open Folder** at piliin ang folder na kaklone mo lang. +2. Buksan ang folder sa Visual Studio Code. Maaari mong gawin ito sa pamamagitan ng pag-click sa **File** > **Open Folder** at pagpili sa folder na kaklone mo lang. -> Inirerekomendang Mga Extension ng Visual Studio Code: +> Inirerekomendang mga extension ng Visual Studio Code: > -> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - upang makita ang preview ng mga pahina ng HTML sa loob mismo ng Visual Studio Code -> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - para tulungan kang mas mabilis magsulat ng code +> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - para makita ang preview ng mga pahina ng HTML sa loob ng Visual Studio Code +> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - para makatulong sa mas mabilis na pagsulat ng code -## 📂 Bawat aralin ay may kasamang: +## 📂 Kasama sa bawat aralin: - opsyonal na sketchnote - opsyonal na karagdagang video - pre-lesson warmup quiz - nakasulat na aralin -- para sa mga proyekto, sunud-sunod na gabay kung paano itatayo ang proyekto -- pagsusuri ng kaalaman +- para sa mga araling proyekto, hakbang-hakbang na gabay kung paano buuin ang proyekto +- mga knowledge check - isang hamon - karagdagang babasahin -- takdang-aralin +- asignatura - [post-lesson quiz](https://ff-quizzes.netlify.app/web/) -> **Isang tala tungkol sa mga pagsusulit**: Lahat ng pagsusulit ay nasa Quiz-app na folder, may 48 kabuuang pagsusulit na tig-3 tanong bawat isa. Available ang mga ito [dito](https://ff-quizzes.netlify.app/web/), ang quiz app ay maaaring patakbuhin nang lokal o ma-deploy sa Azure; sundin ang mga instruksyon sa `quiz-app` na folder. +> **Isang paalala tungkol sa mga pagsusulit**: Lahat ng pagsusulit ay nilalaman sa folder ng Quiz-app, 48 kabuuang pagsusulit na may tig-tatlong tanong bawat isa. Available ang mga ito [dito](https://ff-quizzes.netlify.app/web/); ang quiz app ay maaaring patakbuhin nang lokal o i-deploy sa Azure; sundin ang mga tagubilin sa `quiz-app` folder. ## 🗃️ Mga Aralin -| | Pangalan ng Proyekto | Mga Konseptong Itinuro | Mga Layunin sa Pagkatuto | Nakalink na Aralin | May-akda | -| :-: | :--------------------------------------------------------------: | :--------------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :-----------------------: | -| 01 | Getting Started | Panimula sa Programming at Mga Kasangkapan ng Propesyon | Matutunan ang mga batayang pundasyon sa likod ng karamihan sa mga programming language at tungkol sa software na tumutulong sa mga propesyonal | [Intro to Programming Languages and Tools of the Trade](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | -| 02 | Getting Started | Mga Pangunahing Kaalaman sa GitHub, kasama ang pagtatrabaho sa koponan | Paano gamitin ang GitHub sa iyong proyekto, paano makipagtulungan sa iba sa isang code base | [Intro to GitHub](./1-getting-started-lessons/2-github-basics/README.md) | Floor | -| 03 | Getting Started | Accessibility | Matutunan ang mga batayan ng web accessibility | [Accessibility Fundamentals](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | -| 04 | JS Basics | Mga Uri ng Data sa JavaScript | Mga batayan ng mga uri ng data sa JavaScript | [Data Types](./2-js-basics/1-data-types/README.md) | Jasmine | -| 05 | JS Basics | Mga Function at Method | Matutunan ang tungkol sa mga function at method para pamahalaan ang daloy ng lohika ng isang aplikasyon | [Functions and Methods](./2-js-basics/2-functions-methods/README.md) | Jasmine at Christopher | -| 06 | JS Basics | Paggawa ng Mga Desisyon gamit ang JS | Matutunan kung paano gumawa ng mga kondisyon sa iyong code gamit ang mga paraan ng paggawa ng desisyon | [Making Decisions](./2-js-basics/3-making-decisions/README.md) | Jasmine | -| 07 | JS Basics | Arrays at Loops | Gumamit ng data gamit ang arrays at loops sa JavaScript | [Arrays and Loops](./2-js-basics/4-arrays-loops/README.md) | Jasmine | -| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTML sa Praktis | Gumawa ng HTML para makagawa ng online terrarium, nakatuon sa paggawa ng layout | [Introduction to HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | -| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSS sa Praktis | Gumawa ng CSS para istilohan ang online terrarium, nakatuon sa mga batayan ng CSS kabilang ang paggawa ng page na responsive | [Introduction to CSS](./3-terrarium/2-intro-to-css/README.md) | Jen | -| 10 | [Terrarium](./3-terrarium/solution/README.md) | JavaScript Closures, DOM manipulation | Gumawa ng JavaScript upang pagandahin ang terrarium bilang isang drag/drop interface, na nakatuon sa closures at DOM manipulation | [JavaScript Closures, DOM manipulation](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen | -| 11 | [Typing Game](./4-typing-game/solution/README.md) | Gumawa ng Typing Game | Matutunan kung paano gamitin ang mga keyboard events para patakbuhin ang lohika ng iyong JavaScript app | [Event-Driven Programming](./4-typing-game/typing-game/README.md) | Christopher | -| 12 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Paggawa gamit ang Mga Browser | Matutunan kung paano gumagana ang mga browser, ang kasaysayan nito, at paano magsimula sa mga unang elemento ng isang browser extension | [About Browsers](./5-browser-extension/1-about-browsers/README.md) | Jen | -| 13 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Paggawa ng form, pagtawag ng API at pag-iimbak ng variables sa local storage | Gumawa ng mga elemento ng JavaScript ng iyong browser extension upang tumawag ng API gamit ang mga variable na nakaimbak sa local storage | [APIs, Forms, and Local Storage](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen | -| 14 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Mga background process sa browser, performance ng web | Gamitin ang mga background process ng browser upang pamahalaan ang icon ng extension; matutunan ang web performance at ilang optimizations | [Background Tasks and Performance](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen | -| 15 | [Space Game](./6-space-game/solution/README.md) | Mas Advanced na Pag-develop ng Game gamit ang JavaScript | Matutunan ang tungkol sa Inheritance gamit ang Classes at Composition pati na ang Pub/Sub pattern, bilang paghahanda sa paggawa ng laro | [Introduction to Advanced Game Development](./6-space-game/1-introduction/README.md) | Chris | -| 16 | [Space Game](./6-space-game/solution/README.md) | Pag-drawing sa canvas | Matutunan ang Canvas API, na ginagamit para gumuhit ng mga elemento sa screen | [Drawing to Canvas](./6-space-game/2-drawing-to-canvas/README.md) | Chris | -| 17 | [Space Game](./6-space-game/solution/README.md) | Paggalaw ng mga elemento sa paligid ng screen | Alamin kung paano makakakuha ng galaw ang mga elemento gamit ang cartesian coordinates at ang Canvas API | [Moving Elements Around](./6-space-game/3-moving-elements-around/README.md) | Chris | -| 18 | [Space Game](./6-space-game/solution/README.md) | Pagtuklas ng pagbangga | Pahintulutan ang mga elemento na dumagit at tumugon sa isa't isa gamit ang keypresses at magbigay ng cooldown function para sa performance ng laro | [Collision Detection](./6-space-game/4-collision-detection/README.md) | Chris | -| 19 | [Space Game](./6-space-game/solution/README.md) | Pagpapanatili ng score | Isagawa ang mga kalkulasyon ng math base sa katayuan at performance ng laro | [Keeping Score](./6-space-game/5-keeping-score/README.md) | Chris | -| 20 | [Space Game](./6-space-game/solution/README.md) | Pagtatapos at pagrere-start ng laro | Matutunan ang tungkol sa pagtatapos at pagrere-start ng laro, kabilang ang paglilinis ng mga asset at pagrereset ng mga variable na halaga | [The Ending Condition](./6-space-game/6-end-condition/README.md) | Chris | -| 21 | [Banking App](./7-bank-project/solution/README.md) | HTML Templates at Routes sa isang Web App | Matutunan kung paano lumikha ng istruktura ng isang multipage website gamit ang routing at HTML templates | [HTML Templates and Routes](./7-bank-project/1-template-route/README.md) | Yohan | -| 22 | [Banking App](./7-bank-project/solution/README.md) | Gumawa ng Login at Registration Form | Matutunan ang paggawa ng mga form at paghawak ng validation routines | [Forms](./7-bank-project/2-forms/README.md) | Yohan | -| 23 | [Banking App](./7-bank-project/solution/README.md) | Mga Paraan ng Pagkuha at Paggamit ng Data | Paano dumadaloy ang data sa iyong app, paano ito kunin, iimbak, at alisin | [Data](./7-bank-project/3-data/README.md) | Yohan | -| 24 | [Banking App](./7-bank-project/solution/README.md) | Mga Konsepto ng Pamamahala ng Estado | Matutunan kung paano pinananatili ng iyong app ang estado at paano ito pamahalaan programmatically | [State Management](./7-bank-project/4-state-management/README.md) | Yohan | -| 25 | [Browser/VScode Code](../../8-code-editor) | Paggamit ng VScode | Matutunan kung paano Gumamit ng code editor | [Use VScode Code Editor](./8-code-editor/1-using-a-code-editor/README.md) | Chris | -| 26 | [AI Assistants](./9-chat-project/README.md) | Paggamit ng AI | Matutunan kung paano gumawa ng sarili mong AI assistant | [AI Assistant project](./9-chat-project/README.md) | Chris | +| | Pangalan ng Proyekto | Mga Konseptong Itinuro | Mga Layunin sa Pagkatuto | Kaugnay na Aralin | May-akda | +| :-: | :--------------------------------------------------------------: | :-------------------------------------------------------------------------: | ---------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :---------------------: | +| 01 | Pagsisimula | Panimula sa Programming at Mga Kagamitan sa Industriya | Matutunan ang mga pangunahing pundasyon sa likod ng karamihan sa mga programming language at tungkol sa software na tumutulong sa mga propesyonal na developer | [Intro to Programming Languages and Tools of the Trade](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | +| 02 | Pagsisimula | Mga Batayan ng GitHub, kasama ang pagtatrabaho sa isang koponan | Paano gamitin ang GitHub sa iyong proyekto, paano makipagtulungan sa iba sa isang code base | [Intro to GitHub](./1-getting-started-lessons/2-github-basics/README.md) | Floor | +| 03 | Pagsisimula | Accessibility | Matutunan ang mga batayan ng web accessibility | [Accessibility Fundamentals](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | +| 04 | JS Basics | Mga Uri ng Data sa JavaScript | Ang mga batayan ng mga uri ng data sa JavaScript | [Data Types](./2-js-basics/1-data-types/README.md) | Jasmine | +| 05 | JS Basics | Mga Function at Method | Matuto tungkol sa mga function at method upang pamahalaan ang daloy ng lohika ng isang aplikasyon | [Functions and Methods](./2-js-basics/2-functions-methods/README.md) | Jasmine and Christopher | +| 06 | JS Basics | Paggawa ng mga Desisyon gamit ang JS | Matuto kung paano gumawa ng mga kondisyon sa iyong code gamit ang mga pamamaraan sa paggawa ng desisyon | [Making Decisions](./2-js-basics/3-making-decisions/README.md) | Jasmine | +| 07 | JS Basics | Arrays at Loops | Gamitin ang data gamit ang arrays at loops sa JavaScript | [Arrays and Loops](./2-js-basics/4-arrays-loops/README.md) | Jasmine | +| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTML sa Praktis | Bumuo ng HTML upang makalikha ng online terrarium, nakatuon sa pagbuo ng layout | [Introduction to HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | +| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSS sa Praktis | Bumuo ng CSS upang istilohan ang online terrarium, nakatuon sa mga batayan ng CSS kabilang ang paggawa ng pahina na tumutugon | [Introduction to CSS](./3-terrarium/2-intro-to-css/README.md) | Jen | +| 10 | [Terrarium](./3-terrarium/solution/README.md) | JavaScript Closures, DOM manipulation | Bumuo ng JavaScript upang mag-fungsyon ang terrarium bilang isang drag/drop interface, nakatuon sa closures at DOM manipulation | [JavaScript Closures, DOM manipulation](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen | +| 11 | [Typing Game](./4-typing-game/solution/README.md) | Bumuo ng Isang Typing Game | Matutunan kung paano gamitin ang mga event ng keyboard upang paandarin ang lohika ng iyong JavaScript app | [Event-Driven Programming](./4-typing-game/typing-game/README.md) | Christopher | +| 12 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Paggawa sa mga Browser | Matutunan kung paano gumagana ang mga browser, ang kasaysayan nito, at kung paano mag-scaffold ng mga unang elemento ng isang browser extension | [About Browsers](./5-browser-extension/1-about-browsers/README.md) | Jen | +| 13 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Pagbuo ng form, pagtawag sa API at pag-iimbak ng mga variable sa local storage | Bumuo ng mga elemento ng JavaScript ng iyong browser extension upang tumawag ng API gamit ang mga variable na nakaimbak sa local storage | [APIs, Forms, and Local Storage](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen | +| 14 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Mga background process sa browser, pagganap ng web | Gamitin ang mga background process ng browser upang pamahalaan ang icon ng extension; alamin ang tungkol sa pagganap ng web at ilang mga optimisasyon upang mapabilis | [Background Tasks and Performance](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen | +| 15 | [Space Game](./6-space-game/solution/README.md) | Mas Advanced na Pagbuo ng Laro gamit ang JavaScript | Matuto tungkol sa Inheritance gamit ang parehong Classes at Composition at ang Pub/Sub pattern, bilang paghahanda sa paggawa ng laro | [Introduction to Advanced Game Development](./6-space-game/1-introduction/README.md) | Chris | +| 16 | [Space Game](./6-space-game/solution/README.md) | Pagguho sa canvas | Matuto tungkol sa Canvas API, na ginagamit upang mag-drawing ng mga elemento sa screen | [Drawing to Canvas](./6-space-game/2-drawing-to-canvas/README.md) | Chris | +| 17 | [Space Game](./6-space-game/solution/README.md) | Paggalaw ng mga elemento sa paligid ng screen | Tuklasin kung paano nagkakaroon ng galaw ang mga elemento gamit ang cartesian coordinates at ang Canvas API | [Moving Elements Around](./6-space-game/3-moving-elements-around/README.md) | Chris | +| 18 | [Space Game](./6-space-game/solution/README.md) | Pag-detect ng collision | Pahintulutan ang mga elemento na magbanggaan at mag-react sa isa't isa gamit ang keypresses at magbigay ng cooldown function upang matiyak ang pagganap ng laro | [Collision Detection](./6-space-game/4-collision-detection/README.md) | Chris | +| 19 | [Space Game](./6-space-game/solution/README.md) | Pagpapanatili ng puntos | Gawin ang mga kalkulasyon batay sa status ng laro at pagganap | [Keeping Score](./6-space-game/5-keeping-score/README.md) | Chris | +| 20 | [Space Game](./6-space-game/solution/README.md) | Pagtatapos at muling pagsisimula ng laro | Matutunan ang tungkol sa pagtatapos at muling pagsisimula ng laro, kabilang ang paglilinis ng mga asset at pag-reset ng mga variable values | [The Ending Condition](./6-space-game/6-end-condition/README.md) | Chris | +| 21 | [Banking App](./7-bank-project/solution/README.md) | Mga HTML Template at Routing sa isang Web App | Matutunan kung paano lumikha ng scaffolding ng multipage website gamit ang routing at HTML template | [HTML Templates and Routes](./7-bank-project/1-template-route/README.md) | Yohan | +| 22 | [Banking App](./7-bank-project/solution/README.md) | Bumuo ng Login at Registration Form | Matuto tungkol sa pagbuo ng mga form at paghawak ng mga validation routine | [Forms](./7-bank-project/2-forms/README.md) | Yohan | +| 23 | [Banking App](./7-bank-project/solution/README.md) | Mga Paraan ng Pagkuha at Paggamit ng Datos | Paano dumadaloy ang datos papasok at palabas ng iyong app, paano ito kunin, i-imbak, at alisin | [Data](./7-bank-project/3-data/README.md) | Yohan | +| 24 | [Banking App](./7-bank-project/solution/README.md) | Mga Konsepto ng State Management | Matutunan kung paano hinahawakan ng iyong app ang state at kung paano ito pamahalaan programmatically | [State Management](./7-bank-project/4-state-management/README.md) | Yohan | +| 25 | [Browser/VScode Code](../../8-code-editor) | Paggamit ng VScode | Matutunang Gumamit ng code editor | [Use VScode Code Editor](./8-code-editor/1-using-a-code-editor/README.md) | Chris | +| 26 | [AI Assistants](./9-chat-project/README.md) | Paggamit ng AI | Matutong bumuo ng sariling AI assistant | [AI Assistant project](./9-chat-project/README.md) | Chris | ## 🏫 Pedagohiya -Ang aming kurikulum ay dinisenyo gamit ang dalawang mahahalagang prinsipyo sa pagtuturo: -* pagkatuto base sa proyekto -* madalas na pagsusulit +Ang aming kurikulum ay dinisenyo batay sa dalawang pangunahing prinsipyo sa pagtuturo: +* pagkatuto batay sa proyekto +* madalas na mga pagsusulit -Itinuro sa programa ang mga pundasyon ng JavaScript, HTML, at CSS, pati na rin ang mga pinakabagong kasangkapan at teknik na ginagamit ng mga web developer ngayon. Magkakaroon ang mga mag-aaral ng pagkakataon na magkaroon ng praktikal na karanasan sa paggawa ng isang typing game, virtual na terrarium, eco-friendly na browser extension, space-invader-style game, at isang banking app para sa mga negosyo. Sa pagtatapos ng serye, magkakaroon ang mga mag-aaral ng matatag na pag-unawa sa web development. +Itinuturo ng programa ang mga pundasyon ng JavaScript, HTML, at CSS, pati na rin ang mga pinakabagong kagamitan at teknik na ginagamit ng mga web developer ngayon. Magkakaroon ang mga estudyante ng pagkakataon na magkaroon ng praktikal na karanasan sa pamamagitan ng paggawa ng isang typing game, virtual terrarium, eco-friendly browser extension, laro gaya ng space invader, at isang banking app para sa mga negosyo. Sa pagtatapos ng serye, magkakaroon ang mga estudyante ng matibay na pang-unawa sa pag-develop ng web. -> 🎓 Maaari mong kunin ang mga unang aralin sa kurikulum na ito bilang isang [Learn Path](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon) sa Microsoft Learn! +> 🎓 Maaari mong kunin ang mga unang aralin sa kurikulum na ito bilang [Learn Path](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon) sa Microsoft Learn! -Sa pagtitiyak na ang nilalaman ay naka-align sa mga proyekto, mas nagiging kawili-wili ang proseso para sa mga mag-aaral at mapapalakas ang pag-alala sa mga konsepto. Sumulat din kami ng ilang panimulang aralin sa JavaScript basics upang ipakilala ang mga konsepto, na sinamahan ng isang video mula sa koleksyon ng mga tutorial na video na "[Beginners Series to: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)", na ang ilan sa mga may-akda nito ay nag-ambag sa kurikulum na ito. +Sa pamamagitan ng pagtiyak na ang nilalaman ay tugma sa mga proyekto, mas nagiging kawili-wili ang proseso para sa mga estudyante at mas napapalakas ang pag-alala sa mga konsepto. Sumulat din kami ng ilang panimulang aralin sa mga batayan ng JavaScript upang ipakilala ang mga konsepto, na sinamahan ng video mula sa koleksyon na "[Beginners Series to: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)", na ang ilan sa mga may-akda ay nag-ambag sa kurikulum na ito. -Bukod dito, ang isang low-stakes quiz bago ang klase ay nagtatakda ng intensiyon ng estudyante sa pagkatuto ng isang paksa, habang ang pangalawang pagsusulit pagkatapos ng klase ay nagtitiyak na lalo pang maalala ang materyal. Ang kurikulum na ito ay ginawa upang maging flexible at masaya at maaaring kunin nang buo o paunti-unti. Ang mga proyekto ay nagsisimula sa maliit at unti-unting lumalawak hanggang sa katapusan ng 12-linggong panahon. +Bukod dito, isang mababang-pader na pagsusulit bago ang klase ang nagsisilbing intensyon ng estudyante sa pag-aaral ng isang paksa, habang ang pangalawang pagsusulit pagkatapos ng klase ay nagsisiguro ng karagdagang pagkatuto. Dinisenyo ang kurikulum na ito upang maging flexible at masaya, maaari itong kunin nang buo o bahagi lamang. Ang mga proyekto ay nagsisimula sa maliit at unti-unting lumalalim sa pagiging kumplikado hanggang sa pagtatapos ng 12-linggong yugto. -Habang sinadyang iniiwasan naming ipakilala ang mga JavaScript framework upang magpokus sa mga pangunahing kasanayan na kailangan bilang web developer bago tumanggap ng framework, isang magandang susunod na hakbang matapos makumpleto ang kurikulum na ito ay ang pag-aaral tungkol sa Node.js sa pamamagitan ng isa pang koleksyon ng mga video: "[Beginner Series to: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". +Habang sinasadya naming iwasan ang pagpapakilala ng JavaScript frameworks upang magpokus sa mga pangunahing kakayahan na kailangan bilang isang web developer bago gumamit ng framework, ang isang magandang susunod na hakbang sa pagtatapos ng kurikulum na ito ay ang matutunan ang tungkol sa Node.js sa pamamagitan ng isa pang koleksyon ng mga video: "[Beginner Series to: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". -> Bisitahin ang aming [Code of Conduct](CODE_OF_CONDUCT.md) at mga gabay sa [Contributing](CONTRIBUTING.md). Malugod naming tinatanggap ang iyong makabuluhang puna! +> Bisitahin ang aming [Code of Conduct](CODE_OF_CONDUCT.md) at [Contributing](CONTRIBUTING.md) na mga patnubay. Malugod naming tinatanggap ang iyong mga konstruktibong puna! -## 🧭 Offline access +## 🧭 Offline na pag-access -Maaari mong patakbuhin ang dokumentasyong ito nang offline gamit ang [Docsify](https://docsify.js.org/#/). I-fork ang repositoryong ito, [i-install ang Docsify](https://docsify.js.org/#/quickstart) sa iyong lokal na makina, at pagkatapos ay sa root folder ng repo na ito, i-type `docsify serve`. Ang website ay magiging available sa port 3000 sa iyong localhost: `localhost:3000`. +Maaari mong patakbuhin ang dokumentasyong ito nang offline gamit ang [Docsify](https://docsify.js.org/#/). I-fork ang repo, [i-install ang Docsify](https://docsify.js.org/#/quickstart) sa iyong lokal na makina, at pagkatapos sa root folder ng repo na ito, i-type ang `docsify serve`. Ihahain ang website sa port 3000 sa iyong localhost: `localhost:3000`. ## 📘 PDF -Ang PDF ng lahat ng mga aralin ay matatagpuan [dito](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf). +Isang PDF ng lahat ng mga aralin ay matatagpuan [dito](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf). -## 🎒 Iba Pang Kurso -Ang aming koponan ay gumagawa ng iba pang mga kurso! Tingnan: +## 🎒 Iba Pang Mga Kurso +Ang aming koponan ay gumagawa ng iba pang mga kurso! Tingnan ang: ### LangChain [![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) [![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - +[![LangChain for Beginners](https://img.shields.io/badge/LangChain%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://github.com/microsoft/langchain-for-beginners?WT.mc_id=m365-94501-dwahlin) --- ### Azure / Edge / MCP / Agents @@ -251,21 +229,21 @@ Ang aming koponan ay gumagawa ng iba pang mga kurso! Tingnan: ## Pagkuha ng Tulong -Kung ikaw ay nahihirapan o may mga tanong tungkol sa paggawa ng mga AI app. Sumali sa kapwa mga nag-aaral at mga bihasang developer sa mga talakayan tungkol sa MCP. Isa itong sumusuportang komunidad kung saan malugod ang pagtatanong at malayang pagbabahagi ng kaalaman. +Kung ikaw ay natigil o may mga katanungan tungkol sa paggawa ng mga AI app. Sumali sa mga kapwa mag-aaral at mga may karanasang developer sa mga talakayan tungkol sa MCP. Ito ay isang suportadong komunidad kung saan malugod na tinatanggap ang mga tanong at malayang naibabahagi ang kaalaman. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Kung may feedback ka sa produkto o mga error habang nagbuo, bisitahin: +Kung mayroon kang feedback sa produkto o mga error habang nagtatayo, bisitahin ang: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) ## Lisensya -Ang repositoryong ito ay lisensiyado sa ilalim ng MIT license. Tingnan ang [LICENSE](../../LICENSE) na file para sa karagdagang impormasyon. +Ang repositoryong ito ay lisensyado sa ilalim ng MIT license. Tingnan ang [LICENSE](../../LICENSE) file para sa karagdagang impormasyon. --- **Paunawa**: -Ang dokumentong ito ay isinalin gamit ang serbisyo ng AI translation na [Co-op Translator](https://github.com/Azure/co-op-translator). Bagaman aming sinisikap ang pagiging tumpak, pakatandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o di-tumpak na impormasyon. Ang orihinal na dokumento sa katutubong wika nito ang dapat ituring na pangunahing sanggunian. Para sa mahahalagang impormasyon, inirerekomenda ang propesyonal na pagsasaling tao. Hindi kami mananagot sa anumang hindi pagkakaunawaan o maling interpretasyon na maaaring magmula sa paggamit ng salin na ito. +Ang dokumentong ito ay isinalin gamit ang AI translation service na [Co-op Translator](https://github.com/Azure/co-op-translator). Bagamat nagsusumikap kami para sa katumpakan, pakitandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o di-tumpak na impormasyon. Ang orihinal na dokumento sa kanyang sariling wika ang dapat ituring na pinakaawtoritatibong sanggunian. Para sa mahahalagang impormasyon, inirerekomenda ang propesyonal na pagsasaling-tao. Hindi kami mananagot sa anumang hindi pagkakaunawaan o maling interpretasyon na nagmula sa paggamit ng pagsasaling ito. \ No newline at end of file diff --git a/translations/tl/Roadmap.md b/translations/tl/Roadmap.md new file mode 100644 index 000000000..e312f9876 --- /dev/null +++ b/translations/tl/Roadmap.md @@ -0,0 +1,53 @@ +# Roadmap para sa Web-Dev-For-Beginners Repository ng Microsoft + +**Ang repositoryong ito ay nagbibigay ng roadmap para matutunan ang mga pundasyon ng web development na nakatuon sa JavaScript, HTML, at CSS. Ang kurikulum ay flexible at maaaring kunin nang buo o piraso-piraso, na may 24 na leksyon na nakalatag sa loob ng 12 linggo.** + +## Pangunahing Mga Yugto + +* **Linggo 1-3:** + * Panimula sa mga programming language at mga kasangkapang ginagamit sa trabaho + * Mga pangunahing kaalaman sa GitHub + * Accessibility + * Mga pangunahing kaalaman sa JS: uri ng datos, mga function at mga pamamaraan + * Paggawa ng mga desisyon gamit ang JS +* **Linggo 4-6:** + * Arrays at mga loops + * Terrarium: Praktikal na paggamit ng HTML + * Praktikal na paggamit ng CSS + * Mga closure sa JavaScript + * Manipulasyon ng DOM +* **Linggo 7-9:** + * Typing Game: Event-driven programming + * Green Browser Extension: Paggamit sa mga browser + * Pagbuo ng form, pagtawag sa API, at pag-iimbak ng mga variable sa local storage + * Mga proseso sa background sa browser + * Web performance +* **Linggo 10-12:** + * Space Game: Mas advanced na pagbuo ng laro gamit ang JavaScript + * Pagdidrawing sa canvas + * Paggalaw ng mga elemento sa screen + * Collision detection + * Pagpapanatili ng score, pagtatapos, at pagrere-start ng laro + * Banking App: Mga HTML Template at Routes sa isang Web App + * Pagbuo ng Login at Registration Form + * Mga Pamamaraan ng Pagkuha at Paggamit ng Data + * Mga Konsepto ng State Management + +## Mga Inaasahang Matutunan + +**Sa pagtatapos ng roadmap na ito, magkakaroon ng karanasang praktikal ang mga estudyante sa paggawa ng typing game, virtual terrarium, eco-friendly na browser extension, space-invader-style na laro, at banking app para sa mga negosyo. Magkakaroon din sila ng matibay na pag-unawa sa mga pundasyon ng web development.** + +## Karagdagang Mga Mapagkukunan + +* Ang repositoryong ito ay nagbibigay ng maraming mga mapagkukunan para sa karagdagang pag-aaral, kabilang ang mga tutorial, mga halimbawa ng code, at mga hamon. +* Nagbibigay ang Microsoft Learn platform ng iba't ibang kurso at mga learning path para sa web development. +* Ang mga online na komunidad tulad ng Stack Overflow at ang MDN Web Docs ay nagbibigay ng mahahalagang suporta at mga mapagkukunan para sa mga web developer. + +**Sana makatulong sa iyong paglalakbay sa web development ang roadmap na ito!** + +--- + + +**Pahayag ng Paunawa**: +Ang dokumentong ito ay isinalin gamit ang serbisyong AI na pagsasalin na [Co-op Translator](https://github.com/Azure/co-op-translator). Bagama't nagsusumikap kaming maging tumpak, pakatandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o di-tuwirang impormasyon. Ang orihinal na dokumento sa kanyang wikang sinimulan ang dapat ituring na may pinakamataas na awtoridad. Para sa mahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot sa anumang hindi pagkakaunawaan o maling pagpapakahulugan na nagmula sa paggamit ng pagsasaling ito. + \ No newline at end of file