Welcome to Yore on Yore

Gallery Demo

Sat, 04 Jul 2026 22:37:00 +0800

Photo credit: , licensed under the . The original image can be found via its filename, e.g., white-lilac-spring-92509-flower-10261188.webp maps to .

Basic Centered Layout

Tue, 20 Jan 2026 11:30:00 +0800

This is the most basic centered layout.

H1

H2

H3

H4

H5

H6

Centered Layout with Sidebar TOC

Tue, 20 Jan 2026 11:30:00 +0800

This is the most basic centered layout, with the TOC (Table of Contents) set in the sidebar. This layout supports displaying the knowledge graph within the sidebar.

H1

H2

H3

H4

H5

H6

Two-Column Layout

Tue, 20 Jan 2026 11:30:00 +0800

This is a wide layout using blogLayout: 2-col. This layout is typically used together with placing the TOC in the sidebar.

H1

H2

H3

H4

H5

H6

Markdown Formatting Showcase

Tue, 20 Jan 2026 11:30:00 +0800

Markdown Formatting Showcase.

Rich Content & Media Layout Demo

Tue, 20 Jan 2026 11:30:00 +0800

Rich-content example with front matter

blogLayout: 2-col
pageTocStyle: sidebar
pageHeroStyle: background
pageFeatureImage: img/07.webp

Images

Basic Markdown Syntax

Masonry Shortcode

example of SVG image

example of external image

Carousel Shortcode

1 / 9

External link example

Tue, 20 Jan 2026 11:30:00 +0800

Preconfigured Setting

Thu, 15 Jan 2026 14:45:00 +0800

The preconfigured hugo.yaml provides an optimized site setup. Copy the and paste it into hugo.yaml, then follow the steps below based on your setup.

No further changes are required. This is the default setup assumed by the preconfigured hugo.yaml.

Content Type

Tue, 07 Jul 2026 00:00:00 +0800

Yore provides three content types: blog, docs, and gallery. Each type renders pages with a different set of templates and supports a different set of configuration fields. This guide shows you how to assign a type to your pages.

Fri, 30 Jan 2026 03:14:00 +0800

Hugo provides a built-in related article feature powered by an inverted index algorithm. This mechanism offers high performance, though its reliance on exact string matching requires specific taxonomy strategies to achieve optimal results.

Color Schemes

Wed, 21 Jan 2026 10:30:00 +0800

Yore ships with several built-in color schemes, selectable via themeColorScheme in hugo.yaml.

A color scheme is a CSS file that defines three groups of color tokens, --clr-neutral-*, --clr-brand-*, and --clr-accent-*, which serve as the foundation from which the entire theme derives its colors.

Writing

Sat, 17 Jan 2026 10:40:00 +0800

Admonition

Admonitions allow you to insert eye-catching callout boxes in your content.

[!TYPE] is a GitHub-flavored admonition. The [!TYPE]+/[!TYPE]- syntax controls whether the admonition is collapsible and its default state. This syntax is only supported in Obsidian.

Introduction

Thu, 15 Jan 2026 14:45:00 +0800

Yore is a simple yet feature-rich Hugo theme, designed specifically for content-heavy blogs, placing textual clarity first. Despite its simplicity, Yore offers multiple layouts, headers, and customization options.

Features

17:1 ultra high text contrast ratios, far exceeding WCAG-AA 4.5:1
Prioritizes information delivery
3 distinct header options
2 page hero styles
3-layered CSS structure for flexible styling
Semantic CSS layer for consistent visual customization
Multilingual support
Multi-version content support
Article series support
Keyboard navigation support
RTL support
Automated responsive image
Perfect Google Lighthouse scores on desktop and mobile
GDPR cookie consent banner
lightweight CSS framework
image galleries
interactive charts
LaTeX notation
site search
diagram
diagram zooming
and SVG icon set

Blog

Tue, 07 Jul 2026 00:00:00 +0800

All configurations on blog content type. The blog and docs content types share most of their page and section fields, so the documented below are separate into unique fields and common fields.

Markdown and Hugo

Tue, 20 Jan 2026 11:30:00 +0800

Semantic Markdown

In static site generation, Markdown is not merely a shorthand for text; it is a direct instruction for generating HTML. Hugo follows the specification via the Goldmark engine. Understanding the underlying HTML output is essential for precise layout control.

Media and Content Embeddings

Sat, 17 Jan 2026 10:40:00 +0800

Card

The card shortcode renders a general-purpose preview card with a title, description, optional image or icon, and metadata.

Parameter	Description
`title`	Required. Card heading text.
`href`	Optional. Link target for the whole card.
`desc`	Optional. Description text shown below the title. Supports HTML.
`image`	Optional. Thumbnail image URL. Falls back to a placeholder icon when omitted.
`icon`	Optional. Icon name shown inline before the title.
`metaText`	Optional. Metadata content shown below the description. Supports HTML.

Example

Feature Images

Thu, 15 Jan 2026 14:45:00 +0800

Feature images in Yore appear as hero banners, thumbnails, and social sharing metadata.

Automatic Detection

When using index.md inside a directory (creating a leaf bundle), Yore automatically detects images with the feature* prefix and uses them as the page's feature image.

Getting Started

Thu, 15 Jan 2026 14:45:00 +0800

Prerequisites

extended version, the minimum version is v0.164.0.
version manager.
(Optional) if you want to install Yore using Hugo module instead of Git submodule.

Installing Yore

This is the recommended method. Start by creating a new site:

Docs

Tue, 07 Jul 2026 00:00:00 +0800

All configurations on docs content type. The blog and docs content types share most of their page and section fields, so the documented below are separate into unique fields and common fields. These are theme parameters so the fields should goes under params key.

Authors

Sat, 18 Apr 2026 09:01:00 +0800

Authors are modeled as a . Each author has a dedicated content directory with a profile page, and posts reference authors by slug.

Configuration

Customization

Mon, 02 Feb 2026 16:55:00 +0800

Override Templates

Hugo provides a robust mechanism for template overriding. If the default layout or functionality of a specific theme component does not meet your requirements, you can override it by recreating the file at the equivalent path within your project's root directory.

Directory Structure and Assets

Fri, 30 Jan 2026 03:54:00 +0800

Understanding Hugo's directory structure is essential for managing content and assets effectively.

Directory Structure

Hugo projects follow a conventional layout. Each directory has a fixed role and Hugo will not look for files outside their expected locations.

Math

Sat, 17 Jan 2026 10:40:00 +0800

Render LaTeX math in pages using .

Configuration

Configure Goldmark to bypass math delimiters:

hugo.yaml
markup:
 goldmark:
 extensions:
 passthrough:
 enable: true
 delimiters:
 block:
 - ['\[', '\]']
 - ['$$', '$$']
 inline:
 - ['\(', '\)']

Passthrough skips Goldmark processing for matched content. Then enable math per page:

Gallery

Tue, 07 Jul 2026 00:00:00 +0800

The gallery content type is designed to be minimal. Pages render without a sidebar, table of contents, or related content by default. These are theme parameters so the fields should goes under params key.

Favicon

Fri, 30 Jan 2026 21:09:00 +0800

Favicons are icons that represent websites on browser tabs. This page explains how to provide favicon resources and how to customize them when the default formats are insufficient.

Setup

Place the following assets in the /assets/favicons directory.

Chart

Sat, 17 Jan 2026 10:40:00 +0800

Chart

chart uses the to embed charts into articles. It supports a vast range of .

Note

The chart shortcode places your code directly into a <script> tag. To ensure compatibility:

Series

Wed, 21 Jan 2026 08:52:00 +0800

The Series feature groups multiple articles published across different dates or sections into a named sequence.

Series is implemented as a taxonomy, which is why the front matter variable is defined as a list of strings.

Mermaid

Sat, 17 Jan 2026 10:40:00 +0800

Mermaid

mermaid allows you to draw detailed diagrams and visualisations using text. It uses Mermaid under the hood and supports a wide variety of diagrams, charts and other output formats.

Stale Content Warning

Wed, 22 Jul 2026 00:08:00 +0800

The stale content warning shows an admonition on an article when it has not been updated within a configurable number of days. The partial reads lastmod in front matter, and falls back to date.

Random Page

Wed, 22 Jul 2026 20:59:00 +0800

The random page lets readers discover a random article, giving older posts a chance to be seen again. Visiting this page picks a random page from the site and redirects the visitor to it, showing the chosen page's title with a typing animation before redirecting.

Hosting

Thu, 22 Jan 2026 16:30:00 +0800

Prerequisites

Before deploying, make sure your site builds locally with hugo without errors.

Deploy to GitHub Pages

GitHub Pages builds your site using GitHub Actions. The workflow installs Hugo, runs Pagefind, and publishes the result. Your repository must be hosted on GitHub.

Search

Thu, 22 Jan 2026 16:30:00 +0800

Built-in search is powered by , a static search library that serves results entirely in the browser with no external service needed.

Enabling search requires two steps: setting a config flag so Yore renders the search UI, and running Pagefind after every build to generate the search index. Both are required because the UI will not work without the index.

Page Actions

Sun, 19 Apr 2026 06:50:00 +0800

Page actions add a per-page dropdown menu with utilities for sharing and inspecting content.

Configuration

All keys go under params in hugo.yaml. pageShowActions can also be set per-page in front matter.

Backlinks

Thu, 22 Jan 2026 16:40:00 +0800

Yore embeds a backlink system based on to track and display bidirectional links.

Configuration

Add backlinks to outputs.home to generate the backlink index, and set pageShowBacklinks: true to display backlinks on pages:

Service Worker

Sat, 27 Jun 2026 00:00:00 +0800

The Service Worker intercepts network requests to serve cached assets as a fallback when offline, keeping the site accessible without a network connection.

The Service Worker is intentionally disabled in local development to prevent it from interfering with live page reloads and content updates.

Knowledge Graph

Sat, 02 May 2026 11:59:00 +0800

Knowledge Graph visualizes and taxonomy relationships between articles as an interactive graph. Yore supports with no additional HTML/CSS configuration.

Installation & Configuration

Pick one of these methods to set up.

Cookie Consent

Sat, 28 Mar 2026 18:00:00 +0800

Yore integrates for GDPR-compliant cookie management. Built-in categories are necessary, functional, analytics, and advertising.

Important

Google Ads related products are with vanilla-cookieconsent.
Most libraries exclude functional cookies from consent handling and . Yore follows the same behavior and does not manage them.
Provide a cookie settings entry accessible from all pages to meet GDPR requirements.

Configuration

Set enable: true and list the categories you want to expose to visitors.

Versioning

Fri, 17 Apr 2026 00:00:00 +0800

Versioning serves multiple doc versions. Each version maps to a content directory and gets its own URL prefix.

How It Works

Hugo builds one independent site per version declared in versions. Each site receives only the content directories that match its sites.matrix.versions constraint, controlled through Hugo's module mount system, which maps source directories to the content target at build time.

FAQ

Fri, 24 Jul 2026 22:25:00 +0800

VS Code Editor Snippets

Yore ships two VS Code snippet files that generate shortcode syntax from a short prefix, so you do not have to type parameter names from memory. To install, copy the files into your site's .vscode/ directory.

Reference - Icons

Thu, 15 Jan 2026 14:45:00 +0800

The icon shortcode and partial render inline SVG icons.

Usage

Use the shortcode in Markdown files, or the partial in layouts. Pass the icon name, or a path relative to assets/icons/. A bare name resolves to the first match, and a full path matches exactly. A bare name is sufficient in most cases.

External Link

Wed, 29 Jul 2026 14:29:00 +0800

Placeholder

Sat, 04 Jul 2026 22:37:00 +0800

This is a placeholder page.

Privacy & Cookie Policy

Sat, 18 Apr 2026 00:00:00 +0800

This site is a demonstration of the . It does not sell products, require registration, or run advertising.

Review or change your storage preferences at any time:

About

Thu, 15 Jan 2026 14:45:00 +0800

Yore is a minimalist Hugo theme built around content and reading flow.

Content-Centric Design

I spent a long time thinking about what design defines a content-centric blog. My answer is as follows:

Placeholder

Thu, 08 Jan 2026 22:37:00 +0800

This is a placeholder page.

Placeholder

Wed, 07 Jan 2026 22:37:00 +0800

This is a placeholder page.

Placeholder

Tue, 06 Jan 2026 22:37:00 +0800

This is a placeholder page.

Placeholder

Mon, 05 Jan 2026 22:37:00 +0800

This is a placeholder page.

Random

Mon, 01 Jan 0001 00:00:00 +0000

Welcome to Yore on Yore

Gallery Demo

Basic Centered Layout

H1

H2

H3

H4

H5

H6

Centered Layout with Sidebar TOC

H1

H2

H3

H4

H5

H6

Two-Column Layout

H1

H2

H3

H4

H5

H6

Markdown Formatting Showcase

Rich Content & Media Layout Demo

Images

Basic Markdown Syntax

Masonry Shortcode

Carousel Shortcode

External link example

Preconfigured Setting

Content Type

Related Article

Color Schemes

Writing

Admonition

Introduction

Features

Blog

Markdown and Hugo

Semantic Markdown

Media and Content Embeddings

Card

Feature Images

Automatic Detection

Getting Started

Prerequisites

Installing Yore

Docs

Authors

Configuration

Customization

Override Templates

Directory Structure and Assets

Directory Structure

Math

Configuration

Gallery

Favicon

Setup

Chart

Chart

Series

Mermaid

Mermaid

Stale Content Warning

Archive

Setup

Random Page

Hosting

Prerequisites

Deploy to GitHub Pages

Search

Page Actions

Configuration

Backlinks

Configuration

Service Worker

Knowledge Graph

Installation & Configuration