zola博客

zola-theme-jiaxiang.wang-one

目录

[[toc]]

[toc]

王大佬的zola主题如何支持如Teek一样的文档库

背景

作者开了个issue

https://github.com/iWangJiaxiang/zola-theme-jiaxiang.wang/discussions/14

我的回复：

具体文章：

https://onedayxyy.cn/blog/ideal-blog

v1

v2

v3

技术上好加，需要时间设计

版权

此《zola-theme-jiaxiang.wang-one》项目是在《王嘉祥》大佬开源的《zola-theme-jiaxiang.wang》项目基础之上修改为自己的个人信息，感谢大佬开发的优秀主题，大佬威武，这里仅记录下个人日常使用次主题的一些信息，关于项目具体信息，可访问其官网，多谢。❤️❤️❤️

zola-theme-jiaxiang.wang 是一款适用于 Zola 的博客主题。

本主题由 王嘉祥 移植自 Halo 主题 Halo-Theme-Hao，Halo-Theme-Hao 主题移植自 Hexo 社区中 张洪 Heo 对 Hexo-Theme-Butterfly 主题的魔改与重设计版本。

背景

为什么会选择rust语言开发的ssg呢？

来自一次teek群聊里偶然的闲谈……🤣（来自W3C大佬的话题讨论）

请看下文：

rust pk hugo

问题：hugo和rust哪个写的静态站点构建器速度更快？

2025年8月21日提问。

回答：

在静态站点生成器（SSG）的性能对比中，Rust 编写的工具（如 Zola、Hugo 的替代品）通常比 Hugo（基于 Go）更快，但具体差异取决于使用场景和优化策略。以下是关键对比分析：

1. 语言层面的性能

实测数据（以构建含 10,000 页面的站点为例）：

• Rust (Zola): 1.2~2.5 秒
• Hugo: 3~6 秒
• （注：结果因硬件和内容复杂度而异）

2. 实际场景差异

📌Hugo 的优势

• 开发体验：
  • 热重载（LiveReload）更成熟，适合快速迭代
  • 主题生态丰富（3000+ 主题）
• 适用场景：
  • 中小型博客/文档站（构建速度已足够快）
  • 需要快速上手或复杂主题定制

📌Rust 工具的优势

• 极限性能：
  • 超大规模站点（如 >10 万页面）优势明显
  • 并行处理能力更强（Rust 的 rayon 库优化）
• 资源占用：
  • 内存更低（无 GC，避免突发占用）

3. 代表性工具对比

4. 如何选择？

• 选 Hugo 如果：

  • 你需要现成主题或插件
  • 开发速度比构建速度更重要
  • 项目规模在万级页面以内

• 选 Rust 工具如果：

  • 你需要处理海量内容（如文档站、电商目录）
  • 追求极限性能或低资源占用
  • 愿意接受更少的生态工具

5. 扩展建议

• 测试基准：用实际内容试运行两者（Hugo 和 Zola），命令示例：

  1# Hugo
  2time hugo --minify
  3
  4# Zola
  5time zola build --release

• 混合架构：
  对超大规模站点，可用 Rust 生成器处理数据，Hugo 做前端展示。

总结：Rust 工具在纯构建速度上胜出，但 Hugo 的综合体验更适合大多数用户。如果是性能敏感型项目（如企业级文档站），优先考虑 Rust 方案。

zola简介

仓库

https://github.com/getzola/zola

官网

https://www.getzola.org/

主题

https://www.getzola.org/themes/

Overview | Zola zola文档

zola主题的产生

一个二进制就可启动服务，真香

hugo的模版引擎语法像天书，zola的模版引擎相对直观

张洪的主题有hugo社区版、halo社区版、hexo

zola-theme-jiaxiang.wang主题简介

博客地址：blog.jiaxiang.wang

仓库地址：zola-theme-jiaxiang.wang

主题简单demo：theme.jiaxiang.wang

部署（部署成功💖）

2025年8月21日测试。

（1）winodws安装

https://www.getzola.org/documentation/getting-started/installation/

1$ winget install getzola.zola

（2）安装

（3）效果

结束。

同步到开源库

https://cnb.cool/onedayxyy/zola-theme-jiaxiang.wang

zola-theme-jiaxiang.wang主题为何如此丝滑🤣

zola-theme-jiaxiang.wang

背景

分析

案例：动画是基于gsap，交互是基于jquery

它的动画是基于gsap的 交互可能是基于jquery

案例：他动画加的多

https://vue-bits.dev/text-animations/shiny-text

案例：teeker群主回应

基础知识

目录结构

运行 后，您应该在目录中看到以下结构：zola init

1.
2├── config.toml
3├── content
4├── sass
5├── static
6├── templates
7└── themes
8
95 directories, 1 file

如果您正在运行默认命令，您可能还会看到一个目录，该命令包含站点的一些输出：的完整站点和仅静态资产。该文件夹将由 自动删除/创建。`public

zola build

zola serve

以下是每个目录和 .config.toml

🔗config.toml

TOML 格式的强制性 Zola 配置文件。 配置文档中详细介绍了此文件。

🔗content

包含所有标记内容（主要是文件）。 目录的每个子目录都表示一个包含页面（您的文件）的部分。.md``content``.md

要了解更多信息，请阅读内容概述页面。

🔗sass

包含要编译的 Sass 文件。非 Sass 文件将被忽略。 复制编译文件时，文件夹的目录结构将被保留;例如，将 的文件编译为 。sass``sass/something/site.scss``public/something/site.css

🔗static

包含任何类型的文件。目录中的所有文件/目录将按原样复制到输出目录。 如果您的静态文件很大，您可以配置 Zola 以硬链接它们 而不是通过配置文件中的设置来复制它们。static``hard_link_static = true

🔗templates

包含将用于渲染站点的所有 Tera 模板。 查看模板文档以了解有关默认模板的更多信息 和可用变量。

🔗themes

包含可用于您网站的主题。如果您不打算使用主题，请将此目录留空。 如果您想了解主题，请参阅主题文档。

命令

zola build

zola serve

配置博客

修改网站标题和作者昵称

• 配置方法

• 效果预览

配置网站logo

• 配置方法

• 效果预览

配置标签页标题

• 配置

• 效果

配置座右铭

• 配置方法

• 效果预览

发布博客

 1D:\我的开源项目\zola-theme-jiaxiang.wang\public
 2
 3
 4
 5rsync.exe -avPzruh --delete --port 8730 --password-file=/cygdrive/d/vitepress-theme-teek-one-private/shell/password.txt /cygdrive/d/vitepress-theme-teek-one-private/docs/.vitepress/dist root@106.75.214.199::cmi-vitepress/
 6
 7
 8
 9
10##输出
11rsync.exe -avPzruh --delete --port 8730 --password-file=/cygdrive/d/vitepress-theme-teek-one-private/shell/password.txt /cygdrive/d/我的开源项目/zola-theme-jiaxiang.wang/public root@106.75.214.199::cmi-zola/

OK：

https://zola.onedayxyy.cn/

如何创建文章

创建如下目录：

全局壁纸

1global_cover  = "/articles/misc/Lorem Ipsum/cover.avif"

本地壁纸

banner左侧

• 配置

• 效果

banner右侧

• 配置

• 效果

友链

• 配置

• 效果

修改推荐下2个文章

• 配置

• 效果

修改右侧推荐文章

• 配置

• 效果

配置评论

• 配置

• 效果

改成文档、博客

• 配置

• 效果

公众号配置

报错

（待解决）在线图片为啥报错

改成本地的就好了。。。

（已解决）url缺失报错

url缺失会影响运行的！

to do list

cnb配置待优化

推荐的这个icon需要修改

推荐的这个icon需要修改，目前这个有问题哦。

这个markdown语法太显眼了，需改进

开始支持文档库功能

https://theme.jiaxiang.wang/collections/sample/collection%201/02%20sample/

王嘉祥 开源的zola-theme-jiaxiang.wang主题（基于rust的zola主题，风格移植自张洪Heo），性能地表最强，体验无比丝滑的 静态ssg类型博客。为何如此丝滑？

基于 zola-theme-jiaxiang.wang , 按voding思想（知识库和博客 2合一）二开新主题，力求达到和Teek一样的效果😜（理想状态）。

博客地址：blog.jiaxiang.wang

仓库地址：zola-theme-jiaxiang.wang

主题简单demo：theme.jiaxiang.wang