Skip to Main Content
| Brooklyn College Library & Academic IT |CISC Department

CISC 3130 Data Structures: GitHub Pages

Professor Chuang Spring 2020 OER

Quick Links

Getting Started with GitHub Pages

This section walks you through step by step.

TL;DR:  

  1. Create repo of name: yourusername.github.io
  2. Go to that repo’s settings and check the box for pages (note the drop down option selected)
  3. Add .html files to your repo

You should be able to access your website from http://yourusername.github.io


Longer Version:

When you use GitHub pages, you can access your website at the url http://username.github.io and the underlying files would be found in your repository, which can be found at url structure  http://github.com/username/username.github.io 

 

  1. From your account, create a new repo following the structure username.github.io -- this is the basis for producing a website hosted by github pages (https://pages.github.com/).
  2. Confirm that the pages feature is turned on for that repository, under the settings menu.
  3. This allows you to host files under your GitHub account. 
    1. You could use the github.com web interface to upload each file individually, however I recommended you take time at some point in your career to gain familiarity with the workflow of using git commands from your machine terminal. 
    2. Upload the images and html files to that repo. 
  4. If set up properly you should be able to access your website from http://username.github.io 

 

Specifications

HTML Specifications https://html.spec.whatwg.org/

CSS Specifications https://www.w3.org/Style/CSS/specs.en.html

 

Creating Sites (and Blogs) using Jekyll Site Generator

Github pages recognizes files using the Jekyll Static Site Generator framework. This is a Ruby language library that converts text (markdown formatted files) into html pages.

Static html pages means that it is an html page that doesn't change when you view it across different timestamps. As in, static is not a script generated page that pulls data from a database (that would be dynamic).

The guides for using Jekyll are easily found through your nearest search engine. Here are several: