Document

So you want to build a website? Or maybe you already have one. And instead of buying a hosting server right away, you want something free, easy, and convenient. Well, Github Pages is for you!

Let's start with the requirements. First, your website should be static, not dynamic - which means all your data is stored in your HTML, CSS, or javascript files.

Static - plain websites written in HTML, CSS, and Javascript.
Dynamic - websites that uses a database to fetch data.

Configuring your Github account and repository

Go to Github.com then register or log-in.

Create a new repository

On creating a repository:

Repository name - should be username.github.io, where username is your Github username.
Description - a short description about your website.
Public or Private - choose public, private can only be chosen by paid users.
Initialize this repository with a READ.ME - check the text box since this is a requirement for a repositroy.
Click Create Repository.

Creating files for your project

Click create new file. image here

Let's start with your index.html file.

This file will serve as the Home Page or landing page of your website. Quick note: All website's home page are named index.html; and so, Github will look for this file and use this to display your homepage. image here

If you already have your code, paste it in. Otherwise, let's start with:


      
      
      
      Hello World
      I'm hosted with GitHub Pages.

Once done, scroll down to the commit section area and you will see this: image here.

Add a commit title and a short description of the changes that you made. In this case, this is the first commit and in this commit, we created an index.html file.

Visiting your page

Congrats! You're mostly likely set now to view your website online!

Go to username.github.io where username is your Github username. Mine for example, it's billcastillo.github.io image here.

Common Errors

If everything was set correctly you should see your website, so make sure the file name is correct. Otherwise it might show you this error page. image here.

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque eu, pretium quis, sem. Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu. In enim justo, rhoncus ut, imperdiet a, venenatis vitae, justo. Nullam dictum felis eu pede mollis pretium.

Just testing a new header

This should be small

I dont now what size this will be

Karma will come.. eventually.

FUk off m8.

Useful Resources

Github pages help