A Hugo theme for a personal portfolio with minimalist design and responsiveness.
Example Site: Toha Example Site
- Minimalist Design
- Fully Responsive
- Carefully designed cards
- Great Experience timeline
- Achievement gallery
- Sidebar to categorize posts
- Short Codes
- Google Analytics Support
- Disqus Comment Support
For more details about the features please visit here.
- Hugo Version 0.68.0 or higher
- Create your site if you haven't already
hugo new site my-site -f=yaml
cd my-site
git init
- Add the theme as git sub-module
git submodule add https://github.com/hossainemruz/toha.git themes/toha
Don't use SSH URL of the theme during adding as git sub-module. Also, don't clone the theme in your
themes
directory usinggit clone
. They don't work well with Github Action or Netlify.
If you want to customize the theme templates, then fork it and use the fork as your theme.
Configure your config.yaml
file of your site as below:
baseURL: http://example.org/
languageCode: en-us
title: "Toha"
theme: "toha"
# Allow raw html in markdown file
markup:
goldmark:
renderer:
unsafe: true
tableOfContents:
startLevel: 2
endLevel: 6
ordered: false
# Enable Google Analytics
googleAnalytics: UA-XXXXXXXXX-X
# Enable Disqus forum
disqusShortname: does-not-exist
# Enable global emoji support
enableEmoji: true
# Custom parameters
params:
# Copyright Notice
copyright: © 2020 Copyright.
# Meta description for your site. This will help the search engines to find your site.
description: Portfolio and personal blog of Jane Doe.
# background image of the landing page
background: "images/background.jpg"
# Provide logos for your site. The inverted logo will be used in the initial
# transparent navbar and the main logo will be used in the non-transparent navbar.
# It will be default to the theme logos if not provided.
logo:
main: /assets/images/main-logo.png
inverted: /assets/images/inverted-logo.png
# GitHub repo URL of your site
gitRepo: https://github.com/hossainemruz/toha-example-site
# specify whether you want to write blog post or not
enableBlogPost: true
# specify whether you want to show Table of Contents in reading page
enableTOC: true
# specify the list of custom menus that you want to show in the top navbar.
# they will be separated by a divider from the main menus.
customMenus:
- name: Notes
url: https://hossainnotes.netlify.app/docs/example/
# Provide newsletter configuration. This feature hasn't been implemented yet.
# Currently, you can just hide it from the footer.
newsletter:
enable: true
# some information about you
author:
name: "Jane Doe"
nickname: "Jane"
image: "images/avatar.png"
# give your some contact information. they will be used in the footer
contactInfo:
email: "janedoe@example.com"
phone: "+0123456789"
# a summary of what you do
summary:
- I am a Developer
- I work with Go
- I love to work with some fun projects
You can just copy the content for config.yaml
files from theme/toha/exampleSite/config.yaml
.
Run your hugo site with this theme.
hugo server -w
When you first run your site, it will start with the default parameters. It should look similar to the example site except it will not have any sections in the homepage. Those sections are added via some data files.
You can configure your site by following the step by step guides from here.
Here, are some handy shortcodes you can use with this theme.
Here, are the current plan and progress of various components of this theme. The components will be prioritized based on users requests.
-
Home
- Configurable Background
- Author Image
- Greeting
- Typing Carousel
-
About
- Name and Designation
- Summary
- Markdown Support
- Social Links
- Font Awesome Support
- Resume Link
- Soft Skills Indicator
-
Skills
- Skill Cards
- Markdown Support
-
Experiences
- Designation
- Timeline
- Company Overview
- Responsibilities
-
Projects
- Category Filter
- Project Card
- Overview
- Markdown Support
- Github Stars
- External URL Support
- Technology Tags
- Overview
-
Recent Posts
-
Publications
- Category Filter
- Card
- Abstract
- Authors
- Tags
- Links
- Gallery
-
Accomplishment / Courses
- Overview
- Certificate
-
Achievements Gallery
- Image
- Summary
- Post Cards
- Sidebar
- Pagination
- Hero Image
- Author Information
- Next & Previous Page Navigation
-
Improve This Page
Button - Disqus Comment
- Option to navigate to list page
- Google Analytics
- Disqus Comment
- Image
- Split Page into Multiple Column
- Vertical space between two sections
- Alert
- Figure & sub-figure
- Tabs
You can contribute to this theme in various way. You can report a bug, file an feature request, send a PR, share your thoughts etc.
Pull requests are most welcomed and I will be happy to review. Just follow the following principles:
- Keep it simple.
- Keep it consistent with the design.
- Use as little dependency as possible.
- Have patient.
I am not a web developer. I just created this theme for my personal needs. So, it is reasonable to have some flaws in the codes. Feel free to open issues and PR acknowledging the problems.