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 and Simple Icons 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/hugo-theme-m10c

Add this line in the config.toml file:

theme = "hugo-theme-m10c"

Configuration

In your config.toml file, define the following variables in params:

• author: Name of the author
• description: Short description of the author
• avatar: Path of file containing the author avatar image
• menu_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.

Icons

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...)

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.

Acknowledgements

• Feather - MIT
• Simple Icons - CC0 1.0