[教程] GitHub Pages+Gridea搭建静态博客网站

文章目录

写在前面
WordPress 固然很受欢迎，但它并非是搭建博客网站的唯一选择。假若你目前并不打算付费购买服务器托管自己的网站，那通过 GitHub + Gridea 的方式来搭建一个免费的静态博客网站也不失为一个比较好的选择。

本文将逐步讲解如何从零开始通过 GitHub Pages+Gridea 的方式搭建一个静态博客网站。在认真读完这份文档教程后，即使是纯小白用户也可以自己动手搭建起一个静态博客网站。

文章目录：

为什么要使用 GitHub Pages

GitHub pages 是 GitHub 免费提供的一个轻量级个人博客服务。对于小白用户而言，它有以下一些优势：

免费试用，可省下一笔云服务开支；
创建Github pages 的步骤简单，对小白用户比较友好；
提供自定义域名，一键开启 HTTPS 等功能；
每月带宽使用上限100GB，对个人博客网站而言完全够用；
无需要操心系统维护，可以专注于文章创作；

不过除了以上这些显而易见的优势外，GitHub 作为一项免费服务，也存在一些限制和不足：

在使用时项目和网站大小不要超过1GB；
不要过于频繁地更新网站内容（每小时不超过10个版本）；
GitHub 服务器节点在美国，网站访问速度上没有优势可言；

为什么要使用 Gridea

对于小白而言，使用 GitHub 仓库来管理和推送文章相对比较麻烦。使用 Gridea 这款静态博客写作客户端工具，可以让我们更专注于创作。

搭建步骤

只需按照教程步骤一步一步往下走，即可轻松搭建起一个美观优雅的静态博客网站。

1. 创建 GitHub pages

1. 注册 GitHub 账号。

2. 注册完成后，在个人主页界面中选择创建一个新的 repository（仓库）。

3. 在 Create a new repository 页面，输入 Repository name（仓库名）。

需要注意的是，Repository name 的格式需要设置为类似 githubusername.github.io 的形式。

举个例子，我的 GitHub 用户名为 binzeng001，所以我的 Repository name就需要填写 binzeng001.github.io 。

接下来，选择 Public（公开模式），勾选 Add a README file，接着点击 Create repository 按钮。

4. 创建成功后，点击 Settings 按钮。

5. 点击 Settings 页面左侧的 Pages 打开 GitHub Pages 设置页面。然后选择使用 main 分支，点击 Save 保存。点击 Choose a theme 可以给刚创建好的 GitHub Pages 选择一个主题。

2. 生成一个Token

1. 依次点击右上角个人头像 > Settings > 左侧边栏的 Developer settings > 左侧边栏的Personal access tokens，然后点击右侧的 General net token 按钮。

2. 在 Note 一栏，简单用文字描述此 token 的作用，设置好 token 的过期时间，并勾选 repo。然后滑动页面到最底端，点击 Generate token 按钮生成 token。

3. token 生成好后，可以暂时先开着这个页面，等待会儿安装配置 Gridea 时再把 token 复制过去。

3. 安装配置Gridea

1. 前往Gridea官网下载适用于你电脑操作系统的 Gridea 安装包。

2. 下载完成后，将其安装到你的电脑上。初次打开 Gridea，界面是这个样子，非常简洁素雅：

3. 点击 Gridea 左侧边栏的远程，在基础配置tab下，按照截图所示填写好配置信息，然后点击保存按钮：

域名：Github pages 对应的域名（例如：https://binzeng001.github.io 或自定义域名：e.g. https://blog.justwrite.top）
仓库：你的静态文件存放的仓库（例如：binzeng001.github.io）
分支：你的 GitHub Pages 对应的分支（例如：main）
用户名：仓库所属用户的用户名（你的 GitHub 账号的昵称）
邮箱：Git 推送时使用的邮箱（你的 GitHub 账号的邮箱）
Token: Git 推送时需要的 Token，用来向 GitHub 提交构建后的文件 Github personal access tokens
CNAME: 可通过这个选项配置你自己的域名

4. 随后点击底部检测远程连接，确认远程连接是否正常。

5. 点击同步按钮，你的博客的静态页面就可以同步发布到 GitHub 上了，点击预览按钮，可以查看预览效果。

此外，你还可以通过 Gridea 来设置网站主题，网站名称，网站描述等。

接下来，你就可以在浏览器上输入前面步骤配置好的域名（e.g. https://bingzeng001.github.io）访问你的网站了。

4. 配置自定义域名（非必要步骤）

如果你已经有注册自己的域名，那么你可以在 GitHub Pages 设置中配置自定义域名，并免费启用 HTTPS 。具体操作步骤如下：

1. 前往你的域名提供商网站后台，在 DNS 解析里新增一条类别为 CNAME 的解析记录。举个栗子，我选择使用子域名 blog.justwrite.top 这个子域名来访问这个 GitHub pages，那么我只需要通过 CNAME 的方式指向我前面创建的 GitHub pages 域名 binzeng001.github.io即可：