इस प्रोजेक्ट के बारे में

«अल-कुरान अल-करीम» ऐप MIT लाइसेंस के तहत एक ओपन-सोर्स अरबी प्रोजेक्ट है, जो कुरान पढ़ने, सुनने, खोजने और तफसीर देखने की सुविधा देता है। यह वेब ब्राउज़र और एंड्रॉइड डिवाइस पर काम करता है। वर्तमान संस्करण 3.1.20 है, जिसका APK परीक्षण के लिए उपलब्ध है और वेब संस्करण GitHub Pages पर प्रकाशित है। यह अरबी, अंग्रेजी, फ्रेंच, जर्मन, रूसी, तुर्की, मलय और इंडोनेशियाई सहित आठ भाषाओं का समर्थन करता है, जिसमें अरबी के लिए RTL दिशा का समर्थन शामिल है। पढ़ने के लिए, ऐप AlQuran.cloud से प्राप्त उस्मानी लिपि में 114 सूरह प्रदर्शित करता है, जिसमें सूरह नेविगेशन, अंतिम स्थान को सहेजना, वर्तमान आयत को हाइलाइट करना, 15 सजदा चिह्न, तीस पारा विभाजक और स्क्रॉलिंग से जुड़ी प्रोग्रेस बार शामिल है। यह फ़ॉन्ट आकार (16-45 पिक्सेल), फ़ॉन्ट प्रकार (Amiri, Scheherazade New, Reem Kufi) और लाइन स्पेसिंग को नियंत्रित करने की अनुमति देता है। इसमें अर्थ के पांच अनुवाद, दिन और रात के मोड में 18 रंगीन तजवीद नियम, याद करने के लिए एक 'हिफ्ज़ मोड' और एक 'हिफ्ज़ रूम' है जिसमें पर्दे की सुविधा और गति एवं दोहराव नियंत्रण वाला प्लेयर है। किंग फहद कॉम्प्लेक्स ऑफ द होली कुरान प्रिंटिंग कॉम्प्लेक्स से आधिकारिक हफ्स उस्मानी फ़ॉन्ट का विकल्प सूरह मोड में उपलब्ध है, जबकि पेज मोड QCF4 पर रहता है। 604 पृष्ठों के लेआउट के लिए ऑफलाइन डेटा वैकल्पिक रूप से SHA-256 फिंगरप्रिंट जांच के बाद डाउनलोड किया जा सकता है। सुनने की सुविधा में 30 से अधिक कारी शामिल हैं और दो ऑडियो स्रोत हैं: API के माध्यम से प्रति आयत ध्वनि और mp3quran.net से सूरह की पूरी MP3 फाइल, जिसमें quran.com API के माध्यम से शब्द-दर-शब्द हाइलाइटिंग होती है। यह सूरह के बीच निरंतर प्लेबैक, दोहराव मोड (बंद, आयत, सूरह, कस्टम रेंज), 1 से 180 मिनट का स्लीप टाइमर, गति नियंत्रण, लॉक स्क्रीन नियंत्रण के लिए MediaSession एकीकरण, स्वचालित पुन: प्रयास, Canvas पर ऑडियो विज़ुअलाइज़र और खतम पूरा होने पर अधिसूचना प्रदान करता है। ऑफलाइन पैकेज IndexedDB में 200 MB की सीमा के साथ कुरान पाठ, अनुवाद, तजवीद डेटा, QCF4 फ़ॉन्ट और चयनित कारी की आवाज़ संग्रहीत कर सकता है, जिसमें LRU इविक्शन और चयनात्मक या पूर्ण विलोपन की सुविधा है। खोज इंजन 6,236 आयतों को कवर करता है और स्वर (तशकील) के साथ या बिना पाठ का मिलान करता है, जिसमें परिणाम हाइलाइटिंग, शब्द सुझाव, अंतिम दस खोजों का इतिहास और अरबी में Web Speech API के माध्यम से वॉयस सर्च शामिल है। तफसीर में छह संस्करण (अल-मुयस्सर, इब्न कथिर, अल-तबरी, अल-सादी, अल-बगवी और अल-कुर्तुबी) शामिल हैं, जो स्थानीय से IndexedDB और फिर API तक क्रमिक रूप से लोड होते हैं और QuranTafsirDB में कैश किए जाते हैं। 'आयत पर चिंतन' (Tadabbur) सुविधा तीन चिंतनशील प्रश्न प्रदर्शित करती है, जो बिना किसी AI सेवा या खाते के स्थानीय रूप से काम करती है, और यह केवल उन आयतों के लिए दिखाई देती है जिनके प्रश्न पूर्ण हैं। «मुसहफ मोड» 604 पृष्ठों पर Canvas के माध्यम से QCF V4 फ़ॉन्ट प्रदर्शित करता है, जिसमें प्रति शब्द तजवीद रंग और क्लिक की गई आयत के लिए प्लेबैक और तफसीर की सुविधा है। «डिस्प्ले मोड» सादे, प्राकृतिक और मूड/समय आधारित बैकग्राउंड के साथ फुल-स्क्रीन दृश्य प्रदान करता है, जिसमें Canvas दृश्य (तारे, लहरें, अरोरा, कण, बारिश) शामिल हैं। उपयोगकर्ता आयत के लिए एक विस्तृत चित्र या स्थानीय HD वीडियो बैकग्राउंड और मिशारी अल-अफ़ासी की आवाज़ सेट कर सकते हैं। ऐप में Aladhan के माध्यम से प्रार्थना समय, अज़ान अलर्ट, उम्म अल-कुरा कैलेंडर के अनुसार हिजरी तारीख और किबला कंपास शामिल है। इसके अलावा, सुबह-शाम के अज़कार, काउंटर, अधिसूचनाएं, पसंदीदा और बुकमार्क (टेक्स्ट या JSON निर्यात के साथ), पढ़ने के आंकड़े और चार डिस्प्ले मोड (गहरे नाइट मोड सहित) उपलब्ध हैं। यह Capacitor Share या Web Share API के माध्यम से व्हाट्सएप और टेलीग्राम पर साझा करने, कीबोर्ड शॉर्टकट और एक्सेसिबिलिटी थीम (ARIA लाइव क्षेत्र, हाई कंट्रास्ट आदि) का समर्थन करता है। तकनीकी रूप से, प्रोजेक्ट सख्त मोड में TypeScript 6.0, LightningCSS के साथ Vite 8, PWA के लिए vite-plugin-pwa (Workbox), और एंड्रॉइड पैकेज के लिए Capacitor 8 पर आधारित है। यह बिना किसी बाहरी फ्रेमवर्क के Proxy-आधारित रिएक्टिव स्टेट मैनेजमेंट और localStorage एवं तीन IndexedDB (QuranAppDB, QuranAudioCacheDB, QuranTafsirDB) का उपयोग करता है। बाहरी API में AlQuran.cloud, Aladhan, jsDelivr के माध्यम से तफसीर, mp3quran.net और quran.com शामिल हैं। CI/CD पाइपलाइन में लिंटिंग, टाइप चेक, 80% कवरेज के साथ यूनिट टेस्ट, चार प्रोजेक्ट्स (chromium, firefox, webkit, mobile-chrome) पर Playwright टेस्ट, CodeQL, OWASP ZAP स्कैन, Lighthouse CI, WCAG के बिना axe-core स्कैन और बंडल आकार की निगरानी शामिल है। रिपॉजिटरी बताती है कि इसमें 3,812 यूनिट टेस्ट और 284 UI टेस्ट केस हैं। स्थानीय उत्पादन बिल्ड के लिए Lighthouse परिणाम प्रदर्शन के लिए 93, एक्सेसिबिलिटी के लिए 100, सर्वोत्तम प्रथाओं के लिए 96 और SEO के लिए 91 थे। स्थानीय संचालन के लिए Node.js 22 या नवीनतम आवश्यक है। विकास, निर्माण, पूर्वावलोकन, यूनिट और E2E परीक्षणों के लिए कमांड उपलब्ध हैं। उपयोगकर्ताओं को प्रोजेक्ट बिल्ड करने की आवश्यकता नहीं है, वे सीधे APK डाउनलोड कर सकते हैं। रिपॉजिटरी एक तकनीकी मूल्यांकन गाइड भी प्रदान करती है जो ऑफलाइन कार्यक्षमता और ज्ञात सीमाओं को स्पष्ट करती है।