openlibrary

مفتوح المكتبة

Open Library عبارة عن كتالوج مكتبة مفتوح وقابل للتحرير ، ويتم بناء صفحة ويب لكل كتاب تم نشره على الإطلاق.

هل تتطلع للبدء؟ هذا هو الدليل الذي تبحث عنه. قد ترغب في معرفة المزيد عن Google Summer of Code (GSOC)؟ أو hacktoberfest.

جدول المحتويات

• ملخص

• تثبيت

• تنظيم الكود

• بنيان

• الواجهة الأمامية

• الواجهة الخلفية

• بنية الخدمة

• دليل المطور

• إجراء اختبارات

• المساهمة

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

• الأسئلة الشائعة

ملخص

Open Library هو جهد بدأ في عام 2006 لإنشاء "صفحة ويب واحدة لكل كتاب تم نشره على الإطلاق." يوفر الوصول إلى العديد من الكتب العامة والكتب المطبوعة ، والتي يمكن قراءتها عبر الإنترنت.

إليك جولة عامة سريعة في المكتبة المفتوحة للتعرف على الخدمة وعروضها (10 دقائق).

• تعرف على المزيد حول مشروع المكتبة المفتوحة

• رؤية (حلم) من OpenLibrary

• قم بزيارة المدونة

تثبيت

RUN docker compose up و TIST HTTP: // localhost: 8080

هل تحتاج إلى مزيد من التفاصيل؟ تحقق من تعليمات Docker أو تعليمي الفيديو.

بدلاً من ذلك ، إذا كنت لا ترغب في إعداد مكتبة مفتوحة على جهاز الكمبيوتر المحلي الخاص بك ، جرب Gitpod! يتيح لك هذا العمل على المكتبة المفتوحة بالكامل في متصفحك دون الحاجة إلى تثبيت أي شيء على جهاز الكمبيوتر الشخصي الخاص بك. تحذير: لا يزال هذا التكامل تجريبيًا.

دليل المطور

للحصول على إرشادات حول إدارة مثيل المكتبة المفتوحة ، ارجع إلى دليل QuickStart للمطور.

يمكنك أيضًا العثور على مزيد من المعلومات حول وثائق المطور للمكتبة المفتوحة في مكتبة Open Library Wiki.

تنظيم الكود

• OpenLibrary/Core - وظيفة OpenLibrary الأساسية ، مستوردة واستخدامها من قبل www

• OpenLibrary/Plugins - نماذج أخرى ، وحدات تحكم ، وعرض المساعدين

• OpenLibrary/Views - طرق عرض لتقديم صفحات الويب

• OpenLibrary/Templates - جميع القوالب المستخدمة في الموقع الإلكتروني

• OpenLibrary/Macros - وحدات الماكرو مثل القوالب ، ولكن يمكن استدعاؤها من Wikitext

بنيان

الواجهة الخلفية

تم تطوير OpenLibrary أعلى نظام Wiki Infogami ، والذي تم تصميمه في حد ذاته على الويب.

• نظرة عامة على تقنيات الويب الخلفية

بمجرد قراءة نظرة عامة على تقنيات OpenLibrary Backend ، يتم تشجيعك بشدة على قراءة المطور التمهيدي الذي يشرح كيفية استخدام Infogami (وقاعدة البيانات الخاصة به ، InfoBase).

• تعليمي مطور Infogami

إذا كنت ترغب في الغوص في الكود المصدري لـ Infogami ، راجع Infogami Repo.

إجراء اختبارات

يمكن تشغيل اختبارات المكتبة المفتوحة باستخدام Docker. يرجى البحث عن وثيقة الاختبار لدينا لمزيد من التفاصيل.

docker compose run --rm home make test

المساهمة

هناك العديد من الطرق التي يمكن للمتطوعين المساهمة في مشروع المكتبة المفتوحة ، من التطوير والتصميم إلى إدارة البيانات ومشاركة المجتمع. إليك كيف يمكنك المشاركة:

المطورين

• البدء: تحقق من دليل المساهمة لدينا للحصول على تعليمات حول كيفية إعداد بيئة التطوير الخاصة بك ، وإيجاد مشكلات للعمل عليها ، وتقديم مساهماتك.

• القضايا الأولى الجيدة: تصفح مشكلاتنا الأولى الجيدة للعثور على المهام الصديقة للمبتدئين.

المصممون

• مساهمات التصميم: نرحب بالمصممين للمساعدة في تحسين تجربة المستخدم. يمكنك البدء من خلال النظر في القضايا المتعلقة بالتصميم.

أمناء المكتبات وعشاق البيانات

• مساهمات البيانات: تعلم كيفية المساهمة في كتالوجنا والمساعدة في تحسين بيانات الكتاب على المكتبة المفتوحة. تفضل بزيارة صفحة التطوع الخاصة بنا لمزيد من المعلومات.

مشاركة المجتمع

• انضم إلى مكالمات مجتمعنا: يستضيف Open Library المجتمع الأسبوعي وتصميم المكالمات. تحقق من جدول مكالمات المجتمع للأوقات والتفاصيل.

• اطرح أسئلة: إذا كان لديك أي أسئلة ، انضم إلى دردشة Gitter الخاصة بنا أو طلب دعوة إلى قناة Slack على صفحة المتطوعين لدينا.

لمزيد من المعلومات التفصيلية ، راجع دليل المساهمة.

رخصة

تتوفر جميع رمز المصدر المنشور هنا بموجب شروط ترخيص GNU Affero العام ، الإصدار 3.