Qubt - Template

This is the theme template repository! Please follow the installation instructions below. If you're looking for the actual theme repository, follow this link.

Installation

1. Use this template by pressing Use this template. Don't fork this repository!
2. Wait 20s-30s and update the page. The files in your repo are getting populated.
3. Add a LICENSE to your repo.
4. Clone your version of the template to your local computer:

git clone https://github.com/<username>/<reponame>

5. Change the module name to match your github repo in go.mod.
6. Modify config/_default/hugo.yaml, config/_default/params.yaml and config/_default/menus.yaml according to the configuration below.
7. Add your blog posts to content/blog/. See example posts for reference.
8. Modify content/about.md so it matches your preferences.
9. All images are stored in the assets/ folder. You can group in subfolders if you like.
10. In a terminal/commandline window, move to the newly created folder using cd.
11. Build a local version of your site by executing hugo server. You can see the site by navigating to localhost:1313 (actual URL will be outputted in the CLI) in a browser.
12. Add a new icon.png file to update the favicon. The png file should be 512px by 512px in size.

---

Features

• Simple personal blog theme, designed for mobile-first.
• Automatic dark mode (based on system setttings).
• Emoji support for a fun design.
• Healthcheck endpoint (/healthcheck.json).

---

Configuration

All configuration is done in the four configuration files under config/_default/. The URL and site title can be set in hugo.yaml. The navbar settings are set in menus.yaml. All other parameters are set in params.yaml.

hugo.yaml:

baseURL: 'https://username.github.io/qubt'
title: 'Qubt Theme'

menus.yaml:

main:
- name: Home
  url: /
  weight: 10
- name: Blog
  url: /blog/
  weight: 20
- name: About
  url: /about/
  weight: 30

params.yaml:

############################
## Author
############################

author:
  name: "Qubt"
  image: author.jpeg
  greeting: "A personal blog theme for Hugo :evergreen_tree:"
  icon: ":wave:"

############################
## Links
############################

links:
  - github: https://github.com/username
  - facebook: https://facebook.com/me
 

###############################
## OpenGraph & Twitter Cards
###############################

title: "Qubt Theme"
description: "Demo site build with Qubt & Hugo"
images:
  - thumbnail.jpeg

Links are defined by the name (i.e. "github" or "facebook"). The names must match one of the supported link icons, see list below.

Supported Social Icons

Supported Icons	Supported Icons	Supported Icons	Supported Icons
amazon	apple	bandcamp	bitbucket
bluesky	check-mark	codepen	dev
discord	dribbble	email	etsy
facebook	flickr	foursquare	github
gitlab	google	instagram	keybase
kickstarter	link	linkedin	mastodon
medium	orcid	patreon	paypal
reddit	signal	skype	slack
snapchat	soundcloud	spotify	stack-exchange
stack-overflow	strava	telegram	tiktok
tumblr	twitch	untappd	website
whatsapp	windows	x-twitter	youtube

Custom Social Icons

Users can provide their own icons by placing a .svg image in ./assets/icons/ in their own repo. Creating folders when necessary. The image should be as circular as possible for the best result. Don't use spaces in the filename! Find all current icons here.

---

Update the Theme Version

This guide is left here for reference. Please check the template repo for the most up-to-date documentation.

The theme version used to build the site is defined in go.mod file.

The best practice is to update to released and tested versions. To update to a specific version execute the following command in a terminal/commandline (at the root path of your site repo):

  hugo mod get github.com/Chrede88/qubt@vX.Y.Z

Replace X,Y & Z with the corresponding version numbers. You can find the releases here. Please check if any breaking changes are listed under the release you want to update to, before proceeding.

---

Deploy on Github Pages

You can very easily deploy your site using Github Pages. Included in this template is a Github Action workflow that will build and deploy your site to Github Pages automatically:+1:

You can find the workflow here .github/deploymentWorkflow/buildDeploy.yml. To use this, move it to .github/workflows/.

The workflow is already set up and ready to go, but go through it and spend some time to understand what's going on. Otherwise, it'll always be this black box of magic that you can't fix when it breaks!

Last step: Go to Settings -> Pages -> Build and deployment -> Set the Source to "Github Actions".

Next time you publish a release this workflow will build and deploy your site 🎉

Your site will be published to the following URL: https://<username>.github.io/<repo>, where <username> and <repo> is your Github username and the name of your repository.