archetypes | ||
layouts | ||
static/css | ||
.gitignore | ||
LICENSE | ||
README.md | ||
theme.toml |
KC
Personal blog theme powered by Hugo.
Inspired by Minimal
This theme is a fork of the theme "Minimal", created by Calin Tataru. A live demo is available here. Full source code is here
Installation
You can install the theme either as a clone or submodule.
I recommend the latter. From the root of your Hugo site, type the following:
$ git submodule add https://git.stdcall.me/kancer.club/theme.git themes/kc
$ git submodule init
$ git submodule update
Now you can get updates to KC in the future by updating the submodule:
$ git submodule update --remote themes/kc
Features
You can tweak the look of the theme to suit your needs in a number of ways:
-
The accent colour can be changed by using the
accent
field inconfig.toml
. -
You can also change the background colour by using
backgroundColor
. -
Add colored 5px borders at the top and bottom of pages by setting
showBorder
totrue
.
For best results, I recommend you use a dark accent colour with a light background, for example:
[params]
accent = "red"
showBorder = true
backgroundColor = "white"
Fonts
The theme uses Google Fonts to load its font. To change the font:
[params]
font = "Raleway" # should match the name on Google Fonts!
Syntax highlighting
The theme supports syntax highlighting thanks to highlight.js.
It's disabled by default, so you have to enable it by setting highlight
to true
in your config.
You can change the style used for the highlighting by using the highlightStyle
field.
Only the "common" languages will be loaded by default. To load more, use highlightLanguages
.
A list of all the available styles and languages can be found here.
Please note the style and languages should be written in hyphen-separated lowercase, for example:
[params]
highlight = true
highlightStyle = "solarized-dark"
highlightLanguages = ["go", "haskell", "kotlin", "scala", "swift"]