76 lines
2.1 KiB
Markdown
76 lines
2.1 KiB
Markdown
# KC
|
|
|
|
Personal blog theme powered by [Hugo](https://gohugo.io).
|
|
|
|
## Inspired by Minimal
|
|
|
|
This theme is a fork of the theme "Minimal", created by Calin Tataru.
|
|
A live demo is available [here](https://themes.gohugo.io/theme/minimal/).
|
|
Full source code is [here](https://github.com/calintat/minimal)
|
|
|
|
## 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 in `config.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` to `true`.
|
|
|
|
For best results, I recommend you use a dark accent colour with a light background, for example:
|
|
|
|
```toml
|
|
[params]
|
|
accent = "red"
|
|
showBorder = true
|
|
backgroundColor = "white"
|
|
```
|
|
|
|
### Fonts
|
|
|
|
The theme uses [Google Fonts](https://fonts.google.com) to load its font. To change the font:
|
|
|
|
```toml
|
|
[params]
|
|
font = "Raleway" # should match the name on Google Fonts!
|
|
```
|
|
|
|
### Syntax highlighting
|
|
|
|
The theme supports syntax highlighting thanks to [highlight.js](https://highlightjs.org).
|
|
|
|
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](https://highlightjs.org/static/demo/).
|
|
|
|
Please note the style and languages should be written in hyphen-separated lowercase, for example:
|
|
|
|
```toml
|
|
[params]
|
|
highlight = true
|
|
highlightStyle = "solarized-dark"
|
|
highlightLanguages = ["go", "haskell", "kotlin", "scala", "swift"]
|
|
```
|