Setup instructions

The following instructions will help you to get ready for Premiere Classe:

• Grab a text editor, where you'll spend your day and nights
• Install a package manager
• Pimp your terminal
• Setup Git and Github
• Install Ruby

GitHub account

Have you signed up to GitHub? If not, do it right away, it's free.

Upload a picture and setup your name correctly on your Github account.

Mac Users, install command line tools

If you are running Ubuntu, skip this step. If you are running Mac OS and you already have XCode installed, skip this step.

Open the terminal and type:

$ xcode-select --install

It will open a window asking you if you want to install some software. Accept and wait.

If this does not succeed, install XCode so that you have some command line tools which are not available by default when buying a Mac. Click on the  at the top left of your toolbar and open the App Store. Search for XCode, download it.

Sublime Text 2 - Your text editor

A text editor is one of the two most important tool of a developer (the other one being the command line). Go to this page and download Sublime Text 2. Install it. It is free without any time limit but a popup will appear to remind there is a license to buy. Just hit Esc when this happens, but feel free to buy it if you really like this one (there are alternatives).

Package control

We will install the package manager right away to install addons. Launch Sublime Text, then open the console via the View > Show Console menu. Then you need to copy paste some code in the console. If you have trouble with this step, ask a teacher.

Preferences

Go to Preferences > Settings - Users, it will open a file. Copy paste the following configuration and save this file. Restart Sublime Text 2.

{
  "tab_size": 2,
  "translate_tabs_to_spaces": true,
  "detect_indentation": false,

  "trim_trailing_white_space_on_save": true,
  "draw_white_space": true,
  "use_tab_stops": true,

  "show_minimap": false,
  "rulers": [ 80 ],

  "folder_exclude_patterns": [ "tmp", "log", ".git", "_site", ".bundle", ".sass-cache" ]
}

The convention we are enforcing with this configuration is that we use 2 spaces for indentation (no tabs). So each time you will hit the tab key, Sublime Text will insert 2 spaces.

Homebrew, Mac's missing Package Manager

If you are running Ubuntu, just run the following, and go to next step:

$ sudo apt-get install git

On Mac, you need to install Homebrew. To do so, open your terminal and run:

$ ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"

Then install some useful software:

$ brew install vim git

Oh-my-zsh - Fancy your terminal

We will use the shell named zsh instead of bash, the default one. Open your terminal and run:

$ curl -L http://install.ohmyz.sh | sh

On Mac, open Terminal > Preferences and set the "Pro" theme as default in Réglages. Quit and relaunch the terminal.

Git

We need to configure Git with SSH keys, this way you won't have to put your password each time you want to git push some modifications.

It is a tricky concept and a tricky setup, fortunately GitHub wrote a great article. Just go to this article, and select your environment at the top (Mac or Linux). If you need help, ask a teacher.

NB: when asked for a passphrase, don't put your laptop password or your github password. It is important to protect your keys with a password, otherwise anyone having access to these files will be able to impersonate your GitHub account (and get his hand on your private code for instance).

Your Configuration

Hackers love to refine and polish their shell and tools. We'll start with a great default configuration provided by Le Wagon, stored on Github. As your configuration is personal, you need your own repository storing it, so you first need to fork it to your GitHub account.

Go to this page and fork the repository. Forking means that it will create a new repo in your Github account, identical to the original one.

Open your terminal, and set your github username in a variable (don't just copy paste!):

$ GITHUB_USERNAME=your_github_username

Then run the three commands to clone the repository you just forked to your computer. You just have to copy them, do not try to edit anything.

$ mkdir -p ~/code/${GITHUB_USERNAME} && cd $_
$ git clone git@github.com:${GITHUB_USERNAME}/dotfiles.git
$ cd dotfiles

We now need to configure the gitconfig file with your own identity. Open it in Sublime Text, and update line 2 and 3 with your own identity:

[user]
  name =  "COMPLETE THIS (no accented characters)"
  email = "COMPLETE THIS"

Time to install this default configuration, just run:

$ ./install.sh

You should commit this change:

$ git add gitconfig
$ git commit --message "Added my identity to the gitconfig"
$ git push origin master

Quit and relaunch your terminal. You should be all set!

Installing Ruby

You may already have installed ruby, but we are going to do it again using rbenv, a manager for installing different Ruby versions on your computer.

Open a terminal, and run:

$ source ~/.zshrc
$ curl https://raw.githubusercontent.com/fesplugas/rbenv-installer/master/bin/rbenv-installer | bash

If you are using Ubuntu, run this, if on Mac, skip this step:

$ rbenv bootstrap-ubuntu-12-04

Now, you are ready to install the latest ruby version, and set it as the default version.

$ rbenv install 2.1.2
$ rbenv global 2.1.2
$ source ~/.zshrc
$ ruby -v

You should see something starting with ruby 2.1.2p. If not, try to restart your terminal

Mac Users, password-protect your computer

It is mandataory that you protect your session behind a password. If it is not already the case, go to  > System Preferences > Users & Groups, and change your account password. You should also go to  > System Preferences > Security > General. You should require a password 5 seconds after sleep or screen saver begins.

You can also go to  > System Preferences > Mission Control, and click on the Hot Corners button at the bottom left. Choose for the bottom right corner to start the screen saver. That way, when you leave your desk, you can quickly lock you screen by putting your mouse in the bottom right corner. 5 seconds after, your mac will be locked and will ask for a password to get back on the session.

Mac Users, this is a hacker bonus

You can have a look at this and run whichever command you see fit.