projectblacklight / blacklight_summit_princeton_demo

Blacklight example for Princeton Blacklight Summit workshop

System dependencies

• Ruby 2.3 or greater
• Java 8 or greater

GoRails provides a tutorial for preparing your machine for Rails development on OS X and Linux.

Getting Started

Cloning the project:

$ git clone [email protected]:projectblacklight/blacklight_summit_princeton_demo.git # preferred, or:
# $ git clone https://github.com/projectblacklight/blacklight_summit_princeton_demo.git # or:
# download https://github.com/projectblacklight/blacklight_summit_princeton_demo/archive/master.zip

$ cd blacklight_summit_princeton_demo

Installing the dependencies:

$ bin/setup
# this runs `bundle install`, `rake db:setup`, and does environment sanity checks

Running the tests:

$ bundle exec rake

Running the rails server:

$ bundle exec rails server

Starting solr:

# in a new terminal:
$ bundle exec solr_wrapper -p 8983 -n blacklight-core -d solr/conf -i tmp/solr

Indexing data into solr:

Download our [sample MARC data] (https://github.com/projectblacklight/blacklight-data/archive/master.zip).

$ MARC_FILE=../path/to/the/blacklight-data/lc_records.utf8.mrc bundle exec rake solr:marc:index

References

• Blacklight wiki
• Customizing Blacklight tutorial
• Customizing Geoblacklight
• blacklight/configuration.rb
• Rails guides
• Solr Reference Guide

blacklight_summit_princeton_demo's Issues

Customize a particular search to add some context (over a particular domain)

Add/Customize a hierarchical facet

Customize the application's routes

Can we have a different path than catalog?

Re-order the metadata on the show page and search results

Add a horizontal facet

Change search behavior contextually

• Add an additional facet based on current search context
• Add/change sorts based on search context

Add some custom content (maybe a form) into a new modal

Add a new export format