Panduan Pengguna

1. Pengenalan

Selamat datang ke Aplikasi Tajwid Al-Quran — platform pembelajaran interaktif yang mengajar hukum tajwid, menyemak sebutan anda semasa membaca, menguji hafazan anda, dan menjawab soalan anda tentang Al-Quran dan hukum tajwid.

Teks Al-Quran sentiasa dipaparkan dalam tulisan Uthmani Arab. Antara muka aplikasi (butang, menu, dan penerangan) diterjemahkan ke lebih daripada 68 bahasa mengikut pilihan anda dari menu bahasa di bahagian atas halaman.

2. Papan Pemuka dan Tab Utama

Apabila aplikasi dibuka, tiga tab utama akan muncul:

Setiap jubin hukum membuka halaman yang menunjukkan ayat-ayat di mana hukum tersebut muncul dengan pewarnaan perkataan, audio qari rujukan, dan terjemahan/tafsir ayat mengikut bahasa paparan.

3. Bahasa dan Bantuan

Pilihan Bahasa

Di bahagian atas kiri setiap halaman (atau atas kanan dalam bahasa kanan-ke-kiri) anda akan menemui menu Bahasa. Pilih bahasa anda — butang menu, tajuk, dan penerangan akan berubah serta-merta. Bahasa lalai adalah Arab.

Butang Bantuan

Di sebelah menu Bahasa terdapat butang «Bantuan». Ini akan membuka panduan ini dalam bahasa semasa anda dalam tetingkap baharu. Jika terjemahan bahasa anda belum tersedia, panduan akan dipaparkan dalam bahasa Arab.

Kembali ke Papan Pemuka

Butang «Papan Hukum Tajwid» di bahagian atas kanan halaman akan membawa anda kembali ke halaman utama dari mana-mana sub-halaman.

4. Halaman Hukum Tajwid

Setiap halaman hukum memaparkan:

• Definisi hukum dalam bahasa Arab dengan terjemahan/transliterasi dalam bahasa paparan.
• Jadual atau mushaf yang menyerlahkan perkataan yang terjejas dengan warna yang berbeza.
• Pilihan qari dan memainkan audio ayat atau halaman.
• Penyerlahan perkataan semasa main balik (karaoke): penyerlahan bergerak bersama qari perkataan demi perkataan.
• Medan terjemahan: dari Kalimat.dev atau tafsir tempatan mengikut bahasa yang dipilih.

Mainkan Audio dan Pilih Perkataan

• Klik tunggal pada perkataan: Memilihnya sebagai titik permulaan (penyerlahan biru langit).
• Klik tunggal pada perkataan lain: Meluaskan pilihan untuk menjadi julat antara dua perkataan.
• Klik di dalam julat yang dipilih: Memainkan audio untuk julat yang dipilih sahaja dengan penjejakan bacaan (karaoke).
• Klik di luar julat: Memilih semula perkataan baharu yang diklik.
• Klik dua kali: Memilih perkataan dan membacanya secara individu.
• Seret (Sentuh/Seret Tetikus): Untuk memilih segmen dengan satu sentuhan dan memainkannya sebaik sahaja dilepaskan.
• Butang «Dengar»: Membaca dari perkataan yang dipilih hingga akhir ayat (dalam mod ayat dan halaman) dengan pewarnaan karaoke untuk perkataan.
• Butang «Ulang»: Memainkan semula segmen yang dipilih dalam gelung untuk latihan.
• Klik di luar kawasan ayat: Membatalkan pilihan supaya butang «Dengar» kembali membaca ayat dari awal.

5. Bacaan Pintar (Pembetulan Sebutan)

Halaman /r/recite/ membolehkan anda membaca di hadapan mikrofon dengan pengesahan perkataan demi perkataan menggunakan model transkripsi Al-Quran khusus (Whisper).

Susun Atur Skrin

Dari atas ke bawah:

1. Kawasan Kawalan: Pilihan surah, julat (ayat/halaman/surah), qari, mikrofon, dan ambang penerimaan.
2. Bar Navigasi: Main/henti audio ayat, kemudian butang « » untuk ayat dan « › » untuk perkataan dan untuk ulang.
3. Panduan Warna Tajwid: Muncul terus di atas teks ayat untuk memudahkan rujukan semasa membaca.
4. Teks Ayat: Perkataan yang diwarnakan dan diserlahkan untuk perkataan semasa.

Mula Membaca

1. Pilih surah dan julat (satu ayat disyorkan untuk pemula).
2. Teks dipaparkan secara automatik apabila halaman dibuka atau surah ditukar.
3. Masukkan e-mel anda (disimpan sekali untuk semua halaman).
4. Tekan «Mula Membaca» dan benarkan pelayar mengakses mikrofon.
5. Baca perkataan yang diserlahkan; apabila sebutan betul, ia akan bertukar hijau dan penyerlahan akan beralih ke perkataan seterusnya.

Butang Navigasi

Ambang Penerimaan Perkataan

Anda boleh melaraskan ambang keyakinan minimum (dari 30% hingga 70%) melalui peluncur. Perkataan diterima jika sebutannya mencapai atau melebihi ambang ini. Perkataan di bawah ambang akan dipaparkan markahnya dalam warna oren untuk membantu anda memperbaikinya.

Pewarnaan Hukum Tajwid

Aktifkan «Pewarnaan Hukum Tajwid» untuk melihat warna petunjuk pada perkataan (قلقلة, غنة, إخفاء (Ikhfāʾ), إظهار, لام الجلالة…). Ia boleh dimatikan jika anda mahukan mushaf tanpa warna.

Penilaian Hukum Tajwid (Pilihan)

Apabila «Penilaian Hukum Tajwid» diaktifkan, المد (Madd), الغنة, dan القلقلة juga akan diperiksa secara akustik — keyakinan audio sahaja tidak mencukupi.

Cari Mengikut Bacaan

Tekan «Cari Mengikut Bacaan» dan baca beberapa perkataan; aplikasi akan memaparkan ayat-ayat yang sepadan. Pilih ayat untuk membukanya secara langsung.

Markah Perkataan dan Padam

Apabila kembali ke ayat yang telah dibaca, markah anda akan dipaparkan pada setiap perkataan. Gunakan «Padam Markah Julat» untuk memadam markah ayat/halaman/surah dan cuba lagi.

6. Ujian Hafazan (Tasmi')

Halaman /r/hifz/ menguji hafazan anda: ayat bermula kosong, dan setiap perkataan muncul apabila disebut dengan betul.

• Tekan «Mula» dan baca dari ingatan; perkataan yang betul akan muncul secara beransur-ansur.
• Kesalahan sebutan akan mengeluarkan nada amaran tanpa mendedahkan perkataan.
• Anda boleh «Tunjukkan Perkataan» atau «Tunjukkan Ayat» secara manual sebagai petunjuk.
• Peralihan ke ayat seterusnya adalah manual melainkan anda telah menyelesaikan keseluruhan ayat dengan betul.
• Markah kumulatif untuk surah dan keseluruhan Al-Quran akan direkodkan dan dikaitkan dengan e-mel anda.

7. Pembantu Pintar

Dari tab «Pembantu Pintar» atau halaman /r/chatbot/ anda boleh bertanya soalan tentang:

• Hukum tajwid (Apakah الإخفاء? Di mana ia berlaku dalam سورة …?)
• Teks Al-Quran (Berapa banyak ayat dalam Juz Amma? Ayat-ayat yang mengandungi perkataan …)
• Carian mengikut akar kata, pengulangan, atau ejaan/tulisan Uthmani

Pembantu menggunakan pangkalan pengetahuan tajwid dan pangkalan data Al-Quran dengan Gemini-2.5-flash untuk menjawab dalam bahasa anda. Anda boleh:

• Luaskan kotak soalan (seret tepi bawah atau taip beberapa baris dengan Shift+Enter).
• Buka perbualan baharu, arkibkan, padam, atau muat turun sebagai PDF/Markdown.
• Gunakan soalan contoh untuk permulaan pantas.

8. Markah dan Laporan

Masukkan e-mel anda sekali — ia digunakan untuk bacaan, hafazan, dan ujian tajwid. Markah disimpan dalam pangkalan data dan anda boleh:

• Lihat markah kumulatif untuk surah dan Al-Quran dalam bar status.
• Semak percubaan anda sebelumnya untuk setiap ayat.
• Minta «Hantar Laporan PDF Saya» untuk menghantar laporan terperinci ke e-mel anda (purata, tertinggi, terendah, tarikh).

9. Tetapan Audio

Dari butang «Audio» di halaman bacaan atau hafazan:

• Mikrofon: Pilih peranti input jika terdapat lebih daripada satu.
• Pembesar Suara: Pilih peranti output (disokong dalam Chrome/Edge; mungkin tidak berfungsi dalam Safari).
• Penunjuk Tahap: Bar hijau menunjukkan kekuatan suara anda semasa membaca.
• Diagnostik: Log teknikal untuk menyelesaikan masalah transkripsi (tambah ?debug=1 pada pautan).

10. Soalan Lazim

Mengapa aplikasi menjangkakan perkataan yang tidak saya sebut (seperti Basmalah)?

Sesetengah qari memulakan dengan Basmalah sebelum «Alif Lam Mim» atau «Alif Lam Ra» di awal surah. Kami telah membetulkannya dengan mengesan permulaan dan menjajarkan semula. Jika masalah berterusan, gunakan diagnostik atau cuba lagi selepas tiga percubaan gagal, aplikasi akan beralih secara automatik.

Adakah ia berfungsi pada mudah alih?

Ya — Chrome pada Android dan Safari pada iOS. Anda mungkin memerlukan klik pertama untuk mengaktifkan audio (dasar pelayar).

Adakah data saya peribadi?

Markah dikaitkan dengan e-mel anda dan diasingkan antara pengguna. Rakaman audio tidak dikongsi dengan pihak ketiga — ia diproses di pelayan hanya untuk pengesahan.

Dari mana datangnya terjemahan ayat-ayat?

Kalimat.dev, pangkalan data tempatan, atau Tafsir Jalalain yang diterjemahkan melalui Gemini untuk bahasa yang tidak disokong — dan bukan terjemahan langsung teks Al-Quran oleh kecerdasan buatan.