HugoBlog

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.

1 previews
Author preview
Author-provided previewTop of page

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.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

01

A blog theme for Hugo, with the repository under the MIT license

02

Visuals and structure reference Laruence's blog

03

Provides exampleSite/config.toml example configuration

04

Sidebar widgets include about, QR code, open-source projects, friend links, categories, and tags

05

Comments use a GitHub-repository-based solution, toggleable in the configuration

06

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.

HugoBlog

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. 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. 2

    Copy the theme's example configuration: copy themes/period/exampleSite/config.toml config.toml

  3. 3

    Start a local preview with hugo server -t period

  4. 4

    Adjust the menu, sidebar widgets, comment toggle, and CDN URLs in config.toml as needed

  5. 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

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This 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

logo = "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQAl2chF0OuqvNKaMXWlh9GPn5vlHpSl0pXgQ&usqp=CAU"

Original README
https://github.com/idoubi/hugo-theme-period/blob/master/LICENSEhttps://github.com/idoubi/hugo-theme-period/blob/master/README.md

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 

![](./images/screenshot.png)



## Contributing

Any suggestions or pull request will be appreciated.
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.