ضوء أسود

ضوء أسود

الفروع

• الفرع main حاليًا هو المكان الذي نقوم فيه بتطوير جديد للإصدار 9.0 القادم.
• السلسلة 8.x موجودة في فرع الإصدار 8.x
• السلسلة 7.x موجودة في فرع الإصدار 7.x
• السلسلة 6.x موجودة في فرع الإصدار 6.x

وصف

Blacklight عبارة عن منصة مفتوحة المصدر لاكتشاف واجهة مستخدم Solr. يمكنك استخدام Blacklight لتمكين البحث وتصفح مجموعاتك. يستخدم Blacklight محرك بحث Apache Solr للبحث في النص الكامل و/أو البيانات التعريفية. يتمتع Blacklight بواجهة أمامية قابلة للتكوين بدرجة عالية من Ruby on Rails. تم تطوير Blacklight في الأصل في مكتبة جامعة فيرجينيا وتم نشره بموجب ترخيص Apache 2.0.

تثبيت

أضف Blacklight إلى Gemfile الخاص بك:

 gem "blacklight"

قم بتشغيل منشئ التثبيت الذي سيقوم بنسخ بعض القوالب الأولية وعمليات الترحيل والمسارات والتكوينات:

rails generate blacklight:install

التوثيق والمعلومات والدعم

• الصفحة الرئيسية للمشروع
• وثائق المطور
• دليل البدء السريع
• اختبار وتطوير الضوء الأسود
• تعقب المشكلة
• يدعم

توافق المتصفح

يفترض Blacklight متصفحًا حديثًا يدعم Baseline 2023. وهذا يعني أننا لا ندعم صراحةً Internet Explorer.

التبعيات

• روبي 3.1+
• روبي أون ريلز 6.1+

يهدف Blacklight إلى دعم الإصدارات المدعومة حاليًا من Ruby والإصدارات المدعومة من Ruby on Rails. نحن نهدف إلى الحفاظ على تحديث تكوين الاختبار الخاص بنا مع هذه الإصدارات المدعومة.

رمز المساهمة

نرحب دائمًا بمساهمات الكود، ويمكن العثور على تعليمات المساهمة على CONTRIBUTING.md.

تكوين أباتشي سولر

ستحتاج أيضًا إلى بعض المعلومات حول كيفية توقع Blacklight لتشغيل Apache Solr، والتي يمكنك العثور عليها في تكوين Solr

بناء جافا سكريبت

تم إنشاء جافا سكريبت بواسطة npm من مصادر في app/javascript في حزمة في app/assets/javascripts/blacklight/blacklight.js . لا ينبغي تحرير هذا الملف يدويًا حيث سيتم الكتابة فوق أي تغييرات. عند تغيير أي من مكونات جافا سكريبت في الجوهرة، يجب إعادة بناء هذه الحزمة بالخطوات التالية:

1. قم بتثبيت npm
2. قم بتشغيل npm install لتنزيل التبعيات
3. تشغيل npm run prepare لبناء الحزمة
4. قم بتشغيل npm publish لدفع حزمة جافا سكريبت إلى https://npmjs.org/package/blacklight-frontend

باستخدام جافا سكريبت

يأتي Blacklight مزودًا بجافا سكريبت الذي يمكن تجميعه إما بواسطة Webpacker أو بواسطة Sprockets. لاستخدام Webpacker، راجع التوجيهات على https://github.com/projectblacklight/blacklight/wiki/Using-Webpacker-to-compile-javascript-assets

إذا كنت تفضل استخدام Sprockets، فما عليك سوى تشغيل مولد التثبيت، الذي سيقوم بتشغيل مولد الأصول. للحصول على التفاصيل، راجع https://github.com/projectblacklight/blacklight/wiki/Using-Sprockets-to-compile-javascript-assets