Codebase for Fulcrum, an in-development Hydra-based digital publishing platform built by the University of Michigan Library
Ruby HTML CSS XSLT JavaScript Shell
Latest commit e50a0d3 Feb 21, 2017 @conorom conorom committed on GitHub Merge pull request #767 from mlibrary/indiana-branding
Branding for Indiana
Permalink
Failed to load latest commit information.
.wrap_conf wrapper configs Feb 7, 2017
app first pass at indiana branding, adding fonts, logos, colors - back to… Feb 21, 2017
bin Resolves #256 google analytics pageviews for file_sets Nov 2, 2016
config Merge pull request #758 from mlibrary/123_Dashboard_List_All_Users Feb 15, 2017
db first pass at indiana branding, adding fonts, logos, colors - back to… Feb 21, 2017
fulcrum change copyright year to 2017 Jan 18, 2017
lib Resolves #731 Sections as FileSet metadata Feb 17, 2017
log Generate Rails Mar 3, 2016
script get rid of fileset reversing Jan 31, 2017
solr/config Solr Suggester with build on commit causes stack overflows in Solr, #469 Sep 19, 2016
spec Resolves #731 Sections as FileSet metadata Feb 17, 2017
tmp force creation of tmp folder with hidden empty file Sep 2, 2016
vendor/assets update leaflet to current version to add new accessibility features; … Feb 2, 2017
.fcrepo_wrapper section facet should match section order in monograph's ordered_members Aug 26, 2016
.gitignore Resolves #682 mongraph.subject should be multi-value Jan 19, 2017
.rspec Install rspec and test on Travis Mar 3, 2016
.rubocop.yml Fixes #479 - Added new hdl (handle) and doi predicates for file_sets (#… Oct 25, 2016
.rubocop_todo.yml adding transcripts to videos Jan 27, 2017
.solr_wrapper wrapper configs Feb 7, 2017
.travis.yml travis-ci doesn't need to install clamav Jul 27, 2016
Gemfile Bump solr_wrapper to 0.21.0 Feb 7, 2017
Gemfile.lock bump solr_wrapper to latest release (#756) Feb 7, 2017
LICENSE.txt Create LICENSE.txt Oct 19, 2016
README.md mention wrapper config files Feb 7, 2017
Rakefile Install rubocop Mar 3, 2016
Vagrantfile more power, captain Feb 7, 2017
bootstrap.sh Install libclamav-dev - required by clamav gem Jun 29, 2016
config.ru Generate Rails Mar 3, 2016

README.md

Stories in Ready

heliotrope Build Status

Hydra-based digital publisher platform

Development

Initial setup

  • clone the repository
  • run bundle install
  • run bundle exec bin/setup
  • install redis

Create an admin user

There is a rake task you can use to create a superadmin user. It will prompt you for an email address and password, and then create a user with the correct role.

bundle exec rake admin

If you need to run this when the app has been deployed, run:

RAILS_ENV=production bundle exec rake admin

Run the application

Run this command to start Fedora, Solr and Rails servers:

rake hydra:server

Or, if you prefer to start each server individually: (you must use this alternate option if runnig on a VM)

  $ redis-server /usr/local/etc/redis.conf
  $ bundle exec fcrepo_wrapper -p 8984 --no-jms
  $ bundle exec solr_wrapper -p 8983 -d solr/config/ --collection_name hydra-development
  $ bundle exec bin/rails s

Note, there are also config files available for running the wrappers (which save you from having to remember ports, collection names etc). Their settings attempt to persist your Solr index as you move between dev and test. Use like so:

fcrepo_wrapper --config .wrap_conf/fcrepo_dev
solr_wrapper --config .wrap_conf/solr_dev

Explain Partials

Set the EXPLAIN_PARTIALS environment variable to show partials being rendered in source html of your views (view this info using your browser's inspect element mode)

$ EXPLAIN_PARTIALS=true bundle exec bin/rails s

NOTE: Because this feature can add a fair bit of overhead, it is restricted to only run in development mode.

Testing

run rake ci

Alternatively, you can start up each server individually. This may be preferable because rake ci starts up and tears down Fedora and Solr before/after the test suite is run.

  1. Start up FCrepo

    fcrepo_wrapper -p 8986 --no-jms OR fcrepo_wrapper --config .wrap_conf/fcrepo_test

  2. Start up Solr

    solr_wrapper -p 8985 -d solr/config/ --collection_name hydra-test OR solr_wrapper --config .wrap_conf/solr_test

  3. Run tests

    rspec

Contact

Contact the Fulcrum Developers List with any question about the project.