Convert Sudanese school textbooks into accessible, searchable EPUB 3 books with Arabic RTL support.
# Sudan Schoolbooks EPUB
مشروع مفتوح لتحويل الكتب المدرسية السودانية إلى صيغة **EPUB 3** قابلة للقراءة على الهاتف، التابلت، القارئات الإلكترونية، وأجهزة الكمبيوتر.
> الهدف ليس فقط تحويل ملفات PDF إلى EPUB، بل إنتاج كتب رقمية منظمة، قابلة للبحث، سهلة القراءة، وتحافظ على المحتوى التعليمي السوداني بصورة أفضل للأجيال القادمة.
## Project Description
**Sudan Schoolbooks EPUB** is an open educational digitization project focused on converting Sudanese school textbooks into high-quality EPUB 3 files.
The project aims to make school books more accessible, searchable, lightweight, and friendly for students, teachers, parents, and educational platforms.
## لماذا هذا المشروع؟
كثير من الكتب المدرسية تكون متوفرة كصور أو PDF ثقيل، وهذا يسبب مشاكل مثل:
- صعوبة القراءة على الشاشات الصغيرة.
- عدم إمكانية البحث داخل النص.
- حجم ملفات كبير.
- ضعف الوصول لذوي الاحتياجات الخاصة.
- صعوبة استخدام الكتب داخل التطبيقات التعليمية.
صيغة EPUB تساعد في حل هذه المشاكل لأنها تدعم:
- النص القابل لإعادة التدفق حسب حجم الشاشة.
- الفهرسة والتنقل بين الدروس.
- البحث داخل الكتاب.
- دعم اللغة العربية واتجاه RTL.
- الصور والجداول والهوامش.
- قارئات الشاشة وإمكانية الوصول.
## Scope
يركز المشروع على:
- كتب مرحلة الأساس.
- كتب المرحلة المتوسطة.
- كتب المرحلة الثانوية.
- المناهج السودانية الرسمية أو المواد التعليمية المصرح بنشرها.
- بناء ملفات EPUB معيارية ومنظمة، وليست مجرد نسخ مضغوطة من PDF.
## Important Rights Notice
هذا المشروع يحترم حقوق النشر والملكية الفكرية.
لا يتم قبول أو نشر أي كتاب داخل المستودع إلا إذا كان:
- منشورا رسميا للعامة من جهة تعليمية مخولة.
- أو مرخصا برخصة تسمح بإعادة النشر والتحويل.
- أو مقدما بإذن واضح من مالك الحقوق.
إذا كنت صاحب حق وتريد إزالة مادة أو تعديل طريقة استخدامها، يرجى فتح Issue وسيتم التعامل مع الطلب بجدية.
## Conversion Workflow
```mermaid
flowchart TD
A["Source PDF / Scan"] --> B["OCR Arabic Text"]
B --> C["Text Cleaning"]
C --> D["Structure Chapters"]
D --> E["Add Images and Tables"]
E --> F["Build EPUB 3"]
F --> G["Validate EPUB"]
G --> H["Manual R …