Hugo Themes
Strange Case
A 2 column blog theme for Hugo using Bootstrap - inspired by the Jekyll theme Hyde by mdo
- Author: ExchangeRate-API
- Minimum Hugo Version: 0.53
- GitHub Stars: 24
- Updated: 2021-03-04
- License: MIT
- Tags: Blog Bootstrap Minimal Responsive
Strange Case - Bootstrap Clone of Hyde for Hugo
Strange Case was built for people who like the original Jekyll theme Hyde and its port to Hugo but prefer to use Bootstrap.
The theme was built from an empty Bootstrap 3 template with the goal of easy modification for end users. The code is as simple as possible - clearly formatted HTML and a single stylesheet. It’s a two column responsive design and currently includes version 3.3.7 of Bootstrap.
Pull requests are welcome.
Contents
Installation
Installing Strange Case is easy. Simple clone this repo to themes/
in your Hugo folder.
~$ cd your-hugo-folder/themes/
~$ git clone https://github.com/ExchangeRate-API/strange-case.git
Next, open the config.toml
file in the base of the Hugo folder and ensure the theme is set to strange-case
.
theme = "strange-case"
Customization
There are various options you can easily set from your config.toml
file.
This text will appear after the Title of your site in your <title>
meta tag, and after the Title in the sidebar:
description = "A Hugo Theme built with Bootstrap"
Sidebar
This text will appear in a free paragraph below the Title & Description and above the menu links. Set it to "" if you don’t want it.
sidebarFreeText = "A optional paragraph of free text. Set to blank in config.toml to clear..."
You can include clickable icons (e.g. for social networks )by including "menu=icons"
items in your config.toml
. Example:
[[menu.icons]]
name = "GitHub"
post = "<img src=\"/images/github.png\""
url = "https://github.com"
You can optionally use the post
var to include HTML after the name
in the resulting links.
You can include useful menu links by including "menu=main"
items in your config.toml
. Example:
[[menu.main]]
name = "Hugo"
post = "<span class='glyphicon glyphicon-fire'></span>"
url = "http://gohugo.io"
You can optionally use the post
var to include HTML after the name
in the resulting links.
You can use the "contact_email"
field in [params]
to set a mailto: link the in the sidebar. Leave blank if you don’t want it.
Color Schemes
In keeping with our attempt to replicate the original Hyde in Bootstrap we’ve included some colour scheme options. These are not the same as in the original, but we used palettes from the same Base16 project.
The themes are:
- Dark Brown (
colorScheme="scheme-darkbrown"
) - Light Brown (
colorScheme="scheme-lightbrown"
) - Green (
colorScheme="scheme-green"
) - Orange (
colorScheme="scheme-orange"
) - Slate (
colorScheme="scheme-slate"
)
And then a bonus theme that isn’t from Base16:
- Gulf Racing (
colorScheme="scheme-gulfracing"
)
Using a theme is as simple as changing the colorScheme
param in your config.toml
. Example:
baseurl = "/blog"
title = "Strange Case Hugo Theme"
theme = "strange-case"
[params]
colorScheme = "scheme-darkbrown"
DateFormat = "2 Jan 2006"
description = "A Hugo Theme built with Bootstrap"
sidebarFreeText = "A optional paragraph of free text. Set to blank in config.toml to clear..."
Creating Your Own Color Scheme
To create your own custom color scheme simply scroll to the end of the strange-case.css
stylesheet in the your-hugo-dir/themes/strange-case/static
folder and edit the template we’ve left there.
We’ll happily accept pull requests for quality color schemes.
Analytics
This theme supports Hugo’s native GA integration & a Piwik integration.
For Google Analytics, simply set your UA number in your config.toml
file. Example:
baseurl = "/blog"
title = "Strange Case Hugo Theme"
theme = "strange-case"
googleAnalytics = "UA-123-456"
For Piwik, set the following two params
as below:
baseurl = "/blog"
title = "Strange Case Hugo Theme"
theme = "strange-case"
[params]
colorScheme = "scheme-darkbrown"
piwikSiteID = "1234"
piwikURL = "www.your-site.com"
Example Config
Here is a full example config.toml
:
baseurl = "http://www.your-blog.com"
title = "Your Blog Title"
author = "You"
copyright = "Your Copyright"
canonifyurls = true
paginate = 5
googleAnalytics = ""
theme = "strange-case"
[params]
colorScheme = "scheme-darkbrown"
DateFormat = "2 Jan 2006"
description = "A blog about content"
sidebarFreeText = "A optional paragraph of free text. Set to blank in config.toml to clear..."
piwikSiteID = ""
piwikURL = ""
[[menu.main]]
name = "Hugo"
post = "<span class='glyphicon glyphicon-fire'></span>"
url = "http://gohugo.io"
[[menu.main]]
name = "Bootstrap"
post = "<span class='glyphicon glyphicon-ok'></span>"
url = "http://getbootstrap.com"
Author
ExchangeRate-API.com
Strange Case Uses Bootstrap
Bootstrap
Inspired By
Mark Otto - creator of the Hyde Jekyll theme
Steve Francia - porter of the original Hyde theme to Hugo
Licensing
This theme is released under the MIT License.