The following instructions assume that you have a Mac laptop.
You must set up the following on your local machine:
- administrator rights
- Xcode command line interface tools
- Ruby programming language
- Middleman static site generator
Administrator rights on your laptop
If you are a Government Digital Service (GDS) employee, raise a ticket on the GDS Web Help Desk to request administrator rights on your laptop.
If you are not a GDS employee, follow your internal IT processes.
Install Xcode command line interface tools
- Go to Apple Developer Downloads.
- Search for “Xcode”.
- Select the appropriate Command Line Tools (macOS x.x) for Xcode x.x and download the file.
- Install the file.
If you have a software centre for your department, you should be able to install the Xcode command line tools through this software centre.
You can install Node.js to any location on your local machine.
You can install Ruby to any location on your local machine.
Run the following in the command line to install the ruby version manager:
\curl -sSL https://get.rvm.io | bash -s stable --ruby
Check the Ruby downloads page for the latest version of Ruby.
rvm install ruby-x.x.xto install the latest version of Ruby, where
x.x.xis the Ruby version number. For example,
rvm install ruby-2.6.1.
You can install Middleman to any location on your local machine.
Run the following in the command line to install Middleman:
gem install middleman