How to clone the template

By Wout Dillen

Step 1: Create your own copy of the template

1.1: Add the template repository to your GitHub Account

Visit the re:write repository on GitHub. Click on the green button that says Use this template in the top left. In the drop-down menu, pick Create a new repository to start setting up a copy of the repository on your own account. Choose a name for your repository (or keep the default), choose whether you want your repository to be public or private, and continue. Note: the online visualisation of your essay with GitHub Pages will only work if you select ‘public’.

1.2: Create a copy of your repository on your local machine

Once you have a copy of the template in your GitHub account, clone the repository onto your own device to start developing your essay locally. You can easily do this by using GitHub Desktop, VSC, or do it straight from the command line.

To do this using GitHub Desktop:

  1. Open GitHub Desktop
  2. In the top-left corner, click on the button that reads Current Repository
  3. Click on the Add button, then choose Clone repository...
  4. In the pop-up that allows you to add a repository, make sure that you are son the GitHub.com tab, and select the repository you just made from the list. This will typically be categorised under the heading Your Repositories with a name following the [username]/[repository-name] pattern.
  5. Take note of the ‘Local Path’ underneath the selection menu, this tells you where the repository will be downloaded. Change the path if necessary.
  6. Hit the blue Clone button to download the repository onto your local machine.

For a visual walkthrough, see my video lecture on how to use GitHub, specifically from minute 57 onwards.

To use the commandline instead, refer to GitHub’s documentation.