From 96aaac5a93cedf7e8593a97e0799b658e09b7bd9 Mon Sep 17 00:00:00 2001 From: "localizeflow[bot]" Date: Fri, 6 Feb 2026 09:37:36 +0000 Subject: [PATCH] chore(i18n): sync translations with latest source changes (chunk 1/1, 9 changes) --- translations/ms/.co-op-translator.json | 6 +- translations/ms/AGENTS.md | 262 +++++++++-------- translations/ms/README.md | 215 +++++++------- translations/sw/.co-op-translator.json | 6 +- translations/sw/AGENTS.md | 392 +++++++++++++------------ translations/sw/README.md | 227 +++++++------- translations/tl/.co-op-translator.json | 6 +- translations/tl/AGENTS.md | 376 ++++++++++++------------ translations/tl/README.md | 224 +++++++------- 9 files changed, 846 insertions(+), 868 deletions(-) diff --git a/translations/ms/.co-op-translator.json b/translations/ms/.co-op-translator.json index e6f280d29..399bc2138 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-06T09:34:53+00:00", "source_file": "AGENTS.md", "language_code": "ms" }, @@ -516,8 +516,8 @@ "language_code": "ms" }, "README.md": { - "original_hash": "490c83786552d7fab6390991517bef09", - "translation_date": "2026-01-29T18:49:29+00:00", + "original_hash": "805cd399757df19e886e86f0891a1374", + "translation_date": "2026-02-06T09:27:19+00:00", "source_file": "README.md", "language_code": "ms" }, diff --git a/translations/ms/AGENTS.md b/translations/ms/AGENTS.md index ee41017a3..870bd6356 100644 --- a/translations/ms/AGENTS.md +++ b/translations/ms/AGENTS.md @@ -2,12 +2,12 @@ ## 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 selama 12 minggu yang komprehensif dibangunkan oleh Microsoft Cloud Advocates, yang 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 +- **Kandungan Pendidikan**: 24 pelajaran tersusun di dalam modul berasaskan projek +- **Projek Praktikal**: Terrarium, Permainan Mengetik, Pelanjutan 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) @@ -18,7 +18,7 @@ Ini adalah repositori kurikulum pendidikan untuk mengajar asas pembangunan web k - 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 +- Dokumentasi disediakan melalui Docsify dan tersedia sebagai PDF ## Perintah Persediaan @@ -36,9 +36,9 @@ cd Web-Dev-For-Beginners ```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) @@ -46,17 +46,17 @@ 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 # Mulakan pelayan API +npm run lint # Jalankan ESLint +npm run format # Format dengan Prettier ``` -### Projek Sambungan Penyemak Imbas +### Projek Pelanjutan Pelayar ```bash cd 5-browser-extension/solution npm install -# Follow browser-specific extension loading instructions +# Ikuti arahan memuatkan pelanjutan 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 (Python Backend) ```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,73 +80,73 @@ 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. **Fok repositori** ke akaun GitHub anda +2. **Klon 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 yang berkaitan +6. Serahkan pull request mengikut garis panduan sumbangan ### Untuk Pelajar -1. Fork atau clone repositori +1. Fok atau klon 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 +5. Gunakan contoh kod dalam folder pelajaran +6. Sempurnakan tugasan dan cabaran 7. Ambil kuiz selepas 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 +- **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 berkaitan -## 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 # Semak isu gaya kod +npm run build # Sahkan pembinaan 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 untuk isu gaya kod +node server.js # Sahkan pelayan bermula tanpa ralat ``` -### Pendekatan Pengujian Umum +### Pendekatan Ujian Umum -- Ini adalah repositori pendidikan tanpa ujian automatik yang komprehensif -- Pengujian manual memberi tumpuan kepada: +- Ini adalah repositori pendidikan tanpa ujian automatik yang menyeluruh +- Ujian manual memberi tumpuan kepada: - Contoh kod berjalan tanpa ralat - Pautan dalam dokumentasi berfungsi dengan betul - - Pembinaan projek selesai dengan berjaya - - Contoh mengikuti amalan terbaik + - Projek dibina dengan jayanya + - Contoh mengikut amalan terbaik -### Pemeriksaan Sebelum Penyerahan +### Semakan Sebelum Penyerahan -- Jalankan `npm run lint` di direktori dengan package.json +- Jalankan `npm run lint` dalam direktori yang mempunyai package.json - Sahkan pautan markdown adalah sah -- Uji contoh kod dalam penyemak imbas atau Node.js -- Pastikan terjemahan mengekalkan struktur yang betul +- Uji contoh kod dalam pelayar atau Node.js +- Semak 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 ES6+ terkini +- Ikut konfigurasi ESLint standard yang disediakan dalam projek +- Gunakan nama pembolehubah dan fungsi yang bermakna untuk kejelasan pendidikan +- Tambah komen yang menerangkan konsep untuk pelajar +- Format menggunakan Prettier jika dikonfigurasikan ### HTML/CSS @@ -159,7 +159,7 @@ node server.js # Verify server starts without errors - Garis panduan gaya PEP 8 - Contoh kod yang jelas dan pendidikan -- Petunjuk jenis di mana berguna untuk pembelajaran +- Petunjuk jenis jika membantu pembelajaran ### Dokumentasi Markdown @@ -167,7 +167,7 @@ node server.js # Verify server starts without errors - Blok kod dengan spesifikasi bahasa - Pautan ke sumber tambahan - Tangkapan skrin dan imej dalam direktori `images/` -- Teks alt untuk imej untuk kebolehaksesan +- Teks alt untuk imej untuk aksesibilitas ### Pengorganisasian Fail @@ -176,64 +176,64 @@ node server.js # Verify server starts without errors - Imej disimpan dalam folder `images/` khusus pelajaran - Terjemahan dalam struktur `translations/{language-code}/` -## Pembinaan dan Penghantaran +## Pembinaan dan Penyebaran -### Penghantaran Aplikasi Kuiz (Azure Static Web Apps) +### Penyebaran Aplikasi Kuiz (Azure Static Web Apps) -Aplikasi kuiz dikonfigurasikan untuk penghantaran Azure Static Web Apps: +Aplikasi kuiz dikonfigurasikan untuk penyebaran 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 # Mencipta folder dist/ +# Melaksanakan melalui aliran kerja GitHub Actions apabila melakukan push 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` +- **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 -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 binaan sendiri: +- Projek Vue: `npm run build` menghasilkan bundle produksi +- Projek statik: Tiada langkah binaan, hidangkan fail secara langsung ## Garis Panduan Pull Request ### Format Tajuk -Gunakan tajuk yang jelas dan deskriptif yang menunjukkan kawasan perubahan: +Gunakan tajuk yang jelas dan deskriptif yang menunjukkan bidang 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` +- `[Lesson-3] Betulkan kesilapan taip dalam projek terrarium` +- `[Translation] Tambah terjemahan Sepanyol untuk pelajaran 5` - `[Docs] Kemas kini arahan persediaan` -### Pemeriksaan Diperlukan +### Semakan Diperlukan Sebelum menghantar PR: 1. **Kualiti Kod**: - - Jalankan `npm run lint` di direktori projek yang terjejas + - Jalankan `npm run lint` dalam direktori projek yang terjejas - Betulkan semua ralat dan amaran linting -2. **Pengesahan Pembinaan**: +2. **Pengesahan Binaan**: - Jalankan `npm run build` jika berkenaan - - Pastikan tiada ralat pembinaan + - Pastikan tiada ralat binaan 3. **Pengesahan Pautan**: - Uji semua pautan markdown @@ -241,21 +241,21 @@ Sebelum menghantar PR: 4. **Semakan Kandungan**: - Semak ejaan dan tatabahasa - - Pastikan contoh kod adalah betul dan pendidikan - - Sahkan terjemahan mengekalkan maksud asal + - Pastikan contoh kod betul dan pendidikan + - Sahkan terjemahan mengekalkan makna asal -### Keperluan Sumbangan +### Keperluan Penyumbangan -- Setuju dengan Microsoft CLA (pemeriksaan automatik pada PR pertama) -- Ikuti [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) +- Setuju dengan Microsoft CLA (semakan automatik pada PR pertama) +- Mengikuti [Kod Etika Microsoft Open Source](https://opensource.microsoft.com/codeofconduct/) - Lihat [CONTRIBUTING.md](./CONTRIBUTING.md) untuk garis panduan terperinci - Rujuk nombor isu dalam deskripsi PR jika berkenaan ### Proses Semakan - PR disemak oleh penyelenggara dan komuniti -- Kejelasan pendidikan diutamakan -- Contoh kod harus mengikuti amalan terbaik semasa +- Kejelasan pendidikan diprioritikan +- Contoh kod harus mengikut amalan terbaik terkini - Terjemahan disemak untuk ketepatan dan kesesuaian budaya ## Sistem Terjemahan @@ -263,15 +263,15 @@ Sebelum menghantar PR: ### Terjemahan Automatik - Menggunakan GitHub Actions dengan aliran kerja co-op-translator -- Menterjemah ke lebih 50 bahasa secara automatik +- Menerjemah ke lebih 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 +3. Pastikan contoh kod kekal berfungsi 4. Uji sebarang kandungan kuiz yang dilokalkan ### Metadata Terjemahan @@ -289,56 +289,56 @@ CO_OP_TRANSLATOR_METADATA: --> ``` -## Penyahpepijatan dan Penyelesaian Masalah +## Penjejakan Ralat dan Penyelesaian Masalah ### Isu Biasa -**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 mula**: +- Semak versi Node.js (v14+ disyorkan) +- Padam `node_modules` dan `package-lock.json`, jalankan `npm install` semula +- Semak pertindihan port (lalai: Vite guna port 5173) -**Pelayan API tidak dapat dimulakan**: +**Server API tidak mula**: - Sahkan versi Node.js memenuhi minimum (node >=10) -- Periksa jika port sudah digunakan +- Semak jika port sudah digunakan - Pastikan semua kebergantungan dipasang dengan `npm install` -**Sambungan penyemak imbas tidak dapat dimuat**: +**Pelanjutan pelayar tidak dimuat**: - Sahkan manifest.json diformat dengan betul -- Periksa konsol penyemak imbas untuk ralat -- Ikuti arahan pemasangan sambungan khusus penyemak imbas +- Semak konsol pelayar untuk ralat +- Ikut arahan pemasangan pelanjutan khusus pelayar -**Isu projek chat Python**: +**Isu projek sembang Python**: - Pastikan pakej OpenAI dipasang: `pip install openai` -- Sahkan pembolehubah persekitaran GITHUB_TOKEN telah ditetapkan -- Periksa kebenaran akses GitHub Models +- Sahkan pembolehubah alam sekitar GITHUB_TOKEN ditetapkan +- Semak kebenaran akses GitHub Models -**Docsify tidak menyajikan dokumen**: +**Docsify tidak menyediakan dokumen**: - Pasang docsify-cli secara global: `npm install -g docsify-cli` - Jalankan dari direktori root repositori -- Periksa bahawa `docs/_sidebar.md` wujud +- Semak bahawa `docs/_sidebar.md` wujud -### Petua Persekitaran Pembangunan +### Tips Persekitaran Pembangunan - Gunakan VS Code dengan sambungan Live Server untuk projek HTML -- Pasang sambungan ESLint dan Prettier untuk format yang konsisten -- Gunakan DevTools penyemak imbas untuk penyahpepijatan JavaScript -- Untuk projek Vue, pasang sambungan Vue DevTools penyemak imbas +- 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 yang banyak (50+ bahasa) bermakna klon penuh besar +- Gunakan shallow clone jika hanya kerja kandungan: `git clone --depth 1` +- Kecualikan terjemahan dari carian apabila kerja kandungan Bahasa Inggeris +- Proses binaan mungkin perlahan pada kali pertama (npm install, binaan Vite) ## Pertimbangan Keselamatan -### Pembolehubah Persekitaran +### Pembolehubah Alam Sekitar -- 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 dimasukkan dalam repositori +- Gunakan fail `.env` (sudah disenaraikan dalam `.gitignore`) +- Dokumentasikan pembolehubah alam sekitar diperlukan dalam README projek ### Projek Python @@ -348,31 +348,31 @@ CO_OP_TRANSLATOR_METADATA: ### Akses GitHub Models -- 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 GitHub Models +- Token harus disimpan sebagai pembolehubah alam sekitar +- Jangan sekali-kali commit token atau kelayakan ## Nota Tambahan ### Sasaran Audiens -- Pemula sepenuhnya dalam pembangunan web +- Pemula sepenuhnya kepada pembangunan web - Pelajar dan pembelajar sendiri -- Guru yang menggunakan kurikulum dalam bilik darjah -- Kandungan direka untuk kebolehaksesan dan pembinaan kemahiran secara beransur-ansur +- Guru menggunakan kurikulum dalam bilik darjah +- Kandungan direka untuk aksesibilitas dan pembangunan kemahiran secara berperingkat ### Falsafah Pendidikan - Pendekatan pembelajaran berasaskan projek -- Pemeriksaan pengetahuan yang kerap (kuiz) -- Latihan pengekodan secara langsung +- Pemeriksaan pengetahuan kerap (kuiz) +- Latihan pengkodan praktikal - Contoh aplikasi dunia sebenar - Fokus pada asas sebelum kerangka kerja ### Penyelenggaraan Repositori - Komuniti pelajar dan penyumbang yang aktif -- Kemas kini berkala untuk kebergantungan dan kandungan +- Kemas kini kerap untuk kebergantungan dan kandungan - Isu dan perbincangan dipantau oleh penyelenggara - Kemas kini terjemahan automatik melalui GitHub Actions @@ -381,26 +381,28 @@ CO_OP_TRANSLATOR_METADATA: - [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 +- Kursus tambahan: AI Generatif, Sains Data, ML, kurikulum IoT tersedia -### Bekerja dengan Projek Khusus +### Bekerja dengan Projek Tertentu -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 pada projek individu, rujuk fail README di: +- `quiz-app/README.md` - aplikasi kuiz Vue 3 +- `7-bank-project/README.md` - aplikasi perbankan dengan pengesahan +- `5-browser-extension/README.md` - pembangunan pelanjutan pelayar +- `6-space-game/README.md` - pembangunan permainan berasaskan kanvas +- `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 +Walaupun bukan monorepo tradisional, repositori ini mengandungi beberapa projek berdikari: +- Setiap pelajaran berdiri sendiri - Projek tidak berkongsi kebergantungan - Bekerja pada projek individu tanpa menjejaskan yang lain -- Klon keseluruhan repositori untuk pengalaman kurikulum penuh +- 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 ambil maklum bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang sahih. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab 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..5b148ac9d 100644 --- a/translations/ms/README.md +++ b/translations/ms/README.md @@ -1,130 +1,129 @@ -[![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) +[![Lesen GitHub](https://img.shields.io/github/license/microsoft/Web-Dev-For-Beginners.svg)](https://github.com/microsoft/Web-Dev-For-Beginners/blob/master/LICENSE) +[![Penyumbang GitHub](https://img.shields.io/github/contributors/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/graphs/contributors/) +[![Isu GitHub](https://img.shields.io/github/issues/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/issues/) +[![Permintaan Tarik GitHub](https://img.shields.io/github/issues-pr/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/pulls/) +[![PRs Dialu-alukan](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/) +[![Pemerhati 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/) +[![Cabang 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/) +[![Bintang 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) # 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 menyeluruh selama 12 minggu oleh Pendukung Awan Microsoft. Setiap 24 pelajaran membawa anda menyelami JavaScript, CSS, dan HTML menerusi projek langsung seperti terarium, sambungan pelayar, dan permainan angkasa. Sertai dengan kuiz, perbincangan, dan tugasan praktikal. Tingkatkan kemahiran anda dan optimakan penyerapan 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-langkah ini untuk memulakan menggunakan sumber-sumber ini: +1. **Fork Repositori**: Klik [![Cabang 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. **Duplikat Repositori**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +3. [**Sertai Discord Azure AI Foundry dan temui pakar serta pembangun lain**](https://discord.com/invite/ByRwuEEgH4) ### 🌐 Sokongan Pelbagai Bahasa -#### Disokong melalui GitHub Action (Automatik & Sentiasa Dikemaskini) +#### Disokong melalui Tindakan GitHub (Automatik & Sentiasa Dikemaskini) -[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) +[Arab](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgaria](../bg/README.md) | [Burma (Myanmar)](../my/README.md) | [Cina (Ringkas)](../zh-CN/README.md) | [Cina (Tradisional, Hong Kong)](../zh-HK/README.md) | [Cina (Tradisional, Macau)](../zh-MO/README.md) | [Cina (Tradisional, Taiwan)](../zh-TW/README.md) | [Kroasia](../hr/README.md) | [Ceko](../cs/README.md) | [Denmark](../da/README.md) | [Belanda](../nl/README.md) | [Estonia](../et/README.md) | [Finland](../fi/README.md) | [Perancis](../fr/README.md) | [Jerman](../de/README.md) | [Yunani](../el/README.md) | [Ibrani](../he/README.md) | [Hindi](../hi/README.md) | [Hungary](../hu/README.md) | [Indonesia](../id/README.md) | [Itali](../it/README.md) | [Jepun](../ja/README.md) | [Kannada](../kn/README.md) | [Korea](../ko/README.md) | [Lithuania](../lt/README.md) | [Melayu](./README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Pidgin Nigeria](../pcm/README.md) | [Norway](../no/README.md) | [Parsi (Farsi)](../fa/README.md) | [Poland](../pl/README.md) | [Portugis (Brazil)](../pt-BR/README.md) | [Portugis (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romania](../ro/README.md) | [Rusia](../ru/README.md) | [Serbia (Sirilik)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenia](../sl/README.md) | [Sepanyol](../es/README.md) | [Swahili](../sw/README.md) | [Sweden](../sv/README.md) | [Tagalog (Filipina)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turki](../tr/README.md) | [Ukraine](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnam](../vi/README.md) -> **Lebih Suka Melakukan Klon secara Tempatan?** +> **Lebih suka Duplikat 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 termasuk lebih 50 terjemahan bahasa yang secara ketara meningkatkan saiz muat turun. Untuk duplikat 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 jauh 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 menyokong bahasa terjemahan tambahan, senarai disediakan [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) +[![Buka di 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?_ +#### 🧑‍🎓 _Adakah anda 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 Pusat Pelajar**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) di mana anda akan menemui sumber pemula, pek Pelajar dan juga cara mendapatkan baucar sijil percuma. Ini adalah halaman yang anda mahu tandai dan periksa dari semasa ke semasa kerana kami menukar kandungan setiap bulan. -### 📣 Pengumuman - Cabaran Mod Ejen GitHub Copilot baru untuk diselesaikan! +### 📣 Pengumuman - Cabaran Mod Ejen GitHub Copilot Baharu untuk diselesaikan! -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 baharu ditambah, cari "Cabaran Ejen GitHub Copilot 🚀" dalam kebanyakan bab. Itu adalah cabaran baharu untuk anda lengkapkan menggunakan GitHub Copilot dan mod Ejen. Jika anda belum pernah menggunakan mod Ejen sebelum ini, ia mampu bukan sahaja menjana teks tetapi juga boleh membuat dan mengedit fail, menjalankan perintah dan banyak lagi. -### 📣 Pengumuman - _Projek Baru untuk dibina menggunakan Generative AI_ +### 📣 Pengumuman - _Projek Baharu untuk dibina menggunakan AI Generatif_ -Projek Pembantu AI baru sahaja ditambah, lihat [projek](./9-chat-project/README.md) +Projek Pembantu AI baharu baru sahaja ditambah, semak [projek](./9-chat-project/README.md) -### 📣 Pengumuman - _Kurikulum Baru_ untuk Generative AI bagi JavaScript baru sahaja dikeluarkan +### 📣 Pengumuman - _Kurikulum Baharu_ mengenai AI Generatif untuk JavaScript baru sahaja dikeluarkan -Jangan terlepas kurikulum Generative AI baru kami! +Jangan ketinggalan kurikulum AI Generatif 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 memulakan! -![Background](../../translated_images/ms/background.148a8d43afde5730.webp) +![Latar belakang](../../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-galanya dari asas ke RAG. +- Berinteraksi dengan watak sejarah menggunakan GenAI dan aplikasi pendamping kami. +- Naratif yang menyeronokkan dan menarik, anda akan melakukan perjalanan masa! -![character](../../translated_images/ms/character.5c0dd8e067ffd693.webp) +![watak](../../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 diselesaikan, pemeriksaan pengetahuan dan cabaran untuk membimbing anda mempelajari topik seperti: +- Pemberian arahan dan kejuruteraan arahan +- Penjanaan aplikasi teks dan imej - 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 memulakan! -## 🌱 Mula Bermula +## 🌱 Memulakan -> **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 [menyediakan beberapa cadangan](for-teachers.md) mengenai 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)! -**[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 prakuliah dan teruskan dengan membaca bahan kuliah, melengkapkan pelbagai aktiviti dan periksa pemahaman anda dengan kuiz pascakuliah. -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 memperkayakan pengalaman pembelajaran anda, berhubung dengan rakan sekelas untuk bekerjasama dalam projek-projek! Perbincangan digalakkan di [forum perbincangan kami](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) 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 pembelajaran 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 siap digunakan! Semasa anda bermula, anda boleh memilih untuk menjalankan kurikulum dalam [Codespace](https://github.com/features/codespaces/) (_persekitaran berasaskan pelayar tanpa perlu pemasangan_), atau secara tempatan pada 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, disarankan agar anda membuat salinan repositori ini. 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-langkah ini: +1. **Fork Repositori**: Klik butang "Fork" di penjuru kanan atas halaman ini. +2. **Duplikat 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 membuat Codespace baru untuk anda bekerja. ![Codespace](../../translated_images/ms/createcodespace.0238bbf4d7a8d955.webp) -#### Menjalankan kurikulum secara tempatan di komputer anda +#### Menjalankan kurikulum secara tempatan pada 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 pada komputer anda, anda memerlukan penyunting teks, pelayar web dan alat baris perintah. Pelajaran pertama kami, [Pengenalan kepada Bahasa Pengaturcaraan dan Alatan Perdagangan](../../1-getting-started-lessons/1-intro-to-programming-languages), akan memandu anda melalui pelbagai pilihan untuk setiap alat 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 penyunting, 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). -1. Klon repositori anda ke komputer anda. Anda boleh melakukannya dengan mengklik butang **Code** dan menyalin URL: +1. Duplikat repositori anda ke komputer anda. Anda boleh lakukan ini 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 arahan berikut, menggantikan `` 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 melakukannya dengan mengklik **File** > **Open Folder** dan memilih folder yang baru anda klon. > Sambungan Visual Studio Code yang disyorkan: @@ -132,78 +131,78 @@ Cadangan kami adalah menggunakan [Visual Studio Code](https://code.visualstudio. > * [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 -## 📂 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 - 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, sebanyak 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 dideploy ke Azure; ikut 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 Berpaut | Pengarang | +| :-: | :------------------------------------------------------: | :--------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :------------------------: | +| 01 | Memulakan | Pengenalan kepada Pengaturcaraan dan Alat Perdagangan | Pelajari asas-asas di sebalik kebanyakan bahasa pengaturcaraan dan tentang perisian yang membantu pembangun profesional melakukan kerja mereka | [Pengenalan kepada Bahasa Pengaturcaraan dan Alat Perdagangan](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | +| 02 | Memulakan | Asas GitHub, termasuk bekerjasama dalam satu pasukan | Cara menggunakan GitHub dalam projek anda, cara berkolaborasi dengan orang lain pada pangkalan 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 menguruskan 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 mencipta syarat dalam kod anda menggunakan kaedah membuat keputusan | [Membuat Keputusan](./2-js-basics/3-making-decisions/README.md) | Jasmine | +| 07 | Asas JS | Tatasusunan dan Gelung | Bekerja dengan data menggunakan tatasusunan dan gelung dalam JavaScript | [Tatasusunan dan Gelung](./2-js-basics/4-arrays-loops/README.md) | Jasmine | +| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTML dalam Amalan | Bina HTML untuk mencipta terrarium dalam talian, menumpukan pada pembinaan 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 menggayakan 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 | Bina JavaScript untuk menjadikan terrarium berfungsi sebagai antara muka seret/lepas, menumpukan pada penutupan dan manipulasi DOM | [Penutupan JavaScript, manipulasi DOM](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen | +| 11 | [Permainan Mengetik](./4-typing-game/solution/README.md) | Bina Permainan Mengetik | Pelajari cara menggunakan acara papan kekunci untuk menggerakkan logik aplikasi JavaScript anda | [Pengaturcaraan Berpandukan 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) | Membangun borang, menghubungi API dan menyimpan pemboleh ubah dalam penyimpanan tempatan | Bina elemen JavaScript bagi sambungan pelayar anda untuk memanggil API menggunakan pemboleh ubah yang disimpan dalam penyimpanan tempatan | [API, Borang, dan Penyimpanan 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 menjadikan | [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 Lebih Lanjut dengan JavaScript | Pelajari tentang Pewarisan menggunakan 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 ke kanvas | Pelajari tentang API Canvas, digunakan untuk melukis elemen ke skrin | [Melukis ke Kanvas](./6-space-game/2-drawing-to-canvas/README.md) | Chris | +| 17 | [Permainan Angkasa](./6-space-game/solution/README.md) | Memindahkan elemen di sekitar skrin | Temui bagaimana elemen boleh bergerak menggunakan koordinat kartesian dan API Canvas | [Memindahkan Elemen](./6-space-game/3-moving-elements-around/README.md) | Chris | +| 18 | [Permainan Angkasa](./6-space-game/solution/README.md) | Pengesanan pelanggaran | Membuat elemen berlanggar dan bertindak balas antara satu sama lain menggunakan kekunci dan menyediakan fungsi cooldown untuk memastikan prestasi permainan | [Pengesanan Pelanggaran](./6-space-game/4-collision-detection/README.md) | Chris | +| 19 | [Permainan Angkasa](./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 | [Permainan Angkasa](./6-space-game/solution/README.md) | Mengakhiri dan memulakan semula permainan | Pelajari tentang cara mengakhiri dan memulakan semula permainan, termasuk pembersihan aset dan menetapkan semula nilai pemboleh ubah | [Keadaan Akhir](./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 mencipta rangka kerja arkitektur laman web berbilang halaman menggunakan penghalaan 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 Mengambil dan Menggunakan Data | Bagaimana data mengalir masuk dan keluar dari aplikasi anda, bagaimana untuk mengambil, menyimpan, dan membuangnya | [Data](./7-bank-project/3-data/README.md) | Yohan | +| 24 | [Aplikasi Perbankan](./7-bank-project/solution/README.md) | Konsep Pengurusan Negara | Pelajari cara aplikasi anda mengekalkan keadaan dan cara menguruskannya secara program | [Pengurusan Negara](./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 berkala -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 masa kini. Pelajar akan berpeluang membangunkan pengalaman praktikal dengan membina permainan menaip, terrarium maya, sambungan pelayar mesra alam, permainan gaya penyerang angkasa, dan aplikasi perbankan untuk perniagaan. Menjelang akhir siri, pelajar akan memperoleh pemahaman yang kukuh mengenai 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! +> 🎓 Anda boleh mengambil beberapa pelajaran pertama dalam kurikulum ini sebagai [Jalan 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 ini menjadi lebih menarik untuk pelajar dan pengingatan konsep akan dipertingkatkan. Kami juga menulis beberapa pelajaran permulaan dalam asas JavaScript untuk memperkenalkan konsep, dipadankan dengan video dari koleksi tutorial video "[Siri untuk Pemula kepada: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)", 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 belajar topik tertentu, manakala kuiz kedua selepas kelas memastikan pengingatan lanjutan. Kurikulum ini direka untuk menjadi fleksibel dan menyeronokkan serta boleh diambil sepenuhnya atau sebahagiannya. Projek bermula kecil dan menjadi semakin kompleks menjelang akhir kitaran 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 mengelak memperkenalkan rangka kerja JavaScript untuk menumpukan pada kemahiran asas yang diperlukan sebagai pembangun web sebelum mengadopsi rangka kerja, langkah seterusnya yang baik untuk melengkapkan kurikulum ini adalah belajar tentang Node.js melalui koleksi video lain: "[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 +## 🧭 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/#/). Gandingkan 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 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 semua pelajaran boleh didapati [di sini](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf). ## 🎒 Kursus Lain @@ -213,10 +212,10 @@ Pasukan kami menghasilkan kursus lain! Lihat: ### 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 / Ejen [![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 +231,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 +248,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 pembangun berpengalaman dalam perbincangan tentang 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 ralat 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) @@ -266,6 +265,6 @@ 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. +**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 sahih. Untuk maklumat penting, terjemahan profesional oleh manusia adalah digalakkan. Kami tidak bertanggungjawab atas sebarang salah faham atau tafsiran yang salah 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..60467b9f0 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-06T09:37:31+00:00", "source_file": "AGENTS.md", "language_code": "sw" }, @@ -516,8 +516,8 @@ "language_code": "sw" }, "README.md": { - "original_hash": "490c83786552d7fab6390991517bef09", - "translation_date": "2026-01-29T18:55:31+00:00", + "original_hash": "805cd399757df19e886e86f0891a1374", + "translation_date": "2026-02-06T09:33:39+00:00", "source_file": "README.md", "language_code": "sw" }, diff --git a/translations/sw/AGENTS.md b/translations/sw/AGENTS.md index a5e1a50cc..a65abe844 100644 --- a/translations/sw/AGENTS.md +++ b/translations/sw/AGENTS.md @@ -2,29 +2,29 @@ ## 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 hazina ya mtaala wa elimu kwa kufundisha misingi ya maendeleo ya wavuti kwa wanaoanza. Mtaala huu ni kozi kamili ya wiki 12 iliyotengenezwa na Microsoft Cloud Advocates, ikijumuisha masomo 24 ya vitendo yanayohusu 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 +- **Maudhui ya Elimu**: Masomo 24 yaliyopangwa katika moduli za mradi +- **Miradi ya Vitendo**: Terrarium, Mchezo wa Kuandika, Ongezaji la Kivinjari, Mchezo wa Anga, Programu ya Benki, Mhariri wa Msimbo, na Msaidizi wa Mazungumzo ya AI +- **Maswali ya Kuchunguza**: Maswali 48 yenye maswali 3 kila moja (tathmini kabla/baada ya somo) +- **Msaada wa Lugha Nyingi**: Tafsiri za moja kwa moja 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 +- Hazina ya elimu yenye muundo wa masomo +- Kila folda ya somo ina README, mifano ya msimbo, na suluhisho - Miradi huru katika saraka tofauti (quiz-app, miradi mbalimbali ya somo) -- Mfumo wa tafsiri ukitumia GitHub Actions (co-op-translator) +- Mfumo wa utafsiri unatumia GitHub Actions (co-op-translator) - Nyaraka zinatolewa kupitia Docsify na zinapatikana kama PDF ## Amri za Usanidi -Hifadhi hii ni hasa kwa ajili ya matumizi ya yaliyomo ya elimu. Kwa kufanya kazi na miradi maalum: +Hazina hii ni kwa matumizi ya maudhui ya elimu hasa. Kwa kufanya kazi na miradi maalum: -### Usanidi wa Hifadhi Kuu +### Usanidi Mkuu wa Hazina ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git @@ -36,9 +36,9 @@ cd Web-Dev-For-Beginners ```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,17 +46,17 @@ 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 # Fomati kwa Prettier ``` -### Miradi ya Kiendelezi cha Kivinjari +### Miradi ya Ongezaji la Kivinjari ```bash cd 5-browser-extension/solution npm install -# Follow browser-specific extension loading instructions +# Fuata maagizo ya kupakia nyongeza 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 Seva ya Moja kwa Moja ``` -### Mradi wa Gumzo (Python Backend) +### Mradi wa Mazungumzo (Python Sehemu ya Backend) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Set GITHUB_TOKEN environment variable +# Weka kigezo cha mazingira cha GITHUB_TOKEN python api.py ``` -## Mtiririko wa Maendeleo +## Mchakato 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. **Fokea hazina** kwenye akaunti yako ya GitHub +2. **Nakili fokea yako** ndani ya kompyuta +3. **Tengeneza tawi jipya** kwa mabadiliko yako +4. Fanya mabadiliko kwa maudhui ya somo au mifano ya msimbo +5. Jaribu mabadiliko yoyote ya msimbo katika saraka husika za miradi +6. Tuma maombi ya kuunganisha kufuata miongozo ya mchango ### Kwa Wanafunzi -1. Fork au clone hifadhi -2. Tembelea saraka za masomo kwa utaratibu +1. Fokea au nakili hazina +2. Pitia saraka za masomo moja baada ya nyingine 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 +4. Kamilisha maswali kabla ya somo kwenye https://ff-quizzes.netlify.app/web/ +5. Fanya kazi kupitia mifano ya msimbo katika folda za somo 6. Kamilisha kazi na changamoto -7. Fanya maswali ya baada ya somo +7. Fanya maswali baada ya somo -### Maendeleo ya Moja kwa Moja +### Maendeleo 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**: Tumia ugani wa VS Code Live Server kwa miradi ya HTML - **Miradi ya API**: Endesha `npm start` kwenye saraka husika za API -## Maelekezo ya Kupima +## Maelekezo ya Upimaji ### Upimaji wa Programu ya Maswali ```bash cd quiz-app -npm run lint # Check for code style issues -npm run build # Verify build succeeds +npm run lint # Angalia kwa masuala ya mtindo wa msimbo +npm run build # Thibitisha kuwa ujenzi unafaulu ``` ### 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 masuala ya mtindo wa msimbo +node server.js # Thibitisha server inaanza bila makosa ``` -### Njia ya Jumla ya Upimaji +### Mbinu ya Upimaji kwa Ujumla -- Hii ni hifadhi ya elimu bila majaribio ya kiotomatiki ya kina -- Upimaji wa mikono unalenga: - - Mifano ya nambari inaendeshwa bila makosa +- Hii ni hazina ya elimu isiyo na majaribio ya kiotomatiki kamili +- Upimaji wa mikono unazingatia: + - Mifano ya msimbo inaendeshwa bila makosa - Viungo katika nyaraka vinafanya kazi ipasavyo - - Ujenzi wa mradi unakamilika kwa mafanikio + - Ujenzi wa mradi hufanikiwa vizuri - Mifano inafuata mbinu bora ### Ukaguzi 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 +- Hakiki viungo vya markdown ni halali +- Jaribu mifano ya msimbo kwenye kivinjari au Node.js +- Hakiki kuwa tafsiri zinatunza muundo sahihi -## 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 +- Tumia sintaksia ya kisasa ES6+ +- Fuata usanidi wa ESLint uliotolewa katika miradi +- Tumia majina ya maana kwa toleo na kazi kwa uwazi wa elimu +- Ongeza maelezo ya kufafanua dhana kwa wanafunzi +- Tunga msimbo kwa kutumia Prettier pale inapobidi ### 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 +- Vipengele vya HTML5 vya kihisia +- Kanuni za muundo unaojibadilisha +- Vigezo vya wazi vya majina ya darasa +- Maelezo ya njia za CSS kwa walimu na wanafunzi ### Python - Miongozo ya mtindo wa PEP 8 -- Mifano ya nambari iliyo wazi na ya kielimu -- Vidokezo vya aina pale vinaposaidia kujifunza +- Mifano ya msimbo wazi na ya kielimu +- Mawazo ya aina mahali panaposaidia kujifunza ### Nyaraka za Markdown -- Hierarkia ya wazi ya vichwa -- Vitalu vya nambari vilivyo na maelezo ya lugha +- Mpangilio wazi wa vichwa vya habari +- Bloksi za msimbo zenye lugha iliyoelezwa - Viungo kwa rasilimali za ziada -- Picha na michoro katika saraka za `images/` -- Maandishi mbadala kwa picha kwa upatikanaji +- Picha na skrini katika saraka `images/` +- Matini za alt kwa picha kwa upatikanaji -### Mpangilio wa Faili +### Muundo 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 -- Tafsiri katika muundo wa `translations/{language-code}/` +- Masomo yamepangwa nambari kwa mfuatano (1-getting-started-lessons, 2-js-basics, nk.) +- Kila mradi una saraka za `solution/` na mara nyingi `start/` au `your-work/` +- Picha zimetunzwa katika folda maalum za `images/` kwa somo +- Tafsiri ziko katika muundo wa `translations/{language-code}/` -## Ujenzi na Upelekaji +## Ujenzi na Uenezaji -### Upelekaji wa Programu ya Maswali (Azure Static Web Apps) +### Uenezaji wa Programu ya Maswali (Azure Static Web Apps) -Programu ya quiz-app imewekwa kwa ajili ya upelekaji wa Azure Static Web Apps: +Programu ya maswali imepangwa kwa ajili ya 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` -- **Mahali pa Matokeo**: `dist` -- **Mtiririko wa Kazi**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` +Mpangilio wa Azure Static Web Apps: +- **Mahali pa programu**: `/quiz-app` +- **Mahali pa matokeo**: `dist` +- **Mchakato 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 # Sakinisha 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 kiwango cha kimataifa +docsify serve # Hudumia kwenye localhost:3000 ``` -### Ujenzi Maalum wa Mradi +### Ujenzi wa Miradi Maalum Kila saraka 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 Vue: `npm run build` huvuta vifurushi kwa uzalishaji +- Miradi ya hatua zisizobadilika: Hakuna hatua ya ujenzi, hudumisha faili moja kwa moja -## Miongozo ya Maombi ya Kuvuta +## Miongozo ya Maombi ya Kuunganisha -### Muundo wa Kichwa +### Mtindo 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` +Tumia vichwa wazi na vinavyoeleza eneo la mabadiliko: +- `[Quiz-app] Ongeza swali jipya kwa somo X` +- `[Lesson-3] Rekebisha makosa ya tahajia katika mradi wa terrarium` +- `[Translation] Ongeza tafsiri ya Kihispania kwa somo 5` - `[Docs] Sasisha maelekezo ya usanidi` -### Ukaguzi Unaohitajika +### Ukaguzi Inayohitajika 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 saraka zilizoathirika + - 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` kama inahitajika - Hakikisha hakuna makosa ya ujenzi -3. **Uthibitishaji wa Viungo**: +3. **Uhakiki wa Viungo**: - Jaribu viungo vyote vya markdown - - Hakikisha marejeleo ya picha yanafanya kazi + - Hakiki rejea za picha zinafanya kazi -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 makini tahajia na sarufi + - Hakikisha mifano ya msimbo ni sahihi na ya kielimu + - Hakiki tafsiri zinatunza maana asili ### Mahitaji ya Mchango -- 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 +- Kubali Microsoft CLA (ukaguzi wa moja kwa moja kwenye PR ya kwanza) +- Fuata [Kanuni ya Maadili ya Chanzo Huria ya Microsoft](https://opensource.microsoft.com/codeofconduct/) +- Soma [CONTRIBUTING.md](./CONTRIBUTING.md) kwa miongozo ya kina +- Taja namba za masuala katika maelezo ya PR inapowezekana -### Mchakato wa Mapitio +### Mchakato wa Ukaguzi -- 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 unazingatiwa zaidi +- Mifano ya msimbo inapaswa kufuata mbinu bora za sasa +- Tafsiri hupitiwa kwa usahihi na utofauti wa kitamaduni -## Mfumo wa Tafsiri +## Mfumo wa Utafsiri -### Tafsiri ya Kiotomatiki +### Utafsiri wa Moja kwa Moja -- 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 kwa mtiririko wa co-op-translator +- Hutatiliza tafsiri kwa lugha 50+ moja kwa moja +- Faili za chanzo ziko katika saraka kuu +- Faili za tafsiri ziko katika saraka za `translations/{language-code}/` -### Kuongeza Maboresho ya Tafsiri ya Mwongozo +### Kuongeza Maboresho ya Utafsiri kwa Mkono -1. Tafuta faili katika `translations/{language-code}/` +1. Pata faili ndani ya `translations/{language-code}/` 2. Fanya maboresho huku ukidumisha muundo -3. Hakikisha mifano ya nambari inabaki kufanya kazi -4. Jaribu maudhui yoyote ya maswali yaliyotafsiriwa +3. Hakikisha mifano ya msimbo bado inafanya kazi +4. Jaribu maudhui yaliyotafsiriwa ya maswali yoyote -### Metadata ya Tafsiri +### Metadata ya Utafsiri -Faili zilizotafsiriwa zinajumuisha kichwa cha metadata: +Faili zilizotafsiriwa zina kichwa cha metadata: ```markdown ``` -## Usuluhishi wa Hitilafu na Utatuzi +## Utatuzi na Urekebishaji -### Masuala ya Kawaida +### Masuala Yanayojitokeza Mara kwa Mara **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) +- Kagua toleo la Node.js (v14+ inapendekezwa) +- Futa `node_modules` na `package-lock.json`, endesha `npm install` tena +- Angalia migongano ya bandari (kawaida: Vite hutumia bandari 5173) **Seva ya API haianzi**: -- Hakikisha toleo la Node.js linakidhi kiwango cha chini (node >=10) +- Thibitisha toleo la Node.js linakidhi (node >=10) - Angalia kama bandari tayari inatumika -- Hakikisha utegemezi wote umewekwa na `npm install` +- Hakikisha viongezi vyote vimewekwa kwa `npm install` -**Kiendelezi cha kivinjari hakipakii**: -- Hakikisha manifest.json imeundwa ipasavyo +**Ongezaji la kivinjari halipatiki**: +- Hakiki kuwa manifest.json imeandikwa ipasavyo - Angalia makosa kwenye console ya kivinjari -- Fuata maelekezo maalum ya usakinishaji wa kiendelezi cha kivinjari +- Fuata maelekezo ya usakinishaji wa ongezaji kwa kivinjari husika -**Masuala ya mradi wa gumzo la Python**: +**Masuala ya mradi wa mazungumzo wa Python**: - Hakikisha kifurushi cha OpenAI kimewekwa: `pip install openai` -- Hakikisha mazingira ya GITHUB_TOKEN yamewekwa -- Angalia ruhusa za ufikiaji wa GitHub Models +- Hakiki kuwa GITHUB_TOKEN imewekwa katika mazingira +- Angalia ruhusa za GitHub Models -**Docsify haifanyi kazi**: -- Sakinisha docsify-cli kimataifa: `npm install -g docsify-cli` -- Endesha kutoka kwenye saraka ya mzizi ya hifadhi -- Hakikisha `docs/_sidebar.md` ipo +**Docsify haionyeshi nyaraka**: +- Sakinisha docsify-cli duniani kote: `npm install -g docsify-cli` +- Endesha kutoka na saraka kuu ya hazina +- Hakiki kuwa `docs/_sidebar.md` ipo ### 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 na ugani wa Live Server kwa miradi ya HTML +- Sakinisha ugani wa ESLint na Prettier kwa muundo thabiti +- Tumia DevTools za kivinjari kwa kurekebisha JavaScript +- Kwa miradi ya Vue, sakinisha ugani wa Vue DevTools kwa kivinjari -### Mazingatio ya Utendaji +### Mambo ya Kuzingatia Kuhusu 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+) huleta nakala kubwa +- Tumia nakala finyu ikiwa unafanya kazi tu na maudhui: `git clone --depth 1` +- Zuia tafsiri kutoka kwenye utafutaji unapoangalia maudhui ya Kiingereza +- Mchakato wa ujenzi unaweza kuwa polepole mwanzoni (npm install, ujenzi wa Vite) -## Mazingatio ya Usalama +## Mambo ya Usalama -### Vigezo vya Mazingira +### Mabadiliko ya 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 hazina +- Tumia faili za `.env` (ziko tayari `.gitignore`) +- Andika mabadiliko ya mazingira yanayohitajika 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 kubuni ya virtual: `python -m venv venv` +- Sasisha viongezi mara kwa mara +- Tokeni za GitHub zipate ruhusa ndogo tu zinazohitajika -### Ufikiaji wa GitHub Models +### Kupata 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 za Kufikia Kibinafsi (PAT) zinahitajika kwa GitHub Models +- Tokeni ziwe kwenye mabadiliko ya mazingira +- Kamwe usiweka tokeni au nywila katika hazina -## Vidokezo vya Ziada +## Vidokezo Zaidi -### Watazamaji Wanaolengwa +### Walengwa -- Wanaoanza kabisa katika maendeleo ya wavuti -- Wanafunzi na wanaojifunza wenyewe +- Waanzilishi wa maendeleo ya wavuti +- Wanafunzi na kujifunza kwa kujitegemea - Walimu wanaotumia mtaala darasani -- Yaliyomo yameundwa kwa upatikanaji na ujenzi wa ujuzi wa hatua kwa hatua +- Maudhui yamebuniwa kwa upatikanaji na hatua za kujifunza polepole ### 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 +- Mbinu ya kujifunza kwa mradi +- Dharura za maarifa mara kwa mara (maswali) +- Mazoezi ya kufanyia kazi kwa mikono +- Mifano halisi ya matumizi +- Kuzingatia misingi kabla ya mfumo wa kazi -### Matengenezo ya Hifadhi +### Matunzo ya Hazina - 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 +- Sasisho za mara kwa mara za viongezi na maudhui +- Masuala na majadiliano hupitiwa na wasimamizi +- Sasisho za tafsiri zinafanywa moja kwa moja kupitia GitHub Actions ### Rasilimali Zinazohusiana -- [Moduli za Microsoft Learn](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 +- [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) inayopendekezwa kwa wanafunzi +- Kozi za ziada: AI ya Kizazi, Sayansi ya Data, ML, na mtaala wa IoT zinapatikana -### Kufanya Kazi na Miradi Mahususi +### Kufanya Kazi na Miradi Maalum -Kwa maelekezo ya kina juu ya miradi ya mtu binafsi, rejelea faili za README katika: +Kwa maelekezo ya kina kuhusu miradi binafsi, rejea faili za README katika: - `quiz-app/README.md` - Programu ya maswali 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 +- `5-browser-extension/README.md` - Maendeleo ya ongezaji la kivinjari +- `6-space-game/README.md` - Maendeleo ya mchezo wa Canvas +- `9-chat-project/README.md` - Mradi wa msaidizi wa mazungumzo wa AI ### Muundo wa Monorepo -Ingawa si monorepo ya jadi, hifadhi hii ina miradi huru mingi: -- Kila somo ni huru -- Miradi haishiriki utegemezi -- Fanya kazi kwenye miradi ya mtu binafsi bila kuathiri mingine -- Clone hifadhi nzima kwa uzoefu kamili wa mtaala +Ingawa si monorepo ya kawaida, hazina hii ina miradi huru mbalimbali: +- Kila somo ni huru mwenyewe +- Miradi haiungiwi kwa viongezi vya kawaida +- Fanya kazi kwenye miradi binafsi bila kuathiri mingine +- Nakili hazina 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 + +**Angalizo**: +Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au upungufu wa usahihi. Hati ya asili kwa lugha yake ya asili inapaswa kuzingatiwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu na binadamu inapendekezwa. Hatubeba dhamana kwa maelewano au tafsiri potofu 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..186350075 100644 --- a/translations/sw/README.md +++ b/translations/sw/README.md @@ -10,71 +10,71 @@ [![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 kamilifu ya wiki 12 iliyotolewa na Microsoft Cloud Advocates. Kila somo kati ya 24 linachambua JavaScript, CSS, na HTML kupitia miradi ya vitendo kama vile terrariums, virutubisho vya kivinjari, na michezo ya anga. Shirikiana na maswali ya kujitathmini, majadiliano, na kazi za vitendo. Boresha ujuzi wako na kuongeza uhifadhi wa maarifa yako kwa njia yetu bora ya kufundisha kwa msingi wa miradi. Anza safari yako ya kuandika programu leo! Jiunge na Jamii ya Azure AI Foundry Discord [![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) -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) +1. **Fanya Nakala ya Hifadhi ya Bidhaa**: 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) +2. **Nakili Hifadhi ya Bidhaa**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +3. [**Jiunge na Azure AI Foundry Discord na ukutane na wataalamu na wapenzi wenzao 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) +#### Imeungwa mkono kupitia Hatua za GitHub (Kiotomatiki & Hadi mara kwa mara) [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) -> **Unapendelea Nakili Mahali pa Mitaa?** +> **Unapendelea Nakili kwa Eneo?** -> Hifadhi hii ina tafsiri za lugha zaidi ya 50 ambazo huongeza sana ukubwa wa kupakua. Ili nakili bila tafsiri, tumia sparse checkout: +> Hifadhi ya bidhaa hii ina tafsiri zaidi ya lugha 50 ambayo huongeza kwa kiasi kikubwa 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 kukamilisha kozi kwa upakuaji wa 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)** +**Kama unataka kuwa na lugha za ziada za tafsiri zinazoungwa mkono ziko [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) #### 🧑‍🎓 _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 za waanzilishi, pakiti za Wanafunzi na hata njia za kupata vocha ya cheti bure. Huu ni ukurasa ambao unapaswa kuuweka alama na kuangalia mara kwa mara kadri tunavyobadilisha maudhui kila mwezi. -### 📣 Tangazo - Changamoto mpya za Mode ya GitHub Copilot Agent za kukamilisha! +### 📣 Taarifa - Changamoto mpya za Mode ya Wakala wa GitHub Copilot 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 "GitHub Copilot Agent Challenge 🚀" katika sura nyingi. Hiyo ni changamoto mpya ambayo unapaswa kukamilisha kwa kutumia GitHub Copilot na Mode ya Wakala. Ikiwa hujawahi kutumia Mode ya Wakala awali, inaweza si tu kutengeneza ujumbe bali pia kuunda na kuhariri faili, kuendesha amri na zaidi. -### 📣 Tangazo - _Mradi Mpya wa Kujenga ukitumia AI ya Kizazi_ +### 📣 Taarifa - _Mradi Mpya wa Kujenga kwa kutumia AI Inayotengeneza_ -Mradi mpya wa Msaidizi wa AI umeongezwa hivi karibuni, angalia [mradi](./9-chat-project/README.md) +Mradi mpya wa Msaidizi wa AI umeongezwa, angalia [mradi](./9-chat-project/README.md) -### 📣 Tangazo - _Mtaala Mpya_ juu ya AI ya Kizazi kwa JavaScript umeachiliwa hivi karibuni +### 📣 Taarifa - _Mtaala Mpya_ juu ya AI Inayotengeneza kwa JavaScript umetolewa hivi karibuni -Usikose mtaala wetu mpya wa AI ya kizazi! +Usikose mtaala wetu mpya wa AI Inayotengeneza! 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 yanayohusisha kila kitu kutoka msingi hadi RAG. +- Shirikiana na wahusika wa kihistoria kwa kutumia GenAI na programu yetu ya mshirika. +- Hadithi ya kufurahisha na yenye ushawishi, 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 -- Uundaji wa programu za maandishi na picha +Kila somo linajumuisha kazi ya kukamilisha, mtihani wa maarifa na changamoto ya kukuongoza kujifunza mada kama: +- Kutoa maelekezo na uhandisi wa maelekezo +- Kutengeneza programu za maandishi na picha - Programu za utafutaji Tembelea [https://aka.ms/genai-js-course](../../[https:/aka.ms/genai-js-course) kuanza! @@ -83,123 +83,122 @@ Tembelea [https://aka.ms/genai-js-course](../../[https:/aka.ms/genai-js-course) ## 🌱 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](for-teachers.md) juu ya jinsi ya kutumia mtaala huu. Tunathamini maoni yako [katika jukwaa letu la majadiliano](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. +**[Wanafunzi](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**, kwa kila somo, anza kwa mtihani wa kabla ya duru na fuata kwa kusoma maudhui ya duru, kukamilisha shughuli mbalimbali na angalia uelewa wako kwa mtihani wa baada ya duru. -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 kuongeza uzoefu wako wa kujifunza, ungana na wenzao kufanya miradi pamoja! Majadiliano yanahimizwa katika [jukwaa letu la majadiliano](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 masomo. -### 📋 Kuweka mazingira yako +### 📋 Kuandaa 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! Unapoanza unaweza kuchagua kuendesha mtaala huu katika [Codespace](https://github.com/features/codespaces/) (_mazingira ya kivinjari, yasiyo na haja ya usakinishaji_), au eneo kwenye kompyuta yako kwa kutumia 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 ya bidhaa +Ili uhifadhi kazi yako kwa urahisi, inashauriwa utengeneze nakala yako ya hifadhi ya bidhaa hii. Unaweza kufanya hivi kwa kubonyeza kitufe cha **Use this template** juu ya ukurasa huu. Hii itaunda hifadhi mpya ndani ya akaunti yako ya GitHub na nakala ya mtaala huu. Fuata hatua hizi: -1. **Fungua Nakala**: Bonyeza kitufe cha "Fork" juu-kulia wa ukurasa huu. -2. **Nakili Hifadhi**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +1. **Fanya Nakala ya Hifadhi ya Bidhaa**: Bonyeza kitufe cha "Fork" upande wa juu kulia wa ukurasa huu. +2. **Nakili Hifadhi ya Bidhaa**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` #### Kuendesha mtaala 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 ya bidhaa uliyotengeneza, bonyeza kitufe cha **Code** na chagua **Open with Codespaces**. Hii itaunda Codespace mpya kwa ajili yako kufanya kazi. ![Codespace](../../translated_images/sw/createcodespace.0238bbf4d7a8d955.webp) -#### Kuendesha mtaala ndani ya kompyuta yako +#### Kuendesha mtaala huu eneo la kompyuta yako -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 eneo la kompyuta, utahitaji mhariri wa maandishi, kivinjari na zana ya mstari wa amri. Somo letu la kwanza, [Utangulizi wa Lugha za Programu na Vyombo vya Biashara](../../1-getting-started-lessons/1-intro-to-programming-languages), litakuongoza katika chaguzi mbalimbali za kila moja ya zana hizi ili uchague kinachokufaa wewe. -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, ambayo pia ina [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) iliyo jumuishwa. 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 ya bidhaa hadi kwenye kompyuta yako. Unaweza kufanya hivi 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 uliyo katuwa hivi karibuni: ```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 katika Visual Studio Code. Unaweza kufanya hivyo kwa kubofya **File** > **Open Folder** na kuchagua folda uliyokwama hivi karibuni. -> Upanuzi wa Visual Studio Code unaopendekezwa: +> Vidonge vinavyopendekezwa vya 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 +> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - kwa kuangalia mapema kurasa za 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 ## 📂 Kila somo linajumuisha: -- sketchnote hiari -- video ya ziada hiari -- jaribio la maandalizi kabla ya somo +- sketchnote ya hiari +- video ya ziada ya hiari +- jaribio la kujiandaa kabla ya somo - somo lililoandikwa -- kwa masomo yanayotegemea mradi, miongozo ya hatua kwa hatua juu ya jinsi ya kujenga mradi -- ukaguzi wa maarifa +- kwa masomo yanayojengwa kwa miradi, miongozo ya hatua kwa hatua jinsi ya kujenga mradi +- vipimo vya maarifa - changamoto -- kusoma kwa ziada -- kazi -- [jaribio baada ya somo](https://ff-quizzes.netlify.app/web/) +- usomaji wa ziada +- kazi ya nyumbani +- [jaribio la 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 jaribio:** Jaribio zote zipo katika folda ya Quiz-app, jumla ya jaribio 48 za maswali matatu kila moja. Zinapatikana [hapa](https://ff-quizzes.netlify.app/web/) app ya jaribio inaweza kuendeshwa eneo la karibu au kuwekwa kwenye Azure; fuata maelekezo kwenye folda ya `quiz-app`. ## 🗃️ Masomo -| | Jina la Mradi | Dhana Zinazofundishwa | Malengo ya Kujifunza | Somo Linalohusiana | Mwandishi | +| | Jina la Mradi | Dhana Zilizofundishwa | Malengo ya Kujifunza | Somo Lililohusishwa | 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 | -| 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 - -Mtaala wetu umeundwa kwa misingi miwili muhimu ya kielimu: -* kujifunza kwa kutumia miradi -* 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. - -> 🎓 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. - -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. - -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)". - -> Tembelea miongozo yetu ya [Kanuni za Maadili](CODE_OF_CONDUCT.md) na [Kuchangia](CONTRIBUTING.md). Tunakaribisha maoni yako chanya! - - -## 🧭 Ufikiaji wa Nje ya Mtandao - -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`. +| 01 | Kuanzia | Utangulizi wa Uandishi wa Programu na Vifaa vya Kazi | Jifunze misingi ya lugha nyingi za programu na kuhusu programu zinazowawezesha watengenezaji wa kitaalamu kufanya kazi zao | [Utangulizi wa Lugha za Kiprogramu na Vifaa vya Kazi](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | +| 02 | Kuanzia | Msingi wa GitHub, pamoja na kufanya kazi na timu | Jinsi ya kutumia GitHub katika mradi wako, jinsi ya kushirikiana na wengine kwenye msingi wa msimbo | [Utangulizi wa GitHub](./1-getting-started-lessons/2-github-basics/README.md) | Floor | +| 03 | Kuanzia | Upatikanaji | Jifunze misingi ya upatikanaji wa wavuti | [Misingi ya Upatikanaji](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | +| 04 | Msingi wa 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 | Msingi wa JS | Kazi na Mbinu | Jifunze kuhusu njia na kazi za kusimamia mtiririko wa mantiki ya programu | [Kazi na Mbinu](./2-js-basics/2-functions-methods/README.md) | Jasmine na Christopher | +| 06 | Msingi wa JS | Kufanya Maamuzi na 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 | Msingi wa JS | Mfululizo na Minyororo | Fanya kazi na data ukitumia mfululizo na minyororo katika JavaScript | [Mfululizo na Minyororo](./2-js-basics/4-arrays-loops/README.md) | Jasmine | +| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTML Katika Vitendo | Jenga HTML kuunda terrarium mtandaoni, ukilenga kujenga muundo wa kurasa | [Utangulizi wa HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | +| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSS Katika Vitendo | Jenga CSS kufashiona terrarium mtandaoni, ukilenga misingi ya CSS ikiwa ni pamoja na kufanya ukurasa uwe na mwelekeo wa mwitikio | [Utangulizi wa CSS](./3-terrarium/2-intro-to-css/README.md) | Jen | +| 10 | [Terrarium](./3-terrarium/solution/README.md) | Kuifunga JavaScript, uendeshaji wa DOM | Jenga JavaScript kufanya terrarium kufanya kazi kama kiolesura cha buruta/achia, ukilenga kufunga na uendeshaji wa DOM | [Kuifunga 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 | [Programu Iliyosababishwa 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 vivinjari vinavyofanya kazi, historia yao, na jinsi ya kuanzisha vipengele vya kwanza vya ugani wa kivinjari | [Kuhusu Vivinjari](./5-browser-extension/1-about-browsers/README.md) | Jen | +| 13 | [Green Browser Extension](./5-browser-extension/solution/README.md) | Kujenga fomu, kupiga API na kuhifadhi vigezo katika storage za ndani | Jenga vipengele vya JavaScript za ugani wako wa kivinjari kupiga API ukitumia vigezo vinavyo hifadhiwa ndani ya storage | [API, Fomu, na Storage 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 background katika kivinjari, utendaji wa wavuti | Tumia michakato ya background ya kivinjari kusimamia alama ya ugani; jifunze kuhusu utendaji wa wavuti na baadhi ya uboreshaji kufanikisha | [Kazi za Background na Utendaji](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen | +| 15 | [Space Game](./6-space-game/solution/README.md) | Maendeleo ya mchezo wa hali ya juu zaidi kwa JavaScript | Jifunze kuhusu Urithi ukitumia Madarasa na Muundo pamoja na mfano wa Pub/Sub, kujiandaa kwa kujenga mchezo | [Utangulizi wa Maendeleo ya Mchezo wa Juu Zaidi](./6-space-game/1-introduction/README.md) | Chris | +| 16 | [Space Game](./6-space-game/solution/README.md) | Kuchora kwenye canvasi | Jifunze kuhusu Canvas API, inayotumiwa 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) | Kuendesha vipengele kuzunguka skrini | Gundua jinsi vipengele vinaweza kupata mwendo ukitumia kuratibu za karatasi na Canvas API | [Kuendesha Vipengele Kuizunguka](./6-space-game/3-moving-elements-around/README.md) | Chris | +| 18 | [Space Game](./6-space-game/solution/README.md) | Kugundua mgongano | Fanya vipengele vigongane na kuleta athari kwa kila mmoja ukitumia kubonyeza funguo na kutoa kipengele cha mapumziko kuhakikisha utendaji mzuri | [Ugunduzi wa Mgongano](./6-space-game/4-collision-detection/README.md) | Chris | +| 19 | [Space Game](./6-space-game/solution/README.md) | Kuhifadhi alama | Fanya hisabati kulingana na hali na utendaji 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 yenye kurasa nyingi ukitumia routing 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 Usajili | Jifunze kuhusu kujenga fomu na kushughulikia utangamano wa taarifa | [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, kuihifadhi, na kuiondoa | [Data](./7-bank-project/3-data/README.md) | Yohan | +| 24 | [Banking App](./7-bank-project/solution/README.md) | Dhana za Usimamizi wa State | Jifunze jinsi app yako inavyodumisha state na jinsi ya kuisawazisha kwa mpangilio wa programu | [Usimamizi wa State](./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 wa AI | [Mradi wa Msaidizi wa AI](./9-chat-project/README.md) | Chris | + +## 🏫 Pedagogia + +Mtaala wetu umeundwa kwa kanuni kuu mbili za kijamii: +* kujifunza kwa msingi wa miradi +* jaribio za mara kwa mara + +Programu hufundisha misingi ya JavaScript, HTML, na CSS, pamoja na zana na mbinu mpya zinazotumiwa na waendelezaji wa wavuti wa leo. Wanafunzi watapata nafasi ya kupata uzoefu wa vitendo kwa kujenga mchezo wa kuandika, terrarium pepe, ugani wa kivinjari rafiki wa mazingira, mchezo wa aina ya space-invader, na app ya benki kwa biashara. Mwisho wa mfululizo huu, wanafunzi watakuwa wamepata uelewa thabiti wa maendeleo ya wavuti. + +> 🎓 Unaweza kuchukua masomo machache ya awali 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 maudhui yanaendana na miradi, mchakato unakuwa wa kuvutia zaidi kwa wanafunzi na kumbukumbu ya dhana itaboreshwa. Pia tuliandika masomo kadhaa ya kuanzia kuhusu misingi ya JavaScript kuanzisha dhana, yakiwa yameambatanishwa na video kutoka kwenye mkusanyiko wa "[Series ya Maanzo ya: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)", baadhi ya waandishi wake walichangia katika mtaala huu. + +Zaidi ya hayo, jaribio lisilo na shinikizo kabla ya darasa linaweka azma ya mwanafunzi kuelekea kujifunza mada, wakati jaribio la pili baada ya darasa lina hakikisha kumbukumbu zaidi. Mtaala huu umeundwa kuwa rahisi na wa kufurahisha na unaweza kuchukuliwa kwa jumla au sehemu. Miradi huanza ndogo na kuendelea kuwa ngumu zaidi mwishoni mwa mzunguko wa wiki 12. + +Ingawa tumeepuka kuanzisha miundombinu ya JavaScript kwa lengo la kuzingatia ujuzi wa msingi unaohitajika kama mendelezaji wa wavuti kabla ya kutumia miundombinu, hatua inayofuata nzuri ya kukamilisha mtaala huu itakuwa kujifunza kuhusu Node.js kupitia mkusanyiko mwingine wa video: "[Series ya Maanzo ya: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". + +> Tembelea [Kanuni zetu za Maadili](CODE_OF_CONDUCT.md) na miongozo ya [Kuchangia](CONTRIBUTING.md). Tunakaribisha maoni yako ya kujenga! + +## 🧭 Upatikanaji wa Nje ya Mtandao + +Unaweza kuendesha nyaraka hizi nje ya mtandao kwa kutumia [Docsify](https://docsify.js.org/#/). Chukua repo hii, [sakinisha Docsify](https://docsify.js.org/#/quickstart) kwenye mashine yako ya karibu, kisha katika folda ya mzizi ya repo hii, andika `docsify serve`. Tovuti itahudumiwa kwenye lango la 3000 kwenye localhost yako: `localhost:3000`. ## 📘 PDF @@ -213,14 +212,14 @@ Timu yetu hutengeneza kozi nyingine! 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) - +[![LangChain kwa Waanzilishi](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 +### Azure / Edge / MCP / Wakala [![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) +[![Wakala 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) --- @@ -232,26 +231,26 @@ Timu yetu hutengeneza kozi nyingine! Angalia: --- -### Kujifunza Msingi +### Mafunzo ya 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) +[![Usalama 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 Wavuti 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) --- ### 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 Uandishi wa Programu Pamoja na 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 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 unakosa au una maswali yoyote kuhusu kujenga programu za AI. Jiunge na wanafunzi wenzako na waendelezaji wenye uzoefu katika mijadala kuhusu MCP. Ni jamii yenye msaada ambapo maswali yanakaribishwa na maarifa hutolewa kwa uhuru. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) @@ -261,11 +260,11 @@ Kama una maoni kuhusu bidhaa au makosa wakati wa ujenzi tembelea: ## Leseni -Hifadhi hii ina leseni chini ya leseni ya MIT. Angalia faili la [LICENSE](../../LICENSE) kwa maelezo zaidi. +Hazina hii ina leseni 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. +**Kiarifa cha Msamaha**: +Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi kupata usahihi, tafadhali fahamu kuwa tafsiri za moja kwa moja zinaweza kuwa na makosa au kutoeleweka vyema. Hati ya awali katika lugha yake ya asili inapaswa kuzingatiwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu ya binadamu inashauriwa. Hatuwezi kuwajibika kwa kutoelewana au tafsiri potofu 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..0d51d0fec 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-06T09:36:10+00:00", "source_file": "AGENTS.md", "language_code": "tl" }, @@ -516,8 +516,8 @@ "language_code": "tl" }, "README.md": { - "original_hash": "490c83786552d7fab6390991517bef09", - "translation_date": "2026-01-29T18:53:32+00:00", + "original_hash": "805cd399757df19e886e86f0891a1374", + "translation_date": "2026-02-06T09:31:08+00:00", "source_file": "README.md", "language_code": "tl" }, diff --git a/translations/tl/AGENTS.md b/translations/tl/AGENTS.md index 1ed15aa56..aac82c19c 100644 --- a/translations/tl/AGENTS.md +++ b/translations/tl/AGENTS.md @@ -2,29 +2,29 @@ ## Pangkalahatang-ideya ng Proyekto -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 may 24 na hands-on na mga aralin na sumasaklaw sa JavaScript, CSS, at HTML. -### Pangunahing Bahagi +### Pangunahing Mga Bahagi -- **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 +- **Nilalamang Pang-edukasyon**: 24 na nakaayos na mga aralin na inorganisa sa mga proyekto batay sa module +- **Praktikal na Mga Proyekto**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, at AI Chat Assistant +- **Interactive na Mga Pagsusulit**: 48 na pagsusulit na may tig-3 na tanong bawat isa (pre/post-lesson assessments) +- **Suporta sa Maramihang Wika**: Awtomatikong pagsasalin para sa 50+ na mga wika gamit ang GitHub Actions - **Mga Teknolohiya**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para sa mga AI na proyekto) ### Arkitektura -- 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) +- Edukasyonal na repositoryo na may istrukturang nakabatay sa mga aralin +- Bawat folder ng aralin ay naglalaman ng README, mga halimbawa ng code, at mga solusyon +- Mga nakahiwalay na proyekto sa magkakahiwalay na direktoryo (quiz-app, iba't ibang 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 ipinapakita gamit ang Docsify at magagamit bilang PDF -## Mga Command sa Setup +## Mga Utos sa Setup -Ang repository na ito ay pangunahing para sa pagkonsumo ng nilalaman pang-edukasyon. Para sa pagtatrabaho sa mga partikular na proyekto: +Ang repositoryo na ito ay pangunahing para sa pagkonsumo ng nilalamang pang-edukasyon. Para sa pagtatrabaho sa mga partikular na proyekto: -### Pangunahing Setup ng Repository +### Pangkalahatang Setup ng Repositoryo ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git @@ -36,19 +36,19 @@ cd Web-Dev-For-Beginners ```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 # Bumuo 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 @@ -56,7 +56,7 @@ npm run format # Format with Prettier ```bash cd 5-browser-extension/solution npm install -# Follow browser-specific extension loading instructions +# Sundin ang mga tagubilin sa pag-load ng extension na partikular sa browser ``` ### Mga Proyekto ng Space Game @@ -64,219 +64,219 @@ npm install ```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 environment variable na GITHUB_TOKEN python api.py ``` ## Workflow ng Pag-develop -### Para sa mga Contributor ng Nilalaman +### Para sa Mga Contributor ng Nilalaman -1. **I-fork ang repository** sa iyong GitHub account -2. **I-clone ang iyong fork** nang lokal +1. **I-fork ang repositoryo** sa iyong GitHub account +2. **I-clone ang iyong fork** 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 pagbabago sa code sa mga kaukulang direktoryo ng proyekto +6. Mag-submit ng pull request kasunod ng mga patnubay sa kontribusyon -### Para sa mga Nag-aaral +### Para sa Mga Nag-aaral -1. I-fork o i-clone ang repository +1. Mag-fork o mag-clone ng repositoryo 2. Mag-navigate sa mga direktoryo ng aralin nang sunod-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 +3. Basahin ang README files para sa bawat aralin +4. Kumpletuhin ang mga pre-lesson quizzes sa https://ff-quizzes.netlify.app/web/ +5. Trabahuhin ang mga halimbawa ng code sa mga folder ng aralin +6. Kumpletuhin ang mga takdang-aralin at mga hamon +7. Kumuha ng mga post-lesson quizzes -### Live Development +### Live na Pag-develop - **Dokumentasyon**: Patakbuhin ang `docsify serve` sa root (port 3000) - **Quiz App**: Patakbuhin ang `npm run dev` sa quiz-app directory - **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 +- **Mga API na Proyekto**: Patakbuhin ang `npm start` sa mga kaukulang API directory -## Mga Tagubilin sa Pagsusuri +## Mga Tagubilin para sa Testing -### Pagsusuri ng Quiz App +### Pag-testing ng Quiz App ```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 estilo ng code +npm run build # Tiyakin na matagumpay ang build ``` -### Pagsusuri ng Bank API +### Pag-testing ng Bank API ```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 ang mga isyu sa estilo ng code +node server.js # Siguraduhin na nagsisimula ang server nang walang mga error ``` -### Pangkalahatang Diskarte sa Pagsusuri +### Pangkalahatang Paraan sa Testing -- 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 +- Isang edukasyonal na repositoryo ito na walang komprehensibong awtomatikong mga test +- Manual na testing ay nakatuon sa: + - Mga halimbawa ng code na tumatakbo nang walang error + - Mga link sa dokumentasyon na gumagana nang tama + - Matagumpay na pagsasagawa ng mga build ng proyekto + - Mga halimbawa na sumusunod sa mga pinakamahusay na gawain -### Mga Pre-submission Check +### Mga Pre-submission Checks - Patakbuhin ang `npm run lint` sa mga direktoryo na may package.json -- Siguraduhing valid ang mga markdown link +- Suriin na valid ang mga markdown link - Subukan ang mga halimbawa ng code sa browser o Node.js -- Siguraduhing ang mga pagsasalin ay may tamang istruktura +- Suriin na ang mga pagsasalin ay nananatili sa wastong istruktura -## Mga Gabay sa Estilo ng Code +## Mga Alituntunin sa Estilo ng Code ### 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 standard ESLint configurations na ibinigay sa mga proyekto +- Gumamit ng makahulugang mga pangalang 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 saan naka-configure ### HTML/CSS -- Semantic HTML5 elements +- Semantic HTML5 na mga elemento - Mga prinsipyo ng responsive design -- Malinaw na naming conventions para sa klase +- Malinaw na mga convention sa pag-ngalan ng klase - Mga komento na nagpapaliwanag ng mga teknik sa CSS para sa mga nag-aaral ### Python -- PEP 8 style guidelines -- Malinaw, edukasyonal na mga halimbawa ng code -- Mga type hint kung kapaki-pakinabang para sa pag-aaral +- Mga alituntunin sa estilo ng PEP 8 +- Malinaw, pang-edukasyong mga halimbawa ng code +- Mga type hint kung kapaki-pakinabang sa pagkatuto -### Dokumentasyon ng Markdown +### Dokumentasyon sa Markdown - Malinaw na hierarchy ng heading -- Mga code block na may language specification -- Mga link sa karagdagang resources -- Mga screenshot at imahe sa `images/` directories -- Alt text para sa mga imahe para sa accessibility +- Mga code blocks na may pagtukoy ng wika +- Mga link sa karagdagang mga mapagkukunan +- Mga screenshot at larawan sa mga direktoryo ng `images/` +- Alt text para sa mga larawan para sa accessibility ### Organisasyon ng File -- 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 naka-number nang sunod-sunod (1-getting-started-lessons, 2-js-basics, atbp.) +- Bawat proyekto ay may `solution/` at kadalasan ay `start/` o `your-work/` na mga direktoryo +- Mga larawan na nakaimbak sa lesson-specific na mga folder na `images/` +- Mga pagsasalin sa istrukturang `translations/{language-code}/` ## Build at Deployment -### Deployment ng Quiz App (Azure Static Web Apps) +### Pag-deploy ng Quiz App (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 deployment gamit ang 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 # Gumagawa ng dist/ na folder +# Nagde-deploy gamit ang GitHub Actions workflow sa pag-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 +### Pagbuo ng Dokumentasyong PDF ```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 docs ``` -### Dokumentasyon ng Docsify +### Dokumentasyon gamit ang Docsify ```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 global +docsify serve # I-serve sa localhost:3000 ``` ### Mga Build na Partikular sa Proyekto -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 sariling proseso ng build: +- Mga Vue na proyekto: `npm run build` na lumilikha ng production bundles +- Mga static na proyekto: Walang build step, diretsong nagsisilbi ng mga file -## Mga Gabay sa Pull Request +## Mga Alituntunin para sa Pull Request ### Format ng Pamagat -Gumamit ng malinaw, deskriptibong pamagat na nagpapahiwatig ng lugar ng pagbabago: -- `[Quiz-app] Magdagdag ng bagong quiz para sa lesson X` -- `[Lesson-3] Ayusin ang typo sa terrarium project` -- `[Translation] Magdagdag ng pagsasalin sa Espanyol para sa lesson 5` +Gumamit ng malinaw, mapanuring mga pamagat na nagsasaad ng lugar ng pagbabago: +- `[Quiz-app] Magdagdag ng bagong pagsusulit para sa aralin X` +- `[Lesson-3] Ayusin ang typo sa proyekto ng terrarium` +- `[Translation] Magdagdag ng pagsasaling Espanyol para sa aralin 5` - `[Docs] I-update ang mga tagubilin sa setup` ### Mga Kinakailangang Pagsusuri -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 apektadong mga 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 na walang error sa build 3. **Pag-validate ng Link**: - Subukan ang lahat ng markdown links - - Siguraduhing gumagana ang mga reference ng imahe + - Suriin 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. **Rebyu ng Nilalaman**: + - Proofread para sa pagbaybay at gramatika + - Siguraduhin na tama at edukasyonal ang mga halimbawa ng code + - Patunayan na ang mga pagsasalin ay napapanatili ang orihinal na kahulugan ### Mga Kinakailangan sa Kontribusyon -- Sumang-ayon sa Microsoft CLA (automated check sa unang PR) +- Sumang-ayon sa Microsoft CLA (awtomatikong pagsuri 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 -- I-reference ang mga numero ng isyu sa PR description kung naaangkop +- Tingnan ang [CONTRIBUTING.md](./CONTRIBUTING.md) para sa detalyadong mga patnubay +- I-refer ang mga numero ng isyu sa paglalarawan ng PR kung naaangkop -### Proseso ng Review +### Proseso ng Pagsusuri -- 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 sinusuri ng mga tagapanatili at komunidad +- Pinapahalagahan ang kalinawan ng edukasyon +- Ang mga halimbawa ng code ay dapat sumunod sa kasalukuyang pinakamahusay na mga gawain +- Ang mga pagsasalin ay sinusuri para sa katumpakan at angkop na kultura ## Sistema ng Pagsasalin ### Awtomatikong Pagsasalin -- 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 gamit ang co-op-translator workflow +- Nagsasalin sa 50+ na mga wika nang awtomatiko +- Mga silbing file sa pangunahing mga direktoryo +- Mga naisaling file sa `translations/{language-code}/` na mga direktoryo -### Pagdaragdag ng Manu-manong Pagpapabuti sa Pagsasalin +### Pagdaragdag ng Manual na Pagpapahusay sa Pagsasalin 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 pagpapahusay habang pinapanatili ang istruktura +3. Siguraduhin na ang mga halimbawa ng code ay nananatiling gumagana +4. Subukan ang anumang nilokal na nilalaman ng pagsusulit -### Metadata ng Pagsasalin +### Metadata sa Pagsasalin -Ang mga isinaling file ay may kasamang metadata header: +Ang mga naisaling file ay may metadata na header: ```markdown ``` -## Pag-debug at Pag-troubleshoot +## Pag-debug at Pagsasaayos ng Problema -### Karaniwang Isyu +### Mga Karaniwang Isyu -**Hindi gumagana ang quiz app**: -- Suriin ang bersyon ng Node.js (inirerekomenda: v14+) +**Hindi nagsisimula 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) +- Suriin kung may mga conflict sa port (default: Vite ay 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**: +- Siguraduhin ang Node.js na bersyon ay naaabot ang minimum (node >=10) +- Suriin kung ang port ay kasalukuyang ginagamit +- Siguraduhin na na-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 +- Siguraduhin na maayos na nakabuo ang manifest.json +- Suriin ang console ng browser para sa mga error +- Sundin ang mga tagubilin sa pag-install ng extension na partikular sa 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 +- Siguraduhin na nakaset ang environment variable na GITHUB_TOKEN +- Suriin ang mga permiso sa pag-access ng GitHub Models -**Hindi gumagana ang Docsify**: -- 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 +**Hindi nagsisilbi ang Docsify ng dokumento**: +- Mag-install ng docsify-cli globally: `npm install -g docsify-cli` +- Patakbuhin mula sa root directory ng repositoryo +- Siguraduhing umiiral ang `docs/_sidebar.md` -### Mga Tip sa Development Environment +### Mga Tip sa Kapaligiran ng Pag-develop -- 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 +- Gumamit ng VS Code kasama ang Live Server extension para sa mga HTML na proyekto +- Mag-install ng ESLint at Prettier extensions para sa pare-parehong pag-format +- Gumamit ng DevTools ng browser para sa pag-debug ng JavaScript +- Para sa mga Vue na proyekto, mag-install ng Vue DevTools na extension sa browser ### Mga Pagsasaalang-alang sa Performance -- 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) +- Ang malaking bilang ng mga naisaling file (50+ na wika) ay nagpapalaki ng mga full clone +- Gumamit ng shallow clone kung nilalaman lang ang inaasikaso: `git clone --depth 1` +- I-exclude ang mga pagsasalin sa paghahanap kapag nagtratrabaho sa English content +- Ang mga proseso ng build ay maaaring mabagal sa unang takbo (npm install, Vite build) ## Mga Pagsasaalang-alang sa Seguridad ### Mga Environment Variable -- Ang mga API key ay hindi dapat i-commit sa repository +- Ang mga API key ay hindi dapat isama sa repositoryo - Gumamit ng `.env` files (nasa `.gitignore` na) - I-dokumento ang mga kinakailangang environment variable sa mga README ng proyekto -### Mga Proyekto ng Python +### Mga Proyekto sa Python -- Gumamit ng virtual environments: `python -m venv venv` +- Gumamit ng mga virtual environment: `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 permiso -### Access ng GitHub Models +### Access sa GitHub Models -- Kinakailangan ang Personal Access Tokens (PAT) para sa GitHub Models -- Ang mga token ay dapat itago bilang environment variables -- Huwag kailanman i-commit ang mga token o credentials +- Personal Access Tokens (PAT) ang kinakailangan para sa GitHub Models +- Ang mga token ay dapat itago bilang mga environment variable +- Huwag kailanman i-commit ang mga token o credential -## Karagdagang Tala +## Karagdagang Mga Tala ### Target na Audience -- 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 +- Mga ganap na baguhan sa web development +- Mga estudyante at mga self-learner +- Mga guro na gumagamit ng kurikulum sa mga silid-aralan +- Nilalaman ay idinisenyo para sa accessibility at unti-unting pagbuo ng kakayahan ### Pilosopiya ng Edukasyon -- Diskarte sa pag-aaral na nakabatay sa proyekto -- 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 +- Paraan ng pagkatuto na nakabatay sa proyekto +- Mga madalas na pagsusuri ng kaalaman (quizzes) +- Hands-on na mga ehersisyo sa coding +- Mga totoong halimbawa ng aplikasyon +- Pokus sa mga pundasyon bago ang mga framework -### Pagpapanatili ng Repository +### Pangangalaga ng Repositoryo -- Aktibong komunidad ng mga nag-aaral at contributor +- Aktibong komunidad ng mga nag-aaral at nagkakaloob - 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 +- Mga isyu at diskusyon ay mino-monitor ng mga tagapanatili +- Mga update sa pagsasalin ay awtomatiko gamit ang GitHub Actions -### Mga Kaugnay na Resources +### Mga Kaugnay na Mapagkukunan - [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 ang [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) para sa mga nag-aaral +- Karagdagang mga kurso: Generative AI, Data Science, ML, IoT curricula na available -### Pagtatrabaho sa Partikular na Mga Proyekto +### Pagtatrabaho sa Mga Partikular na Proyekto -Para sa detalyadong tagubilin sa mga indibidwal na proyekto, tingnan ang README files sa: -- `quiz-app/README.md` - Vue 3 quiz application +Para sa detalyadong mga tagubilin sa mga indibidwal na proyekto, sumangguni sa mga README file sa: +- `quiz-app/README.md` - Vue 3 na aplikasyon ng pagsusulit - `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 +- `5-browser-extension/README.md` - Development ng browser extension +- `6-space-game/README.md` - Desenvolvimento ng canvas-based na laro - `9-chat-project/README.md` - Proyekto ng AI chat assistant ### Istruktura ng Monorepo -Bagama't hindi tradisyunal na monorepo, ang repository na 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 +Bagama’t hindi tradisyunal na monorepo, ang repositoryo na ito ay naglalaman ng maramihang independiyenteng mga proyekto: +- Ang bawat aralin ay nakahiwalay +- Hindi nagsasaluhan ng dependencies ang mga proyekto +- Puwedeng 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 AI na serbisyo ng 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 kamalian. Ang orihinal na dokumento sa kanyang sariling wika ang dapat ituring na opisyal na sanggunian. Para sa mahalagang impormasyon, inirerekomenda ang propesyonal na pagsasaling pantao. Hindi kami mananagot sa anumang hindi pagkakaunawaan o maling pag-intindi 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..cf23cc106 100644 --- a/translations/tl/README.md +++ b/translations/tl/README.md @@ -1,219 +1,193 @@ -[![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) +# Web Development para sa mga Baguhan - Isang Kurikulum -[![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 pundasyon ng 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 kuis, talakayan, at praktikal na mga takdang-aralin. Pagandahin ang iyong mga kasanayan at i-optimize ang iyong kaalaman gamit ang aming epektibong pedagohiya na nakabatay sa proyekto. Simulan ang iyong paglalakbay sa pag-cocode 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) - -### 🌐 Suporta para sa Maramihang Wika +Sundin ang mga hakbang na ito upang makapagsimula gamit ang mga resources na ito: +1. **I-fork ang Repository**: I-click [![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 makipagkilala sa mga eksperto at kapwa developer**](https://discord.com/invite/ByRwuEEgH4) -#### Sinusuportahan sa pamamagitan ng GitHub Action (Awtomatiko at Palaging Napapanahon) +### 🌐 Suporta para sa Maraming Wika - -[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) +#### Sinusuportahan sa pamamagitan ng GitHub Action (Awtomatiko at Laging Napapanahon) -> **Mas gusto mo bang I-clone ito nang Lokal?** +> **Mas gusto bang mag-clone nang 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 repository na ito ang 50+ na pagsasalin sa iba't ibang wika na nagpapalaki nang malaki sa laki ng pag-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. - +> Magbibigay ito sa'yo 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 mo ng karagdagang suporta sa mga wikang 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 makakakita ka ng mga panimulang resource, Student packs, at mga paraan upang makakuha ng libreng voucher para sa sertipiko. Ito ang pahina na nais mong i-bookmark at balikan paminsan-minsan dahil palagi kaming nagbabago ng nilalaman buwan-buwan. -### 📣 Anunsyo - Mga bagong hamon sa GitHub Copilot Agent mode na kailangang tapusin! +### 📣 Anunsyo - Mga bagong hamon ng 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 na dapat mong tapusin gamit ang GitHub Copilot at Agent mode. Kung hindi mo pa nagagamit ang Agent mode, kaya nitong hindi lamang gumawa ng teksto kundi makagawa at mag-edit ng mga file, magpatakbo ng mga command, at higit pa. -### 📣 Anunsyo - _Bagong Proyekto na gagawin gamit ang Generative AI_ +### 📣 Anunsyo - _Bagong Proyekto 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 [project](./9-chat-project/README.md) -### 📣 Anunsyo - _Bagong Kurikulum_ sa Generative AI para sa JavaScript ay inilabas na +### 📣 Anunsyo - _Bagong Kurikulum_ tungkol sa Generative AI para sa JavaScript ay inilabas na Huwag palampasin ang aming bagong Generative AI curriculum! -Bisitahin ang [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) para 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! +Bisitahin ang [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) upang makapagsimula! -![character](../../translated_images/tl/character.5c0dd8e067ffd693.webp) +- Mga aralin na sumasaklaw sa lahat mula sa mga batayan hanggang RAG. +- Makipag-ugnayan sa mga makasaysayang karakter gamit ang GenAI at ang aming companion app. +- Masaya at nakakaaliw na salaysay, para kang naglalakbay sa oras! - -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 takdang-aralin, pagsusuri ng kaalaman, at hamon na gagabay sa iyong 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! +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 mungkahi](for-teachers.md) kung paano gagamitin ang kurikulum na ito. Gusto naming marinig ang 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)**, sa bawat aralin, simulan sa pamamagitan ng pre-lecture quiz at sundan ito sa pagbabasa ng materyal ng lektura, pagtapos ng mga iba't ibang aktibidad, at suriin ang iyong pang-unawa gamit ang post-lecture quiz. -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. +Upang mapahusay ang iyong karanasan sa pag-aaral, kumonekta sa iyong mga kaklase upang magtrabaho nang magkakasama 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 katanungan. -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. +Upang higit pang mapalawak ang iyong edukasyon, lubos naming inirerekumenda na tuklasin ang [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 +### 📋 Pagset-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). +Ang kurikulum na ito ay may handang development environment! Sa pagsisimula mo, maaari kang pumili na patakbuhin ang kurikulum gamit ang [Codespace](https://github.com/features/codespaces/) (_isang browser-based na kapaligiran na hindi kailangan ng install_), o lokal sa iyong kompyuter gamit ang 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. +#### Gumawa ng iyong repository +Para madali mong ma-save ang iyong trabaho, inirerekomenda namin na gumawa ka ng sariling kopya ng repository na ito. Magagawa mo ito sa pamamagitan ng pag-click sa **Use this template** na button sa taas ng pahina. Ito ay gagawa ng bagong repository 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 Repository**: I-click ang "Fork" na button sa kanang-itaas na sulok ng pahinang ito. +2. **I-clone ang Repository**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` -#### Pagpapatakbo ng kurikulum sa Codespace +#### Pagpatakbo 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 repository na ginawa mo, i-click ang **Code** na button at piliin ang **Open with Codespaces**. Ito ay gagawa ng bagong Codespace para sa iyong pagtatrabaho. ![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. +#### Pagpatakbo ng kurikulum lokal sa iyong kompyuter -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). +Upang patakbuhin ang kurikulum na ito lokal sa iyong kompyuter, kakailanganin mo ng 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 opsyon para sa bawat isa sa mga tool na ito para mapili mo kung ano ang pinakamainam para sa'yo. +Inirerekomenda namin ang paggamit ng [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) bilang iyong editor, na may 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). -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 repository sa iyong kompyuter. Magagawa mo ito sa pamamagitan ng pag-click sa **Code** na 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: + 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 kakopya mo lang: ```bash 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 mo itong gawin sa pamamagitan ng pag-click sa **File** > **Open Folder** at piliin ang folder na kaklone mo lang. -> Inirerekomendang Mga Extension ng Visual Studio Code: +> Inirerekomendang mga extension para sa 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) - upang makita ang preview ng mga HTML na pahina sa loob ng Visual Studio Code +> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - upang tulungan kang magsulat ng code nang mas mabilis -## 📂 Bawat aralin ay may kasamang: +## 📂 Kasama sa bawat aralin: - opsyonal na sketchnote - opsyonal na karagdagang video -- pre-lesson warmup quiz +- paunang warmup quiz bago ang aralin - nakasulat na aralin -- para sa mga proyekto, sunud-sunod na gabay kung paano itatayo ang proyekto -- pagsusuri ng kaalaman +- para sa mga aralin na nakabatay sa proyekto, may step-by-step na gabay kung paano bumuo ng proyekto +- pagsubok ng kaalaman - isang hamon -- karagdagang babasahin +- dagdag na babasahin - takdang-aralin - [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 tala tungkol sa mga quiz**: Lahat ng quiz ay nasa Quiz-app folder, 48 na kabuuang quiz na may tig-tatlong tanong bawat isa. Makukuha ang mga ito [dito](https://ff-quizzes.netlify.app/web/). Maaaring patakbuhin ang quiz app 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 | Linked Lesson | May-akda | +| :-: | :--------------------------------------------------------------: | :-----------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :----------------------: | +| 01 | Getting Started | Panimula sa Programming at Mga Kasangkapan | Matutuhan ang mga pangunahing pundasyon sa likod ng karamihang programming languages 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 | Getting Started | Mga Pangunahing Kaalaman sa GitHub, kabilang ang pagtatrabaho sa isang koponan | Paano gamitin ang GitHub sa iyong proyekto, kung 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 | Matutuhan ang mga pangunahing kaalaman sa web accessibility | [Accessibility Fundamentals](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | +| 04 | JS Basics | JavaScript Data Types | Ang mga pangunahing tungkol sa mga uri ng data sa JavaScript | [Data Types](./2-js-basics/1-data-types/README.md) | Jasmine | +| 05 | JS Basics | Mga Function at Method | Matutuhan ang tungkol sa mga function at method para pamahalaan ang daloy ng lohika ng 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 | Matutuhan kung paano gumawa ng mga kundisyon 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 | Gamitin ang mga 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 in Practice | Bumuo ng HTML para gumawa ng online terrarium, naka-focus sa paggawa ng layout | [Introduction to HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | +| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSS in Practice | Gamitin ang CSS upang istilohan ang online terrarium, nakatuon sa mga pangunahing kaalaman sa CSS kabilang ang paggawa na responsive ng pahina | [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 paganahin ang terrarium bilang drag/drop interface, naka-focus 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 | Matutuhan kung paano gamitin ang keyboard events upang 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) | Paggamit ng Browsers | Alamin kung paano gumagana ang mga browser, kanilang kasaysayan, at 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) | Paggawa ng form, pagtawag sa API at pagtatago ng mga variable sa lokal na storage | Gumawa ng mga JavaScript na elemento ng iyong browser extension upang tumawag sa isang API gamit ang mga variable na nakaimbak sa lokal na imbakan | [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; matutuhan ang tungkol sa performance ng web at ilang mga optimisasyon upang mapabuti | [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 | Matutuhan ang tungkol sa Inheritance gamit ang Classes at Composition pati na ang Pub/Sub na 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) | Pagguhit sa canvas | Matutuhan ang Canvas API, ginagamit para mag-draw 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 screen | Tuklasin kung paano mapapagalaw ang mga elemento gamit ang cartesian coordinates at 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 banggaan | Gawin ang mga elemento na magbanggaan at mag-react sa isa't isa gamit ang mga keypress at magbigay ng cooldown function upang matiyak ang 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 batay sa status 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 pag-restart ng laro | Matutuhan ang tungkol sa pagtatapos at pag-restart ng laro, kabilang ang paglilinis ng mga assets at pag-reset ng mga variable | [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 Web App | Matutuhan kung paano gumawa ng scaffold ng arkitektura ng isang multipage na 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 | Matutuhan ang tungkol sa paggawa 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 Data | Paano dumadaloy ang data papasok at palabas ng iyong app, paano ito kunin, itago, at itapon | [Data](./7-bank-project/3-data/README.md) | Yohan | +| 24 | [Banking App](./7-bank-project/solution/README.md) | Mga Konsepto sa Pamamahala ng Estado | Matutuhan kung paano ang iyong app ay nagtatago ng estado at kung paano pamahalaan ito gamit ang programa | [State Management](./7-bank-project/4-state-management/README.md) | Yohan | +| 25 | [Browser/VScode Code](../../8-code-editor) | Paggamit ng VScode | Matutuhan kung paano gumamit ng isang 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 | Matutuhan kung paano gumawa ng sarili mong 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 gamit ang dalawang pangunahing prinsipyo sa pagtuturo: +* pagkatuto na nakabatay 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 kasangkapan at teknik na ginagamit ng mga web developer ngayon. Magkakaroon ang mga estudyante ng pagkakataong magpraktis sa pamamagitan ng paggawa ng isang typing game, virtual terrarium, eco-friendly browser extension, space-invader-style na laro, at isang banking app para sa mga negosyo. Sa pagtatapos ng serye, magkakaroon ang mga estudyante ng matibay na pag-unawa sa pagbuo 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 unang ilang 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! -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 pagsisiguro na ang mga nilalaman ay naka-align sa mga proyekto, mas nagiging kapana-panabik ang proseso para sa mga estudyante at mas nalalago ang pagtanda ng mga konsepto. Nagsulat din kami ng ilang mga panimulang aralin sa mga batayang JavaScript upang ipakilala ang mga konsepto, kasabay ng video mula sa "[Beginners Series to: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)" na koleksyon ng mga tutorial na video, na 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. +Bilang karagdagan, isang low-stakes na pagsusulit bago ang klase ang nagtatakda ng layunin ng estudyante para matutunan ang isang paksa, habang ang pangalawang pagsusulit pagkatapos ng klase ay nagsisiguro ng karagdagang retention. Ang kurikulum na ito ay dinisenyo upang maging malikhain at masaya at maaaring kunin nang buo o bahagi lamang. Ang mga proyekto ay nagsisimula sa maliit at unti-unting lumalalim sa kahirapan sa pagtatapos ng 12-linggong siklo. -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 sinadyang iniiwasan naming ipakilala ang mga JavaScript frameworks upang tumuon sa mga pangunahing kasanayan na kailangan bilang isang web developer bago mag-adopt ng framework, ang isang magandang susunod na hakbang upang tapusin 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)". -> 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 ang [Contributing](CONTRIBUTING.md) na mga patnubay. Malugod naming tinatanggap ang iyong makatutulong na puna! -## 🧭 Offline access +## 🧭 Offline na 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 na 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 ihahain 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 aralin ay maaaring makuha [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 +225,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 naipit o may mga tanong tungkol sa paggawa ng mga AI na app. Sumali sa mga kapwa mag-aaral at mga bihasang developer sa mga talakayan tungkol sa MCP. Ito ay isang sumusuportang komunidad kung saan malugod ang mga tanong at malayang ibinabahagi 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 puna sa produkto o mga error habang gumagawa, 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 may lisensyang MIT. Tingnan ang [LICENSE](../../LICENSE) na 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. +**Pahayag ng Paalala**: +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 kami para sa katumpakan, pakatandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o di-tumpak na impormasyon. Ang orihinal na dokumento sa orihinal nitong wika ang dapat ituring na pinagmumulan ng awtoridad. Para sa mahahalagang impormasyon, inirerekomenda ang propesyonal na pagsasaling pantao. Hindi kami mananagot sa anumang hindi pagkakaintindihan o maling interpretasyon na nagmumula sa paggamit ng pagsasaling ito. \ No newline at end of file