Skip to content

mivinci/hugo-theme-minima

Repository files navigation

Minima

Minima is a clean and minimal Hugo theme originally ported from Hexo Minima. Check out the example site.

screenshot

Note that the main branch is in development phase, UI or configuration may vary.

Features

  • 🌗 Dark mode
  • 📚 Multilingual mode
  • 🏳️‍🌈 Code highlighting - VSCode dark+
  • 🔢 Math - KaTeX
  • 💹 Flowcharts - Mermaid
  • 🧑‍💻 Comment - Disqus, Utterances, Giscus
  • 🔎 Search - FuseJS
  • 〽️ Google analytics
  • 🔗 External link
  • ✉️ RSS

Usage

Before using Minima, make sure you've got Hugo (extended version) installed on your device.

Installation

You can use either git submodule or git clone to fetch this theme into the directory where Hugo places themes.

Git Submodule

git submodule add --depth 1 https://github.com/mivinci/hugo-theme-minima.git themes/minima

Git Clone

git clone https://github.com/mivinci/hugo-theme-minima.git themes/minima

Configuration

Follow exampleSite/config.yaml and edit your own one.

Supported Front Matters

Attr Type Explanation
title string title
description string description
date string creation time
categories array category list
series array series list
tags array tag list
math bool enables math plugin
diagram bool enables diagram plugin
comment bool enable comment plugin
draft bool disallow being published
link string a URL to redirect to

Contribution

I'm currently looking for i18n contributors :)

Feedback

Feedbacks are welcome here.

Star History

Star History Chart

License

Hugo Minima is MIT licensed.