文档 on Yore

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

Getting Started

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

Prerequisites

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

Installing Yore

Pick one of these three ways to set up the Yore theme on your new site.

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

A typical Hugo project follows this structure:

.
├── archetypes/ # Templates for new Markdown files
├── assets/ # Processed assets (images, CSS, JS)
├── content/ # Markdown files and page bundles
├── data/ # Custom configuration data
├── i18n/ # Translation files
├── layouts/ # Custom layout files
├── static/ # Raw static files (favicons, robots.txt)
├── themes/ # Theme files
└── hugo.yaml # Site configuration

This guide focuses on three key directories: assets/, static/, and content/, as these are the ones you'll work with most frequently.

Reference - Configuration

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

The preconfigured hugo.yaml.

Reference - Front matter

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

These parameters extend standard Hugo functionality and are categorized into global site parameters and page-level front matter.

Blog Config

Article Pages

Configurations of index.md.

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.