Hugo Themes

Prev/Next: Hugo.386 Fuji All Themes

devise

A fast, minimal, responsive Hugo theme for blogs.

Author: Austin Gebauer
Minimum Hugo Version: 0.61.0
Updated: 2020-05-24
License: MIT
Tags: blog minimal personal simple clean

Download Demo Homepage

Devise

A fast, minimal, responsive Hugo theme for blogs.

For a live demo of the theme, see at:

Configuration Features

General
- Hugo’s Builtin Content Management Features
- Google Analytics
Header
- Title and Subtitle
- Image
- Navigation Menu
- Font Awesome Icons with Links
Main Body
- Last ‘N’ Recent Pages
- Categorical Page Grouping

Usage

This following guides installation, configuration, and updating of the Devise Hugo theme.

Installation

Before installing this theme, be sure to install Hugo and create a new site.

To install the theme, run the following from the root directory of your Hugo site:

$ git submodule add https://github.com/austingebauer/devise.git themes/devise

Configuration

Next, open the config.toml file in the root of your Hugo site and set the theme:

theme = "devise"

Example config.toml file with all configuration features filled out:

baseURL = "https://example.com"
title = "Your Website Title"
languageCode = "en-us"
theme = "devise"
relativeURLs = true
enableEmoji = true
googleAnalytics = ""
enableRobotsTXT = true
copyright = "&copy; Copyright Year, Your Name"

# Main menu items
[menu]
  [[menu.main]]
    identifier = "about"
    name = "About"
    title = "About"
    url = "/about/"
    weight = -110
  [[menu.main]]
    identifier = "posts"
    name = "Posts"
    title = "Posts"
    url = "/post/"
    weight = -100
  [[menu.main]]
    identifier = "categories"
    name = "Categories"
    title = "Categories"
    url = "/categories/"
    weight = -90

# Configuration Features
[params]
  header_title = "Your Name"                 # Your header title
  header_subtitle = "Your Creative Subtitle" # Your header subtitle
  home_image = "/images/avatar.png"          # Path to header image starting from the static directory
  recent_posts = 5                           # Max amount of recent posts to show
  mainSections = ["posts", "post", "blog"]   # Main sections to include in recent posts
  [[params.social]]
    fa_icon = "fab fa-github fa-1x"          # Font Awesome icon class
    href = "http://github.com/youruser"      # Link to associate with icon (http://, https://, mailto:)
  [[params.social]]
    fa_icon = "fab fa-linkedin-in fa-1x"
    href = ""
  [[params.social]]
    fa_icon = "fab fa-twitter fa-1x"
    href = ""
  [[params.social]]
    fa_icon = "fas fa-at fa-1x"
    href = ""

Updating

To get updates to the theme, run the following from the root directory of your Hugo site:

$ git submodule update --remote themes/devise

Demo

To run a live demo of the theme on your laptop, run the following from the exampleSite directory of the devise theme:

hugo server --themesDir ../.. --watch --verbose --cleanDestinationDir --disableFastRender