如果你正在使用 Hugo 搭建个人博客，一定听说过 PaperMod —— 它是 Hugo 生态中最受欢迎的主题之一，GitHub 上拥有超过 15,000 个 Star。PaperMod 以简洁、快速、轻量著称，但它的设计偏向英文博客场景，对中文用户来说还有一些可以改进的空间。

PaperUI 正是在 PaperMod 的基础上，针对中文博客的实际需求进行深度定制的优化版本。它不是重新造轮子，而是站在巨人的肩膀上，让轮子滚得更顺畅。

PaperUI 的定位

PaperUI 保留了 PaperMod 的全部核心优势 —— 极快的构建速度、完善的 SEO 支持、响应式布局、深色/浅色模式切换 —— 同时增加了以下特性：

  • 首页轮播系统：支持 16:9 主轮播图 + 正方形卡片 + 竖版图片的三栏展示
  • 双栏布局：首页和内页均可启用侧边栏，展示分类、标签、搜索等小部件
  • 彩色标签系统：8 色循环配色，让标签和分类视觉更丰富
  • 搜索增强：首页侧边栏搜索框 + 搜索模态框 + Ctrl+K 快捷键
  • 移动端优化：汉堡菜单 + 侧滑导航，移动端自动隐藏侧边栏
  • 中文深度本地化：面包屑、页脚、存档格式等全部中文化
  • LLM 友好：内置 llms.txt 模板，方便 AI 搜索引擎索引

为什么叫 PaperUI？

Paper 代表它源自 PaperMod 的设计基因 —— 像纸张一样干净、纯粹；UI 则强调在用户界面和交互体验上的改进。两个词合在一起，表达了在保持简洁本质的同时，追求更好的用户界面体验。

技术栈

PaperUI 基于 Hugo v0.146.0+ 开发，前端使用纯 CSS 变量实现主题定制，JavaScript 仅用于必要的交互（搜索、轮播、主题切换），不引入任何第三方前端框架。构建后的页面体积极小，首屏加载速度飞快。

开源地址

你可以在 GitHub 上找到 PaperUI 的完整源代码：github.com/scenlinx/PaperUI

接下来的系列文章，我们将深入探讨 PaperMod 为什么好、PaperUI 做了哪些改进、以及如何快速上手使用。