Skip to content
Minimal Hugo blog theme
HTML CSS JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data/css
gulpfile.babel.js
images
layouts
src/scss
static
.babelrc
.eslintrc.js
.gitignore
LICENSE.md
README.md
package-lock.json
package.json
theme.toml

README.md

Comfortable Basic

Comfortable Basic is a modern, simple Hugo theme. Intended for a blog like site.

View: Demo using hugoBasicExample

Screenshot

Features

  • Mobile friendly
  • Emphasis on readability
  • Lightweight(ish) see notes

Installation

Inside the folder of your Hugo site run:

$ cd themes
$ git clone https://github.com/freemagee/comfortable-basic

For more information read the official setup guide of Hugo.

Example HUGO site config toml

baseURL= "https://example.com"
languageCode= "en-gb"
title= "Example Site"
paginate = 3
theme = "comfortable-basic"
pluralizeListTitles = false
pygmentsUseClasses = true

[params]
  description = "This is a website!"
  metaDescription = "Used as 'description' meta tag for both home and index pages. If not set, 'description' will be used instead"
  author = "SOMEGUY"
  authorWebsite = "https://example.com"
  titleSeperator = "/"
  useHighlightJS = true

[taxonomies]
  category = "categories"
  tag = "tags"

Content Architecture Example

This theme is meant for a simple blog with posts and a about page. To get the most from it is recommended to structure your content folder like this:

+---content
    |   _index.md # This is the intro, it will appear at the
    |               top of the site on the homepage only
    |
    +---about
    |       _index.md # This is the about page content
    |
    \---post
            # all markdown posts

Simple as that.

Notes

Recently added some better code syntax highlighting. Hugo has really good built-in highlighting using Chroma. Ran into some formatting issues with some code and extra white space being added. So have added Highlightjs as an alternative. This unfortunately has bumped the theme file size up with the extra JavaScript, and some additional fonts. So that is why Comfortable Basic is lightweight(ish) at around > 300kb.

Performance update A flag has been added to the theme config useHighlightJS = true that can be set to false to disable Highlightjs and just use Hugo's default syntax highlighting. This can save about 90Kb.

TODO

  • Optional logo support
  • Add image type posts
  • Handle multiple pages
You can’t perform that action at this time.