search

openjournals / theoj

The Open Journal
http://theoj.org
MIT License
129 stars 10 forks source link

Update of Installation Notes #284

Open rgiessmann opened 6 years ago

rgiessmann commented 6 years ago

Hi all,

I really enjoy this package, but would like to add my pennies to make the installation process for first-time users easier:

  1. On Debian, I could get ruby with apt install ruby but also needed ruby-dev (for having ruby headers, which are needed by the json gem), so best is: apt install ruby ruby-dev

  2. I had to execute sudo gem install bundler first, to make the command bundle available.

  3. bundle install didn't work its way through, because of : 3.1. the json gem => solved with installing ruby-dev as described above; 3.2. but also because of libxml-ruby depending on libxml2 => sudo apt install libxml2-dev 3.3 gem mysql2: sudo apt install default-libmysqlclient-dev

  4. Further, because I had ruby 2.3.3 installed, I had to change the first line in Gemfile to ruby '2.3.3' instead of ruby '2.3.0' (worked still)

  5. I am still having a problem with firebase (NameError: uninitialized constant Firebase::Client), but hope to solve this soon.

All the best, Robert

marcrohloff commented 6 years ago

The app is configured to work with rvm and I would recommend using that to manage multiple ruby versions since I haven't tested against 2.3.3 (Although there is no reason it shouldn't work). You might want to start by installing it from https://rvm.io/

I just checked in a change which should fix the Firebase issue but if all else fails, we currently have Firebase support disabled so you could just comment that out.