One

主题

00:00:00
2025-08-212025-09-07博客搭建zola
2760
12.6m
0

zola-theme-jiaxiang.wang-one ​

zola-theme-jiaxiang.wang-one ​

image-20250906230626911

目录 ​

[toc]

版权 ​

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

image-20250906230559393

背景 ​

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

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

请看下文：

image-20250906230959659

image-20250906231306955

image-20250906231343979

rust pk hugo ​

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

2025年8月21日提问。

回答：

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

1. 语言层面的性能 ​

维度Rust 工具 (如 Zola)Hugo (Go)
执行速度⚡️ 极快（零成本抽象，无GC）快（Go 已优化，但有 GC 开销）
编译优化可编译为原生机器码，极致优化依赖 Go 运行时，优化有限
内存安全无 GC，内存安全无代价有 GC，偶尔停顿

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

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

2. 实际场景差异 ​

📌Hugo 的优势

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

📌Rust 工具的优势

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

3. 代表性工具对比 ​

工具语言特点适用场景
ZolaRust极简设计，速度最快技术博客/高性能需求
HugoGo生态丰富，主题多通用内容站/快速开发
CobaltRust支持 Liquid 模板Hugo 用户的 Rust 替代方案

4. 如何选择？ ​

  • 选 Hugo 如果：

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

  • 选 Rust 工具如果：

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

5. 扩展建议 ​

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

    bash
    # Hugo
time hugo --minify

# Zola
time zola build --release

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

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

zola简介 ​

仓库 ​

https://github.com/getzola/zola

image-20250821182557525

官网 ​

https://www.getzola.org/

image-20250821182623635

主题 ​

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

Overview | Zola zola文档

image-20250821182644308

zola-theme-jiaxiang.wang主题简介 ​

提示

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

博客地址：blog.jiaxiang.wang

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

主题简单demo：theme.jiaxiang.wang

其它文章

回馈社区，本站博客主题正式开源！

zola-theme-jiaxiang.wang 主题介绍

从0到1：回顾建站历程

展示你独特的一面，个人主页主题正式开源！

image-20250824054615170

image-20250821182812692

image-20250821182855962

部署（部署成功💖） ​

2025年8月21日测试。

（1）winodws安装

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

bash
$ winget install getzola.zola

image-20250821225138898

（2）安装

具体步骤

  1. 参考官方说明安装 Zola 命令行工具

  2. 将本仓库克隆到本地

    git clone --depth=1 https://github.com/iWangJiaxiang/zola-theme-jiaxiang.wang.git

  3. 进入本地仓库

    cd zola-theme-jiaxiang.wang

  4. 运行预览命令，然后在浏览器打开提示的预览地址

    zola serve

    此时您应该成功访问到博客网站啦

  5. 参考官方资料进一步探索并定制您的博客

（3）效果

image-20250821225302108

结束。

同步到开源库 ​

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

image-20250822062021781

这个主题为何如此丝滑🤣 ​

zola-theme-jiaxiang.wang

image-20250822115927143

背景 ​

image-20250822115224423

image-20250822115239883

分析 ​

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

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

image-20250822115302196

image-20250822115310683

NOTE

gsap 支持 Vue ，而且开源

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

image-20250822115410838

案例：他动画加的多 ​

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

image-20250822115509029

案例：群主回应 ​

image-20250824064016727

image-20250824064121150

基础知识 ​

目录结构 ​

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

bash
.
├── config.toml
├── content
├── sass
├── static
├── templates
└── themes

5 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

配置博客 ​

修改网站标题和作者昵称 ​

  • 配置方法

image-20250905123207429

  • 效果预览

image-20250905123231347

image-20250905123243497

  • 配置方法

image-20250905124613911

  • 效果预览

image-20250905124658032

配置标签页标题 ​

  • 配置

image-20250906070626704

  • 效果

image-20250906070641414

配置座右铭 ​

  • 配置方法

image-20250905125015576

  • 效果预览

image-20250905125030015

发布博客 ​

bash
D:\我的开源项目\zola-theme-jiaxiang.wang\public



rsync.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/




##输出
rsync.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/

image-20250905221258376

如何创建文章 ​

创建如下目录：

image-20250906065032791

image-20250906065057825

全局壁纸 ​

image-20250906070007924

bash
global_cover  = "/articles/misc/Lorem Ipsum/cover.webp"

本地壁纸 ​

image-20250906070040372

banner左侧 ​

  • 配置

image-20250906071448227

  • 效果

image-20250906071506286

banner右侧 ​

  • 配置

image-20250906072251531

  • 效果

image-20250906072307776

友链 ​

  • 配置

image-20250906073856136

  • 效果

image-20250906073837769

修改推荐下2个文章 ​

  • 配置

image-20250906075047285

  • 效果

image-20250906075118551

修改右侧推荐文章 ​

  • 配置

image-20250906093953737

  • 效果

image-20250906093935392

配置评论 ​

  • 配置

image-20250906090653065

image-20250906090716677

  • 效果

image-20250906090633346

改成文档、博客 ​

  • 配置

image-20250906192905846

  • 效果

image-20250906192924340

公众号配置 ​

image-20250907044044734

image-20250907044135456

报错 ​

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

改成本地的就好了。。。

image-20250905124003528

（已解决）url缺失报错 ​

url缺失会影响运行的！

image-20250905225448411

image-20250905225520636

to do list ​

cnb配置待优化 ​

image-20250907042504547

image-20250907042518186

推荐的这个icon需要修改 ​

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

image-20250906193419648

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

image-20250906064505714

最近更新