.. | ||
assets/css | ||
data/m10c | ||
exampleSite | ||
images | ||
layouts | ||
resources/_gen/assets/scss/css | ||
scripts | ||
static | ||
.editorconfig | ||
.gitignore | ||
LICENSE.md | ||
README.md | ||
theme.toml |
m10c theme
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 icons included
Getting started
Installation
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/m10c
Add this line in the config.toml
file:
theme = "m10c"
Configuration
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 = "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.
Styling
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.
License
This theme is released under the MIT License.