แสงสีดำ

แบล็กไลท์

สาขา

• สาขา main ในปัจจุบันเป็นที่ที่เราทำการพัฒนาใหม่สำหรับการเปิดตัว 9.0 ที่กำลังจะมาถึง
• ซีรีส์ 8.x อยู่ในสาขา release-8.x
• ซีรีส์ 7.x อยู่ในสาขา release-7.x
• ซีรีส์ 6.x อยู่ในสาขา release-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+
• รูบี้บน Rails 6.1+

Blacklight มีเป้าหมายเพื่อรองรับ Ruby เวอร์ชันที่รองรับในปัจจุบันและ Ruby on Rails เวอร์ชันที่รองรับ เรามุ่งมั่นที่จะรักษาการกำหนดค่าการทดสอบให้ทันสมัยอยู่เสมอด้วยเวอร์ชันที่รองรับเหล่านี้

รหัสสนับสนุน

เรายินดีต้อนรับการบริจาครหัสเสมอ คำแนะนำสำหรับการบริจาคสามารถดูได้ที่ CONTRIBUTING.md

การกำหนดค่า Apache Solr

คุณยังต้องการข้อมูลบางอย่างเกี่ยวกับวิธีที่ Blacklight คาดหวังให้ Apache Solr ทำงาน ซึ่งคุณสามารถดูได้ในการกำหนดค่า Solr

การสร้างจาวาสคริปต์

จาวาสคริปต์ถูกสร้างขึ้นโดย npm จากแหล่งที่มาใน app/javascript ลงในบันเดิลใน app/assets/javascripts/blacklight/blacklight.js ไม่ควรแก้ไขไฟล์นี้ด้วยมือ เนื่องจากการเปลี่ยนแปลงใดๆ จะถูกเขียนทับ เมื่อส่วนประกอบ Javascript ใดๆ ใน Gem มีการเปลี่ยนแปลง บันเดิลนี้ควรถูกสร้างใหม่ด้วยขั้นตอนต่อไปนี้:

1. ติดตั้ง npm
2. รัน npm install เพื่อดาวน์โหลดการอ้างอิง
3. รัน npm run prepare สร้างบันเดิล
4. เรียกใช้ npm publish เพื่อพุชแพ็คเกจ javascript ไปที่ https://npmjs.org/package/blacklight-frontend

การใช้จาวาสคริปต์

Blacklight มาพร้อมกับ Javascript ที่สามารถคอมไพล์โดย 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