Aller au contenu

Ressources

Développeurs

Des ressources pour les développeurs qui travaillent avec les données coraniques.

Notre corpus coranique

Le texte coranique, les données mot à mot, les traductions, les tafsirs, les notes, la recherche et les métadonnées audio sont servis depuis notre propre base de données, via qurangallery.com/quran/api/quran. Rien sur une page de lecture ne dépend de la disponibilité d’une API tierce.

Il couvre le Coran complet en six variantes d’écriture, 150 traductions, 23 tafsirs, ainsi que la position de chaque mot (page et ligne) pour chaque mushaf — plus les métadonnées des sourates, versets, juz et autres divisions. Les réponses suivent le format v4 déjà attendu par la plupart des outils coraniques, si bien que les clients existants les lisent sans modification. L’audio des récitations reste diffusé depuis QuranCDN.

Référence de l’API

Chaque point d’accès ci-dessous est servi depuis notre propre corpus et accepte les paramètres de requête v4 habituels (language, translations, words, page).

Principaux points d’accès :

  • /chapters — Liste des 114 sourates avec leurs métadonnées
  • /verses/by_chapter/:id — Obtenir les versets d’une sourate donnée
  • /search — Recherche en texte intégral dans les traductions
  • /resources/recitations — Récitateurs et fichiers audio disponibles
  • /resources/translations — Traductions disponibles dans toutes les langues

Pile technique

Quran Gallery repose sur des technologies web modernes axées sur la performance et l’accessibilité :

Frontend
SvelteKit 2 avec Svelte 5, Tailwind CSS v4
Environnement d’exécution
Node.js sur un VPS auto-hébergé (adapter-node)
Base de données
PostgreSQL via Drizzle ORM
Internationalisation
Paraglide JS — 7 langues, dont des langues RTL

Open source

Nous croyons à la collaboration ouverte pour les projets au service de la communauté musulmane. Les contributions sont les bienvenues — corriger des bugs, améliorer les traductions, ajouter des fonctionnalités ou renforcer l’accessibilité.

Architecture

Quran Gallery fonctionne comme un monorepo de services Node.js, chacun servant une partie différente de la plateforme. Caddy achemine les requêtes selon le préfixe de chemin vers le service approprié sur le VPS.

qurangallery.com (Passerelle)  /quran   → Lecteur du Coran et outils d’étude  /chat    → Chat coranique propulsé par l’IA  /studio  → Atelier d’art islamique  /hifz    → Suivi de mémorisation  /adhkar  → Invocations quotidiennes  /blog    → Articles et guides

Contact

Pour toute question technique, problème d’API ou demande de collaboration, écrivez à [email protected] ou ouvrez un ticket sur GitHub.