ITEC 4610 - Project Development and Portfolio Defense

Github.com - Using Github to Host Your Portfolio

Getting Started with Github

Create Your Github Account

  • Go to https://github.com and click "Join" or login to an existing account. (use a professional username, such as your initials and last name. Use all lowercase.
  • Enter your UA Little Rock Email and and choose a password. Be sure that you retain your password. Review and accept the Terms of Service.
  • Click the "Create an Account" button.
  • Complete the CAPTCHA puzzle.
  • Choose the free subscription plan.
  • Login to your UA Little Rock email and locate an email from Github. Click the "Verify Email Address" button. This confirms your email address and returns you to the sign-up process.
  • You probably want to leave the "Send Me Updates" box unchecked unless you are delighted by spam emails.
  • Click "Submit " to complete the process.

Create Your Portfolio Repository

  • Click on the "Octocat" logo at the top left of the Github webpage. This will take you to the homepage.
  • In the upper left of the page, you will see "Repositories". Click the "New" button to the left.
  • Here you will name your repository:
    • The owner is set to your username...do not changes this.
    • In the Repository name, enter "portfolio" (no spaces).
    • Leave your repository as public. DO NOT set your repository to private, since this requires a paid subscription
    • Check the box "Add a README file", so that you will have one file in your repository.
    • Scroll to the bottom of the page and click "Create Repository"
  • Click on the "Octocat" logo at the top left of the Github webpage. You should now see your porfolio repository. Click on the link to display the repository. It should have the README file in it. Note the URL of the repository. It should look like: https://github.com/username/portfolio. Click on the README file, where you can see and edit the contents of the file.

Files and Folders

Making Changes to Your Portfolio

  • The index.html file is the default file for a URL when no file is specified.
  • Click the "Add File" dropdown, then click "Create New File".  Enter "index.html" in the file name.  Copy and paste the following into the file source:
<!DOCTYPE html>
<html>
<head>
<title>Portfolio of Put Your Name Here</title>
</head>
<body>
<h1>Hello World - Portfolio of Put Your Name Here</h1>
</body>
</html>
  • Scroll to the bottom of the page and click "Commit new file" to save the changes.
  • Open "index.html" with a browser and you should see the portfolio homepage.
  • You should see "index.html" in your portfolio repository.

Publishing Your Portfolio

  • In the upper right tabs, click on "Settings".
  • Scroll down to "Pages". On the Source value, click the dropdown and select "master branch", then click "Save".
  • It will take a minute or two before your portfolio is published. You will eventually be able to see the portfolio at https://yourusername.github.io/portfolio
  • Open a new browser tab and browse to https://yourusername.github.io/portfolio to see your "index.html" file.

Submiting your Portfolio Github URL

  • When you are satisfied that your portfolio is working on Github, email the URL of your portfolio to your instructor. It should be of the form:  https://yourusername.github.io/portfolio