Setup: Before Creating Content#
Fortunately and unfortunately comitting to open source projects usually requires more in-depth knowledge than just pushing some slides onto dropbox and sending a link to your students.
To replicate the showcased websites here we’ll therefore be using some tools that you might not be familliar with. The following section will illustrate exatly what we need, how to install the necessary tools and where to go for further information.
Required Software#
We’ll need the following
a Github account
a version control system
git (command line tool) and Bash
or
An IDE or text editor: e.g. VSCode (recommended)
For this tutorial we will be relying on the Gitkraken client**, a software package icnluding a Graphical-user-interface to manage all your git/Github projects. If you’re not too familiar with coding or simply prefer to have a visual overview of the exact changes you’ve made, your version history, etc., this might just be the better choice for you, than using Git via the command line.
Simply download and install the Gitkraken client and connect it to your online Github profile.
Setting up a GitHub account#
First things first, let us set up a GitHub Account.
1. Go to the GitHub website: Open a web browser and navigate to the github.com.
2. Click on the “Sign up” button located in the upper-right corner.
3. Fill out the registration form: Fill out the required information and choose a username. Choose your username carefully, as your username will be included in the link to the website we’re going to build and will be publicly displayed!
4. Verify your email address: Check your email inbox and click on the verification link sent by GitHub.
5. Customize your profile: Fill out your profile information. This will help others to find and connect with you on GitHub.
And that’s it! You can now use your new GitHub account to store your code online or collaborate and share your projects with the world!
Check if you are ready#
Can you open a text editor?
Can you go to your GitHub account?
A.) When you open a terminal on your system and type
git --version
, does it output the version number? (macOS / Linux: you might need to run this:conda install -c anaconda git
)or
B.) Open Gitkraken and create a new repository (called initiating a new repository, under “Start a local project”)