Blogs are for reading and sharing. This theme tries to make both of those better.
min_night is built on top of Minimal, and keeps a lot of the cool original features:
It also gets a bunch of new add-ons:
- A night-mode toggle, with HTML5 storage to remember view preferences
- OpenGraph and TwitterCard meta tags for upgrading your social sharing
- Favicon support via the RealFaviconGenerator
- A site logo for index.html (headshot, hexsticker...its up to you)
- A tags/categories list page template from Xmin
- Updated tag labels to hyperlinks (categories too)
- Tweaked list templates for posts and projects
A live demo is available here.
Installing Hugo themes as submodules is best.
This is how you can get starting with
min_night using the QuickStart tutorial. Run each line individually.
hugo new site quick cd quick git init git submodule add https://github.com/nathancday/min_night.git themes/min_night cp -r themes/min_night/exampleSite/ . hugo server -D
Now your brand new site is being served locally at
Submodules are better because it makes updating the theme easier for future you.
$ git submodule update --remote themes/min_night
Personally I use this theme via the
blogdown, and you can too, like this:
library(blogdown) new_site(theme = "nathancday/min_night")
To configure most of the customizations in this theme all you need to do is edit the parameters in
[params] accent = "#006264" backgroundColor = "#f5f5f5"
accentchanges the color of the navbar and footer in day-mode and the color of the body background of your site in night-mode. Dark colors work best.
backgroundColorchanges the background color of the body. The default is light grey for easy eye reading.
Always use hex codes.
[params] font = "Mina"
This theme uses Google Fonts, so go nuts.
[params] highlight = true highlightStyle = "solarized-dark" highlightLanguages = ["r", "python", "bash"]
The theme supports syntax highlighting thanks to highlight.js, which is turned on by default. Checkout out the available palette options here. Note
highlightStyle param should be hyphen-separated lowercase.
Make sure your main languages render well and keep control on the languages that get special highlighted.
For best aesthetics with dark-mode, I reccommend choosing a light background style that matches your
This theme comes equipped with stock favicons modeled as hex stickers.
To update those, pick out an image and head over to RealFaviconGenerator. Go through their build process and append the path
/img/favicon/ at the last step when you download. Just unzip and drop all of the new files in
quick/static/img/favicon/. Now you have favicons for everything from tablets to tiles, that's tight.
The site logo defaults to using the 192x192 Android favicon but you can change the path for
logo param in
config.toml. This could be a headshot, another hex-sticker or something completely different, but if you want to change the image dimensions drastically, you may have to tweak
layouts/index.html directly to get a good result.
You must change
baseURL to your current domain for this feature to work properly.
baseURL = "your_domain.com"
The current set up has two TwitterCard/OpenGraph options depending on the params you specify in your post's front matter. If you add the param
twitter_img to a post, with the valid image path, then a summary card with large image will be shown. If you don't provide
twitter_img then a summary card with the site logo will be shown instead. For best scaling large image summary wants a 2:1 ratio image and regular summary wants 1:1. The post
exampleSite/creating-a-new-theme.md has been tweaked to include these new params, so you can template and test off of that.
The summary description will use the one provided in a post's front matter if it exists or use the generic site description from
config.toml. You should also adjust the
twitterSite params in
config.toml to point to your account. You can check how your cards are rendering once your website is being publish with the TwitterCard Validator.
This theme is something I have been working on for the last 6-months and feel like it is finally ready (enough) to share with the world. I'm sure there a wrinkles in some of it that I have yet to find.
If you get unexpected behavior post an issue and try to keep it as minimal as possible. Ideally bug reports would be reproducible using the QuickStart tutorial plus whatever changes cause the problem.
Pull requests are literally the best thing since ever, so if you have the idea (and the time) to add something to
min_night do it! I promise I will respond quickly.