README.ar.md

shamela2epub | أداة تحميل كتب الشاملة من الموقع بصيغة EPUB

أداة سطر أوامر وواجهة رسومية لتحميل الكتب من موقع المكتبة الشاملة بصيغة كتاب إلكتروني EPUB.

إخلاء مسؤولية:

• هذا البرنامَج مجاني ومفتوح المصدر ومخصص فقط للاستخدام الشخصي أو التعليمي.

التثبيت

من PyPI

pip install shamela2epub

من المستودع

# Using poetry
poetry install

# or using pip 18+
pip install .

الاستخدام

أداة سطر الأوامر

python3 -m shamela2epub download URL
# python3 -m shamela2epub download "https://shamela.ws/book/823"

python3 -m shamela2epub download --help
Usage: python -m shamela2epub download [OPTIONS] URL

  Download Shamela book form URL to ePub

Options:
  -o, --output TEXT  ePub output book custom name
  --help             Show this message and exit.

الواجهة الرسومية

• إذا كنت قد ثبتت الحُزْمَة من PyPI فيمكنك استخدام الأمر التالي:

shamela2epubgui

• وإذا كنت قد حملت المِلَفّ التنفيذي الخاص بالإصدار الأخير من الواجهة الرسومية يمكنك فتحه وتشغيله بالطريقة العادية.
• بخلاف ما سبق، استخدم أمر بايثون التالي::

python3 -m shamela2epub gui

الميزات

• أداة سطر أوامر وواجهة رسومية.
• إنشاء كتاب EPUB3 عربي قياسي.
• إضافة صفحة لمعلومات الكتاب.
• إنشاء فِهْرِس المحتويات مع دعم المستويات الفرعية.
• إضافة رقم الجزء ورقم الصفحة أسفل كل صفحة من الكتاب.
• تنقية HTML الكتاب من العناصر والمعلومات غير الضرورية.
• تحويل تنسيقات ألوان CSS الداخلية إلى فئات.
• تحويل الهوامش إلى نوافذ منبثقة inline footnote لسهولة التنقل منها وإليها.

المشاكل المعروفة

• الكتب التي بها قسم فرعي أخير في مستوى ما في الفِهْرِس (مثلا 3) وهذا المستوى أعمق من المستوى التالي له (2 مثلا)، وكلاهما له نفس رَقَم الصفحة (مثلا page_017.xhtml)، لا يمكن تحويلها إلى KFX إلا عندما يحذف القسم الفرعي المذكور.

قائمة المهام

التالية

• أخبرني أنت :)

المحتملة

• حل مشكلة الفِهْرِس خلال التحويل عندما يكون آخر قسم ذو مستوى أعمق من المستوى التالي له، ورقم صفحة كلا منهما نفس الرَّقَم، عبر حذف المستوى الأعمق من الفِهْرِس.

شكر وتقدير

• شكرا لفريق Phosphor Icons على أيقونة الواجهة الرسومية (books - duotone - #AB8B64).