A Hugo minimalistic theme for bloggers
Main features:
- Fully responsive
- Twitter Cards, Open Graph, Disqus and Google Analytics supported (see Hugo docs)
- Customizable colors
- Customizable picture and description
- Customizable menu on sidebar
- Customizable social media links on sidebar
- Optimized for performance 100/100 on Lighthouse
- All Feather and Simple Icons icons included
Create a new Hugo site:
$ hugo new site [path]
Clone this repository into themes/
directory:
$ cd [path]
$ git clone https://github.com/vaga/hugo-theme-m10c.git themes/hugo-theme-m10c
Add this line in the config.toml
file:
theme = "hugo-theme-m10c"
In your config.toml
file, define the following variables in params
:
author
: Name of the authordescription
: Short description of the authoravatar
: Path of file containing the author avatar imagemenu_item_separator
: Separator between each menu item. HTML allowed (default: " - ")favicon
: Absolute path of your favicon.ico file (default: "/favicon.ico")
To add a menu item, add the following lines in menu
:
[[menu.main]]
identifier = "tags"
name = "Tags"
url = "/tags/"
Read Hugo documentations for more informations about menu
To add a social link, add the following lines in params
:
[[params.social]]
icon = "brand-github"
name = "My Github"
url = "https://github.com/vaga"
To change theme colors, add the following lines in params
:
[params.style]
darkestColor = "#d35050"
darkColor = "#212121"
lightColor = "#f5e3e0"
lightestColor = "#f5f5f5"
primaryColor = "#ffffff"
If you want the above theme colors, you can see the exampleSite/config.toml file.
This theme uses two libraries for icons:
- Feather is used for application-related icons.
- Simple Icons is used for brand icons.
To differentiate brand icons from regular ones, the prefix brand-
is added
to all icons from the Simple Icons library. (e.g., brand-github, brand-x, brand-mastodon...)
To override styles using scss, add a file called _extra.scss
to [path]/assets/css/
Note: Hugo releases come in two versions, hugo
and hugo_extended
. You need hugo_extended
to automatically compile your scss.
This theme is released under the MIT License.