aruba8 / temple

A fast, minimal, responsive theme for Hugo

Temple

A Hugo theme focused on content, cleanliness, speed and responsiveness. The main goal of this theme is to be simple and fast.

This is a fork of nofancy with many improvements.

A live version of this theme can be found on my personal blog.

Table of Contents

• Features
• Getting Started
• Customizing
• Contributing
• License

Features

The main features of this theme include:

• Page load speed optimizations (scores 98/100 on PageSpeed)
• Syntax highlighting with chroma
• No JavaScript
• Multiple categories as navigation tabs
• Tags and categories have their own pages
• Footer with variable social links and RSS
• Google analytics enabled

Getting Started

If you have not already created a blog, I recommend you check out my getting started guide for a comprehensive overview. Otherwise, just download it or clone it into your themes/ directory:

$ cd themes && git clone https://github.com/aos/temple.git

Then reference it in your config:

theme = "temple"

Or when building the site, pass it in to the CLI:

$ hugo -t temple

Customizing

Your config file will hold all your options:

baseURL = "https://aos.github.io/"
title = "Your Blog Title"
theme = "temple"
# If not set, it will not appear. Otherwise it will show below your footer links
copyright = "(c) 2008 - 2014"

# Enables Chroma-based syntax highlighting with theme "friendly"
# See https://xyproto.github.io/splash/docs/ for other theme options
pygmentsStyle = "friendly"
# If true, Chroma will highlight GitHub-style code fences in addition to
# highlight shortcodes
pygmentsCodeFences = true

[params]
  # Enables the topmenu, which pulls from categories
  topmenu = "categories"

  # Enables custom date format (optional, the default is MM-DD-YYYY)
  # For reference to date and time templating, see:
  # https://gohugo.io/functions/format/#hugo-date-and-time-templating-reference
  dateformatpretty = "2006-01-02"

# Builds a list page for each category given
[taxonomies]
  tag = "tags"
  category = "categories"

[author]
  name = "Aos Dabbagh"
  github = "aos"
  email = "[e-mail]"
  gaid = "Your Google Analytics ID"
  twitter = "twitterID"
  medium = "mediumUsername"

There is also a fixed About page on the navbar. Create it using:

$ hugo new about

Contributing

Contributions are welcome.

Features:
If you are adding a feature, fork the repository, create a new branch for your feature and submit a PR. Please make sure to put documentation for your new feature:

• Place a small comment about what your feature is doing above the code.
• If making additions that will affect the config file, make sure you update the example config in README as well as the config.toml.

Issues/Bugs:
Submit a new issue with information about your issue and/or bug. If you have a solution, then submit a new PR with the guidelines posted above in the features section and link your issue to it using the keyword "closes".

License

Licensed under the MIT License. See the LICENSE.