블랙라이트

블랙라이트

지점

• 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 라이센스에 따라 공개되었습니다.

설치

Gemfile 에 Blacklight를 추가하세요.

 gem "blacklight"

일부 초기 템플릿, 마이그레이션, 경로 및 구성을 복사하는 설치 생성기를 실행합니다.

rails generate blacklight:install

문서, 정보 및 지원

• 프로젝트 홈페이지
• 개발자 문서
• 빠른 시작 가이드
• Blacklight 테스트 및 개발
• 이슈 트래커
• 지원하다

브라우저 호환성

Blacklight는 Baseline 2023을 지원하는 최신 브라우저를 가정합니다. 즉, Internet Explorer를 명시적으로 지원하지 않습니다.

종속성

• 루비 3.1+
• 루비 온 레일스 6.1+

Blacklight는 현재 지원되는 Ruby 버전과 지원되는 Ruby on Rails 버전을 지원하는 것을 목표로 합니다. 우리는 지원되는 버전으로 테스트 구성을 최신 상태로 유지하는 것을 목표로 합니다.

코드 기여

코드 기여는 언제나 환영합니다. 기여 지침은 CONTRIBUTING.md에서 확인할 수 있습니다.

Apache Solr 구성

또한 Blacklight가 Apache Solr의 실행을 기대하는 방식에 대한 정보가 필요합니다. 이 정보는 Solr 구성에서 찾을 수 있습니다.

자바스크립트 빌드

javascript는 npm에 의해 app/javascript 의 소스에서 app/assets/javascripts/blacklight/blacklight.js 의 번들로 빌드됩니다. 변경 사항을 덮어쓰게 되므로 이 파일을 직접 편집해서는 안 됩니다. gem의 자바스크립트 구성 요소가 변경되면 다음 단계에 따라 이 번들을 다시 빌드해야 합니다.

1. npm 설치
2. npm install 실행하여 종속성을 다운로드하세요.
3. npm run prepare 실행하여 번들 빌드
4. npm publish 실행하여 javascript 패키지를 https://npmjs.org/package/blacklight-frontend에 푸시합니다.

자바스크립트 사용

Blacklight에는 Webpacker 또는 Sprocket으로 컴파일할 수 있는 Javascript가 함께 제공됩니다. 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를 참조하세요.