Hugo-based static blog theme released under the MIT license
hugo_eiio — Hugo Blog Template
By leonhe
hugo_eiio is a Hugo-based static blog theme that provides basic blogging features such as responsive layout, code highlighting, Emoji, Disqus comments, and post thumbnails, under the MIT license.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Responsive layout, adapting to both desktop and mobile
Supports code syntax highlighting, with highlight.js styles switchable via the hljsStyle parameter
Supports Emoji and Disqus comments
Supports setting thumbnails separately for the homepage post list and body content
Configuration items cover pagination, taxonomies, author social links, Google Analytics, and sitemap
Template Details
hugo_eiio is a Hugo static blog theme released by developer leonhe, with the repository open under the MIT license. The theme targets conventional personal blog scenarios, offering post lists and inner page displays, and supports setting thumbnails separately for the homepage list and the body content. The README lists features including responsive layout, code syntax highlighting, Emoji, Disqus comments, and post thumbnails, and provides a TOML configuration example covering site basic information, pagination, taxonomies, highlight.js styles, author social links, Google Analytics, and sitemap parameters. The theme is used by cloning it via git into the themes directory of a Hugo site and specifying theme = "hugo_eiio" in the configuration. The demo site is heyuanfei.com, and the repository also provides actual screenshots for desktop, mobile, and inner pages.
Is it right for your project?
Use Cases
- Building a personal blog with Hugo and needing post lists and inner page displays
- Blogs that want to use different thumbnails for the homepage list and body content
- Writing-oriented sites that need code highlighting, Emoji, and Disqus comments
- Configuring taxonomies such as categories and tags and browsing posts with pagination
Suitable For
- Personal bloggers building static sites with Hugo
- Developers who prefer the MIT license and freely modify theme code
- Users who need a responsive blog theme and accept TOML configuration
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
In the Hugo site directory, enter the themes folder and run git clone https://github.com/leonhe/hugo_eiio
- 2
Set theme = "hugo_eiio" in the site configuration, and fill in parameters such as baseurl, title, and languageCode according to the README example
- 3
Specify the homepage list thumbnail by setting header_images in the post front matter
- 4
Use the shortcode {{< figure class="floatright|floatleft" src="image path" alt="" >}} for thumbnails within the body content
- 5
External services such as Disqus and Google Analytics require you to provide the corresponding identifiers and are subject to their respective terms
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Using Disqus comments requires you to provide a Disqus shortname; comment data is hosted on Disqus and subject to its terms of service.
- Enabling Google Analytics requires you to provide a tracking code; data statistics are processed by Google services and subject to their terms.
- Site verification requires you to apply for and fill in the verification key provided by Google.
- Code highlighting styles depend on highlight.js CSS stylesheets, which you must include yourself or confirm their license.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; they cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
disqusShortname = "user id"
Original README
googleAnalytics='google analytics code'
Original README
googleSiteVerification = "google site verification key"
Original README
https://github.com/leonhe/hugo_eiio/blob/master/LICENSEhttps://github.com/leonhe/hugo_eiio/blob/master/README.mdhljsStyle="github" #code highlightjs css style
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 79 / 100
- Technologies
- Hugo
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-08-06
- Screenshot last checked
- 2026-10-02
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: c364589e5a752445b4d7fdbf6c9e34e10da4e0b3de79674eaff0421aaad70c7c
2026-10-02T10:15:48.757Z
Source file / repository# Hugo blog theme
This is a [hugo](https://gohugo.io/) static blog engine theme, if you like 😍 💗 this theme,please give me star🌟🌟 ~_~
## Features
- ✏️ Blog ️
- 🎩 Modern、Responsive
- 🅾️ Syntax highlight
- Emoji 😄 ,Disqus 🌐
- 🏙 🎇 🌆 Post thumbnail images
[See Demo](https://heyuanfei.com)
<!-- # Screenshot
!--  -->
# Installation
Inside the folder of your Hugo site run:
```
cd themes
git clone https://github.com/leonhe/hugo_eiio
```
# Config
Modify your configuration:
```
baseurl = "site url"
title = "Site Name"
languageCode = "site language code"
copyright = "Copyright right infomation."
themesdir = "themes"
theme = "hugo_eiio"
Paginate=15
MetaDataFormat = "toml"
PaginatePath="page"
pygmentsuseclasses = true
disqusShortname = "user id"
googleAnalytics='google analytics code'
hasCJKLanguage = true
preserveTaxonomyNames = false
disablePathToLower =false
enableEmoji = true
enableInlineShortcodes = true
enableRobotsTXT = true
[taxonomies]
category = "categories"
tag = "tags"
summaryLength = 250 # default 70
[params]
hljsStyle="github" #code highlightjs css style . See [Style List](https://github.com/highlightjs/highlight.js/tree/master/src/styles "CSS Style list")
showNextAndPrePost = false #Is Show Next and Previous Post Button
description = "site description"
keywords = "site keywords use seo"
googleSiteVerification = "google site verification key"
author = "your name"
github ="github username"
email="your email"
twitter="your twitter name"
securityPolicy = false #disable https content security policy
footerRight="Your tips content" #footer right content
mainSections = ['page']
[sitemap]
changefreq = "monthly"
priority = 0.5
filename = "sitemap.xml"
```
# Use post's thumbnail
## Home thumbnail of post:
if you need in home page list display thumbnail of post,write head of post keywords,see below code👇:
```
+++
title = "Post Title"
categories = ["Categories"]
tags = ["tags"]
date = "write datetime"
draft = false
header_images="post home list thumbnail"
+++
..............
```
## Content thumbnail of post:
if you need in post content to display different thumbnail,see below code 👇
```
{{< figure class="floatright|floatleft" src="your image path" alt="" >}}
```
# License
This theme is released under the [MIT License](https://github.com/leonhe/hugo_eiio/blob/master/LICENSE).
Explore similar templates
Compare previews and descriptions within the same stack and category.

hugo-PaperMod
A fast, clean, responsive Hugo theme for blogs and lightweight portfolios, with three layout modes (Regular, Home-Info, Profile), automatic and manual light/dark themes, Fuse.js client-side search, multilingual support, and built-in Open Graph, Twitter Cards, and Schema.org data.
Hugo · Portfolio

LoveIt
LoveIt is a clean, elegant, and feature-rich Hugo blog theme derived from LeaveIt and KeepIt, MIT-licensed. It offers light/dark modes, responsive layout, multilingual support, and search via Lunr.js or Algolia.
Hugo · Blog

hugo-coder
hugo-coder is a minimalist Hugo blog theme maintained by luizdepra under the MIT license. It provides a clean, text-focused blog appearance, configuration documentation in the docs directory, and a complete exampleSite with hugo.toml.
Hugo · Blog

blowfish
Blowfish is a Hugo personal website and blog theme built with Tailwind CSS 4, focused on lightness, simplicity, and content-first presentation.
Hugo · Blog

hugo-paper
hugo-paper is a simple, clean, and customizable Hugo blog theme configured through config.toml or hugo.toml.
Hugo · Blog

hextra
Hextra is a Hugo theme for documentation and blog sites, built on Hugo and Tailwind CSS with design referencing Nextra.
Hugo · Documentation
