Publish your portfolio on GitHub

Alex Jose — Fri, 25 Sep 2020 06:53:17 +0000

How portfolios help you?

A portfolio helps working professionals to highlight their best work and display accomplishments, skills and potentials. Portfolios visually showcase examples of work. Portfolios are a great way to demonstrate the competencies you would list on a resume or talk about in an interview - they allow you to show and not just tell. It presents evidence of your relevant skills and abilities.

Why GitHub?

GitHub is a web-based platform for version control using git. It is also where users can collaborate on or adopt open-source projects, fork code, share ideas and more. You can consider GitHub as a website while Git is a tool that keeps track of your files and modifications to those files in a repository. It is easier and free to set-up a GitHub account and host your portfolio using GitHub pages.

Prerequisites:

Create a GitHub account
Knowledge on how to use Git and GitHub
Understand how GitHub-Pages work
A Theme for your portfolio. You can use either Bootstrap theme or HTML/CSS template

For quick portfolio template:

How to publish portfolio on GitHub?

Login to you GitHub account or create one if you don't have one.
Create a new repository named username.github.io. If your GitHub username is alexjose, then your repository name should be alexjose.github.io. Make sure to set your repository as public.
Create a folder in your local machine. Eg: Documents/Portfolio. After that, clone your repository by running the following command in git bash:

git clone https://github.com/username/username.github.io.git

Remember to replace the URL with your username.

Copy the contents of your downloaded template into the cloned local repository.Make sure that index.html file is at the root of this directory.
From git bash change directory into cloned repository:

cd username.github.io

Run the following commands to make the push to your remote repository:

git add -A
git commit -m "initial commit"
git push origin master

Navigate to https://username.github.io to view your newly created online portfolio.