2025.03.28

02. Features

1. Main Image

You can set a main image on the homepage. Add the image URL in the [params] section of hugo.toml under mainImageUrl.

If you don’t want a main image, set showMainImage to false.

mainImageUrl = "https://i.imgur.com/URQWyyY.png"
showMainImage = true

2. GitHub Contribution Chart

You can also show your GitHub contribution graph on the homepage. Add your GitHub username to githubUsername in the [params] section of hugo.toml. Control visibility with showGithubChart.

githubUsername = "elecbrandy"
showGithubChart = true

3. Primary Color

By default, the primary color is set to freshpink. You can change it to any color you like in hugo.toml using a hex code.

primaryColor = "#fa8b84"

4. Featured Image in Posts

Each post can have a featured image. At the top of your .md file, add the following in TOML format. This will display the image above your post.

+++
title = '{{ replace .File.ContentBaseName "-" " " | title }}'
date = {{ .Date }}
featured_image = "/basic.png"
tags = ['tag1']
draft = true
+++

5. Tags

In the front matter of each .md file, you’ll see a tags = [] field. Use this to assign tags to your post.

tags = ['tag_a']

You can assign multiple tags ->

tags = ['tag_a', 'tag_c']

To browse posts by tag, create a Tags page:

1. Go to content/tags (create it if it doesn’t exist).
2. Inside, create a directory named after your tag (e.g., unix). This makes content/tags/unix and completes the setup.

6. Table of Contents (TOC)

The theme includes a TOC on the left side of the post. By default, it is transparent so it doesn’t distract while reading. When you hover over it, it becomes visible and clickable.

7. Back to Top Button

A “Back to Top” button is included with Vanilla Back to Top. It makes navigation easier by letting readers quickly return to the top of the page.