دليل البحث عن الكتب 📚

نظرة عامة 🔍

"دليل البحث عن الكتب" هو تطبيق ويب يوفر واجهة سهلة الاستخدام للبحث عن الكتب واستعراض تفاصيلها. يستخدم التطبيق واجهة برمجة تطبيقات (API) مخصصة لاسترجاع معلومات الكتب من موقع Kotobati.

⚠️ تنبيه: هذا المشروع مخصص لأغراض تعليمية فقط. جميع الحقوق محفوظة لموقع Kotobati.

الميزات الرئيسية 🌟

• البحث عن الكتب باستخدام الكلمات المفتاحية
• عرض نتائج البحث مع صور الأغلفة وتفاصيل موجزة
• إمكانية الاقتراح التلقائي أثناء الكتابة
• عرض تفاصيل شاملة للكتاب عند النقر على نتيجة البحث
• واجهة مستخدم سهلة الاستخدام ومتجاوبة مع مختلف أحجام الشاشات

التقنيات المستخدمة 🛠️

• الواجهة الأمامية: HTML, CSS (مع Tailwind CSS), JavaScript
• الخادم: Node.js مع Express.js
• مكتبات إضافية: axios للطلبات HTTP، cheerio لتحليل HTML

تثبيت المكتبات الضرورية 📦

لتثبيت جميع المكتبات الضرورية للمشروع، قم بتنفيذ الأمر التالي في مجلد المشروع:

npm install express axios cheerio cors

هذا الأمر سيقوم بتثبيت المكتبات التالية:

• express: إطار عمل ويب سريع ومرن لـ Node.js
• axios: مكتبة للقيام بطلبات HTTP
• cheerio: مكتبة لتحليل HTML وتصفحه بسهولة
• cors: مكتبة لتمكين CORS (Cross-Origin Resource Sharing) مع خيارات متنوعة

كيفية الإعداد والتشغيل 🚀

1. قم بتثبيت Node.js على جهازك إذا لم يكن مثبتًا بالفعل.
2. استنسخ هذا المستودع إلى جهازك المحلي:

   git clone https://github.com/farsabdraouf/dalil-book.git
   

3. انتقل إلى مجلد المشروع:

   cd dalil-book
   

4. قم بتثبيت التبعيات:

   npm install
   

5. قم بتشغيل الخادم:

   node index.js
   

6. افتح متصفحك وانتقل إلى http://localhost:3000 لاستخدام التطبيق.

هيكل المشروع 📁

• index.js: ملف الخادم الرئيسي الذي يحتوي على تعريفات API.
• public/: مجلد يحتوي على ملفات الواجهة الأمامية:
  • index.html: صفحة HTML الرئيسية.
  • script.js: كود JavaScript للتفاعل مع واجهة المستخدم وإجراء طلبات API.
  • styles.css: أنماط CSS للتطبيق.

وصف API 📡

الخادم يوفر ثلاث نقاط نهاية رئيسية:

1. /search: للبحث عن الكتب.

   • طريقة الطلب: GET
   • المعامل: q (استعلام البحث)
   • مثال: GET /search?q=رواية

2. /autocomplete: للحصول على اقتراحات البحث.

   • طريقة الطلب: GET
   • المعامل: q (استعلام البحث الجزئي)
   • مثال: GET /autocomplete?q=روا

3. /book: للحصول على تفاصيل كتاب معين.

   • طريقة الطلب: GET
   • المعامل: url (رابط صفحة الكتاب على Kotobati)
   • مثال: GET /book?url=https://www.kotobati.com/book/section/...

المساهمة 🤝

نرحب بالمساهمات لتحسين هذا المشروع! إذا كان لديك اقتراحات أو تحسينات، يرجى فتح issue أو إرسال pull request.

الترخيص 📄

هذا المشروع مرخص تحت رخصة MIT. يرجى الاطلاع على ملف LICENSE للمزيد من التفاصيل.

الاعتمادات 🙏

• تم تطوير هذا المشروع بواسطة فارس عبد الرؤوف.
• جميع بيانات الكتب مقدمة من Kotobati. جميع الحقوق محفوظة لهم.

تنويه ⚠️

هذا المشروع مخصص لأغراض تعليمية فقط. يرجى احترام حقوق الملكية الفكرية لموقع Kotobati واستخدام هذا التطبيق بمسؤولية.