auto_stories

بطاقات القرآن الكريم

بيانات 114 سورة متكاملة - صوت، PDF، يوتيوب

menu_book
114 سورة
play_circle
140+ فيديو
format_quote
6,236 آية
cloud_download
293 MB
info عن المشروع

عن المشروع

مشروع وقفي عالمي لخدمة القرآن الكريم

person

المؤلف

أ.د. ياسر بن إسماعيل راضي

language

الموقع الرسمي

albitaqat.com

book

الكتاب

135 صفحة - ISBN: 9786030350469

mic

التسجيل الصوتي

استديو وقف تعظيم الوحيين

برنامج عملي مصاحب لقراءة القرآن الكريم وحفظه، يوفر مَتْنٍ مختصرٍ شاملٍ لسور القرآن مسموعاً ومقروءاً.

terminal تحميل المشروع

حمّل المشروع

استنسخ المستودع وابدأ خلال دقائق

terminal

1. استنسخ المستودع

# استنسخ المستودع
git clone https://github.com/rn0x/albitaqat_quran.git
cd albitaqat_quran

# أو حمّل كـ ZIP
wget https://github.com/rn0x/albitaqat_quran/archive/refs/heads/main.zip
unzip main.zip
check_circle

2. تحقق من الملفات

# هيكل المشروع
albitaqat_quran/
├── data/                    # ملفات JSON (بيانات السور)
├── api/                     # Node.js API (Hono + Docker)
├── web/                     # الموقع الثابت
├── scripts/                 # سكريبتات Python
└── src/                     # كود Python
folder_open ملفات البيانات

ملفات البيانات

حمّل البيانات بصيغة JSON لاستخدامها في مشاريعك

اسم الملف الحجم التحميلات الوصف تحميل
quran_cards.json 500 KB download - البيانات الأصلية المكشطة من الموقع download
quran_cards_full.json 107 KB download - البيانات الشاملة مع روابط الصوت و PDF و يوتيوب download
audio_links.json 27 KB download - روابط تحميل الصوت (114 ملف MP3) download
pdf_links.json 30 KB download - روابط تحميل البطاقات بصيغة PDF download
youtube_videos.json 43 KB download - فيديوهات شرح البطاقات من يوتيوب (140+) download
rocket_launch البدء السريع

البدء السريع

ابدأ باستخدام البيانات في دقائق

# تثبيت المتطلبات
pip install -r src/requirements.txt

# تحميل جميع الملفات (صوت + PDF)
python src/downloader.py --mode full

# تحميل الصوت فقط
python src/downloader.py --mode audio

# تحميل PDF فقط
python src/downloader.py --mode pdf

# تحميل فيديوهات يوتيوب
python src/downloader.py --mode youtube

# التحقق من الملفات
python src/downloader.py --mode verify
lightbulb أمثلة الاستخدام

أمثلة الاستخدام

كيف تستخدم البيانات في مشاريعك

code

Python

import json

# قراءة بيانات السور
with open('data/quran_cards_full.json') as f:
    data = json.load(f)

# عرض جميع السور
for surah in data['surahs']:
    print(f"{surah['number']} - {surah['name_arabic']}")

# البحث عن سورة
baqarah = next(
    s for s in data['surahs']
    if s['number'] == 2
)
print(baqarah['downloads']['audio']['url'])
javascript

Node.js

const fs = require('fs');

// قراءة بيانات السور
const data = JSON.parse(
  fs.readFileSync('data/quran_cards_full.json')
);

// عرض جميع السور
data.surahs.forEach(surah => {
  console.log(`${surah.number} - ${surah.name_arabic}`);
});

// جلب سورة عبر API
const res = await fetch('http://localhost:3000/api/surahs/1');
const surah = await res.json();
console.log(surah.data.name_english);
terminal

cURL

# جلب جميع السور
curl http://localhost:3000/api/surahs

# جلب سورة الفاتحة
curl http://localhost:3000/api/surahs/1

# بحث عن سورة
curl "http://localhost:3000/api/surahs/search?q=رعد"

# جلب روابط الصوت
curl http://localhost:3000/api/audio/1

# جلب فيديوهات يوتيوب
curl http://localhost:3000/api/youtube/1

# إحصائيات المشروع
curl http://localhost:3000/api/stats
language

JavaScript (Browser)

// جلب البيانات من API
const response = await fetch(
  'http://localhost:3000/api/surahs'
);
const { data } = await response.json();

// عرض السور في الصفحة
const list = document.getElementById('surahs');
data.forEach(surah => {
  list.innerHTML += `
    <div class="surah-card">
      <h3>${surah.name_arabic}</h3>
      <p>${surah.name_english}</p>
      <a href="${surah.downloads.audio.url}">
        استمع
      </a>
    </div>
  `;
});
api واجهة برمجة التطبيقات

واجهة برمجة التطبيقات

API مجاني للوصول لبيانات البطاقات

GET /api/surahs/:number

الحصول على سورة برقمها

استجابة API

{
  "success": true,
  "data": {
    "number": 1,
    "name_arabic": "الفاتحة",
    "name_english": "Al-Fatihah",
    "ayahs_count": 7,
    "revelation_type": "مكية",
    "downloads": {
      "audio": {
        "filename": "001_Al-Fatihah.mp3",
        "url": "https://archive.org/..."
      }
    }
  }
}
deployed_code Docker

Docker

شغّل API مع جميع البيانات في ثوانٍ

cloud_download

تحميل تلقائي

يحمل جميع ملفات الصوت و PDF تلقائياً عند التشغيل

save

بيانات محفوظة

تُحفظ البيانات في Docker Volume ولا تضيع

speed

جاهز للإنتاج

مبني لأداء عالٍ مع Rate Limiting و Logging