黑光燈

蒙特內哥羅

分公司

• 目前，我們在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。

依賴關係

• 紅寶石 3.1+
• Ruby on Rails 6.1+

Blacklight 旨在支援目前支援的 Ruby 版本以及支援的 Ruby on Rails 版本。我們的目標是使我們的測試配置與這些受支援的版本保持同步。

貢獻程式碼

程式碼貢獻始終受到歡迎，貢獻說明可以在 CONTRIBUTING.md 中找到。

配置 Apache Solr

您還需要一些有關 Blacklight 期望 Apache Solr 如何運行的信息，您可以在 Solr 配置中找到這些信息

建構 JavaScript

javascript 由 npm 從app/javascript中的來源建置到app/assets/javascripts/blacklight/blacklight.js中的捆綁包中。不應手動編輯此文件，因為任何更改都會被覆蓋。當 gem 中的任何 javascript 元件發生變更時，應按照以下步驟重建此套件：

1. 安裝 npm
2. 執行npm install下載依賴項
3. 運行npm run prepare來建立捆綁包
4. 運行npm publish將 javascript 套件推送到 https://npmjs.org/package/blacklight-frontend

使用 JavaScript

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