Hexo 个人博客仓库初始化流程

    graph LR
    A[Hexo 项目] --> B[安装主题]
    B --> C{方式选择}
    C -->|直接克隆| D[git clone]
    C -->|Submodule| E[git submodule add]
    D --> F[git init]
    E --> F
    F --> G[git add . / commit]
    G --> H[git push]
    H --> I[配置 CI/CD 变量]
    I --> J[推送触发自动构建与部署]

1. 前置准备

确保已安装 Hexo 及所需插件：

1 2	npm install hexo-cli -g npm install

2. 安装主题

本文使用 Butterfly 主题（官方文档）。

方式一：直接克隆（推荐）

1	git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

方式二：Git Submodule（方便后续更新）

如需持续跟踪主题更新，可改用 submodule：

1	git submodule add -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

如果同时执行了 clone 和 submodule add，会产生冲突，选择其中一种即可。

3. 初始化仓库

git init
git add .
git commit -m "Hexo Blog Init"
git remote add origin <你的仓库地址>
git push -u origin master

4. 配置 CI/CD

推送完成后，在仓库设置中添加以下密钥和变量：

名称	类型	说明
`HEXO_RELEASE_TOKEN`	Secrets	Gitea API 令牌，用于自动创建 Release
`SSH_PRIVATE_KEY`	Secrets	服务器 SSH 私钥，用于自动部署
`SERVER_HOST`	Variables	目标服务器地址
`SERVER_PORT`	Variables	SSH 端口，默认 22
`SERVER_USER`	Variables	SSH 登录用户
`SERVER_PATH`	Variables	部署路径

详细 CI/CD 流程参见：Gitea Action 自动打包发布流程。