Make Local Changes With GitHub Desktop

It’s time to create the home page for your website.

gif of following the directions below

  1. Make sure you are checked out to the new branch you just created. You change branches by clicking the Current Branch button at the top of the application, then selecting a branch.
  2. Open your preferred text editor.

The next steps are determined by if you used a GitHub Pages theme or decided to just enable GitHub Pages on your repository.

I am using a GitHub Pages theme

  1. Open the file named README.md.
  2. Remove the template text that was added to the README.md when you selected your theme.
  3. In the README.md file include at least the following two lines: # Hello World! and My name is GITHUB_USERNAME. Bonus points for including more information.
  4. When you are finished, save your changes and close the text editor.

I am not using a GitHub Pages theme

  1. Create a new file named index.html.
  2. In your index.html file, include at least the following two lines: <h1> Hello World! </h1> and <p> My name is GITHUB_USERNAME </p>. Bonus points for including more information, or using Jekyll Themes to create a more robust site.
  3. When you are finished, save your file inside your repository folder, and close the text editor.
Tell me why

Your First Website

For this activity, we are focusing on the steps for working with a repository with GitHub.com and your local environment. If you are not familiar with web design, that’s ok. These instructions will create a very basic, unformatted page.

There are several tools you can use in combination with GitHub Pages to create a beautiful website. For example, you can download one of the themes on http://jekyllthemes.org/ or you can create a regular HTML page. The possibilities are endless!

Stuck? Open an issue in the repository for this class and mention @githubteacher for help from one of the GitHub trainers!
Continue