Fork of the blog theme I use for
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Holly McFarland 8f281384a6
Update theme attribution
2 months ago
archetypes Moved files in the right folder structure 4 years ago
exampleSite Fix invisible unicode error 7 months ago
images Update readme with mastodon social 10 months ago
layouts Update theme attribution 2 months ago
static Fix Deca's author page 2 months ago
LICENSE Changing license to MIT 4 years ago Update readme with mastodon social 10 months ago
theme.toml Cleaning stuff 4 years ago

Hugo Theme Prav



This theme began it's life in early 2013, as the theme for my blog "Thoughts on Engineering and Management". Back then it was generated using nanoc. In 2018, I moved to hugo because of it's ability to hot-reload the website while I was working.


I have always believed in using as little computing resources as possible. This theme uses the excellent purecss css library, which is tiny while still being quite functional.

The colours used have been chosen to be easy on the eyes, with just enough contrast to help with accessibility.

This theme is by no means complete. I have added to it over the last six years and will continue to do so. I hope you and the rest of the community will help in contributing to making this theme even better.


This is a two column theme with a navbar at the top and a sidebar to the right. The navbar contains links to major pages and links to social networks. The sidebar contains an about section, a section with the last 10 posts and finally a section which lists tags used across your site.

Beautiful tables and images through purecss

Beautiful tables

Syntax highlighting by pygments

Set your pygments theme by setting,

pygmentsCodeFences = "true"
pygmentsStyle = "perldoc"

Example highlighted code,

Example highlighted code

Update the about image

To update the image shown in the sidebar, simply create a file called "author.png" in the static/img/ folder. Alternatively, you can edit the path in config.toml file.

Feature images in archives

Setting the image parameter in the yaml header sets a feature image which is displayed in the articles section. Note that the feature images should be present in the static/img/feature/ folder. The frontmatter should contain something like,

image: path-to-image.jpg

If you want to add custom code to the header or footer, create a file called custom_header.html or custom_footer.html under layouts\partials folder in the root folder of your hugo project. The contents of these files will be included in the header and footer.

Comments by disqus

To enable comments, set your disqusShortname in config.toml. This will make comments appear on all single article pages. This bit of code is located at layouts/_default/single.html.


To enable a link to a social network in the header (top-right), enter the url. To disable it, just comment it out. This bit of code is located at layouts/partials/menu.html.

Social header


This is an example of the configuration file.

baseURL = ""
languageCode = "en-gb"
title = "Hugo Theme - Prav"
theme = "hugo-theme-prav"

pygmentsCodeFences = "true"
pygmentsStyle = "perldoc"

# If you want to track using GA or use disqus for comments, uncomment the 
# following and add the correct values
#googleanalytics = ""
#disqusShortname = ""

# The settings below are used throughout the theme.
# Please update!
  title = "Hugo Theme - Prav"
  tagline = "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
  author = "Pravin Paratey"
  authorImgPath = "/img/author.png"
  authorBlurb = "Something about me"

# If you do not want a social icon, just comment it out
# Please update the example values!
  email = ""
  facebook = ""
  twitter = ""
  medium = ""
  github = ""
  linkedin = ""
  mastodon = ""

# Set unsafe mode to allow markdownify to work with goldmark
# This is important. Please do not delete. It is used to re-render markdown
      unsafe = true

In closing

I hope you enjoy this theme as much as I have enjoyed building and using it over the last few years.