我是如何搭建一个全新博客的

Gavin

前言

老博客年久失修,又双叒叕准备迁移到新的博客。

这次选用了 Hexo 作为框架,而主题则使用了 Redefine,笔者主要喜欢上了其简洁大气的风格。搭建则使用了 Cloudflare Pages。

接下来的内容将完整记录我是如何把这个博客搭建起来的,想要自己搭建的朋友也可以参考。

正文

Hexo 使用 npm 安装,所以我们需要先安装 Node.js,具体过程不再赘述。

接着,初始化一个 Hexo 博客并安装 Redefine 主题。

1
2
3
4
npm install hexo-cli -g
npm init Blog
cd Blog
npm install hexo-theme-redefine@latest

我们需要手动在配置文件中启用 Redefine 主题,仅需在博客根目录中的 _config.yml 中设置 theme 即可。

1
theme: redefine

在博客根目录下创建 _config.redefine.yml 文件,并将此处的内容复制进去。当然,你可以删除 _config.landscape.yml 文件了,它已无用。

使用 Hexo 提供的命令即可在本地开启一个服务器或生成静态页面以预览博客。

1
2
3
4
# 启动服务器
hexo server
# 生成静态界面
hexo generate

这些命令也有相应的简写形式。

1
2
hexo s
hexo g

Redefine 的配置文档非常全,对于博客的配置完全可以参考文档一步一步来,下面不多赘述。

CMS

机房的电脑开机会复原,但笔者又有在机房电脑更新博客的需求。这时,我们可以搭建一个 CMS。笔者选择了 Decap CMS,这个东西需要一个后端辅助进行身份验证,老博客使用的是 Netlify Identity + Git Gateway,但因为 Netlify 现在的访问速度一言难尽(至少对我来说),于是转用了 Cloudflare Pages 的 Functions。已经有前人写出了开箱即用的代码,在这里,我们直接按照 Readme 搭建即可。

把 repo 里的 functions 文件夹丢进你博客的根目录(不是 public 文件夹里),Pages 部署时就可以自动检测到了。接下来安装 Decap CMS,找一个你要放 CMS 的地方,写一个 html。

1
2
3
4
5
6
7
8
9
10
11
12
13
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="robots" content="noindex" />
<title>Content Manager</title>
</head>
<body>
<!-- Include the script that builds the page and powers Decap CMS -->
<script src="https://unpkg.com/decap-cms@^3.0.0/dist/decap-cms.js"></script>
</body>
</html>

在同级目录下创建一个 config.yml 文件,进行配置。其他配置可以自己根据 Decap CMS 的文档来,backend 则使用我们刚刚的 functions。

1
2
3
4
5
6
7
backend:
name: github
repo: <user>/<repo>
branch: main
site_domain: <url>
base_url: <url>
auth_endpoint: /api/auth

把 repo 项替换成自己的 Github repo,填部署出来的就可以了。只要是对此仓库有写权限的账户都可以进行编辑了。

别忘了把你放 CMS 的文件夹丢进 hexo 的 skip_render 里。

  • 标题: 我是如何搭建一个全新博客的
  • 作者: Gavin
  • 创建于 : 2025-07-13 00:24:00
  • 更新于 : 2025-07-26 10:01:43
  • 链接: https://gavin-blog.pages.dev/2025/我是如何搭建一个全新博客的/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
目录
我是如何搭建一个全新博客的