HugoHexoStarter

hugo-theme-diary — Hugo Starter Template

By AmazingRise

A diary-style theme ported from the Hexo theme Journal to Hugo, supporting multiple languages, dark mode, table-of-contents scroll positioning, and various third-party comment services.

Open Source Site Download Source ZIP

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

1 previews

Author preview

View sourceOpens in a new tab

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.

A Hugo diary/essay-style theme ported from the Hexo theme Journal

Supports English, Simplified Chinese, Traditional Chinese, French, German, and Brazilian Portuguese

Built-in dark mode, switchable automatically or manually

Table of contents with scroll positioning for easier reading of long articles

Can integrate comment services such as Gitalk, LiveRe, Disqus, Waline, and Twikoo

LaTeX support is disabled by default and can be enabled according to the wiki instructions

Template Details

hugo-theme-diary is a Hugo theme maintained by AmazingRise, ported from SumiMakito's Hexo theme Journal, with the repository under the MIT license. The theme is positioned as a blog appearance for recording daily fragments, arranging posts in a grid on the homepage, suitable for essays and diary-style content.

In terms of features, the theme provides a configurable sidebar, favicon, table of contents (with scroll positioning), reading time, code highlighting, and adjustments to fonts and color schemes; it includes dark mode, which can be switched automatically or manually; and it supports English, Simplified Chinese, Traditional Chinese, French, German, and Brazilian Portuguese. Third-party service integrations include comment systems such as Gitalk, LiveRe, Disqus, Waline, and Twikoo, as well as Google Analytics, Google site verification, and an on-site Google search box. LaTeX support is disabled by default and must be enabled according to the wiki instructions.

Usage is as a Hugo theme, which can be added to the site's themes/diary directory via git submodule, and the repository's exampleSite provides a sample config.toml. The theme documentation is primarily in the project wiki, covering i18n, sidebar, table of contents, comments, metadata, RSS, image insertion, color schemes, fonts, reading time, dark mode, and troubleshooting.

Limitations and notes: the materials do not list the required Hugo version, so compatibility must be checked independently before use; version 1.3.0 removed redundant scripts such as jQuery. The licenses for third-party assets such as demo images, fonts, and icons must be confirmed separately and cannot be judged solely by the code's MIT license.

HugoHexoLauncher

Is it right for your project?

Use Cases

Building a personal blog focused on diaries, essays, and short records
A Hugo site that needs a multilingual interface and targets Chinese readers
A reading-oriented blog that wants dark mode and table-of-contents scroll positioning
A static site that needs to integrate third-party comment systems or Google Analytics

Suitable For

Individual authors building static blogs with Hugo
Users who prefer a diary/essay layout style over a magazine-style homepage
Site maintainers who need multilingual and comment integration capabilities
Developers willing to configure the theme themselves via the project wiki

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

1
Run git submodule add https://github.com/AmazingRise/hugo-theme-diary.git themes/diary in the Hugo site root to add the theme
2
Use git submodule update --remote --merge to update the theme repository
3
Refer to the repository's exampleSite/config.toml for configuration
4
Run hugo server --themesDir ../.. in the themes/diary/exampleSite directory to preview the example site
5
See the project wiki for detailed configuration items (i18n, sidebar, comments, LaTeX, dark mode, etc.)

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This 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 that 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 complete 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

Features such as comments, search, and analytics depend on third-party services, requiring you to register accounts and configure the respective services, which may incur external service fees or data transmission.
LaTeX support is disabled by default and must be manually enabled according to the wiki instructions before mathematical formula rendering can be used.
Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and 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

3rd. service intergration (Gitalk, LiveRe, Disqus, Waline, Twikoo, Google Search, Analytics... )
Original README

LaTeX support (disabled by default)
Original README

https://github.com/AmazingRise/hugo-theme-diary/blob/main/LICENSE https://github.com/AmazingRise/hugo-theme-diary/blob/main/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: Hugo Themes
Documentation and maintenance reference score: More documented · 84 / 100
Technologies: Hugo · Hexo
Website type: Starter

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-01-30
Screenshot last checked: 2026-10-02

No demo link is recorded. Use the repository instructions to evaluate the project locally; the screenshot alone cannot establish interactive behavior.

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: 8e2684fb4bd04f31c0af9382d3274b8aeac7f1c2bcedf03920f453762686eb92

2026-10-02T14:07:53.243Z

Source file / repository

# <div align="center">Hugo Theme Diary</div>

<div align="center">

![](https://img.shields.io/badge/license-MIT-blue.svg)
![](https://img.shields.io/badge/version-1.3.0-brightgreen)

[My Blog with ✨Theme Diary✨](https://risehere.net/) -
[Intro Video](https://www.bilibili.com/video/av84273002) -
[Progress](https://github.com/AmazingRise/hugo-theme-diary/projects/) -
[Wiki](https://github.com/amazingrise/hugo-theme-diary/wiki)

隻言片語・於此匯聚

Moments piled up.

</div>

A Hugo theme ported from [SumiMakito/hexo-theme-Journal](https://github.com/SumiMakito/hexo-theme-Journal/).

## Features

### Features of this theme

- Customizable: Easy to customize with detailed project wiki.
- Adaptive: Mobile-friendly & widescreen-friendly.
- Abundant: 3rd. service intergration (Gitalk, LiveRe, Disqus, Waline, Twikoo, Google Search, Analytics... ).
- Convenient: Table of Contents with scroll spy.
- Professional: LaTeX support (disabled by default).
- Graceful: Dark mode (automatic or manual switch).
- International: English, Chinese (CHS/CHT), French, German, Portuguese(Brazil) support.
- ...

For details, please visit [project wiki](https://github.com/AmazingRise/hugo-theme-diary/wiki/).

### Features in new version

<details>
<summary>CHANGELOG</summary>

1.3.0:

- Removed jQuery and other redundant scripts.
- Some improvements on performance.

</details>

## Quick Start

<details>
<summary>Click to expand</summary>

If your website is using Git as version control, please do as follows:

1. Fetch the theme dir.

From the root of your Hugo site, open the terminal and execute:
```bash
git submodule add https://github.com/AmazingRise/hugo-theme-diary.git themes/diary
```
2. Update git repository.

Then update the git repository from the root of your site:
```bash
git submodule update --remote --merge
```

3. Run example site.

From the root of themes/diary/exampleSite:
```bash
hugo server --themesDir ../..
```

</details>

## Personalization

### Example config

See [/exampleSite/config.toml](https://github.com/AmazingRise/hugo-theme-diary/blob/main/exampleSite/config.toml)

### Customization

- [Wiki Home](https://github.com/AmazingRise/hugo-theme-diary/wiki)
- Configurations
  * [Internationalization(i18n)](https://github.com/AmazingRise/hugo-theme-diary/wiki/Internationalization)
  * [Sidebar](https://github.com/AmazingRise/hugo-theme-diary/wiki/Customization#customize-sidebar)
  * [Favicon](https://github.com/AmazingRise/hugo-theme-diary/wiki/Customization#add-favicon)
  * [Table Of Contents](https://github.com/AmazingRise/hugo-theme-diary/wiki/Table-Of-Contents)
  * [Enable/Disable Comment](https://github.com/AmazingRise/hugo-theme-diary/wiki/Comment-Area)
- 3rd. party services
  * [Comment Services](https://github.com/AmazingRise/hugo-theme-diary/wiki/Comment)
  * [Google Analytics](https://github.com/AmazingRise/hugo-theme-diary/wiki/Customization#add-google-analytics)
  * [Google Site Verification](https://github.com/AmazingRise/hugo-theme-diary/wiki/Customization#add-google-site-verification)
  * [Google Search Intergration](https://github.com/AmazingRise/hugo-theme-diary/wiki/Customization#add-google-search-box-on-your-site)
- Writing
  * [Meta Data](https://github.com/AmazingRise/hugo-theme-diary/wiki/Post's-meta-data)
  * [LaTeX Support](https://github.com/AmazingRise/hugo-theme-diary/wiki/MathJax)
  * [RSS Feed](https://github.com/AmazingRise/hugo-theme-diary/wiki/RSS-Feed)
  * [Inserting Figures](https://github.com/AmazingRise/hugo-theme-diary/wiki/Inserting-Figures)
- Styling
  * [Color Scheme](https://github.com/AmazingRise/hugo-theme-diary/wiki/Customization#change-color-scheme)
  * [Code Highlight](https://github.com/AmazingRise/hugo-theme-diary/wiki/Customization#about-highlight)
  * [Font Family](https://github.com/AmazingRise/hugo-theme-diary/wiki/Customization#change-default-font-scheme)
  * [Reading Time](https://github.com/AmazingRise/hugo-theme-diary/wiki/Reading-Time)
  * [Dark Mode](https://github.com/AmazingRise/hugo-theme-diary/wiki/Dark-Mode)
- [Troubleshooting](https://github.com/AmazingRise/hugo-theme-diary/wiki/Troubleshooting)


## Screenshots

<details>
<summary>Index Page</summary>

![](images/main.png)

</details>

<details>
<summary>Post</summary>

![](images/essay.png)

![](images/essay2.png)

</details>

<details>
<summary>Dark Mode</summary>

![](images/dark.png)

</details>

<details>
<summary>Mobile View</summary>

![](images/m_main.png)

![](images/m_drawer.png)

</details>



</details>

Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

hugo-xmin

hugo-xmin is an extremely minimal Hugo theme written by Yihui Xie for template beginners. HTML and CSS total about 140 lines, with no external dependencies, and it uses the MIT license.

Hugo · Starter

hugo-theme-gallery

A Hugo Extended photo gallery theme that organizes images with Page Bundles, automatically generating album lists and gallery pages with a Justified layout and PhotoSwipe lightbox.

Hugo · Starter

reveal-hugo

reveal-hugo is a Hugo theme that converts Markdown content into Reveal.js-based HTML presentations. It supports slide separation with `---`, shortcodes for fragments, slides, sections, notes, Markdown, and MathJax, and organizes content as root or section presentations with order controlled by weight.

Hugo · Starter

anatole

Anatole is a minimalistic two-column Hugo theme ported from farbox-theme-Anatole, featuring dark mode, multilingual and RTL support, and optional portfolio, comments, analytics, KaTeX, and Mermaid integrations. It suits personal blogs, portfolios, or documentation sites built with Hugo.

Hugo · Starter

risotto

risotto is a minimalist, responsive Hugo theme inspired by terminal ricing aesthetics. It uses semantic HTML and pure CSS with no JavaScript, and its layout relies on CSS Grid for native responsiveness without manual breakpoints.

Hugo · Starter

hugo-theme-stack-starter

A Hugo blog quickstart template that loads hugo-theme-stack through Hugo Modules, with configuration centralized in the config directory and GitHub Actions preconfigured for automatic deployment to GitHub Pages.

Hugo · Blog