Panduan Guru

Impor & Ekspor Soal (Word, Markdown, Excel)

Panduan lengkap format impor soal dari Microsoft Word (.docx), paket Markdown (.md / .zip) bergambar, tabel Excel/CSV, serta fitur Tarik Soal Online.

Untuk memudahkan guru memindahkan naskah soal yang sudah diketik, NILUJI mendukung 4 metode pemasukan soal masal sekaligus fitur Export Bank Soal (.zip) untuk dibagikan antar-guru.


1. Impor dari Microsoft Word (.docx)

Buka halaman paket soal, klik Import Soal, lalu pilih Dari Word (.docx). Anda cukup menyiapkan:

  1. Berkas Naskah Soal (.docx):
    • Setiap soal diawali nomor urut (1., 2., 3., dst.).
    • Pilihan jawaban diawali huruf A., B., C., D. (dan E. jika 5 opsi).
    • Gambar yang ditempel (paste) di dalam paragraf soal maupun di dalam baris opsi jawaban Word akan otomatis diekstrak dan diunggah ke database lokal NILUJI.
    • Untuk soal Esai, cukup tulis teks pertanyaan bernomor tanpa diikuti opsi A. sampai D..
  2. Berkas Kunci Jawaban (.docx) (opsional, bisa digabung atau dipisah):
    • Berisi daftar kunci seperti 1. B, 2. C, atau tabel kunci jawaban beserta skor poin dan pedoman penskoran esai.

Sebelum disimpan, NILUJI menampilkan Tabel Pratinjau Interaktif sehingga Anda bisa memeriksa dan mengedit setiap soal, kunci jawaban, maupun gambar yang terdeteksi.


2. Impor & Ekspor Paket Markdown (.md / .zip)

Format Markdown sangat ideal untuk menyimpan arsip bank soal yang ringan, rapi, dan mudah dibagikan.

Contoh Struktur Berkas .md:

contoh-soal.md
---
kelas: "6"
pelajaran: "Matematika"
jenis: "STS Ganjil"
pin: "1234"
---

## Soal 1

Perhatikan gambar bangun datar berikut:

![soal](gambar/soal-1.png)

Berapakah luas bangun datar di atas?

- A. 24 cm² ![opsi-A](gambar/soal-1-opsi-A.png)
- B. 36 cm²
- C. 48 cm²
- D. 64 cm²

**Kunci:** C
**Poin:** 2

## Soal 2

Tuliskan rumus keliling lingkaran dan jelaskan arti setiap variabelnya!

**Tipe:** esai
**Poin:** 5
**Pedoman:** Menuliskan K = 2 x pi x r atau K = pi x d beserta keterangan r (jari-jari) dan d (diameter).
Saat Anda mengklik tombol Export di halaman Bank Soal, NILUJI otomatis mengemas seluruh soal, gambar pertanyaan (gambar/soal-{id}.{ext}), dan gambar opsi jawaban (gambar/soal-{id}-opsi-{A-E}.{ext}) ke dalam satu berkas .zip yang dilindungi PIN. Berkas .zip tersebut dapat langsung diimpor kembali di komputer lain melalui menu Import Soal > Dari Markdown (.md / .zip).

3. Impor dari Tabel Excel / CSV

Pilih Import Soal > Dari CSV / Excel jika Anda memiliki daftar soal berbentuk tabel dengan kolom:

  • Pertanyaan
  • Tipe (pg atau esai)
  • A, B, C, D, E
  • Kunci (A / B / C / D / E)
  • Poin
  • Pedoman

4. Tarik Soal Online dari Repositori GitHub

Jika tim guru di sekolah atau gugus kecamatan mengunggah hasil Export Bank Soal ke repositori GitHub:

  1. Buka Pengaturan > Setting Data > Tarik Soal Online.
  2. Pilih Kelas, Mata Pelajaran, dan Jenis Ujian Tujuan.
  3. Masukkan PIN Paket Soal yang diberikan oleh penyusun soal, periksa pratinjau butir soal beserta gambar soal dan gambar opsinya, lalu klik Simpan ke Bank Soal.