cahaya hitam

cahaya hitam

Cabang

• Cabang main saat ini adalah tempat kami melakukan pengembangan baru untuk rilis 9.0 mendatang.
• Seri 8.x ada di cabang rilis-8.x
• Seri 7.x ada di cabang rilis-7.x
• Seri 6.x ada di cabang rilis-6.x

Keterangan

Blacklight adalah platform penemuan antarmuka pengguna Solr open source. Anda dapat menggunakan Blacklight untuk mengaktifkan pencarian dan penelusuran koleksi Anda. Blacklight menggunakan mesin pencari Apache Solr untuk mencari teks lengkap dan/atau metadata. Blacklight memiliki front-end Ruby on Rails yang sangat dapat dikonfigurasi. Blacklight awalnya dikembangkan di Perpustakaan Universitas Virginia dan dipublikasikan di bawah lisensi Apache 2.0.

Instalasi

Tambahkan Blacklight ke Gemfile Anda:

 gem "blacklight"

Jalankan generator instalasi yang akan menyalin beberapa template awal, migrasi, rute, dan konfigurasi:

rails generate blacklight:install

Dokumentasi, Informasi dan Dukungan

• Beranda Proyek
• Dokumentasi Pengembang
• Panduan Memulai Cepat
• Menguji dan Mengembangkan Blacklight
• Pelacak Masalah
• Mendukung

Kompatibilitas Peramban

Blacklight menggunakan browser modern dengan dukungan untuk Baseline 2023. Artinya kami secara eksplisit tidak mendukung Internet Explorer.

Ketergantungan

• Ruby 3.1+
• Ruby di Rel 6.1+

Blacklight bertujuan untuk mendukung versi Ruby yang saat ini didukung dan versi Ruby on Rails yang didukung. Kami bertujuan untuk selalu memperbarui konfigurasi pengujian kami dengan versi yang didukung ini.

Kode yang Berkontribusi

Kontribusi kode selalu diterima, instruksi untuk berkontribusi dapat ditemukan di CONTRIBUTING.md.

Mengonfigurasi Apache Solr

Anda juga memerlukan beberapa informasi tentang bagaimana Blacklight mengharapkan Apache Solr berjalan, yang dapat Anda temukan di Konfigurasi Solr

Membangun javascript

Javascript dibuat oleh npm dari sumber di app/javascript ke dalam bundel di app/assets/javascripts/blacklight/blacklight.js . File ini tidak boleh diedit dengan tangan karena perubahan apa pun akan ditimpa. Ketika salah satu komponen javascript di permata diubah, bundel ini harus dibangun kembali dengan langkah-langkah berikut:

1. Instal npm
2. jalankan npm install untuk mengunduh dependensi
3. jalankan npm run prepare untuk membuat bundel
4. jalankan npm publish untuk mendorong paket javascript ke https://npmjs.org/package/blacklight-frontend

Menggunakan javascript

Blacklight dikirimkan dengan Javascript yang dapat dikompilasi oleh Webpacker atau Sprockets. Untuk menggunakan Webpacker lihat petunjuk di https://github.com/projectblacklight/blacklight/wiki/Using-Webpacker-to-compile-javascript-assets

Jika Anda lebih suka menggunakan Sprocket, cukup jalankan generator install, yang akan menjalankan generator aset. Untuk detailnya lihat https://github.com/projectblacklight/blacklight/wiki/Using-Sprockets-to-compile-javascript-assets