Skip to content

Installation Instructions: Mac

Elana Hashman edited this page Mar 6, 2016 · 3 revisions

Install a Text Editor

You will need to install a text editor in order to write files to put in our git repository and eventually push to the site. A text editor like Vim, Emacs or Sublime allows you to edit raw text files directly, unlike a rich document editor like MS Word, which saves the text that you see with hidden formatting.

OS X already has a built in text editor called TextEdit. You can use this if you want, but it's missing a couple features that you might find useful.

In this workshop, I recommend you install and use Atom. Atom is an open-source text editor - you can actually see the code for it on GitHub!

  1. Download Atom here; click on "Download for Mac".
  2. Once the package has finished downloading, double click on the zip file to install Atom.
  3. To run Atom, search for the application (command + space) and click on the icon to run it.
  4. Once Atom is running, right click on the Atom icon in your dock and click "Keep in Dock" under Options.

Install Homebrew

Homebrew is package management software that simplifies installing software on OS X. You don't need Homebrew to install git, but it will likely make your life a lot easier in the future.

  1. Open the Terminal. (command + space + "Terminal" + enter)
  2. Copy and paste /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" into your terminal command prompt. Press return.
  3. Enter brew --version to confirm that the installation was successful. Terminal should print a version number, git revision number and a date of the last commit

Don't close your terminal! Not only will you need it for the rest of this section, but you will also need id for the rest of the workshop.

Install Git

Now that Homebrew is installed, installing git is super easy!

  1. Enter brew install git into a terminal prompt.
  2. Enter git --version to confirm that the installation was successful. Terminal should print git version <version number> (Apple-Git-61)

That's it!

Once you've completed these steps you can move on to the Part 2: Setup your Repository page.