Skip to main content

Preface Materials: Windows

As this book was written on the assumption that you have no experience with Git or the command line, it also assumes you do not have necessary materials (software). Downloads will differ slightly depending on it you have a Mac or a PC and if you are running Linux. The following will provide necessary materials to use this book as well as links and some relevant instructions for those who are using Windows. If you are running Windows Subsystem for Linux, instructions might be slightly different; however, start here and jump to a quick Google search if something goes wrong.

A Text Editor.

In order to edit files as demonstrated in this book, you will need a text editor outside of the basic default editor. Any editor will work such as Sublime Text 6 .
If you are already familiar with an editor or if you like a particular one, use it! However, I personally prefer Visual Studio (VS) Code 7  which can be downloaded at the previous link. Throughout this book, I will refer to VS Code with some guidelines on how to find certain features. Should you decide to use another editor, it is up to you to learn how to use it. If you are a beginner with Git and the command line, I would stick with VS Code although as you gain experience you might think about switching to Sublime Text.

Git/Git Bash.

To use Git, you need to download and install it on your computer. Depending on your computer and where you got it, you may actually already have Git (for instance, university laptops). To run a quick check, use Windows + S and search for “git bash”. If an application pops up, great! You do not need to install anything. If not, carry on.
Windows does come with its own command prompt. (What’s a command prompt? See Section 2.1.) However, its syntax doesn’t match other terminals and notably is different from Macs. Thus, to ensure that everyone is on the same page, we will download a piece of software called Git Bash that allows everyone to use the same commands.
To install Git Bash, follow these next steps. Yuvraj Chandra wrote a useful Git Bash installation guide 8  that may help you if you get stuck.
  1. Visit the Git website 9  and select the download for Windows.
  2. Open the .exe file and follow the instructions to install Git Bash. Most of the default options should not be changed. However, please read the following notes before installing.
    • Your computer may ask you if you want to allow the app to modify your computer; it is safe to say yes.
    • When you reach the “Select Components” screen, I recommend leaving the default boxes checked as they will be useful later on.
    • When you reach the “Choosing the default editor used by Git” screen, I recommend selecting the “Use Visual Studio Code...” option (if you have decided to use VS Code).
    • When you reach the “Adjusting the name of the initial branch...” screen, I recommend selecting “Override the default branch name...” and type in main (lowercase) into the box. This will help us match the Mac version and respect Git’s attempts to be more inclusive 10 .

GitHub.

You will also need a GitHub account. Since this is an extensive topic, this is covered in Subsection 3.1.1.