diff --git a/translations/id/.co-op-translator.json b/translations/id/.co-op-translator.json index 53d3ca3b0..106c10e7c 100644 --- a/translations/id/.co-op-translator.json +++ b/translations/id/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-04-06T16:49:02+00:00", + "translation_date": "2026-04-20T16:43:50+00:00", "source_file": "AGENTS.md", "language_code": "id" }, diff --git a/translations/id/AGENTS.md b/translations/id/AGENTS.md index 6abfcdd9e..6bfe74edc 100644 --- a/translations/id/AGENTS.md +++ b/translations/id/AGENTS.md @@ -1,28 +1,28 @@ # AGENTS.md -## Ikhtisar Proyek +## Gambaran Proyek -Ini adalah repositori kurikulum edukasi untuk mengajarkan dasar-dasar pengembangan web kepada pemula. Kurikulumnya adalah kursus komprehensif selama 12 minggu yang dikembangkan oleh Microsoft Cloud Advocates, menampilkan 24 pelajaran praktis yang mencakup JavaScript, CSS, dan HTML. +Ini adalah repositori kurikulum edukasi untuk mengajarkan dasar-dasar pengembangan web kepada pemula. Kurikulum ini merupakan kursus komprehensif selama 12 minggu yang dikembangkan oleh Microsoft Cloud Advocates, menampilkan 24 pelajaran praktis yang mencakup JavaScript, CSS, dan HTML. ### Komponen Utama - **Konten Edukasi**: 24 pelajaran terstruktur yang diorganisasi dalam modul berbasis proyek -- **Proyek Praktis**: Terrarium, Permainan Mengetik, Ekstensi Browser, Permainan Luar Angkasa, Aplikasi Perbankan, Editor Kode, dan Asisten Obrolan AI -- **Kuis Interaktif**: 48 kuis dengan 3 pertanyaan setiap kuis (penilaian sebelum dan sesudah pelajaran) -- **Dukungan Multi-bahasa**: Terjemahan otomatis untuk 50+ bahasa melalui GitHub Actions +- **Proyek Praktis**: Terrarium, Permainan Mengetik, Ekstensi Browser, Permainan Luar Angkasa, Aplikasi Perbankan, Editor Kode, dan Asisten Chat AI +- **Kuis Interaktif**: 48 kuis dengan 3 pertanyaan tiap kuis (penilaian sebelum/sesudah pelajaran) +- **Dukungan Multi-bahasa**: Terjemahan otomatis untuk lebih dari 50 bahasa melalui GitHub Actions - **Teknologi**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (untuk proyek AI) ### Arsitektur - Repositori edukasi dengan struktur berbasis pelajaran -- Setiap folder pelajaran memuat README, contoh kode, dan solusi -- Proyek mandiri dalam direktori terpisah (quiz-app, berbagai proyek pelajaran) +- Setiap folder pelajaran berisi README, contoh kode, dan solusi +- Proyek mandiri di direktori terpisah (quiz-app, berbagai proyek pelajaran) - Sistem terjemahan menggunakan GitHub Actions (co-op-translator) - Dokumentasi disajikan melalui Docsify dan tersedia dalam format PDF ## Perintah Setup -Repositori ini terutama untuk konsumsi konten edukasi. Untuk bekerja dengan proyek spesifik: +Repositori ini terutama untuk konsumsi konten edukasi. Untuk bekerja dengan proyek khusus: ### Setup Repositori Utama @@ -56,7 +56,7 @@ npm run format # Format dengan Prettier ```bash cd 5-browser-extension/solution npm install -# Ikuti instruksi pemuatan ekstensi khusus browser +# Ikuti petunjuk pemuatan ekstensi spesifik browser ``` ### Proyek Permainan Luar Angkasa @@ -67,12 +67,12 @@ npm install # Buka index.html di browser atau gunakan Live Server ``` -### Proyek Obrolan (Backend Python) +### Proyek Chat (Backend Python) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Atur variabel lingkungan GITHUB_TOKEN +# Tetapkan variabel lingkungan GITHUB_TOKEN python api.py ``` @@ -81,28 +81,28 @@ python api.py ### Untuk Kontributor Konten 1. **Fork repositori** ke akun GitHub Anda -2. **Clone hasil fork** secara lokal +2. **Clone fork Anda** secara lokal 3. **Buat cabang baru** untuk perubahan Anda -4. Buat perubahan pada konten pelajaran atau contoh kode +4. Lakukan perubahan pada konten pelajaran atau contoh kode 5. Uji perubahan kode di direktori proyek terkait -6. Ajukan pull request sesuai pedoman kontribusi +6. Ajukan pull request sesuai panduan kontribusi ### Untuk Pembelajar 1. Fork atau clone repositori 2. Navigasi ke direktori pelajaran secara berurutan -3. Baca file README untuk setiap pelajaran -4. Kerjakan kuis pra-pelajaran di https://ff-quizzes.netlify.app/web/ -5. Kerjakan contoh kode dalam folder pelajaran +3. Baca file README di setiap pelajaran +4. Selesaikan kuis sebelum pelajaran di https://ff-quizzes.netlify.app/web/ +5. Kerjakan contoh kode di folder pelajaran 6. Selesaikan tugas dan tantangan -7. Kerjakan kuis pasca-pelajaran +7. Ikuti kuis sesudah pelajaran ### Pengembangan Langsung - **Dokumentasi**: Jalankan `docsify serve` di root (port 3000) - **Aplikasi Kuis**: Jalankan `npm run dev` di direktori quiz-app -- **Proyek**: Gunakan ekstensi VS Code Live Server untuk proyek HTML -- **Proyek API**: Jalankan `npm start` di direktori API masing-masing +- **Proyek-proyek**: Gunakan ekstensi Live Server VS Code untuk proyek HTML +- **Proyek API**: Jalankan `npm start` di direktori API terkait ## Instruksi Pengujian @@ -111,7 +111,7 @@ python api.py ```bash cd quiz-app npm run lint # Periksa masalah gaya kode -npm run build # Verifikasi build berhasil +npm run build # Verifikasi keberhasilan build ``` ### Pengujian API Bank @@ -124,57 +124,57 @@ node server.js # Verifikasi server mulai tanpa kesalahan ### Pendekatan Pengujian Umum -- Ini adalah repositori edukasi tanpa pengujian otomatis yang lengkap -- Pengujian manual difokuskan pada: +- Ini adalah repositori edukasi tanpa pengujian otomatis lengkap +- Pengujian manual fokus pada: - Contoh kode berjalan tanpa error - - Tautan di dokumentasi berfungsi dengan baik - - Build proyek selesai dengan sukses - - Contoh mengikuti praktik terbaik + - Link di dokumentasi berfungsi dengan baik + - Proses build proyek berjalan sukses + - Contoh sesuai praktik terbaik -### Pemeriksaan Sebelum Pengajuan +### Pemeriksaan Sebelum Pengiriman - Jalankan `npm run lint` di direktori dengan package.json -- Verifikasi tautan markdown valid +- Verifikasi link markdown valid - Uji contoh kode di browser atau Node.js -- Pastikan terjemahan mempertahankan struktur yang benar +- Pastikan terjemahan mempertahankan struktur yang tepat ## Pedoman Gaya Kode ### JavaScript - Gunakan sintaks ES6+ modern -- Ikuti konfigurasi ESLint standar yang disediakan di proyek +- Ikuti konfigurasi ESLint standar di proyek - Gunakan nama variabel dan fungsi yang bermakna untuk kejelasan edukasi -- Tambahkan komentar untuk menjelaskan konsep kepada pembelajar -- Format menggunakan Prettier jika sudah dikonfigurasi +- Tambahkan komentar penjelasan konsep untuk pembelajar +- Format menggunakan Prettier jika dikonfigurasi ### HTML/CSS - Elemen HTML5 semantik - Prinsip desain responsif -- Konvensi penamaan kelas yang jelas -- Komentar yang menjelaskan teknik CSS untuk pembelajaran +- Penamaan kelas yang jelas +- Komentar menjelaskan teknik CSS untuk pembelajar ### Python -- Pedoman gaya PEP 8 -- Contoh kode yang jelas dan edukatif -- Tambahkan tipe (type hints) jika membantu proses belajar +- Panduan gaya PEP 8 +- Contoh kode jelas dan edukatif +- Gunakan type hint bila membantu pembelajaran ### Dokumentasi Markdown -- Hirarki judul yang jelas -- Blok kode dengan spesifikasi bahasa -- Tautan ke sumber daya tambahan +- Hierarki judul yang jelas +- Blok kode dengan penentuan bahasa +- Link ke sumber daya tambahan - Screenshot dan gambar di direktori `images/` -- Teks alt untuk gambar demi aksesibilitas +- Teks alternatif untuk gambar demi aksesibilitas ### Organisasi File - Pelajaran diberi nomor berurutan (1-getting-started-lessons, 2-js-basics, dll.) -- Setiap proyek memiliki direktori `solution/` dan sering `start/` atau `your-work/` -- Gambar disimpan dalam folder `images/` khusus pelajaran -- Terjemahan di struktur `translations/{kode-bahasa}/` +- Setiap proyek memiliki direktori `solution/` dan sering juga `start/` atau `your-work/` +- Gambar disimpan di folder `images/` khusus pelajaran +- Terjemahan disimpan dalam struktur `translations/{language-code}/` ## Build dan Deployment @@ -193,7 +193,7 @@ Konfigurasi Azure Static Web Apps: - **Lokasi output**: `dist` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### Pembuatan PDF Dokumentasi +### Generasi PDF Dokumentasi ```bash npm install # Pasang docsify-to-pdf @@ -203,22 +203,22 @@ npm run convert # Hasilkan PDF dari docs ### Dokumentasi Docsify ```bash -npm install -g docsify-cli # Instal Docsify secara global -docsify serve # Jalankan di localhost:3000 +npm install -g docsify-cli # Pasang Docsify secara global +docsify serve # Layani di localhost:3000 ``` ### Build Spesifik Proyek -Setiap direktori proyek dapat memiliki proses build sendiri: -- Proyek Vue: `npm run build` membuat bundle produksi -- Proyek statis: Tidak ada langkah build, file disajikan langsung +Setiap direktori proyek mungkin memiliki proses build sendiri: +- Proyek Vue: `npm run build` untuk membuat bundel produksi +- Proyek statis: Tidak ada langkah build, layani file langsung -## Pedoman Pull Request +## Panduan Pull Request ### Format Judul -Gunakan judul yang jelas dan deskriptif menunjukkan area perubahan: -- `[Quiz-app] Tambah kuis baru untuk pelajaran X` +Gunakan judul jelas yang menggambarkan area perubahan: +- `[Quiz-app] Tambahkan kuis baru untuk pelajaran X` - `[Lesson-3] Perbaiki typo di proyek terrarium` - `[Translation] Tambah terjemahan Spanyol untuk pelajaran 5` - `[Docs] Perbarui instruksi setup` @@ -228,33 +228,33 @@ Gunakan judul yang jelas dan deskriptif menunjukkan area perubahan: Sebelum mengirim PR: 1. **Kualitas Kode**: - - Jalankan `npm run lint` di direktori proyek yang terpengaruh - - Perbaiki semua error dan peringatan linting + - Jalankan `npm run lint` di direktori proyek terkait + - Perbaiki semua error dan peringatan lint 2. **Verifikasi Build**: - - Jalankan `npm run build` jika diperlukan + - Jalankan `npm run build` jika berlaku - Pastikan tidak ada error build -3. **Validasi Tautan**: - - Uji semua tautan markdown +3. **Validasi Link**: + - Uji semua link markdown - Verifikasi referensi gambar berfungsi -4. **Review Konten**: - - Baca ulang pengejaan dan tata bahasa +4. **Tinjau Konten**: + - Proofreading tata bahasa dan ejaan - Pastikan contoh kode benar dan edukatif - Verifikasi terjemahan mempertahankan makna asli ### Persyaratan Kontribusi -- Setuju dengan Microsoft CLA (cek otomatis pada PR pertama) -- Ikuti [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- Lihat [CONTRIBUTING.md](./CONTRIBUTING.md) untuk pedoman rinci -- Cantumkan nomor isu dalam deskripsi PR jika ada +- Setujui Microsoft CLA (pemeriksaan otomatis pada PR pertama) +- Ikuti [Kode Etik Open Source Microsoft](https://opensource.microsoft.com/codeofconduct/) +- Lihat [CONTRIBUTING.md](./CONTRIBUTING.md) untuk panduan rinci +- Referensikan nomor isu dalam deskripsi PR jika ada ### Proses Review -- PR direview oleh maintainer dan komunitas -- Kejelasan edukasi diprioritaskan +- PR direview oleh pemelihara dan komunitas +- Prioritaskan kejelasan edukasi - Contoh kode harus mengikuti praktik terbaik saat ini - Terjemahan direview untuk akurasi dan kesesuaian budaya @@ -263,20 +263,20 @@ Sebelum mengirim PR: ### Terjemahan Otomatis - Menggunakan GitHub Actions dengan workflow co-op-translator -- Menerjemahkan otomatis ke 50+ bahasa +- Menerjemahkan ke lebih dari 50 bahasa secara otomatis - File sumber di direktori utama -- File terjemahan di direktori `translations/{kode-bahasa}/` +- File terjemahan di direktori `translations/{language-code}/` -### Menambahkan Perbaikan Terjemahan Manual +### Menambah Perbaikan Terjemahan Manual -1. Temukan file di `translations/{kode-bahasa}/` -2. Lakukan perbaikan sambil mempertahankan struktur +1. Cari file di `translations/{language-code}/` +2. Buat perbaikan sambil mempertahankan struktur 3. Pastikan contoh kode tetap berfungsi -4. Uji konten kuis yang sudah dilokalkan +4. Uji konten kuis yang sudah diterjemahkan ### Metadata Terjemahan -File terjemahan menyertakan header metadata: +File terjemahan termasuk header metadata: ```markdown **Penafian**: -Dokumen ini telah diterjemahkan menggunakan layanan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Meskipun kami berusaha untuk akurasi, harap diingat bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidakakuratan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang sahih. Untuk informasi penting, disarankan menggunakan terjemahan profesional oleh manusia. Kami tidak bertanggung jawab atas kesalahpahaman atau salah tafsir yang timbul dari penggunaan terjemahan ini. +Dokumen ini telah diterjemahkan menggunakan layanan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Meskipun kami berusaha untuk akurasi, harap diingat bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidakakuratan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang sah. Untuk informasi yang penting, disarankan untuk menggunakan terjemahan profesional oleh manusia. Kami tidak bertanggung jawab atas kesalahpahaman atau penafsiran yang salah yang timbul dari penggunaan terjemahan ini. \ No newline at end of file diff --git a/translations/ms/.co-op-translator.json b/translations/ms/.co-op-translator.json index 3b1460b32..a8e22b26e 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": "2026-04-06T16:50:07+00:00", + "translation_date": "2026-04-20T16:45:17+00:00", "source_file": "AGENTS.md", "language_code": "ms" }, diff --git a/translations/ms/AGENTS.md b/translations/ms/AGENTS.md index e91c224af..0214b8894 100644 --- a/translations/ms/AGENTS.md +++ b/translations/ms/AGENTS.md @@ -2,23 +2,23 @@ ## Gambaran Projek -Ini adalah repositori kurikulum pendidikan untuk mengajar asas pembangunan web kepada pemula. Kurikulum ini adalah kursus lengkap selama 12 minggu yang dibangunkan oleh Microsoft Cloud Advocates, menampilkan 24 pelajaran amali yang merangkumi JavaScript, CSS, dan HTML. +Ini adalah repositori kurikulum pendidikan untuk mengajar asas pembangunan web kepada pemula. Kurikulum ini merupakan kursus menyeluruh selama 12 minggu yang dibangunkan oleh Microsoft Cloud Advocates, menampilkan 24 pelajaran praktikal yang merangkumi JavaScript, CSS, dan HTML. ### Komponen Utama -- **Kandungan Pendidikan**: 24 pelajaran berstruktur yang disusun dalam modul berasaskan projek -- **Projek Praktikal**: Terrarium, Permainan Mengetik, Sambungan Pelayar, Permainan Angkasa, Aplikasi Perbankan, Penyunting Kod, dan Pembantu Sembang AI -- **Kuis Interaktif**: 48 kuis dengan 3 soalan setiap satu (penilaian pra/pasca pelajaran) -- **Sokongan Pelbagai Bahasa**: Terjemahan automatik untuk lebih 50+ bahasa melalui GitHub Actions -- **Teknologi**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (untuk projek AI) +- **Kandungan Pendidikan**: 24 pelajaran tersusun yang dianjurkan dalam modul berasaskan projek +- **Projek Praktikal**: Terrarium, Permainan Mengetik, Sambungan Pelayar, Permainan Angkasa, Aplikasi Perbankan, Penyunting Kod, dan Pembantu Chat AI +- **Kuis Interaktif**: 48 kuiz dengan 3 soalan setiap satu (penilaian sebelum/selepas pelajaran) +- **Sokongan Pelbagai Bahasa**: Terjemahan automatik untuk lebih 50 bahasa melalui GitHub Actions +- **Teknologi**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (untuk projek AI) -### Senibina +### Seni Bina -- Repositori pendidikan dengan struktur berasaskan pelajaran -- Setiap folder pelajaran mengandungi README, contoh kod, dan penyelesaian -- Projek berdikari di direktori berasingan (quiz-app, pelbagai projek pelajaran) -- Sistem terjemahan menggunakan GitHub Actions (co-op-translator) -- Dokumentasi dihidangkan melalui Docsify dan tersedia sebagai PDF +- Repositori pendidikan dengan struktur berasaskan pelajaran +- Setiap folder pelajaran mengandungi README, contoh kod, dan penyelesaian +- Projek bebas di direktori berasingan (quiz-app, pelbagai projek pelajaran) +- Sistem terjemahan menggunakan GitHub Actions (co-op-translator) +- Dokumentasi disajikan melalui Docsify dan tersedia dalam format PDF ## Perintah Persediaan @@ -30,7 +30,7 @@ Repositori ini terutamanya untuk penggunaan kandungan pendidikan. Untuk bekerja git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` - + ### Persediaan Aplikasi Kuis (Vue 3 + Vite) ```bash @@ -40,7 +40,7 @@ npm run dev # Mula pelayan pembangunan npm run build # Bina untuk pengeluaran npm run lint # Jalankan ESLint ``` - + ### API Projek Bank (Node.js + Express) ```bash @@ -50,24 +50,24 @@ npm start # Mula pelayan API npm run lint # Jalankan ESLint npm run format # Format dengan Prettier ``` - + ### Projek Sambungan Pelayar ```bash cd 5-browser-extension/solution npm install -# Ikuti arahan muat naik pelanjutan khusus pelayar +# Ikuti arahan pemuatan pelanjutan khusus pelayar ``` - + ### Projek Permainan Angkasa ```bash cd 6-space-game/solution npm install -# Buka index.html dalam pelayar atau gunakan Live Server +# Buka index.html dalam pelayar atau guna Live Server ``` - -### Projek Sembang (Backend Python) + +### Projek Chat (Backend Python) ```bash cd 9-chat-project/solution/backend/python @@ -75,34 +75,34 @@ pip install openai # Tetapkan pembolehubah persekitaran GITHUB_TOKEN python api.py ``` - + ## Aliran Kerja Pembangunan ### Untuk Penyumbang Kandungan -1. **Fork repositori** ke akaun GitHub anda -2. **Clone fork anda** secara lokal -3. **Buat cawangan baru** untuk perubahan anda -4. Buat perubahan pada kandungan pelajaran atau contoh kod -5. Uji sebarang perubahan kod dalam direktori projek berkaitan -6. Hantar pull request mengikut panduan sumbangan +1. **Fork repositori** ke akaun GitHub anda +2. **Clone fork anda** secara lokal +3. **Buat cawangan baru** untuk perubahan anda +4. Lakukan perubahan pada kandungan pelajaran atau contoh kod +5. Uji sebarang perubahan kod dalam direktori projek berkaitan +6. Hantar pull request mengikut garis panduan sumbangan ### Untuk Pelajar -1. Fork atau clone repositori -2. Navigasi ke direktori pelajaran secara berurutan -3. Baca fail README untuk setiap pelajaran -4. Selesaikan kuis pra-pelajaran di https://ff-quizzes.netlify.app/web/ -5. Kerjakan contoh kod dalam folder pelajaran -6. Lengkapkan tugasan dan cabaran -7. Ambil kuis pasca-pelajaran +1. Fork atau clone repositori +2. Navigasi ke direktori pelajaran secara berurutan +3. Baca fail README untuk setiap pelajaran +4. Selesaikan kuiz pra-pelajaran di https://ff-quizzes.netlify.app/web/ +5. Kerjakan contoh kod dalam folder pelajaran +6. Selesaikan tugasan dan cabaran +7. Ambil kuiz pasca-pelajaran ### Pembangunan Langsung -- **Dokumentasi**: Jalankan `docsify serve` di root (port 3000) -- **Aplikasi Kuis**: Jalankan `npm run dev` di direktori quiz-app -- **Projek**: Gunakan sambungan Live Server VS Code untuk projek HTML -- **Projek API**: Jalankan `npm start` dalam direktori API masing-masing +- **Dokumentasi**: Jalankan `docsify serve` di root (port 3000) +- **Aplikasi Kuis**: Jalankan `npm run dev` di direktori quiz-app +- **Projek**: Gunakan sambungan VS Code Live Server untuk projek HTML +- **Projek API**: Jalankan `npm start` di direktori API berkaitan ## Arahan Ujian @@ -110,173 +110,173 @@ python api.py ```bash cd quiz-app -npm run lint # Semak untuk isu gaya kod -npm run build # Sahkan binaan berjaya +npm run lint # Periksa isu gaya kod +npm run build # Sahkan pembinaan berjaya ``` - + ### Ujian API Bank ```bash cd 7-bank-project/api -npm run lint # Periksa masalah gaya kod +npm run lint # Periksa isu gaya kod node server.js # Sahkan pelayan bermula tanpa ralat ``` - + ### Pendekatan Ujian Umum -- Ini adalah repositori pendidikan tanpa ujian automatik menyeluruh -- Ujian manual memberi fokus kepada: - - Contoh kod berjalan tanpa ralat - - Pautan dalam dokumentasi berfungsi dengan betul - - Projek membina dengan jayanya - - Contoh mengikut amalan terbaik +- Ini adalah repositori pendidikan tanpa ujian automatik menyeluruh +- Ujian manual fokus pada: + - Contoh kod berjalan tanpa ralat + - Pautan dalam dokumentasi berfungsi dengan betul + - Pembinaan projek selesai dengan jayanya + - Contoh mengikuti amalan terbaik -### Semakan Pra-penyerahan +### Semakan Pra-penghantaran -- Jalankan `npm run lint` di direktori dengan package.json -- Sahkan pautan markdown adalah sah -- Uji contoh kod dalam pelayar atau Node.js -- Semak terjemahan mengekalkan struktur betul +- Jalankan `npm run lint` di direktori yang mengandungi package.json +- Sahkan pautan markdown sah +- Uji contoh kod dalam pelayar atau Node.js +- Periksa terjemahan mengekalkan struktur betul ## Garis Panduan Gaya Kod ### JavaScript -- Gunakan sintaks ES6+ moden -- Ikuti konfigurasi ESLint standard yang disediakan dalam projek -- Gunakan nama pembolehubah dan fungsi bermakna untuk kejelasan pendidikan -- Tambah komen yang menerangkan konsep untuk pelajar -- Format menggunakan Prettier apabila dikonfigurasi +- Gunakan sintaks ES6+ moden +- Ikuti konfigurasi ESLint standard yang disediakan dalam projek +- Gunakan nama pemboleh ubah dan fungsi yang bermakna untuk kejelasan pendidikan +- Tambah komen yang menerangkan konsep untuk pelajar +- Format menggunakan Prettier di mana dikonfigurasi ### HTML/CSS -- Elemen semantic HTML5 -- Prinsip reka bentuk responsif -- Konvensyen nama kelas yang jelas -- Komen menerangkan teknik CSS untuk pelajar +- Elemen HTML5 semantik +- Prinsip reka bentuk responsif +- Konvensyen penamaan kelas yang jelas +- Komen menerangkan teknik CSS untuk pelajar ### Python -- Garis panduan gaya PEP 8 -- Contoh kod jelas dan pendidikan -- Petunjuk jenis jika membantu pembelajaran +- Garis panduan gaya PEP 8 +- Contoh kod yang jelas dan pendidikan +- Petunjuk jenis di mana berguna untuk pembelajaran ### Dokumentasi Markdown -- Hierarki tajuk yang jelas -- Blok kod dengan spesifikasi bahasa -- Pautan ke sumber tambahan -- Tangkapan skrin dan imej dalam direktori `images/` -- Teks alt untuk imej demi aksesibiliti +- Hirarki tajuk yang jelas +- Blok kod dengan spesifikasi bahasa +- Pautan ke sumber tambahan +- Tangkapan skrin dan imej dalam direktori `images/` +- Teks alt untuk imej bagi kebolehcapaian ### Pengurusan Fail -- Pelajaran bernombor secara berurutan (1-getting-started-lessons, 2-js-basics, dan lain-lain) -- Setiap projek ada `solution/` dan biasanya `start/` atau `your-work/` direktori -- Imej disimpan dalam folder `images/` khusus pelajaran -- Terjemahan dalam struktur `translations/{language-code}/` +- Pelajaran dinomborkan secara berurutan (1-getting-started-lessons, 2-js-basics, dll.) +- Setiap projek mempunyai direktori `solution/` dan sering `start/` atau `your-work/` +- Imej disimpan dalam folder `images/` khusus pelajaran +- Terjemahan dalam struktur `translations/{language-code}/` -## Pembinaan dan Penyebaran +## Pembinaan dan Penghantaran -### Penyebaran Aplikasi Kuis (Azure Static Web Apps) +### Penghantaran Aplikasi Kuis (Azure Static Web Apps) -quiz-app dikonfigurasi untuk penyebaran Azure Static Web Apps: +quiz-app dikonfigurasi untuk penghantaran Azure Static Web Apps: ```bash cd quiz-app -npm run build # Mewujudkan folder dist/ -# Melaksanakan melalui alur kerja GitHub Actions apabila push ke main +npm run build # Membuat folder dist/ +# Melakukan deploy melalui workflow GitHub Actions apabila ada push ke main ``` - -Konfigurasi Azure Static Web Apps: -- **Lokasi app**: `/quiz-app` -- **Lokasi output**: `dist` -- **Aliran kerja**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` + +Konfigurasi Azure Static Web Apps: +- **Lokasi aplikasi**: `/quiz-app` +- **Lokasi output**: `dist` +- **Aliran kerja**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` ### Penjanaan PDF Dokumentasi ```bash npm install # Pasang docsify-to-pdf -npm run convert # Jana PDF daripada docs +npm run convert # Hasilkan PDF daripada docs ``` - + ### Dokumentasi Docsify ```bash npm install -g docsify-cli # Pasang Docsify secara global docsify serve # Hidangkan pada localhost:3000 ``` - + ### Pembinaan Khusus Projek -Setiap direktori projek mungkin mempunyai proses binaan sendiri: -- Projek Vue: `npm run build` menghasilkan bundel produksi -- Projek statik: Tiada langkah binaan, hidangkan fail secara langsung +Setiap direktori projek mungkin mempunyai proses binaan sendiri: +- Projek Vue: `npm run build` menghasilkan bundle pengeluaran +- Projek statik: Tiada langkah binaan, hidangkan fail secara langsung ## Garis Panduan Pull Request ### Format Tajuk -Gunakan tajuk jelas dan deskriptif yang menunjukkan kawasan perubahan: -- `[Quiz-app] Tambah kuiz baru untuk pelajaran X` -- `[Pelajaran-3] Betulkan kesilapan ejaan dalam projek terrarium` -- `[Terjemahan] Tambah terjemahan Sepanyol untuk pelajaran 5` -- `[Docs] Kemas kini arahan persediaan` +Gunakan tajuk jelas dan deskriptif yang menunjukkan bidang perubahan: +- `[Quiz-app] Tambah kuiz baru untuk pelajaran X` +- `[Lesson-3] Betulkan ejaan dalam projek terrarium` +- `[Translation] Tambah terjemahan Sepanyol untuk pelajaran 5` +- `[Docs] Kemas kini arahan persediaan` -### Semakan Wajib +### Semakan Diperlukan -Sebelum menghantar PR: +Sebelum menghantar PR: -1. **Kualiti Kod**: - - Jalankan `npm run lint` di direktori projek terlibat - - Betulkan semua ralat dan amaran linting +1. **Kualiti Kod**: + - Jalankan `npm run lint` di direktori projek terjejas + - Betulkan semua ralat dan amaran linting -2. **Pengesahan Binaan**: - - Jalankan `npm run build` jika berkenaan - - Pastikan tiada ralat binaan +2. **Pengesahan Pembinaan**: + - Jalankan `npm run build` jika berkaitan + - Pastikan tiada ralat binaan -3. **Pengesahan Pautan**: - - Uji semua pautan markdown - - Sahkan rujukan imej berfungsi +3. **Pengesahan Pautan**: + - Uji semua pautan markdown + - Sahkan rujukan imej berfungsi -4. **Semakan Kandungan**: - - Semak ejaan dan tatabahasa - - Pastikan contoh kod betul dan pendidikan - - Sahkan terjemahan mengekalkan maksud asal +4. **Semakan Kandungan**: + - Semak ejaan dan tatabahasa + - Pastikan contoh kod tepat dan pendidikan + - Sahkan terjemahan mengekalkan maksud asal ### Keperluan Penyumbangan -- Setuju dengan Microsoft CLA (semakan automatik pada PR pertama) -- Ikuti [Kod Etika Sumber Terbuka Microsoft](https://opensource.microsoft.com/codeofconduct/) -- Rujuk [CONTRIBUTING.md](./CONTRIBUTING.md) untuk panduan terperinci -- Rujuk nombor isu dalam penerangan PR jika berkenaan +- Setuju dengan Microsoft CLA (semakan automatik pada PR pertama) +- Ikuti [Kod Etika Sumber Terbuka Microsoft](https://opensource.microsoft.com/codeofconduct/) +- Lihat [CONTRIBUTING.md](./CONTRIBUTING.md) untuk garis panduan terperinci +- Rujuk nombor isu dalam penerangan PR jika berkenaan ### Proses Semakan -- PR disemak oleh penyelenggara dan komuniti -- Kejelasan pendidikan diberi keutamaan -- Contoh kod harus mengikut amalan terbaik semasa -- Terjemahan disemak dari segi ketepatan dan kesesuaian budaya +- PR disemak oleh penyelenggara dan komuniti +- Kejelasan pendidikan diutamakan +- Contoh kod harus mengikuti amalan terbaik terkini +- Terjemahan disemak ketepatan dan kesesuaian budaya ## Sistem Terjemahan ### Terjemahan Automatik -- Menggunakan GitHub Actions dengan workflow co-op-translator -- Menerjemah ke 50+ bahasa secara automatik -- Fail sumber dalam direktori utama -- Fail terjemahan dalam `translations/{language-code}/` direktori +- Menggunakan GitHub Actions dengan aliran kerja co-op-translator +- Menterjemah ke 50+ bahasa secara automatik +- Fail sumber dalam direktori utama +- Fail terjemahan dalam direktori `translations/{language-code}/` ### Menambah Penambahbaikan Terjemahan Manual -1. Cari fail dalam `translations/{language-code}/` -2. Lakukan penambahbaikan sambil mengekalkan struktur -3. Pastikan contoh kod masih berfungsi -4. Uji sebarang kandungan kuiz yang dilokalkan +1. Cari fail dalam `translations/{language-code}/` +2. Lakukan penambahbaikan sambil mengekalkan struktur +3. Pastikan contoh kod kekal berfungsi +4. Uji sebarang kandungan kuiz yang dialih bahasa ### Metadata Terjemahan -Fail terjemahan termasuk pengepala metadata: +Fail terjemahan termasuk tajuk metadata: ```markdown ``` - -## Pengesanan Masalah dan Penyelesaian Masalah -### Isu Lazim +## Pengesanan dan Penyelesaian Masalah + +### Isu Biasa -**Aplikasi kuis gagal mula**: -- Semak versi Node.js (disyorkan v14+) -- Padam `node_modules` dan `package-lock.json`, jalankan `npm install` semula -- Semak konflik port (default: Vite menggunakan port 5173) +**Aplikasi kuiz gagal dimulakan**: +- Periksa versi Node.js (disyorkan v14+) +- Padamkan `node_modules` dan `package-lock.json`, jalankan `npm install` semula +- Semak konflik port (lalai: Vite guna port 5173) -**Server API tidak mula**: -- Sahkan versi Node.js memenuhi minimum (node >=10) -- Semak sama ada port sudah digunakan -- Pastikan semua kebergantungan dipasang dengan `npm install` +**Pelayan API tidak mula**: +- Sahkan versi Node.js memenuhi minimum (node >=10) +- Periksa jika port sudah digunakan +- Pastikan semua kebergantungan dipasang dengan `npm install` -**Sambungan pelayar tidak dimuatkan**: -- Sahkan manifest.json diformat dengan betul -- Semak konsol pelayar untuk ralat -- Ikut arahan pemasangan sambungan khusus pelayar +**Sambungan pelayar tidak dimuat**: +- Periksa manifest.json diformat dengan betul +- Semak konsol pelayar untuk ralat +- Ikuti arahan pemasangan sambungan khusus pelayar -**Isu projek chat Python**: -- Pastikan pakej OpenAI dipasang: `pip install openai` -- Sahkan pembolehubah persekitaran GITHUB_TOKEN diset -- Semak kebenaran akses Model GitHub +**Isu projek chat Python**: +- Pastikan pakej OpenAI dipasang: `pip install openai` +- Sahkan pembolehubah persekitaran GITHUB_TOKEN diset +- Periksa kebenaran akses GitHub Models -**Docsify tidak menghidang dokumentasi**: -- Pasang docsify-cli secara global: `npm install -g docsify-cli` -- Jalankan dari direktori root repositori -- Semak bahawa `docs/_sidebar.md` wujud +**Docsify tidak menyajikan dokumen**: +- Pasang docsify-cli secara global: `npm install -g docsify-cli` +- Jalankan dari direktori root repositori +- Semak bahawa `docs/_sidebar.md` wujud -### Petua Persekitaran Pembangunan +### Tips Persekitaran Pembangunan -- Gunakan VS Code dengan sambungan Live Server untuk projek HTML -- Pasang sambungan ESLint dan Prettier untuk format konsisten -- Gunakan DevTools pelayar untuk pengesanan JavaScript -- Untuk projek Vue, pasang sambungan Vue DevTools pelayar +- Gunakan VS Code dengan sambungan Live Server untuk projek HTML +- Pasang sambungan ESLint dan Prettier untuk format konsisten +- Gunakan DevTools pelayar untuk debug JavaScript +- Untuk projek Vue, pasang sambungan Vue DevTools pelayar ### Pertimbangan Prestasi -- Bilangan fail terjemahan yang banyak (50+ bahasa) bermakna klon penuh adalah besar -- Gunakan shallow clone jika hanya bekerja pada kandungan: `git clone --depth 1` -- Kecualikan terjemahan daripada carian apabila bekerja pada kandungan Bahasa Inggeris -- Proses binaan mungkin lambat pada larian pertama (npm install, binaan Vite) +- Bilangan fail terjemahan yang banyak (50+ bahasa) menyebabkan klon penuh besar +- Gunakan clone cetek jika hanya bekerja dengan kandungan: `git clone --depth 1` +- Kecualikan terjemahan dari carian ketika bekerja pada kandungan Inggeris +- Proses binaan mungkin perlahan pada kali pertama (npm install, binaan Vite) ## Pertimbangan Keselamatan ### Pembolehubah Persekitaran -- Kekunci API tidak harus pernah dikomit ke repositori -- Gunakan fail `.env` (sudah dalam `.gitignore`) -- Dokumentasikan pembolehubah persekitaran diperlukan dalam README projek +- Kunci API tidak boleh dimuat naik ke repositori +- Gunakan fail `.env` (sudah disenarai dalam `.gitignore`) +- Dokumentasikan pembolehubah persekitaran yang diperlukan dalam README projek ### Projek Python -- Gunakan persekitaran maya: `python -m venv venv` -- Pastikan kebergantungan dikemas kini -- Token GitHub harus mempunyai kebenaran minimum diperlukan +- Gunakan persekitaran maya: `python -m venv venv` +- Kemas kini kebergantungan secara berkala +- Token GitHub hendaklah mempunyai kebenaran minimum diperlukan -### Akses Model GitHub +### Akses GitHub Models -- Token Akses Peribadi (PAT) diperlukan untuk Model GitHub -- Token harus disimpan sebagai pembolehubah persekitaran -- Jangan sekali-kali komit token atau kelayakan +- Token Akses Peribadi (PAT) diperlukan untuk GitHub Models +- Token disimpan sebagai pembolehubah persekitaran +- Jangan sesekali memuat naik token atau kelayakan ## Nota Tambahan -### Audiens Sasaran +### Sasaran Pengguna -- Pemula lengkap dalam pembangunan web -- Pelajar dan pembelajar kendiri -- Guru yang menggunakan kurikulum dalam bilik darjah -- Kandungan direka untuk aksesibiliti dan pembinaan kemahiran secara berperingkat +- Pemula lengkap dalam pembangunan web +- Pelajar dan pembelajar kendiri +- Guru yang menggunakan kurikulum dalam bilik darjah +- Kandungan direka untuk kebolehcapaian dan pembinaan kemahiran secara berperingkat ### Falsafah Pendidikan -- Pendekatan pembelajaran berasaskan projek -- Pemeriksaan ilmu yang kerap (kuis) -- Latihan pengkodan amali -- Contoh aplikasi dunia nyata -- Fokus pada asas sebelum kerangka kerja +- Pendekatan pembelajaran berasaskan projek +- Pemeriksaan pengetahuan kerap (kuiz) +- Latihan amali pengkodan +- Contoh aplikasi dunia sebenar +- Fokus pada asas sebelum kerangka kerja ### Penyelenggaraan Repositori -- Komuniti pembelajar dan penyumbang yang aktif -- Kemas kini berkala ke kebergantungan dan kandungan -- Isu dan perbincangan dipantau oleh penyelenggara -- Kemas kini terjemahan automatik melalui GitHub Actions +- Komuniti pelajar dan penyumbang aktif +- Kemas kini kandungan dan kebergantungan secara berkala +- Isu dan perbincangan dipantau oleh penyelenggara +- Kemas kini terjemahan automatik melalui GitHub Actions ### Sumber Berkaitan -- [Modul Microsoft Learn](https://docs.microsoft.com/learn/) -- [Sumber Student Hub](https://docs.microsoft.com/learn/student-hub/) -- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) disyorkan untuk pelajar -- Kursus tambahan: AI Generatif, Sains Data, ML, kurikulum IoT tersedia +- [Modul Microsoft Learn](https://docs.microsoft.com/learn/) +- [Sumber Pelajar Student Hub](https://docs.microsoft.com/learn/student-hub/) +- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) disyorkan untuk pelajar +- Kursus tambahan: AI Generatif, Sains Data, ML, kurikulum IoT tersedia ### Bekerja dengan Projek Tertentu -Untuk arahan terperinci mengenai projek individu, rujuk fail README dalam: -- `quiz-app/README.md` - aplikasi kuis Vue 3 -- `7-bank-project/README.md` - aplikasi perbankan dengan pengesahan -- `5-browser-extension/README.md` - pembangunan sambungan pelayar -- `6-space-game/README.md` - pembangunan permainan berasaskan canvas -- `9-chat-project/README.md` - projek pembantu sembang AI +Untuk arahan terperinci projek individu, rujuk fail README di: +- `quiz-app/README.md` - aplikasi kuiz Vue 3 +- `7-bank-project/README.md` - aplikasi perbankan dengan pengesahan +- `5-browser-extension/README.md` - pembangunan sambungan pelayar +- `6-space-game/README.md` - pembangunan permainan berasaskan canvas +- `9-chat-project/README.md` - projek pembantu chat AI ### Struktur Monorepo -Walaupun bukan monorepo tradisional, repositori ini mengandungi pelbagai projek bebas: -- Setiap pelajaran adalah berdikari -- Projek tidak berkongsi kebergantungan -- Bekerja pada projek individu tanpa menjejaskan projek lain -- Klon keseluruhan repo untuk pengalaman kurikulum penuh +Walaupun bukan monorepo tradisional, repositori ini mengandungi pelbagai projek bebas: +- Setiap pelajaran berdiri sendiri +- Projek tidak berkongsi kebergantungan +- Kerja pada projek individu tanpa menjejaskan yang lain +- Clone keseluruhan repositori untuk pengalaman kurikulum penuh --- **Penafian**: -Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Walaupun kami berusaha untuk ketepatan, sila diberi perhatian bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidakakuratan. Dokumen asal dalam bahasa asalnya hendaklah dianggap sebagai sumber yang sahih. Untuk maklumat kritikal, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab terhadap sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini. +Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Walaupun kami berusaha untuk ketepatan, sila maklum bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang sahih. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab terhadap sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini. \ No newline at end of file diff --git a/translations/tl/.co-op-translator.json b/translations/tl/.co-op-translator.json index 48502440e..16df302f0 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": "2026-04-06T16:51:17+00:00", + "translation_date": "2026-04-20T16:46:27+00:00", "source_file": "AGENTS.md", "language_code": "tl" }, diff --git a/translations/tl/AGENTS.md b/translations/tl/AGENTS.md index a00876411..caaf09c40 100644 --- a/translations/tl/AGENTS.md +++ b/translations/tl/AGENTS.md @@ -2,27 +2,27 @@ ## Project Overview -Ito ay isang edukasyonal na repositoryo ng kurikulum para sa pagtuturo ng mga pundasyon ng web development sa mga nagsisimula. Ang kurikulum ay isang komprehensibong 12-linggong kurso na binuo ng Microsoft Cloud Advocates, na may 24 na hands-on na aralin na sumasaklaw sa JavaScript, CSS, at HTML. +Ito ay isang edukasyonal na repositoryo ng kurikulum para sa pagtuturo ng mga pangunahing kaalaman sa web development sa mga nagsisimula. Ang kurikulum ay isang komprehensibong 12-linggong kurso na binuo ng Microsoft Cloud Advocates, na nagtatampok ng 24 na hands-on na aralin na sumasaklaw sa JavaScript, CSS, at HTML. ### Key Components -- **Nilalamang Pang-edukasyon**: 24 na istrukturadong aralin na inayos sa mga module batay sa proyekto -- **Mga Praktikal na Proyekto**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, at AI Chat Assistant -- **Mga Interactive na Quiz**: 48 na quiz na may tig-3 tanong bawat isa (pre/post-lesson assessments) -- **Suporta sa Maramihang Wika**: Awtomatikong pagsasalin para sa 50+ na wika gamit ang GitHub Actions +- **Nilalaman Pang-edukasyon**: 24 na istrukturadong aralin na inayos sa mga proyekto bilang mga modulo +- **Praktikal na Mga Proyekto**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, at AI Chat Assistant +- **Interaktibong Mga Quiz**: 48 na quiz na may tig-3 tanong bawat isa (pagsusulit bago/pagkatapos ng aralin) +- **Suporta sa Maraming Wika**: Awtomatikong pagsasalin para sa 50+ na wika gamit ang GitHub Actions - **Mga Teknolohiya**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para sa mga AI na proyekto) ### Architecture -- Edukasyonal na repositoryo na may lesson-based na estruktura -- Bawat folder ng aralin ay naglalaman ng README, mga halimbawa ng code, at mga solusyon -- Mga standalone na proyekto sa hiwalay na mga direktoryo (quiz-app, iba't ibang proyekto ng aralin) +- Edukasyonal na repositoryo na may istruktura batay sa mga aralin +- Ang bawat folder ng aralin ay naglalaman ng README, mga halimbawa ng code, at mga solusyon +- Mga standalone na proyekto sa hiwalay na mga direktoryo (quiz-app, iba't ibang mga proyekto sa aralin) - Sistema ng pagsasalin gamit ang GitHub Actions (co-op-translator) -- Dokumentasyon na ipinapakita sa pamamagitan ng Docsify at available bilang PDF +- Dokumentasyon na ibinibigay sa pamamagitan ng Docsify at available bilang PDF ## Setup Commands -Ang repositoryong ito ay pangunahing para sa pagkonsumo ng edukasyonal na nilalaman. Para sa pagtatrabaho sa mga partikular na proyekto: +Ang repositoryong ito ay pangunahing para sa konsumpsyon ng edukasyonal na nilalaman. Para sa pagtatrabaho sa mga partikular na proyekto: ### Main Repository Setup @@ -37,7 +37,7 @@ cd Web-Dev-For-Beginners cd quiz-app npm install npm run dev # Simulan ang development server -npm run build # Bumuo para sa produksyon +npm run build # I-build para sa produksyon npm run lint # Patakbuhin ang ESLint ``` @@ -56,7 +56,7 @@ npm run format # I-format gamit ang Prettier ```bash cd 5-browser-extension/solution npm install -# Sundin ang mga tagubilin para sa pag-load ng extension na tiyak sa browser +# Sundin ang mga tagubilin sa pag-load ng extension na partikular sa browser ``` ### Space Game Projects @@ -72,37 +72,37 @@ npm install ```bash cd 9-chat-project/solution/backend/python pip install openai -# Itakda ang environment variable na GITHUB_TOKEN +# Itakda ang GITHUB_TOKEN na variable ng kapaligiran python api.py ``` ## Development Workflow -### Para sa mga Content Contributors +### Para sa mga Contributor ng Nilalaman -1. **I-fork ang repository** sa iyong GitHub account +1. **I-fork ang repositoryo** sa iyong GitHub account 2. **I-clone ang iyong fork** nang lokal -3. **Gumawa ng bagong branch** para sa iyong mga pagbabago -4. Gumawa ng mga pagbabago sa nilalaman ng aralin o mga halimbawa ng code -5. Subukan ang anumang mga pagbabago sa code sa mga kaukulang direktoryo ng proyekto -6. Mag-submit ng pull request alinsunod sa mga panuntunan ng kontribusyon +3. **Gumawa ng bagong sanga** para sa iyong mga pagbabago +4. Gawin ang mga pagbabago sa nilalaman ng aralin o mga halimbawa ng code +5. Subukan ang anumang pagbabago sa code sa mga kaukulang direktoryo ng proyekto +6. Mag-submit ng pull requests alinsunod sa mga gabay sa kontribusyon -### Para sa mga Learners +### Para sa mga Nag-aaral -1. Mag-fork o mag-clone ng repositoryo -2. Pumunta sa mga direktoryo ng aralin nang sunud-sunod -3. Basahin ang mga README na file para sa bawat aralin -4. Kumpletuhin ang mga pre-lesson quiz sa https://ff-quizzes.netlify.app/web/ -5. Gawing ang mga halimbawa ng code sa mga folder ng aralin -6. Tapusin ang mga assignment at hamon -7. Kunin ang mga post-lesson quiz +1. I-fork o i-clone ang repositoryo +2. Mag-navigate sa mga direktoryo ng aralin sunod-sunod +3. Basahin ang mga README file para sa bawat aralin +4. Kumpletuhin ang mga pre-lesson quizzes sa https://ff-quizzes.netlify.app/web/ +5. Trabahuhin ang mga halimbawa ng code sa mga folder ng aralin +6. Kumpletuhin ang mga takdang-aralin at hamon +7. Sagutan ang mga post-lesson quizzes ### Live Development - **Dokumentasyon**: Patakbuhin ang `docsify serve` sa root (port 3000) -- **Quiz App**: Patakbuhin ang `npm run dev` sa direktoryo ng quiz-app +- **Quiz App**: Patakbuhin ang `npm run dev` sa folder ng quiz-app - **Mga Proyekto**: Gamitin ang VS Code Live Server extension para sa mga HTML na proyekto -- **API Projects**: Patakbuhin ang `npm start` sa kaukulang mga direktoryo ng API +- **API Projects**: Patakbuhin ang `npm start` sa mga kaukulang API na direktoryo ## Testing Instructions @@ -110,71 +110,71 @@ python api.py ```bash cd quiz-app -npm run lint # Suriin ang mga isyu sa estilo ng code -npm run build # Tiyakin na matagumpay ang build +npm run lint # Suriin kung may mga isyu sa istilo ng kodigo +npm run build # Tiyakin na matagumpay ang pagbuo ``` ### Bank API Testing ```bash cd 7-bank-project/api -npm run lint # Suriin ang mga isyu sa istilo ng code -node server.js # Tiyakin na nagsisimula ang server nang walang mga error +npm run lint # Suriin ang mga isyu sa estilo ng code +node server.js # Tiyaking nagsisimula ang server nang walang mga error ``` -### General Testing Approach +### Pangkalahatang Paraan ng Pagsusuri -- Ito ay isang edukasyonal na repositoryo na walang kumpletong automated tests -- Manual testing ay nakatuon sa: - - Mga halimbawa ng code na tumatakbo nang walang error - - Mga link sa dokumentasyon ay gumagana nang tama - - Proyekto ay matagumpay na na-build - - Mga halimbawa ay sumusunod sa pinakamahusay na kasanayan +- Ito ay isang edukasyonal na repositoryo na walang komprehensibong automated tests +- Ang manual na pagsusuri ay nakatuon sa: + - Hindi nagkakaroon ng error ang mga halimbawa ng code kapag pinatakbo + - Gumagana nang maayos ang mga links sa dokumentasyon + - Matagumpay ang pagbuo ng mga proyekto + - Sumusunod ang mga halimbawa sa pinakamahusay na mga kasanayan -### Pre-submission Checks +### Mga Pre-submission Checks -- Patakbuhin ang `npm run lint` sa mga direktoryo na may package.json -- Siguraduhing ang mga markdown link ay valid +- Patakbuhin ang `npm run lint` sa mga direktoryong may package.json +- Tiyakin na wasto ang mga markdown links - Subukan ang mga halimbawa ng code sa browser o Node.js -- Suriin na ang mga pagsasalin ay nagpapanatili ng tamang estruktura +- Suriin na ang mga pagsasalin ay nananatiling maayos ang istruktura ## Code Style Guidelines ### JavaScript -- Gumamit ng modernong ES6+ na sintaks -- Sundan ang standard na ESLint configurations na ibinigay sa mga proyekto -- Gumamit ng makahulugang pangalan ng mga variable at function para sa kalinawan sa edukasyon -- Magdagdag ng mga komento na nagpapaliwanag ng mga konsepto para sa mga nag-aaral +- Gumamit ng makabagong ES6+ na syntax +- Sundin ang mga standard ESLint na konfigurasyon na ibinigay sa mga proyekto +- Gumamit ng makabuluhang mga pangalan ng variable at function para sa kalinawan sa edukasyon +- Magdagdag ng mga paliwanag na komentaryo tungkol sa mga konsepto para sa mga nag-aaral - I-format gamit ang Prettier kung saan naka-configure ### HTML/CSS -- Semantic na HTML5 na mga elemento +- Semantic HTML5 elements - Mga prinsipyo ng responsive design -- Malinaw na klaseng pagnenaming mga kombensiyon -- Mga komento na nagpapaliwanag ng mga teknik sa CSS para sa mga nag-aaral +- Malinaw na conventions sa pagbibigay ng pangalan sa mga klase +- Mga komentaryo na nagpapaliwanag ng mga teknik sa CSS para sa mga nag-aaral ### Python -- PEP 8 na mga gabay sa estilo -- Malinaw, edukasyonal na mga halimbawa ng code -- Mga type hint kung makakatulong sa pag-aaral +- Mga patnubay sa estilo ayon sa PEP 8 +- Malinaw, pang-edukasyonal na mga halimbawa ng code +- Mga type hint kung nakakatulong sa pag-aaral ### Markdown Documentation - Malinaw na hierarchy ng mga heading -- Mga code block na may pagtukoy ng wika +- Mga code block na may pagspecify ng wika - Mga link sa karagdagang mga mapagkukunan -- Mga screenshot at mga larawan sa `images/` na mga direktoryo +- Mga screenshot at larawan sa mga `images/` na mga direktoryo - Alt text para sa mga larawan para sa accessibility ### File Organization -- Mga aralin na naka-numero nang sunud-sunod (1-getting-started-lessons, 2-js-basics, atbp.) -- Bawat proyekto ay may `solution/` at madalas ay `start/` o `your-work/` na mga direktoryo -- Mga larawan na nakaimbak sa aralin-nakatuong mga folder na `images/` -- Mga pagsasalin sa `translations/{language-code}/` na istruktura +- Ang mga aralin ay may sunud-sunod na bilang (1-getting-started-lessons, 2-js-basics, atbp.) +- Ang bawat proyekto ay may `solution/` at madalas `start/` o `your-work/` na mga direktoryo +- Ang mga larawan ay naka-imbak sa mga lesson-specific na `images/` folder +- Mga pagsasalin sa istrukturang `translations/{language-code}/` ## Build and Deployment @@ -184,11 +184,11 @@ Ang quiz-app ay naka-configure para sa Azure Static Web Apps deployment: ```bash cd quiz-app -npm run build # Lumilikha ng folder na dist/ -# Nagde-deploy gamit ang GitHub Actions workflow sa push sa main +npm run build # Lumilikha ng dist/ folder +# Nagde-deploy gamit ang GitHub Actions workflow kapag may push sa main ``` -Azure Static Web Apps configuration: +Azure Static Web Apps na konfigurasyon: - **App location**: `/quiz-app` - **Output location**: `dist` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` @@ -207,76 +207,76 @@ npm install -g docsify-cli # I-install ang Docsify nang globally docsify serve # I-serve sa localhost:3000 ``` -### Project-specific Builds +### Mga Build na Nakatuon sa Proyekto -Bawat direktoryo ng proyekto ay maaaring may sarili nitong proseso ng pag-build: -- Vue projects: `npm run build` ay lumilikha ng production bundles -- Static projects: Walang build step, direktang nagseserbisyo ng mga file +Ang bawat direktoryo ng proyekto ay maaaring may sariling proseso ng build: +- Vue projects: `npm run build` na lumilikha ng mga production bundles +- Static projects: Walang build step, direktang pag-serbisyo ng mga file ## Pull Request Guidelines -### Title Format +### Format ng Pamagat -Gumamit ng malinaw, deskriptibong mga titulo na nagpapakita ng bahagi ng pagbabago: -- `[Quiz-app] Magdagdag ng bagong quiz para sa aralin X` -- `[Lesson-3] Ayusin ang typo sa terrarium na proyekto` -- `[Translation] Magdagdag ng pagsasalin sa Spanish para sa aralin 5` -- `[Docs] I-update ang mga tagubilin sa setup` +Gumamit ng malinaw, deskriptibong mga pamagat na nagpapakita ng bahagi ng pagbabago: +- `[Quiz-app] Add new quiz for lesson X` +- `[Lesson-3] Fix typo in terrarium project` +- `[Translation] Add Spanish translation for lesson 5` +- `[Docs] Update setup instructions` -### Required Checks +### Mga Kinakailangang Pag-check Bago magsumite ng PR: 1. **Kalidad ng Code**: - - Patakbuhin ang `npm run lint` sa mga naapektuhang direktoryo ng proyekto - - Ayusin lahat ng linting errors at warnings + - Patakbuhin ang `npm run lint` sa mga apektadong proyekto + - Ayusin ang lahat ng linting error at babala -2. **Build Verification**: - - Patakbuhin ang `npm run build` kung naaangkop +2. **Pag-verify ng Build**: + - Patakbuhin ang `npm run build` kung kinakailangan - Siguraduhing walang error sa build -3. **Link Validation**: - - Subukan ang lahat ng markdown links - - Siguraduhing gumagana ang mga image references +3. **Pag-validate ng Link**: + - Subukan ang lahat ng markdown link + - Siguraduhing gumagana ang mga reference ng larawan -4. **Content Review**: - - Proofread para sa spelling at grammar - - Siguraduhin na ang mga halimbawa ng code ay tama at edukasyonal - - Suriin na ang mga pagsasalin ay nananatili ang orihinal na kahulugan +4. **Pagsusuri ng Nilalaman**: + - Proofread para sa baybay at gramatika + - Siguraduhing tama at edukasyonal ang mga halimbawa ng code + - I-verify ang mga pagsasalin ay nananatili ang orihinal na kahulugan -### Contribution Requirements +### Mga Kinakailangan sa Kontribusyon -- Sumasang-ayon sa Microsoft CLA (awtomatikong tseke sa unang PR) -- Sundan ang [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- Tingnan ang [CONTRIBUTING.md](./CONTRIBUTING.md) para sa detalyadong mga panuntunan -- Banggitin ang mga numero ng isyu sa deskripsiyon ng PR kung naaangkop +- Sumang-ayon sa Microsoft CLA (automated check sa unang PR) +- Sundin ang [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) +- Tumingin sa [CONTRIBUTING.md](./CONTRIBUTING.md) para sa mga detalyadong gabay +- Banggitin ang mga numero ng isyu sa paglalarawan ng PR kung angkop -### Review Process +### Proseso ng Review -- Ang mga PR ay nire-review ng mga maintainers at komunidad +- Ang mga PR ay sinusuri ng mga maintainer at komunidad - Pinapahalagahan ang kalinawan sa edukasyon -- Ang mga halimbawa ng code ay dapat sumunod sa kasalukuyang pinakamahusay na mga kasanayan -- Ang mga pagsasalin ay nire-review para sa katumpakan at angkop sa kultura +- Dapat sundin ng mga halimbawa ng code ang kasalukuyang best practices +- Sinusuri ang mga pagsasalin para sa katumpakan at angkop na kultura ## Translation System ### Automated Translation -- Gumagamit ng GitHub Actions sa co-op-translator workflow -- Awtomatikong nagsasalin sa 50+ na mga wika -- Source files ay nasa main directories -- Mga isinaling file ay nasa `translations/{language-code}/` na mga direktoryo +- Gumagamit ng GitHub Actions na may co-op-translator workflow +- Nagsasalin sa 50+ na wika nang awtomatiko +- Mga source file sa mga pangunahing direktoryo +- Mga naisaling file sa `translations/{language-code}/` na mga direktoryo -### Adding Manual Translation Improvements +### Pagdaragdag ng Manual na Pagpapabuti sa Pagsasalin 1. Hanapin ang file sa `translations/{language-code}/` -2. Gumawa ng mga pagpapabuti habang pinapanatili ang estruktura -3. Siguraduhin na ang mga halimbawa ng code ay nananatiling gumagana -4. Subukan ang anumang lokal na nilalaman ng quiz +2. Gawin ang mga pagpapabuti nang pinananatili ang istruktura +3. Siguraduhing nananatiling gumagana ang mga halimbawa ng code +4. Subukan ang anumang lokal na nilalamang quiz -### Translation Metadata +### Metadata ng Pagsasalin -Ang mga isinaling file ay may kasama na metadata header: +Ang mga naisaling file ay may kasamang metadata header: ```markdown -**Pagsasanggalang**: -Ang dokumentong ito ay isinalin gamit ang AI translation service na [Co-op Translator](https://github.com/Azure/co-op-translator). Habang nagsusumikap kami para sa katumpakan, pakatandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga error o kamalian. Ang orihinal na dokumento sa katutubong wika nito ang dapat ituring na opisyal na sanggunian. Para sa mahahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot sa anumang hindi pagkakaintindihan o maling interpretasyon na nagmula sa paggamit ng pagsasaling ito. +**Paunawa**: +Ang dokumentong ito ay isinalin gamit ang AI translation service na [Co-op Translator](https://github.com/Azure/co-op-translator). Bagaman nagsusumikap kami para sa katuparan, pakatandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o hindi pagkakatugma. Ang orihinal na dokumento sa orihinal nitong wika ang dapat ituring na pangunahing sanggunian. Para sa mga mahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot para sa anumang hindi pagkakaunawaan o maling interpretasyon na nagmumula sa paggamit ng pagsasaling ito. \ No newline at end of file