#Portfolio Template
Hey, This is my portfolio.
Demo: https://deep-debug.github.io/
About this template
Getting started
How to customize this template
Creating a new project page
Adding gallery images
Publishing with Github Pages
After seeing the mission of Unemployables (https://unemployables.io/) to help people become self-employed and grow their businesses, I immediately thought about helping people build portfolios. It's something that I've helped friends with in the past and really enjoyed doing.
This template is mobile friendly, so you won't have to worry about your site not working on phones.
The goals of this template are:
- To be a starting point for someone who's never touched web development but wants to build their own portfolio website.
- Help keep costs of running a portfolio website low by publishing the website on Github Pages for free (instructions further down).
If you haven't used Git / Github before, here's some guides to get you started:
- Basics of git: https://www.freecodecamp.org/news/learn-the-basics-of-git-in-under-10-minutes-da548267cc91/
- Forking a repository: https://docs.github.com/en/get-started/quickstart/fork-a-repo
Template instructions:
- Click the
Use As Template
button above and name your new repository (it should be set to public). - Clone your newly created repo to your local machine.
- Navigate to the cloned repo on your machine and open
index.html
with your browser. - Open the repo folder in your favorite code editor and start editing. (Make sure to refresh the browser to see the code changes you make!)
- Publish your site by pushing your commits to your repo.
- Set up Github Pages (guide further down!)
All changes that need to be made are commented in the code with a TODO
tag.
Search for it and you'll find all the changes you need to make. That being said, there are some high level things to know:
- Image assets that you add for projects, header photo, or the favicon should go in the
assets/images
folder - For every new project page, make a copy of
project-template.html
and keep it in theproject-pages
folder - All styling is located in the
css
folder, have at it if you feel like changing up the styling. - The
js
folder holds one script file that you can add any custom Javascript into.
- Make a copy of
project-template.html
in theproject-pages
folder and rename it to<project-name>.html
- Open
index.html
and find thediv
withclassName='project-container'
- Add a new project card into that div. Here's the template for a project card:
<div class="project-card">
<img src="./assets/images/IMAGE_NAME" class="project-image">
<div class="project-card-text-container">
<div class="subheader-text project-title">PROJECT_NAME</div>
<div class="body-text project-card-text">SMALL_PROJECT_DESCRIPTION</div>
</div>
<a class="button" href="./project-pages/PROJECT_PAGE_NAME.html">
<span class="button-text">Read More</span>
<image src="./assets/icons/arrow-right.svg" class="right-arrow-icon"/>
</a>
</div>
- Change
PROJECT_PAGE_NAME.html
to the name of the new html file you copied from the project template - The project page is now linked to the homepage! Customize the page and
"project-card"
to your heart's content.
- Make sure the images that you want to show are added to the
assets/images
folder - Open the project page you want to edit and find the
div
withclass="project-gallery-content"
- To add an image, copy one of the two templates below and paste them into the
project-gallery-content
Full Width Image:
<div class="gallery-image-container">
<img src="../assets/images/IMAGE_NAME" class="gallery-image">
<span class="image-caption">IMAGE_CAPTION</span>
</div>
Half Width Image:
<div class="gallery-image-container half-width">
<img src="../assets/images/IMAGE_NAME" class="gallery-image">
<span class="image-caption">IMAGE_CAPTION</span>
</div>
- Change IMAGE_NAME to the filename of the image you added to
assets/images
and IMAGE_CAPTION to whatever caption you want (or remove it, I don't mind) - Refresh the project page in your browser and boom! Your image has been added to the gallery.
Github Pages allows us to host this website for free! It's pretty simple to set up as well.
- Head to
Settings
on the repository - The repository will need to be public for this work (if it's not, navigate to
General
and scroll all the way down toChange repository visibility
. Make it public) - Navigate to
Pages
in the sidebar - For
Source
choosemain
from the dropdown. Save the changes. - That's it! Github should give you a URL that your website is published on (give it a few minutes to update).
- To add a custom domain (i.e. yourname.com), follow this guide: https://medium.com/codex/add-a-custom-domain-to-your-github-pages-personal-website-53ab40e7c7d0
Feel free to send me pictures of your portfolio website once it's up and running. Would love to see them! https://twitter.com/ndoherty_xyz