你好，Chaos

Chaos是一个专为个人博客设计的极简Hugo主题：不依赖前端脚本框架，核心基础脚本经压缩后仅约2 KB（未压缩约6 KB），提供外观模式切换、自动目录、代码复制、即时页面导航以及针对中文排版的细致处理。

设计理念

主题配色源自日本传统色 和色（wairo））：以白練（shiro-neri）为底，以墨（sumi）为字，辅以红緋（hi-iro）与瑠璃色（ruri-iro）作为强调与链接色。兼顾素雅纸张质感与WCAG规定的色彩对比度要求。

💡 友情提示

点击右上角的🌓按钮，可以在「跟随系统/浅色/深色」三种模式之间切换。

基础配置

在站点的 hugo.toml 中，建议配置以下基础字段：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

theme = 'chaos'
baseURL = 'https://example.org/'
locale = 'zh-cn'
defaultContentLanguage = 'zh-cn'
title = '混沌札记'

# 必须启用：让Hugo按字符统计中文字数并正常截断摘要
hasCJKLanguage = true

[outputs]
  home = ['HTML', 'ATOM', 'sitemapxsl', 'RSS', 'feedxsl', 'REDIR']
  section = ['HTML']
  taxonomy = ['HTML']
  term = ['HTML']

[params]
  subtitle = '一个 *Chaos* 主题的示例站点'
  mainSections = ['posts']
  excludedTypes = ['page']

  [params.search]
    enable = true

主题特性指南

本系列文章分别介绍主题的各项功能与对应配置方法：

1. 中文排版：汉字、西文与标点的混排处理：中西文间距、标点悬挂、振假名与拼音注音、源码断行空格净化。
2. 提示框的语义类型与语法：NOTE、TIP、IMPORTANT、WARNING、CAUTION、HISTORICAL与DISCLAIMER，以及自定义标题支持。
3. 代码语法高亮、交互参数与Mermaid图表：静态语法高亮、可交互代码参数（code_vars）、代码一键复制与Mermaid图表。
4. 用KaTeX书写数学公式：行内与块级公式、Goldmark passthrough配置与洛伦兹方程组。
5. 文章元数据与内容控制：deprecated（过时降权）、searchHidden（隐藏检索）、noindex（避免收录）、series（系列）与标题锚点ID。
6. 全文检索与阅读交互：两层离线全文检索、快捷键、打印时外链自动转尾注与页面预渲染。
7. 少即是多：静态博客的依赖取舍：尽量不引入冗余外界依赖的工程取舍，以及各项特性在Gzip与Brotli下的真实尺寸对比。

• ← 文章元数据与内容控制
• 中文排版：汉字、西文与标点的混排处理 →