How to Make a Data Science Portfolio That Stands Out

---

Many people have asked how I made my https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/website. In this article, I want to describe that exact process and walk through all the tools and tech I used.

Note: This tutorial is mainly for Mac users as that's what I use and can document.

Pre-Requisites

To deploy our website, we will use Git and GitHub quite a lot. The stuff you need is:

• GitHub account -> Create one https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/here.
• Install git for command line -> Follow thttps://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/his guide.
• Generate SSH keys for cloning repos -> Follow https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/this guide.
• Basic understanding of git commands -> Check out a guidebook https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/here.
• Understanding of command line -> https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/Here is a good tutorial.

However, don't worry too much. I will walk through all the git commands in this post anyway, but it's always better to have some intuition of what's happening.

You will also need https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/Homebrew. This is dubbed the ‘missing package manager for MacOS' and is very useful for anyone https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/Coding on their Mac.

You can install Homebrew using the command given on their website:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Verify Homebrew is installed by running brew help (you should get a list of brew commands and how to use them).

Finally, have some IDE, like https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/PyCharm or https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/VSCode. Anything you like will do.

Hugo

https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/Hugo is a tool for creating static websites written in GO. It is straightforward to use but requires some programming experience. I wouldn't recommend it if you don't have any coding experience whatsoever; in your scenario, no-code solutions are better.

Installation

The first step is to install GO and Hugo using Homebrew. Run the following command to do this:

brew install go hugo

Verify both are installed by running:

hugo version
go version

Creating Site

First, we will create a new website template by running the following:

hugo new site quicksite

Then we will go into that new directory:

cd quickstart

You can view whats in this folder by running ls.

Now, we will initialise this folder as a GitHub repo in preparation for pushing it to GitHub.

git init

Adding Theme

Hugo has many themes and templates that you can use instead of building your website from scratch. A link to all the templates https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/is here.

https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/Congo is the theme I use for my website, and we will be working with it today. However, this process will work for any theme in the list, so if you don't like the one I use, I am sure you can find something.

Credit to https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/James Panther for creating this template, I recommend you check his stuff out!

There are different ways to add the theme to your repo; my personal preference is through https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/git submodules.

https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/See here for a complete list of adding themes. Many users prefer to use Hugo modules.

Git submodules allow you to put another git repo/project within your own git repo, and you can reference it. The main project can then use the submodule's code, but it maintains its own commit and branch history.

It may sound complicated, but it's not that difficult in practice. In essence, it's just copying and pasting a directory into a project.

To start, we need to add the Congo theme as a submodule (make sure you are in the projects directory when you do this):

git submodule add https://github.com/jpanther/congo.git themes/congo

Your file structure should look something like:

quicksite/
├─ archetupes
├─ assest
├─ config
├─ content
├─ data
├─ i8n
├─ layouts
├─ public/
├─ static
└─ themes/
   └─ congo/

Now, we need to move some theme files into our main project. I used my IDE for the next few steps, but you can just do what feels comfortable to you.

In the root folder, delete the hugo.toml file that was generated by cloning the submodule.

Copy the *.toml config files from the congo theme into your config/_default/ folder. This will ensure you have all the correct theme settings.

The file structure in config should look like this:

config/_default/
├─ config.toml
├─ languages.en.toml
├─ markup.toml
├─ menus.toml
├─ module.toml
└─ params.toml

Go to the config/_default/config.toml file and uncomment the baseURL line and add theme = "congo". To verify the theme is active, run hugo server and click on the local host link. You page should look something like this.

Congrats, the theme is now up and running!

The author of the Congo theme also provides his own guide on installing the theme if you want a second reference point.

https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/Installation

Editing Theme

Let's now customise the theme. I won't go over every detail because it will take ages, and the author has a https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/complete guide on their website that you can use for more information.

In general, the structure of the repo looks as follows:

.
├── assets
│   └── img
│       └── author.jpg
├── config
│   └── _default
├── content
│   ├── _index.md
│   ├── about.md
│   └── posts
└── themes
    └── congo

To customise mine, I viewed some other websites that use this theme, found https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/ones I liked, and simply copied their GitHub code. This one was a big inspiration, and you can find the GitHub code https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/here.

For this tutorial, I will show you how I made my homepage, which you can see at the start of the article.

Create content/_index.md page, and add the following to it:

---
title: "About"
showAuthor: false
showDate: false
showReadingTime: false
showTableOfContents: false
showComments: false
---

I'm a Data Scientist & Machine Learning Engineer with a Master's degree in Physics, currently working at [Deliveroo](https://deliveroo.co.uk/).

In my spare time, I create [YouTube videos](https://www.youtube.com/channel/UC9Tl0-lzeDPH4y7LcRwRSQA), 
and write [newsletters](https://newsletter.egorhowell.com/) and [blogs](https://medium.com/@egorhowell) about https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/Data Science and machine learning.


  
For any questions or inquiries, feel free to reach out via https://towardsdatascience.com/how-to-make-a-data-science-portfolio-that-stands-out-94dd81be1448/[email protected]">email          
Tags:          Artificial Intelligence Careers Coding Data Science Machine Learning          
          

		  

		  Add Fav
		  
		  

		  
		  
		  
		  

	
	
	
	
	
	
	
	
	
	
	
	
	
	
	
	
	
	
	
	
	
	
	
	

         
         
         

         

         
Comment