A blog theme for Hugo, with the repository under the MIT license
hugo-theme-period — Hugo Blog Template
By idoubi
hugo-theme-period is a blog theme for Hugo developed by idoubi, styled after Laruence's blog, released under the MIT license, with example configuration and a demo site.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Preview provided in the project README.
One original preview is available. Open the full image to inspect the design.
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Visuals and structure reference Laruence's blog
Provides exampleSite/config.toml example configuration
Sidebar widgets include about, QR code, open-source projects, friend links, categories, and tags
Comments use a GitHub-repository-based solution, toggleable in the configuration
Code highlighting uses highlight.js; jQuery and highlight.js are loaded via CDN
Template Details
hugo-theme-period is a blog theme for Hugo by idoubi, with the repository released under the MIT license. The theme's visuals and structure reference Laruence's blog; the author provides a demo site at idoubi.cc and screenshot previews in the repository.
The theme is configured via config.toml. The example configuration includes the site title, subtitle, logo, pagination count, main navigation menu, and sidebar widgets: about, QR code, open-source projects, friend links, categories, and tags. Comments use a GitHub-repository-based comment solution, which can be toggled in the configuration and has a selectable theme. Code highlighting relies on highlight.js; jQuery and highlight.js are loaded via CDN URLs, with bootcdn links used in the example.
To use it, clone the repository into the Hugo site's themes/period directory, copy exampleSite/config.toml as the site configuration, then start with hugo server -t period. The README does not state the theme's required Hugo version or list dependencies, so no specific version compatibility range is inferred here.
Is it right for your project?
Use Cases
- Building a personal blog with Hugo and wanting a theme styled after Laruence's blog
- A blog that needs to show about information, open-source projects, friend links, categories, and tags in the sidebar
- A site that wants comments hosted via a GitHub repository and toggleable in the configuration
- A Hugo site that needs highlight.js and jQuery loaded via CDN
Suitable For
- Developers building personal blogs with Hugo
- Users who prefer a clean blog layout and need sidebar widgets
- Site maintainers who accept comments hosted via a GitHub repository solution
- Hugo users able to configure config.toml and CDN resources themselves
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
From the Hugo site directory, clone the theme into themes/period: git clone https://github.com/idoubi/hugo-theme-period.git themes/period
- 2
Copy the theme's example configuration: copy themes/period/exampleSite/config.toml config.toml
- 3
Start a local preview with hugo server -t period
- 4
Adjust the menu, sidebar widgets, comment toggle, and CDN URLs in config.toml as needed
- 5
Third-party assets and external services must be checked against their own licenses and fees; the code's MIT license does not cover these
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in the public repository under the MIT license; the free scope is that version's code 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
- The comment feature relies on a GitHub-repository-based solution; you need to fill in {org}/{repo} in the configuration and it may depend on GitHub-related services; if not needed, keep show = false to disable it.
- The example configuration loads highlight.js and jQuery via external CDNs such as bootcdn; actual use requires you to confirm the availability and terms of these external services.
- The logo and QR code images in the example configuration point to external addresses; their asset licenses and availability must be checked separately, and the MIT code license does not cover these assets.
- 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 fees.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
[params.comment] repo = "{org}/{repo}" show = false theme = "github-light"
Original README
highlightjs = "https://cdn.bootcdn.net/ajax/libs/highlight.js/10.3.2/highlight.min.js"
Original README
https://github.com/idoubi/hugo-theme-period/blob/master/LICENSEhttps://github.com/idoubi/hugo-theme-period/blob/master/README.mdlogo = "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQAl2chF0OuqvNKaMXWlh9GPn5vlHpSl0pXgQ&usqp=CAU"
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
- Partly documented · 73 / 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
- 2025-03-10
- 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: 0afb00f0b0f52b758780c59c681c33f3d9a7002d918bcee0d8c73f28dad08b77
2026-10-02T10:18:09.477Z
Source file / repository## Period
[Period](https://github.com/idoubi/hugo-theme-period) is a beautiful theme for Hugo.
Reference from [Laruence's blog](https://www.laruence.com/)
view the [Demo Site](https://idoubi.cc)
## Usage
goto your hugo site
```shell
cd {path-to-your-hugo-site}
```
get the theme
```shell
git clone https://github.com/idoubi/hugo-theme-period.git themes/period
```
copy theme config file
```shell
copy themes/period/exampleSite/config.toml config.toml
```
run your hugo site
```shell
hugo server -t period
```
## Example Config
```toml
theme = "period"
baseURL = "https://example.com"
copyright = "© idoubi.cc All rights reserved"
paginate = 20
title = "Period Theme"
[[menu.main]]
name = "Home"
url = "/"
weight = 1
[[menu.main]]
name = "Posts"
url = "/post/"
weight = 2
[[menu.main]]
name = "Abount"
url = "/about/"
weight = 3
[params]
logo = "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQAl2chF0OuqvNKaMXWlh9GPn5vlHpSl0pXgQ&usqp=CAU"
subTitle = "A beautiful theme for Hugo."
[params.cdn.js]
highlightjs = "https://cdn.bootcdn.net/ajax/libs/highlight.js/10.3.2/highlight.min.js"
jquery = "https://cdn.bootcdn.net/ajax/libs/jquery/3.5.1/jquery.min.js"
[params.cdn.css]
highlightjs = "https://cdn.bootcdn.net/ajax/libs/highlight.js/10.3.2/styles/an-old-hope.min.css"
[params.comment]
repo = "{org}/{repo}"
show = false
theme = "github-light"
[params.widget.about]
description = "A fullstack developer"
logo = "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQAl2chF0OuqvNKaMXWlh9GPn5vlHpSl0pXgQ&usqp=CAU"
show = true
title = "Idoubi"
[params.widget.qrcode]
show = false
title = "WeChat Official Account"
url = "https://blogcdn.idoustudio.com/idoubi-mp.jpeg"
[params.widget.projects]
show = true
title = "Open Source Projects"
[[params.widget.projects.items]]
description = "Daily news for golang"
name = "gonews"
url = "https://github.com/idoubi/gonews"
[[params.widget.projects.items]]
description = "Generate go struct according to SQL"
name = "sql2struct"
url = "https://github.com/idoubi/sql2struct"
[[params.widget.projects.items]]
description = "Request library used in golang"
name = "goz"
url = "https://github.com/idoubi/goz"
[params.widget.links]
show = true
title = "Friendly Links"
[[params.widget.links.items]]
title = "Hugo"
url = "https://gohugo.io"
[[params.widget.links.items]]
title = "Theme period"
url = "https://github.com/idoubi/hugo-theme-period"
[params.widget.categories]
show = true
title = "Categories"
[params.widget.tags]
show = true
title = "Tags"
```
## Preview

## Contributing
Any suggestions or pull request will be appreciated.
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
