Guide de l'utilisateur

1. Introduction

Bienvenue dans l'Application de Tajwid du Saint Coran — une plateforme éducative interactive qui enseigne les règles de Tajwid, vérifie votre prononciation pendant la récitation, teste votre mémorisation et répond à vos questions sur le Coran et les règles de Tajwid.

Le texte du Saint Coran est toujours affiché en écriture arabe ottomane. L'interface de l'application (boutons, menus et explications) est traduite dans plus de 68 langues selon votre choix dans le menu de langue en haut de la page.

2. Tableau de bord et onglets

Lorsque vous ouvrez l'application, trois onglets principaux apparaissent :

Chaque tuile de règle ouvre une page affichant les versets où la règle apparaît avec les mots colorés, la voix du récitateur de référence, et la traduction/explication du verset selon la langue d'affichage.

3. Langue et aide

Choix de la langue

En haut à gauche de chaque page (ou en haut à droite dans les langues de droite à gauche), vous trouverez le menu de langue. Choisissez votre langue — les boutons de menu, les titres et les explications changent immédiatement. La langue par défaut est l'arabe.

Bouton d'aide

À côté du menu de langue se trouve le bouton « Aide ». Il ouvre ce guide dans votre langue actuelle dans une nouvelle fenêtre. Si la traduction de votre langue n'est pas encore disponible, le guide est affiché en arabe.

Retour au tableau de bord

Le bouton « Tableau des règles de Tajwid » en haut à droite de la page vous ramène à la page principale depuis n'importe quelle sous-page.

4. Pages des règles de Tajwid

Chaque page de règle affiche :

• Définition de la règle en arabe avec traduction/transcription dans la langue d'affichage.
• Tableau ou Mushaf qui met en évidence les mots affectés par une couleur distinctive.
• Choix du récitateur et lecture audio du verset ou de la page.
• Mise en évidence des mots pendant la lecture (karaoké) : la mise en évidence se déplace mot par mot avec le récitateur.
• Champ de traduction : de Kalimat.dev ou de l'explication locale selon la langue choisie.

Lecture audio et sélection de mots

• Clic simple sur un mot : le sélectionne comme point de départ (mise en évidence bleu ciel).
• Clic simple sur un autre mot : étend la sélection pour former une plage entre les deux mots.
• Clic à l'intérieur de la plage sélectionnée : lit l'audio uniquement pour la plage sélectionnée avec suivi de la lecture (karaoké).
• Clic en dehors de la plage : réinitialise la sélection au nouveau mot cliqué.
• Double-clic : sélectionne le mot et le lit seul.
• Glisser (Touch/Mouse Drag) : pour sélectionner un passage d'un seul geste et le lire dès le relâchement.
• Bouton « Écouter » : lit du mot sélectionné jusqu'à la fin du verset (en mode verset et page) avec coloration karaoké des mots.
• Bouton « Répéter » : rejoue le passage sélectionné en boucle pour s'entraîner.
• Clic en dehors de la zone du verset : annule la sélection pour que le bouton « Écouter » lise le verset depuis le début.

5. Récitation intelligente (correction de la prononciation)

La page /r/recite/ vous permet de réciter devant le microphone avec une vérification mot par mot à l'aide d'un modèle de transcription coranique personnalisé (Whisper).

Disposition de l'écran

De haut en bas :

1. Zone de contrôle : sélection de la sourate, de la plage (verset/page/sourate), du récitateur, du microphone et du seuil d'acceptation.
2. Barre de navigation : lecture/pause de l'audio du verset, puis boutons « » pour les versets et « › » pour les mots et pour la répétition.
3. Guide des couleurs de Tajwid : apparaît directement au-dessus du texte du verset pour faciliter la révision pendant la récitation.
4. Texte du verset : les mots colorés et mis en évidence pour le mot actuel.

Démarrer la récitation

1. Choisissez la sourate et la plage (un seul verset est recommandé pour les débutants).
2. Le texte est affiché automatiquement à l'ouverture de la page ou au changement de sourate.
3. Entrez votre adresse e-mail (enregistrée une seule fois pour toutes les pages).
4. Cliquez sur « Démarrer la récitation » et autorisez le navigateur à accéder au microphone.
5. Lisez le mot mis en évidence ; si la prononciation est correcte, il devient vert et la mise en évidence passe au mot suivant.

Boutons de navigation

Seuil d'acceptation du mot

Vous pouvez ajuster le seuil de confiance minimum (de 30 % à 70 %) via le curseur. Un mot est accepté si sa prononciation atteint ou dépasse ce seuil. Un mot en dessous du seuil affiche son score en orange pour vous aider à vous améliorer.

Coloration des règles de Tajwid

Activez « Coloration des règles de Tajwid » pour voir les couleurs d'indication sur les mots (القلقلة (Qalqalah), الغنة (Ghunnah), الإخفاء (Ikhfāʾ), الإظهار (Iẓhār), لام الجلالة (Lām al-Jalālah)…). Il peut être désactivé si vous souhaitez un Mushaf sans couleurs.

Évaluation des règles de Tajwid (facultatif)

Lorsque « Évaluation des règles de Tajwid » est activé, le المد (Madd), la الغنة (Ghunnah) et la القلقلة (Qalqalah) sont également vérifiés acoustiquement — la confiance audio seule ne suffit pas.

Recherche par récitation

Cliquez sur « Recherche par récitation » et lisez quelques mots ; l'application affiche les versets correspondants. Choisissez un verset pour l'ouvrir directement.

Scores des mots et effacement

Lorsque vous revenez à un verset précédemment récité, vos scores apparaissent sur chaque mot. Utilisez « Effacer les scores de la plage » pour effacer les scores du verset/de la page/de la sourate et réessayer.

6. Test de mémorisation (Tasmīʿ)

La page /r/hifz/ teste votre mémorisation : le verset commence vide, et chaque mot apparaît lorsqu'il est prononcé correctement.

• Cliquez sur « Démarrer » et lisez de mémoire ; les mots corrects apparaissent progressivement.
• Une erreur de prononciation émet une tonalité d'alerte sans révéler le mot.
• Vous pouvez « Afficher le mot » ou « Afficher le verset » manuellement comme indice.
• Le passage au verset suivant est manuel sauf si vous avez complété tout le verset correctement.
• Les scores cumulatifs pour la sourate et pour tout le Coran sont enregistrés et liés à votre e-mail.

7. Assistant intelligent

Depuis l'onglet « Assistant intelligent » ou la page /r/chatbot/, vous pouvez poser des questions sur :

• Les règles de Tajwid (Qu'est-ce que l'الإخفاء (Ikhfāʾ) ? Où se trouve-t-il dans la sourate … ?)
• Le texte du Coran (Combien de versets dans le Juz' 'Amma ? Versets contenant le mot …)
• La recherche par racine, répétition ou écriture orthographique/ottomane

L'assistant utilise la base de connaissances du Tajwid et la base de données du Coran avec Gemini-2.5-flash pour répondre dans votre langue. Vous pouvez :

• Agrandir la boîte de question (faites glisser le bord inférieur ou tapez plusieurs lignes avec Shift+Entrée).
• Ouvrir de nouvelles conversations, les archiver, les supprimer ou les télécharger en PDF/Markdown.
• Utiliser les questions modèles pour un démarrage rapide.

8. Scores et rapports

Entrez votre e-mail une seule fois — il est utilisé pour la récitation, la mémorisation et le test de Tajwid. Les scores sont enregistrés dans la base de données et vous pouvez :

• Voir le score cumulatif pour la sourate et pour le Coran dans la barre d'état.
• Revoir vos tentatives précédentes pour chaque verset.
• Demander « Envoyer mon rapport PDF » pour qu'un rapport détaillé soit envoyé à votre e-mail (moyenne, plus élevé, plus bas, dates).

9. Paramètres audio

Depuis le bouton « Audio » sur la page de récitation ou de mémorisation :

• Microphone : Choisissez le périphérique d'entrée s'il y en a plusieurs.
• Haut-parleur : Choisissez le périphérique de sortie (pris en charge dans Chrome/Edge ; peut ne pas fonctionner dans Safari).
• Indicateur de niveau : Une barre verte montre la puissance de votre voix pendant la récitation.
• Diagnostic : Un journal technique pour résoudre les problèmes de transcription (ajoutez ?debug=1 au lien).

10. Questions fréquentes

Pourquoi l'application s'attend-elle à des mots que je n'ai pas prononcés (comme la Basmala) ?

Certains récitateurs commençaient par la Basmala avant « الم » ou « آلم » au début des sourates. Nous avons corrigé cela en détectant l'ouverture et en réalignant. Si le problème persiste, utilisez le diagnostic ou réessayez après trois tentatives infructueuses, l'application passe automatiquement.

Fonctionne-t-il sur mobile ?

Oui — Chrome sur Android et Safari sur iOS. Vous devrez peut-être cliquer une première fois pour activer l'audio (politiques du navigateur).

Mes données sont-elles privées ?

Les scores sont liés à votre e-mail et sont isolés entre les utilisateurs. Les enregistrements audio ne sont pas partagés avec des tiers — ils sont traités sur le serveur uniquement pour vérification.

D'où proviennent les traductions des versets ?

Kalimat.dev, base de données locale, ou Tafsir al-Jalālayn traduit via Gemini pour les langues non prises en charge — et non une traduction directe du texte coranique par l'intelligence artificielle.