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

78 lines
4.8 KiB

<!--
CO_OP_TRANSLATOR_METADATA:
{
"original_hash": "71009af209f81cc01a1f2d324200375f",
"translation_date": "2025-10-03T10:19:06+00:00",
"source_file": "for-teachers.md",
"language_code": "ms"
}
-->
### Untuk Pendidik
Anda dialu-alukan untuk menggunakan kurikulum ini di dalam kelas anda. Ia berfungsi dengan lancar bersama GitHub Classroom dan platform LMS terkemuka, dan juga boleh digunakan sebagai repositori mandiri dengan pelajar anda.
### Penggunaan dengan GitHub Classroom
Untuk menguruskan pelajaran dan tugasan mengikut kumpulan, buat satu repositori bagi setiap pelajaran supaya GitHub Classroom dapat melampirkan setiap tugasan secara bebas.
- Fork repositori ini ke organisasi anda.
- Buat repositori berasingan untuk setiap pelajaran dengan mengekstrak folder pelajaran ke dalam repositori masing-masing.
- Pilihan A: Buat repositori kosong (satu untuk setiap pelajaran) dan salin kandungan folder pelajaran ke dalam setiap satu.
- Pilihan B: Gunakan pendekatan yang mengekalkan sejarah Git (contohnya, pecahkan folder ke repositori baru) jika anda memerlukan asal usul.
- Dalam GitHub Classroom, buat tugasan bagi setiap pelajaran dan pautkan ke repositori pelajaran yang sepadan.
- Tetapan yang disyorkan:
- Kebolehlihatan repositori: peribadi untuk kerja pelajar.
- Gunakan kod permulaan dari cabang lalai repositori pelajaran.
- Tambahkan templat isu dan permintaan tarik untuk kuiz dan penghantaran.
- Konfigurasikan penggredan automatik dan ujian jika pelajaran anda menyertakannya.
- Konvensyen yang membantu:
- Nama repositori seperti lesson-01-intro, lesson-02-html, dan sebagainya.
- Label: kuiz, tugasan, perlu-ulasan, lewat, penghantaran semula.
- Tag/pelepasan mengikut kumpulan (contohnya, v2025-term1).
Tip: Elakkan menyimpan repositori di dalam folder yang diselaraskan (contohnya, OneDrive/Google Drive) untuk mengelakkan konflik Git pada Windows.
### Penggunaan dengan Moodle, Canvas, atau Blackboard
Kurikulum ini termasuk pakej yang boleh diimport untuk aliran kerja LMS yang biasa.
- Moodle: Gunakan fail muat naik Moodle [Moodle upload file](../../../../../../../teaching-files/webdev-moodle.mbz) untuk memuatkan keseluruhan kursus.
- Common Cartridge: Gunakan fail Common Cartridge [Common Cartridge file](../../../../../../../teaching-files/webdev-common-cartridge.imscc) untuk keserasian LMS yang lebih luas.
- Nota:
- Moodle Cloud mempunyai sokongan Common Cartridge yang terhad. Lebih baik gunakan fail Moodle di atas, yang juga boleh dimuat naik ke Canvas.
- Selepas import, semak modul, tarikh akhir, dan tetapan kuiz untuk disesuaikan dengan jadual penggal anda.
![Moodle](../../translated_images/moodle.94eb93d714a50cb2c97435b408017dee224348b61bc86203ffd43a4f4e57b95f.ms.png)
> Kurikulum dalam kelas Moodle
![Canvas](../../translated_images/canvas.fbd605ff8e5b8aff567d398528ce113db304446b90b9cad55c654de3fdfcda34.ms.png)
> Kurikulum dalam Canvas
### Penggunaan repositori secara langsung (tanpa Classroom)
Jika anda lebih suka tidak menggunakan GitHub Classroom, anda boleh menjalankan kursus secara langsung dari repositori ini.
- Format segerak/atas talian (Zoom/Teams):
- Jalankan pemanasan pendek yang dipimpin mentor; gunakan bilik pecahan untuk kuiz.
- Umumkan jangka masa untuk kuiz; pelajar menghantar jawapan sebagai Isu GitHub.
- Untuk tugasan kolaboratif, pelajar bekerja dalam repositori pelajaran awam dan membuka permintaan tarik.
- Format peribadi/tidak segerak:
- Pelajar fork setiap pelajaran ke repositori **peribadi** mereka sendiri dan tambahkan anda sebagai kolaborator.
- Mereka menghantar melalui Isu (kuiz) dan Permintaan Tarik (tugasan) pada repositori kelas anda atau fork peribadi mereka.
### Amalan terbaik
- Sediakan pelajaran orientasi tentang asas Git/GitHub, Isu, dan PR.
- Gunakan senarai semak dalam Isu untuk kuiz/tugasan berbilang langkah.
- Tambahkan CONTRIBUTING.md dan CODE_OF_CONDUCT.md untuk menetapkan norma kelas.
- Tambahkan nota kebolehaksesan (teks alt, kapsyen) dan tawarkan PDF yang boleh dicetak.
- Versikan kandungan anda mengikut penggal dan bekukan repositori pelajaran selepas diterbitkan.
### Maklum balas dan sokongan
Kami ingin kurikulum ini berfungsi untuk anda dan pelajar anda. Sila buka Isu baru dalam repositori ini untuk laporan pepijat, permintaan, atau penambahbaikan, atau mulakan perbincangan di Teacher Corner.
---
**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 penting, terjemahan manusia profesional adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini.