通过 Gitea 部署 Hexo 教程

一、准备工作

1. 安装软件：确保你已经安装了 Node.js 和 Git。
2. 注册 Gitea：注册并登录 Gitea 平台。

二、配置 Git

1. 配置 Git 用户名和邮箱：

   1 2	$ git config --global user.name "gitea用户名" $ git config --global user.email "你的邮箱"

2. 生成 SSH 密钥：

   1	$ ssh-keygen -t rsa -C "你的邮箱"

   然后一直回车，生成 id_rsa（私人密钥）和 id_rsa.pub（公共密钥）。

3. 添加 SSH 公钥到 Gitea：

   • 打开 id_rsa.pub 文件，复制内容。
   • 登录 Gitea，进入个人设置，添加 SSH 公钥。

三、创建 Hexo 项目

1. 初始化 Hexo 项目：

   1 2	$ hexo init $ npm install

2. 新建文章：

   1	$ hexo new [layout] <title>

3. 生成静态文件：

   1

   $ hexo g

4. 启动本地服务器：

   1

   $ hexo s

   访问 http://localhost:4000 查看效果。

四、部署到 Gitea

1. 创建 Gitea 仓库：

   • 在 Gitea 上创建一个新仓库，复制仓库的 SSH 地址。

2. 配置 Hexo 的部署：

   • 在 _config.yml 文件中添加 Gitea 仓库地址：

     1 2 3 4

     deploy: type: git repo: git@gitee.com:<你的用户名>/<你的仓库名>.git branch: master

3. 安装 Git 部署插件：

   1	npm install --save hexo-deployer-git

4. 部署到 Gitea：

   1 2 3

   $ hexo clean $ hexo g $ hexo d

五、配置 Gitea Page 服务

1. 启动 Gitea Page：

   • 进入 Gitea 的仓库设置，启用 Gitea Page 服务。
   • 选择 master 分支进行部署，并勾选 强制使用 HTTPS。

2. 访问博客：

   • 部署成功后，你可以通过 https://<你的用户名>.gitee.io 访问你的博客。

六、自定义域名（可选）

1. 配置 CNAME 文件：

   • 在 Hexo 项目的根目录下创建一个名为 CNAME 的文件，并输入你的域名。
   • 重新部署博客：

     1 2 3

     $ hexo clean $ hexo g $ hexo d

2. 配置域名解析：

   • 在你的域名管理后台添加一条 CNAME 记录，指向 yourusername.gitee.io。

七、常见问题

1. 页面样式显示不正确：
   • 检查 _config.yml 中的 URL 设置，确保正确。

通过以上步骤，你可以成功将 Hexo 博客部署到 Gitea 平台。希望这个教程对你有所帮助！