Skip to content
This repository has been archived by the owner on Feb 28, 2023. It is now read-only.

RealOrangeOne/hugo-theme-utils

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hugo theme utils

CircleCI

Warning: This repo is currently a work in progress!

Requires Hugo >=0.42.

Utility shortcodes and partials for use in Hugo sites. Thanks to Theme Composition, themes can be merged. This repo houses many utility shortcodes and partials to reduce the amount of reuse and duplication in hugo sites.

This project is also partially in response to a thread on the forums about Hugo having too many internal shortcodes. Moving them out to here allows them to be released and updated separately to Hugo itself, and doesn't bloat the application any more.

Installation:

  1. Add this repo as a git submodule inside the themes/ directory of your site (Or just copy it in, but submodule is far easier to update), as a directory called utils, resulting in themes/utils/.
  2. Add utils to your theme configuration as the last entry in the list.

You may now use any shortcode or partial from here in your site, as if it were included in your sites shortcodes and partials.

Note: Make sure utils is added as the last entry to ensure your theme overrides any shortcodes used in the utils, to avoid any name clashes.