Lab & Development Environment - Webbprogrammering/websoft GitHub Wiki

You need a set of basic development tools. You can use those as proposed below, or choose your own liking.

General setup

These are the tools you will need to enter the course.

Texteditor

You need a texteditor or a more advanced Integrated Development Environment (IDE). A plain texteditor will suffice, for example Atom or Visual Studio Code.

Git

You need the code versioning system Git. I propose you work in a terminal like Git Bash, but the Git GUI might also work.

You should configure your installation of Git, that is to identify yourself as the one that have changed the code. This is done in the terminal.

git config --global user.email "[email protected]"
git config --global user.name "Your Name"

You can ensure that it was done correctly by entering the following command.

git config --global --list

It could look like this, when you execute that command, but with your name and your email. The $ represents the prompt and is not part of the command written.

$ git config --global --list
[email protected]
user.name=Mikael Roos

You can get some help to set up Git in the help section.

GitHub

GitHub is a website offering hosting of Git repos and additional services. You should create your own personal account on GitHub. You will need it to create your own git repo for the course.

Fork the course repo

Lets create your own copy of the course repo. Start by login to GitHub with your new user. Then move onto the course repo.

Find the button named "Fork", usually up to the right. Click on it to fork (copy) the course repo into your own account.

There are more information about forking a repo in the help section.

Clone your version of the course repo

Once you have Git installed, and you have forked the course repo, then you can clone your own version of the to your local harddrive.

Go to your repo, find the button labeled "Clone or Download". Open up your terminal and clone the repo. It will initially be easiest to use https as the cloning method. Feel free to use ssh if you understand what needs to be configured.

Change YOUR-ACCOUNT to your own account name.

git clone https://github.com/YOUR-ACCOUNT/websoft.git
cd websoft

The course repo contains a folder named example/, check it out to see what it contains.

Create a working directory in the repo

Note. Do not change any of the existing files in the repo. That prevents you to get an updated version of the course repo.

Instead, make your own directory work/ and save all your own work and example programs in that directory. You can copy files from example/ into work and play around and change them as you wish.

# Go the websoft directory
mkdir work
cd work
ls

In the Git Bash terminal you are using Unix terminal commands.

If needed, read up on Basic UNIX commands.