MINTS Instructables

How To Build a Github Pages Website:

Once you’ve created a GitHub account, the first thing you want to do when creating a GitHub Pages Website is to build a repository.

You can do this by logging on to GitHub.com, and then clicking the green button on the homepage labeled, “New repository.”

Make sure to initialize the repository with a README.

The remaining process of creating a GitHub page varies from if you’re building a user/organization site or your project a site.

User/Organization Site:

You can either start your user/organization site by using a terminal, or by using GitHub Desktop.

1. Clone Your Repository

-If you are using a terminal, navigate to the folder you’d like to store your project, and then clone the repository by clicking the green “Clone or download” button on your repository’s homepage.

-If you are using GitHub Desktop, click the “Set up in Desktop” button on the repository’s homepage to clone.

2. Create/Add an index.html File: After entering your project folder you need to add an index.html file to your project.

3. Finalize: Enter the repository, commit, and publish your changes.

Project Site:

You can either start your project site from scratch, or by choosing a theme.

Starting From Scratch:

1. Create an Index File: Under your repository create a new file by pressing the “Create new file” button.

Name the file index.html and type HTML content into the editor. Commit the file.

2. Enable Github Pages: You can do this by clicking the settings button on your repository. Scroll down the “Options” category in settings until you find the heading labeled, “Github Pages.”

Now select your source. Your “source” is considered the root of your web page.

Use the “Source” drop-down menu to select a publishing source.

-If creating a user/organization site, you must save your site’s source code on the master branch.

-If your chosen publishing source already exists, navigate to it.

-If your chosen publishing source doesn’t exist, create it.

Choosing a theme:

1. Theme Chooser: You can do this by clicking the settings button on your repository. Scroll down the “Options” category in settings until you find the heading labeled, “Github Pages.”

2. Pick a Theme: Click the, “Choose a theme” button that’s under the Github Pages heading. Scroll through the theme options, and choose the one that’s most appealing to you by clicking the green, “Select theme” button.

3. Edit The Content On Your Site

4. Click The Green “Commit changes” Button To Finalize