Awesome Open Source
Awesome Open Source

m10c theme

Intro

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 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 = "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.

Acknowledgements


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
html (10,855
hacktoberfest (4,195
theme (807
responsive (213
hugo (171
dark (44
minimalistic (19

Find Open Source By Browsing 7,000 Topics Across 59 Categories