banner
虫子游戈

虫子游戈

一个写故事的人类
mastodon
email

用Gridea搭建博客竟如此简单

我曾在大学时试过用 WordPress 搭建博客,但其复杂程度超过了我的掌控能力,后来也反反复复多次使用过 GitHub Jekyll,但总觉得不好用,坚持不了几天。到后来,我就更愿意使用现成的博客服务平台了,比如新浪博客、网易 Lofter、简书等,但国内博客平台存在严重的审查问题,所以也始终不称意。然后我就开始用 Blogger,体验很差,但好在没了审查,所以也就忍受了几年。但如此却将我自己的故事挡在了墙外,常会让我感到遗憾。尽管我尝试使用 ZeroNet 来发布文章,但这个分布式网络可以说是一个鬼城,并没有几个真正严肃的真实用户。

今天下午,我偶然在知乎上看到了一篇文章《完全小白教程:使用 Github Pages 和 Gridea 搭建个人博客》,发现了 Gridea 这个超简单的博客工具,简单了解了下发现这正是我需要的东西 —— 简简单单就能免费创建一个能受自己控制且(几乎)不被审查的博客。真的非常简单!

下面我将分步骤描述我的创建和配置过程,其中包括注册配置 GitHub 代码库、下载配置 Gridea 客户端、选择合适的博客主题、绑定域名、配置谷歌分析、发布文章。

1 注册配置 GitHub 代码库#

首先注册一个 GitHub 账户。如果你不打算使用自己的域名,那么请慎重选择你的「用户名」,因为它会以「用户名.github.io」这一形式作为你的博客地址。

注册完毕后,点击右上角+,单击 New repository,新建代码库:

image

之后在 Repository name 填写你的「用户名.github.io」,然后创建代码库:

image

此时你会得到一个空的代码库。

点击右上角头像,进入 Settings,找到 Developer Settings,选择 Personal access tokens,然后点击 Generate new token:

image

然后在 Note 处随意填写你的备注,勾选 repo,然后点击下方生成 token:

image

复制这行 ghp_ 开头的 token。请注意蓝色警告:退出该页面后将无法看到这串字符。如果失误丢失了这个 token 也别慌,你可以重复上述步骤再生成一个新的。

image

2 下载配置 Gridea 客户端#

Gridea 官网其 GitHub 代码库下载对应操作系统的客户端并安装。

首先进入「远程」进行配置。平台选择 GitHub Pages,域名选择 https:// 并填写你的「用户名.github.io」,仓库名称也是「用户名.github.io」,分支可填写 master 或 main,用户名便是你的用户名,邮箱可选,令牌则粘贴上面的 token。如果你有自己的域名,就填入 CNAME;如果否则留空。然后点击右下「保存」,并可点击左下角「检测远程连接」。我个人偶尔会遇到连接不上的情况,可能还是有些 bug。 如果没问题,便可以将你的初始博客「同步」到 GitHub。

image

同步成功后,等待很短时间,访问你的「用户名.github.io」应该就能看到你的博客了。

初始博客预置了两篇文章,一篇是欢迎文章,一篇是「关于」,两者均可删除或修改。

另外,如果你希望在自己定义的文件夹(比如放在网盘文件夹中同步)管理你的博客,可点击左下角的设置按钮,配置「站点源文件路径」:

image

3 选择合适的博客主题#

在 Gridea 客户端「主题」窗口,可以选择博客主题。选择之后一定要点击保存,并且要同步成功后才能应用到博客上:

image

Gridea 预置了 4 个主题,但它们可能并不合你的心意。你也可以在官网主题页面下载你感兴趣的主题。然后将下载好的主题解压后放入站点源文件路径下的 themes 路径中。之后关闭 Gridea 客户端并重启,再重新选择主题即可。

image

当然你也可以修改你的主题,这可通过 Gridea 客户端的「自定义配置」实现,也可通过修改相应主题中的文件或 config 文件夹中相应配置文件完成。

4 绑定域名#

我的域名 czyouge.xyz 是几年前在 Godaddy 购买的,当时挺便宜,现在价格应该也不高。购买完成后进入该域名的 DNS 管理,添加如下图所示的几条记录:

image

其中一条是 CNAME 记录,name 填入 www,当然你可以用其它的,比如 blog—— 这样可通过 blog.你的域名 访问你的博客。value 填入你的「用户名.github.io」。

另外再添加一条或多条 A 记录,这是为了实现更安全的 HTTPS 访问,A 记录的 IP 地址可选择:

  • 185.199.108.153
  • 185.199.109.153
  • 185.199.110.153
  • 185.199.111.153

更多详情可参考这个知乎回答

然后进入你的 GitHub 代码库,选择 Settings:

image

然后选择 Pages,在 Custom domain 填入你的域名并保存(Save),然后等待验证完成,点击 Enforce HTTPS,这是强制启用 HTTPS。这样即使使用 http://你的域名 访问,也会强制转向 https://你的域名

image

这个功能很有用,至少 Chrome 浏览器在打开你的博客时不会发出安全报警,比如访问饭否时便会收到这样的报警:

image

5 配置谷歌分析#

如果你想知道博客的访问数据,可以免费使用谷歌分析来做到这一点。Gridea 也提供了非常简单易用的支持。

首先当然是注册谷歌账户,然后进入 Google Analytics。点击左下角管理:

image

然后在「账号」栏创建账号,之后你会得到一个 UA-xxxxxxxxx-x 格式的跟踪 ID。接下来进入「媒体资源设置」:

image

在「默认网址」设置 https 并填入你的网址:

image

然后进入 Gridea 客户端「主题」→「自定义配置」→「谷歌统计」,填入跟踪 ID:

image

之后可通过谷歌分析查看博客访问数据报告。

6 发布文章#

使用 Gridea,我们有两种发布博客文章的方式。

一是使用客户端文章窗口添加文章:

image

但这种方法略显笨重。

第二种方法则是直接将 Markdown 文章放入 站点源文件路径 下的 posts 文件夹中。使用这种方式有几点需要注意:

  • Markdown 文件的名称即为文章的链接 ID。
  • 文件内有一些重要的元数据:title 是文章标题,date 是展示的时间,tag 为标签,published 为是否发布(false 为保存草稿)、hideInList 为是否隐藏(隐藏后不会在文章列表中出现)、isTop 为是否置顶,feature 的参数则为文章封面图的链接(可留空)。
  • <!-- more --> 用于分割摘要和其余正文。
  • 另外,如果是在其它位置编辑带图片的 Markdown 文件,请注意图片的相对地址。

image

最后,在任何操作后都记得「同步」到 GitHub 代码库哦,这样你的文章才能和读者见面。

加载中...
此文章数据所有权由区块链加密技术和智能合约保障仅归创作者所有。