Class Website

Git is a version control system that is widely used within the developer community. Git will record changes made to our files and allow us to revert to older versions. You can read more here. We'll be using Git to publish our class websites through a Git repository hosting site called GitHub.

First, we have to set up our GitHub account and make our first repository:

  1. Make an account on GitHub (make sure to verify the account)
  2. Make a new repository by clicking the "+" in the top-right and selecting "new repository"
  3. Name your repository "class-site"
  4. Check "Initialize this repository with a README"
  5. Create the repository

Now to initialize GitHub Pages on our repository

  1. On the repository page, navigate to the settings tab and scroll down to the GitHub Pages section
  2. Change the source from "none" to "master branch"
  3. The settings should save automatically

Next, we need to create a link between our local files and the online repository:

  1. Download GitHub Desktop
  2. Open the GitHub Desktop application and login with your GitHub credentials
  3. Go to File > clone repository
  4. Select the "class-site" repository
  5. Change the local path to a location that is unlikely to change
  6. Click "clone"

Now we have a local folder that is linked to our Github repository. Next, we just need to make our index.html and publish the changes!

  1. Find the folder that you just created
  2. Open Atom, create a new file, and name it index.html
  3. Add all the necessary ingredients for the html document
  4. Make sure to add something in the body
  5. Save
  6. Open the GitHub Desktop application
  7. Select the "class-site" repository in the left-hand panel
  8. It should show that there is 1 changed file
  9. In the bottom-left dialog box, name the change (called a "commit") something like: "create index.html" (it can be anything you like, but the clearer the better)
  10. Click "Commit to master"
  11. And, finally, click the "Push origin" button in the top-right
  12. The changes that we made locally are now hosted online in our github repository!
  13. Any time we make changes locally to our folder, we will need to make sure to commit those changes and push them using the GitHub Desktop application before they will be reflected online

Your website will be published to your-github-username.github.io/class-site. If you don't see the changes reflected, wait a minute or two, sometimes it takes a second for the changes to update.

back