xuan

Modern, pretty, and clean theme

Author: jhq223

This theme requires Zola version 0.23.6 and above

License: MIT

Homepage: https://github.com/jhq223/xuan

Live Demo: https://xuan-theme.jhq223.workers.dev

Last updated: 2026-09-19T17:20:17+08:00

Xuan

Xuan 是一个基于 Duckquill 二次开发的现代化 Zola 博客主题。

它保留了原版简洁、美观的设计理念，并在其基础上进行了深度定制，优化了阅读体验并集成了更强大的搜索功能。

✨ 主要特性与修改

相较于原版 Duckquill，Xuan 做了以下改进：

• 🎨 视觉风格：
  • 修改了分割线样式。
  • 移除原版所有用于定制的 "mods" 样式。
• 🧩 调整：
  • 移除博客列表页的“按标签筛选”功能，界面更清爽。
  • 移除文章页移动端顶部的按钮列表，改为右下角悬浮操作按钮（返回顶部、主页等）。
  • 移除了 alert 和 vimeo 短代码。
• 🚀 功能增强：
  • 新增归档页面：按时间线查看所有文章。
  • 新增友情链接页面：方便展示友链。
  • 全新搜索体验：弃用原有搜索，改用 Pagefind 构建静态索引，搜索速度更快，支持中文分词，且无需前端加载大量 JS。

🛠️ 安装

需要 Zola 0.23.6 或更新版本。从旧版升级时，同步更新文章中的组件语法和站点自己的 i18n/：中文日期格式改为 y 年 MM 月 dd 日，英文改为 MMMM dd, y。

将此主题克隆到你的 Zola 站点的 themes 目录下：

git clone https://github.com/jhq223/xuan.git themes/xuan

然后在你的 zola.toml（旧项目也可以是 config.toml）中启用它：

theme = "xuan"

构建和检查：

zola build
zola check --skip-external-links

使用 Pagefind 搜索时，仍需在 Zola 构建后生成索引：

npx pagefind --site public

主题维护者可运行 python tests/smoke.py --zola /path/to/zola，检查多语言、组件、日期、分页、订阅、高亮和可选配置。

文章中的旧短代码改用组件，例如：

{{/* <image url="image.png" alt="图片" config={config} /> */}}
{{/* <video url="video.webm" controls={true} /> */}}
{{/* <youtube id="0Da8ZhKcNKQ" /> */}}

展示模板代码时，用 {%/* raw */%} / {%/* endraw */%} 包住示例。更多组件用法见主题的预览文章。

📄 许可证

本项目遵循 MIT License。 基于 Duckquill 开发。

由 daudix 原创设计，经过二次开发定制。