Skip to content
This repository has been archived by the owner on Nov 21, 2022. It is now read-only.

Initial setup: Mac

Zachary Wood edited this page Feb 3, 2020 · 4 revisions

If you haven't already, please follow the SRCT initial setup instructions for Mac to install the prerequisite software.

Open Terminal and navigate to your SRCT projects directory.

1. Install Ruby

We will use a tool called rbenv to install Ruby. This is good practice as it allows you to easily manage multiple Ruby versions across different projects. Run

brew install rbenv ruby-build

To activate rbenv, run the command

rbenv init

and follow the instructions that come up. Depending on the shell you use, it will ask you to insert some code at the end of your shell configuration. For example, if a set of instructions are printed out such as:

Load rbenv automatically by appending
The following to ~/.bash_profile:

run the following: echo 'eval "$(rbenv init -)"' >> ~/.bash_profile.

Restart your shell so that the changes take effect.

And then install Ruby 2.6.5 with

rbenv install 2.6.5
rbenv global 2.6.5

And run ruby -v to ensure the version is correct.

2. Install Bundler

Bundler is the ruby program used to install ruby packages. To install it, simply run

gem install bundler

3. Clone SRCTWeb

In your SRCT projects directory, run the following command to clone the SRCTweb codebase to your machine

git clone git@github.com:srct/srctweb.git

Run cd srctweb/srctweb to enter into the project directory.

4. Install dependencies

To install the Ruby dependencies, run

bundle install

This will probably fail -- if it does, run rm Gemfile.lock and try again.

5. Run SRCTWeb

Run the website by running the command

bundle exec jekyll serve
Clone this wiki locally