HugoBlogDocumentation

hugo-yore — Hugo Blog Template

By ZhenShuo2021

Yore is a minimalist Hugo theme centered on reading, supporting blog, documentation, and gallery layouts, with features including multilingual support, multi-version content, article series, RTL, and accessibility.

Explore the design

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

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-03View source

What stands out

A quick read of the recorded project description.

01

Minimalist design centered on reading, emphasizing information delivery first

02

Supports three content layouts: blog, documentation, and gallery

03

Provides multilingual support, multi-version content, and article series

04

Built-in Pagefind search, MathJax formulas, Mermaid diagrams, and ECharts charts

05

Integrates PhotoSwipe image galleries and SVG Toolbelt chart zooming

06

Includes RTL, accessibility support, and a GDPR cookie consent banner

Template Details

Yore is a Hugo theme hosted on GitHub, authored by ZhenShuo2021, and licensed under MIT. The theme is positioned as a minimalist style centered on reading, emphasizing information delivery first, with the repository description and README both built around this goal.

In terms of content organization, the theme supports three layouts: blog, documentation, and gallery, and includes multilingual support, multi-version content, and article series, covering content sites that require long-term maintenance or versioned releases. For styling, it offers 3 header options, 2 page hero styles, and a three-layer CSS structure, making it easy to adjust the visual presentation as needed.

For feature integration, the theme incorporates TailwindCSS as the styling framework and integrates PhotoSwipe image galleries, ECharts interactive charts, MathJax formulas, Mermaid diagrams, Pagefind site search, SVG Toolbelt chart zooming, and the iconoir and fontawesome icon sets. It also includes responsive image automation, a GDPR cookie consent banner, RTL, and accessibility support.

Installation involves adding the repository as a git submodule to the themes directory of a Hugo site and declaring the theme in hugo.yaml; the README recommends starting with its preconfigured hugo.yaml. Mentions in the README of high contrast, Lighthouse scores, etc., are the author's own statements and were not independently verified in this material.

HugoBlogDocumentation

Is it right for your project?

Use Cases

  • Building a personal blog focused on long-form reading
  • Establishing a documentation site that requires versioned maintenance
  • Creating illustrated content pages with image galleries and charts
  • Publishing content for multilingual readers

Suitable For

  • Developers building static sites with Hugo
  • Content sites needing a mix of blog and documentation layouts
  • Sites that value reading experience and accessibility
  • Projects requiring multilingual or multi-version content organization

Getting started & customization

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

  1. 1

    On Windows, use PowerShell instead of CMD to run installation commands

  2. 2

    Add the theme to the themes/hugo-yore directory via git submodule

  3. 3

    Declare the theme in hugo.yaml with theme: hugo-yore

  4. 4

    The README recommends starting the project with the author's preconfigured hugo.yaml

  5. 5

    Third-party assets such as demo images, fonts, and icons must be checked separately under their respective licenses

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 applies to that version's code and does not imply 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 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

  • Demo images, fonts, icons, and other third-party assets must be checked under 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

Compiled by DeepSeek based on repository license and README ·2026-10-03. 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 · 85 / 100
Technologies
Hugo
Website type
Blog · Documentation
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-10-02
Screenshot last checked
2026-10-03

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: e55b4072409e4a7143ac56d09a925657ba55b023243b8dfb8710c4ea37793f73

2026-10-03T00:53:56.824Z

Source file / repository
## Yore

Yore is a minimalist Hugo theme focused on reading. See [demo site](https://yore.zsl0621.cc/) here.

## Features

- 17:1 ultra high text contrast ratios, far exceeding WCAG-AA 4.5:1
- 3 distinct header options
- 2 page hero styles
- 3-layered CSS structure for flexible styling
- Prioritizes information delivery
- Blog, documentation, and gallery layout support
- Multilingual support
- Multi-version content support
- Article series support
- Accessibility support
- RTL support
- Automated responsive image
- Perfect Google Lighthouse scores on desktop and mobile
- GDPR cookie consent banner
- Semantic CSS layer for consistent visual customization
- [TailwindCSS v4](https://tailwindcss.com/) lightweight CSS framework
- [PhotoSwipe](https://photoswipe.com/) image galleries
- [ECharts](https://echarts.apache.org/) interactive charts
- [MathJax](https://www.mathjax.org/) LaTeX notation
- [Pagefind](https://pagefind.app/) site search
- [Mermaid](https://mermaid.ai/open-source/) diagram
- [SVG Toolbelt](https://github.com/zakariaf/svg-toolbelt) diagram zooming
- [iconoir](https://iconoir.com/) and [fontawesome](https://fontawesome.com/icons/packs/brands) SVG icon set

## Installation

> [!NOTE]
> On Windows, use PowerShell instead of CMD.

Create a new site if you haven't already:

```sh
hugo new site my-site --format yaml
cd my-site
```

Install Yore:

```sh
git init
git submodule add https://github.com/ZhenShuo2021/hugo-yore themes/hugo-yore
echo "theme: hugo-yore" >> hugo.yaml
```

Create contents:

```sh
hugo new content/blog/_index.md
hugo new content/blog/first/index.md
hugo new content/blog/second/index.md
```

Start development:

```sh
hugo server -D
```

It's recommended to start your project with our preconfigured [hugo.yaml](https://yore.zsl0621.cc/docs/configuration/preconfigured-setting/).
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.