https://github.com/projectblacklight/intro-to-blacklight-2022
https://github.com/projectblacklight/intro-to-blacklight-2022
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/projectblacklight/intro-to-blacklight-2022
- Owner: projectblacklight
- Created: 2022-09-08T22:28:56.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-09-28T18:57:41.000Z (over 3 years ago)
- Last Synced: 2025-02-17T04:39:49.485Z (over 1 year ago)
- Language: Ruby
- Homepage:
- Size: 114 KB
- Stars: 1
- Watchers: 10
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Setup your computer for Blacklight development in advance
During the workshop you will be learning to customize Blacklight while following along on your local computer. We ask that you set up your development environment in advance of the workshop. Developers may do this in a variety of different ways. Please do this however you feel most comfortable. You will need to be able to do the following:
- Run this Ruby on Rails application
- Edit files in a Rails application and see the changes
- Run an instance of Solr. We will recommend using `solr_wrapper` (pre-configured with this application) for this workshop. If you plan to use something different, you are welcome to, as long as you can use the same solr configurations see `solr/conf` and can index our fixture data.
If you are new to Ruby on Rails development we recommend the following guide to get started: https://gorails.com/setup/ . This will help you set up the Ruby and Rails requirements for the workshop.
## Development system requirements:
- Install Ruby (3.1.2 recommended) https://gorails.com/setup#ruby
- Java version 11 or higher (for solr). See the Solr documentation for how to check this
https://solr.apache.org/guide/solr/latest/deployment-guide/system-requirements.html#installation-requirements
### To test your setup..
Clone https://github.com/projectblacklight/intro-to-blacklight-2022
1. Run `$ bin/setup`
2. In a separate terminal window, run `$ bundle exec solr_wrapper` to launch solr
3. Run `$ bin/rails blacklight:index:seed`
4. Run `$ bin/rails server`
Open http://localhost:3000 in a browser
You should see a Blacklight application that looks similar to https://demo.projectblacklight.org.