This is the beginning of a template for websites implemented using Jekyll.

Project Dependencies

Dependencies required for this project are:

• Python 3.5.2

• Node 4.5.0

• Ruby 2.3.3

• Ruby DevKit

• Docker Toolbox v17.06.0a-ce

  Note we are using this version due to a potential bug in 1.12.5, which is unable to mount volumes on Windows.

  docker-archive/toolbox#607

Windows Installation

Installing Python

https://www.python.org/ftp/python/3.5.2/python-3.5.2.exe

This documentation assumes an installation path of c:/Python35.

When installing Python:

• Choose 'Customize Installation'

• On 'Optional Features':

  Check 'pip' and 'for all users (requires elevation)'.

  Uncheck 'Documentation', 'tcl/tk and IDLE', 'Python test suite', 'py launcher'.

• On 'Advanced Options':

  Set an installation path of c:/Python35.

  Uncheck all options.

Creating a Virtual Environment and Installing Dependencies

Create the virtual environment. From the working directory of our project (e.g., c:/devel/web-tractdb):

c:/Python35/python.exe -m venv env35

This will create a directory for the virtual environment (e.g., c:/devel/web-tractdb/env35/).

Next activate that virtual environment and install our Python dependencies:

env35/Scripts/activate.bat
pip install -r requirements3.txt

Installing Node

https://nodejs.org/dist/v4.5.0/node-v4.5.0-x64.msi

The default installation options are appropriate.

Installing Ruby

https://dl.bintray.com/oneclick/rubyinstaller/rubyinstaller-2.3.3.exe

This documentation assumes an installation path of c:/Ruby233.

When installing Ruby:

• On 'Installation Destination and Optional Tasks':

  Set an installation path of c:/Ruby233.

  Check 'Add Ruby executables to your PATH'.

Installing Ruby DevKit:

https://dl.bintray.com/oneclick/rubyinstaller/DevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe

This documentation assumes an installation path of c:/RubyDevKit.

When installing the Ruby DevKit:

• Extract to c:/RubyDevKit.

• Install the DevKit into the Ruby installation:

  cd c:/RubyDevKit
  ruby dk.rb init
  ruby dk.rb install
  

Installing Docker Toolbox

https://github.com/docker/toolbox/releases/download/v17.06.0a-ce/DockerToolbox-17.06.0a-ce.exe

This installer must be run by right-clicking and selecting 'Run as administrator'. This is required even when using an Administrator account. Otherwise, VirtualBox can fail to create the host-only network required for VirtualBox and Docker Toolbox.

When installing Docker Toolbox:

• On 'Select Destination Location':

  Set an installation path of c:/Program Files/Docker Toolbox.

• On 'Select Components':

  Uncheck 'Kitematic for Windows'.

Mac Installation

Installing Homebrew

This documentation assumes use of Homebrew: https://brew.sh/.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

The default installation options are appropriate.

Installing Python

brew install python3

Installing python3 via Homebrew should automatically install pip3. Use that to install virtualenv.

pip3 install virtualenv

Creating a Virtual Environment and Installing Dependencies

Create the virtual environment. From the working directory of our project (e.g., ~/Desktop/web-tractdb):

virtualenv -p python3 env35

This will create a directory for the virtual environment (e.g., ~/Desktop/web-tractdb/env35/).

Next activate that virtual environment and install our Python dependencies:

source env35/bin/activate
pip3 install -r requirements3.txt

Installing Node

brew install node

Installing Ruby

brew install rbenv

Configure the terminal to include rbenv:

echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile`
source ~/.bash_profile`

Install the correct version of Ruby:

rbenv install 2.3.3
rbenv global 2.3.3

Alternatively, you can specify a Ruby version for the directory:

rbenv local 2.3.3

Installing Ruby DevKit:

Installing rbenv via Homebrew should automatically install ruby-devkit

Installing Docker Toolbox

TODO