简介

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

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

主题预览

🚀 快速上手

💡 强烈建议：访问官方代码仓库 zola-theme-jiaxiang.wang 获取最新文档。

前置要求

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

安装步骤

1. 初始化项目

zola init myblog
cd myblog

2. 使用 Git Submodule 添加主题

git init  # 如果还没有初始化 Git
git submodule add https://github.com/iWangJiaxiang/zola-theme-jiaxiang.wang.git themes/jiaxiang.wang

3. 配置主题设置

# 查看主题提供的配置示例（手动合并到自己的 config.toml 中）
cp themes/jiaxiang.wang/config.toml config.toml.example  # 备份参考配置

4. 修改配置文件

编辑 config.toml 文件，设置主题：

theme = "jiaxiang.wang"

5. （可选）导入示例内容

cp -r themes/jiaxiang.wang/content/* content/

🔧 Git Submodule 的优势

使用 Git Submodule 管理主题有以下好处：

  • 版本管理：submodule 会记录特定的 commit，避免主题更新破坏网站配置
  • 便于更新：git submodule update --remote 可以轻松更新主题
  • 协作友好：其他人 clone 项目时能自动获取正确版本的主题
  • 依赖明确：明确显示项目依赖的外部主题

📥 常用命令

更新主题到最新版本

git submodule update --remote

克隆包含 submodule 的项目

git clone --recursive <你的项目地址>

初始化已克隆项目的 submodule

git submodule init
git submodule update

如有问题，请参考主题仓库的 Issues 或提交新的问题。