Installation Instructions: Windows

To work on this repository on a Windows machine, you need to install a couple of tools.

Installing a Text Editor

Note: If you already have a preferred plaintext editor that you like, go ahead and skip this section!

You will need to install a text editor in order to write files to put in your git repository and push to the website. A text editor like Vim or Emacs is different from something like MS Word, because they edit raw text files directly. MS Word stores files with special formatting automatically, hiding the details from the user.

In this workshop, I recommend you install and use Atom. Atom is a cool text editor that has a pretty graphical user interface, and is entirely open-source! You can even view the source code on GitHub.

Another text editor that will be useful for you to know in the future is Vim. This editor takes a little more getting used to, and I won't be going over it in the curriculum, but I recommend trying it out in the future!

Install Atom from here, and poke around a bit to get used to writing a file in it.

Installing Git

You can install git for windows here. This will install both git graphical user interface (GUI) and git bash shell on your computer. In this workshop we will learn about using git bash.

The following are the recommended installation options for this workshop:

1. Select Components screen - The default setup for this should be fine, you can choose to add a desktop icon.

2. Adjusting your PATH environment screen - Choose "Use git from git bash only"

3. Choosing the SSH executable screen - Choose "Use OpenSSH"

4. Configuring the line ending conversions screen - Choose "checkout Windows-style, commit Unix-style"

5. Configuring terminal emulator screen - Choose "use MinTTY"

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