---
title: "Panduan guru"
description: "Bina kursus dalam Quire, tulis halaman bersama-sama, dan tetapkan serta tanda kerja."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/ms/llms.txt
> Use this file to discover all available pages before exploring further.

# Panduan guru

<span id="teacher-guide"></span>

Mula dengan sebuah kursus di mana peranan anda membenarkan penyuntingan. Siapkan
struktur kursus terlebih dahulu, kemudian tambah aktiviti dan tentukan cara pelajar
menerima maklum balas.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/teacher-edit-mode.webp" alt="A course page in edit mode. The top bar shows View and Edit links with Edit selected, and an accent line runs under the bar." width="1032" height="720" loading="lazy" decoding="async"><figcaption>Choose Edit in the top bar to change a course in place. View shows it as learners see it.</figcaption></figure>

Anda membina kursus, menulis halaman mereka, menetapkan kerja dan menandanya.
Kursus anda disenaraikan di `/teaching`.

## Sebuah kursus <!--quire:a-course-->

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/teacher-edit-sections.webp" alt="The course outline in edit mode: each section and activity has a checkbox, a drag handle and Move, Restrict, Edit and Permissions buttons." width="1032" height="760" loading="lazy" decoding="async"><figcaption>In edit mode every section and activity can be moved, restricted, edited and given permissions.</figcaption></figure>

Sebuah kursus mempunyai bahagian, dan setiap bahagian memegang aktiviti: halaman,
fail, kuiz, tugasan, forum, pakej SCORM, alat LTI dan banyak lagi. Daripada halaman
kursus:

- **Tambah aktiviti**: pilih bahagian, kemudian jenis aktiviti. Setiap aktiviti
  boleh mempunyai tarikh hantar, syarat penyiakan dan sekatan, seperti "hanya
  selepas kuiz sebelumnya lulus".
- **Peserta** (`/courses/<course>/participants`): siapa yang didaftarkan dan dalam
  peranan apa. **Kaedah pendaftaran** menentukan cara orang menyertai: ditambah
  oleh anda, pendaftaran kendiri dengan satu kunci pilihan, satu kohort, atau
  pembayaran.
- **Kumpulan** (`/courses/<course>/groups`): bahagikan sebuah kursus supaya setiap
  kumpulan melihat benang forum dan penyerahannya sendiri.
- **Buku gred** (`/courses/<course>/gradebook`): setiap aktiviti bergred sebagai
  satu lajad. Tetapkan bobot dan kategori di bawah **Tetapan**, lihat gred seorang
  pelajar di bawah **Pengguna**, dan import atau eksport satu himpunan data.
- **Penyiakan**: syarat yang menjadikan kursus itu selesai, yang memacu sijil dan
  laporan. Penyiakan direkodkan dan dilaporkan bagi orang yang dinilai oleh
  organisasi anda, jadi guru yang didaftarkan dalam kursus itu tidak muncul dalam
  laporan kemajuan. Buku gred menyenaraikan orang yang sama.
- **Bank kandungan** (`/courses/<course>/content-bank`): simpan satu fail atau
  kandungan interaktif sekali dan gunakannya semula. Lihat
  [panduan bank kandungan](/ms/teacher/content-bank/).
- **Sandaran** dan **Import**: salin sebuah kursus, atau bawa masuk satu sandaran
  Moodle.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/teacher-participants.webp" alt="The Participants page, a filterable table of enrolled people with their roles, enrolment method and status." width="1032" height="640" loading="lazy" decoding="async"><figcaption>Participants: who is enrolled, in which role and by which method.</figcaption></figure>

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/teacher-groups.webp" alt="The Groups page listing a seminar group and its members, each with a Remove button." width="1032" height="640" loading="lazy" decoding="async"><figcaption>Groups split a course so each group can have its own forum threads and submissions.</figcaption></figure>

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/teacher-gradebook.webp" alt="The grader report, with a row for each learner and a column for each graded activity, and tabs for other gradebook views." width="1032" height="640" loading="lazy" decoding="async"><figcaption>The grader report: every graded activity is a column.</figcaption></figure>

## Menulis halaman bersama <!--quire:writing-pages-together-->

Buka satu halaman dan pilih **Edit bersama**. Semua orang yang menyunting halaman
pada saat yang sama melihat kursor antara satu sama lain, setiap satu dengan
warnanya sendiri berserta namanya, dan setiap perubahan muncul kepada yang lain
sebaik sahaja ia ditaip. Tiada apa-apa hilang jika dua orang menaip dalam ayat yang
sama.

- **Komen**: pilih teks, tulis di bawah **Komen pada teks yang dipilih** dan pilih
  **Hantar komen**. Komen itu kekal terlekat pada teks tersebut walaupun kata-kata
  di sekelilingnya disunting; **Tunjuk dalam dokumen** menemuinya. Jika teks itu
  dipadam, benang itu menyatakan demikian dan bukannya hilang. Balas dalam benang
  tersebut, dan **Selesaikan** apabila ia selesai.
- **Versi**: berikan keadaan semasa halaman itu satu nama dan pilih **Simpan
  versi**. **Pulihkan versi ini** membawanya yang lebih awal kembali sebagai satu
  perubahan baharu, jadi pemulihan itu sendiri boleh dibatalkan.
- **Terbitkan ke halaman**: pelajar melihat perubahan anda hanya apabila anda
  menerbitkan. Menyunting bersama mengubah draf, bukan sekali-kali apa yang sedang
  dibaca oleh pelajar.

Jika perkhidmatan penyuntingan kolaboratif tidak berjalan pada pemasangan anda,
halaman menyatakan demikian dan anda menyuntingnya sendiri seperti biasa.

## Kuiz <!--quire:quizzes-->

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/teacher-questions.webp" alt="The course question bank with search, category and tag filters and a list of questions." width="1032" height="700" loading="lazy" decoding="async"><figcaption>The question bank keeps every version of every question.</figcaption></figure>

Sebuah kuiz menarik soalan daripada bank soalan (`/questions`), di mana setiap
soalan menyimpan versinya. Bina kuiz daripada soalan tetap atau rawak daripada satu
kategori, tetapkan had masa, percubaan dan pilihan semakan, kemudian pratontonnya
seperti yang akan dilihat oleh seorang pelajar. Selepas percubaan masuk:

- **Penandaan kuiz** menanda soalan yang memerlukan seorang manusia, seperti esei.
- **Tanda semula** mengira semula percubaan selepas anda membetulkan satu soalan.
- **Laporan kuiz** menunjukkan kemudahan dan diskriminasi setiap soalan, supaya
  satu soalan yang mengelirukan menonjol.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/teacher-quiz-reports.webp" alt="Quiz reports showing the latest mark for each learner and tabs for Grades, Responses, Manual grading and Statistics." width="1032" height="700" loading="lazy" decoding="async"><figcaption>Quiz reports: grades, responses, manual grading and statistics.</figcaption></figure>

### Statistik soalan dalam bank <!--quire:question-statistics-in-the-bank-->

Angka yang sama mengikut setiap soalan ke dalam bank soalan. Setelah pelajar
menyiapkan percubaan yang menggunakan sesebuah soalan dan statistik kuiz sudah
dikira, halaman soalan itu memaparkan **Statistik penggunaan** bagi setiap versi:
percubaan, indeks kemudahan, indeks diskriminasi, kecekapan diskriminasi dan bila
ia terakhir digunakan. Angka disimpan setiap versi, digumpulkan merentas setiap
kuiz yang menggunakan versi itu, jadi sebuah soalan yang ditulis semula bermula
semula.

Sebuah versi yang kelihatan salah dilabel **Perlu diperiksa**, dengan sebabnya:
diskriminasi rendah bermakna semak semula soalan itu, dan diskriminasi negatif
bermakna semak kunci jawapan. Pada senarai bank, pilih **Hanya soalan yang perlu
diperiksa** untuk melihatnya bersama. Sebuah versi tanpa percubaan yang mencukupi
menyatakan bahawa data tidak mencukupi dan bukannya memaparkan satu nombor.

## Tugasan <!--quire:assignments-->

Pelajar menyerahkan fail atau teks. Buka **Penandaan** pada tugasan itu untuk
menanda penyerahan satu demi satu, anotasi satu PDF yang diserahkan dalam peramban,
guna satu rubrik atau panduan penandaan, dan berikan maklum balas. Sambungan dan
pembetulan adalah setiap pelajar atau setiap kumpulan. Markah boleh kekal
tersembunyi sehingga anda melepaskannya semua serentak.

## Glosari <!--quire:glossary-->

Sebuah glosari memegang istilah yang ditulis bersama oleh sebuah kursus. Satu
entri boleh dipaut di mana-mana sahaja teks kursus menyebut konsepnya atau salah
satu daripada kata lainnya: tanda **Paut konsep ini di mana-mana teks kursus
menyebutnya**, dan pilih sama ada padanan mengabaikan huruf besar dan sama ada ia
hanya memadankan perkataan penuh. Guru meluluskan entri sebelum orang lain boleh
membacanya, dan sebuah glosari boleh diimport dan dieksport sebagai CSV.

Pelajar melihat pautan di mana sahaja mereka membaca teks kursus: halaman pelajaran,
catatan forum, pengenalan tugasan, wiki, pangkalan data, sembang, glosari, aktiviti
interaktif dan bengkel, kriteria bengkel, teks soalan kuiz dalam satu percubaan, dan
ringkasan kursus serta bahagian. Pautan itu ditambah apabila halaman dipaparkan dan
tidak pernah disimpan, jadi menyunting satu halaman tidak meninggalkan pautan di
dalamnya. Satu entri glosari tidak dipaut kepada dirinya sendiri. Jika sebuah
kursus mempunyai terlalu banyak entri yang dipaut automatik, pautan tidak
dipaparkan dan glosari menyatakan untuk mematikan pemautan automatik bagi glosari
yang tidak memerlukannya.

## SCORM dan pakej lain <!--quire:scorm-and-other-packages-->

Sebuah aktiviti SCORM atau AICC menyampaikan satu pakej SCORM 1.2, SCORM 2004
(edisi ke-2, ke-3 atau ke-4) atau AICC. Pakej SCORM 2004 berjalan dengan peraturan
susunan dan navigasinya sendiri, jadi apa yang boleh dibuka oleh seorang pelajar
seterusnya, dan apa yang kekal tidak tersedia sehingga bahagian terdahulu selesai,
mengikut pakej itu. Pemacu memaparkan **Kandungan**, **Sebelumnya** dan **Teruskan**,
**Simpan dan keluar**, **Keluar**, dan **Mulakan pakej semula** untuk memulakan
satu percubaan baharu. Tetapkan percubaan yang dibenarkan, percubaan mana yang
bergred dan bagaimana setiap percubaan diberi skor di bawah tetapan aktiviti itu.
Laporan pakej itu sendiri menunjukkan percubaan dan hasil setiap pelajar.

## Jenis aktiviti lain <!--quire:more-activity-types-->

- **Temu janji** (perancang): selepas satu mesyuarat, rekod pada halaman perancang
  sama ada pelajar itu hadir, satu gred pada mata atau skala, satu nota yang hanya
  boleh dibaca kakitangan dan satu nota yang boleh dibaca pelajar. Gred itu pergi
  ke buku gred sebagai yang terbaik atau purata temu janji mereka, dan penyiakan
  boleh menuntut satu temu janji yang dihadiri.
- **Kehadiran**: cipta sesi, ulanginya setiap sekian banyak hari atau minggu
  sehingga satu tarikh, edit status (sembunyikan satu yang sudah digunakan dan
  bukannya memadamnya), dan muat turun laporan sebagai CSV, XLSX atau ODS.
- **Pangkalan data**: simpan medan dan templat pangkalan data sebagai satu pratetap,
  kongsikannya dengan kursus-kursus lain organisasi, gunakannya pada pangkalan data
  lain, dan eksport atau import pratetap dalam format pratetap Moodle atau sebagai
  JSON Quire. Sebuah pratetap Moodle yang diimport melaporkan apa yang tidak
  disimpan oleh Quire, seperti templat pengepala, pengaki dan skrip.
- **Surat maklum balas**: instrumen yang diterbitkan seperti ATTLS dan COLLES,
  termasuk COLLES yang ditanya dua kali, pilihan dan sebenar, dengan jurang
  antaranya dilaporkan.

## Kursus dikongsi <!--quire:shared-courses-->

Sebuah organisasi boleh berkongsi sebuah kursus dengan organisasi lain untuk
digunakan. Jika anda mengajar dalam organisasi yang mengambilnya, kursus itu
muncul dalam senarai kursus anda sendiri, dalam kategori **Dikongsi dengan kami**,
dan merupakan sebuah kursus biasa anda: anda boleh mendaftar pelajar, menanda kerja
mereka dan melihat mereka dalam buku gred anda. Kuiz, pakej SCORM dan aktiviti
lainnya berjalan seperti dalam mana-mana kursus. Anda boleh mengedit atau memadam
aktiviti dalam salinan anda. Apabila pemilik menerbitkan versi baharu, aktiviti
yang mereka tambahkan muncul dalam salinan anda, dan aktiviti yang sudah anda ada
dibiarkan sebagaimana adanya. Forum, wiki, sembang, bengkel dan pangkalan data
ditutup dalam kursus sedemikian melainkan kedua-dua organisasi telah bersetuju
membukanya. Lihat [perkongsian antara organisasi](/ms/admin/sharing/).

## Pelajar luar talian <!--quire:offline-learners-->

Pelajar boleh memuat turun sebuah kursus untuk dipelajari tanpa sambungan (lihat
[panduan pelajar](/ms/learner/#offline)). Apa yang mereka tanda semasa luar talian
dihantar apabila mereka menyambung semula. Jika anda mengubah kursus itu dalam
masa itu, Quire mengekalkan kerja pelajar itu dan memberitahu mereka apa yang
berubah.

## Transkrip tutor AI <!--quire:ai-tutor-transcripts-->

Jika organisasi anda menggunakan tutor AI, anda boleh membuka perbualan pelajar di
`/courses/<course>/transcripts`. Membuka satu direkodkan, dan pelajar melihat
bahawa seorang kakitangan membacanya, siapa, dan bila. Baca satu apabila anda
mempunyai sebab pengajaran untuk berbuat demikian.

## Bahasa dan kebolehcapaian <!--quire:language-and-accessibility-->

Tulis dalam bahasa organisasi anda. Label dan butang milik Quire sendiri muncul
dalam bahasa pilihan setiap pelajar, kanan-ke-kiri untuk Arab, Ibrani, Parsi dan
Urdu. Tambahkan teks alternatif untuk setiap imej dan kapsyen untuk setiap video:
Quire meminta kedua-duanya semasa anda memuat naik.

Source: https://docs.quirelms.com/ms/teacher/index.mdx
