新建一个博客以及博客维护

简述

本文档主要记录了如何从零开始新建一个博客，以及为后续维护提供一个指导。该博客采用Hexo框架，部署到github pages，主题则为redefine

环境

• Windows 11或Ubuntu 24.04

建立第一个博客

建议直接查看官方教程，会比本文档更加全面

• Hexo官方文档
• redefine主题官方文档

下载并安装git

• Windows：请前往git官网下载安装包
• Ubuntu：在终端执行以下命令

  sudo apt update #更新软件包列表
  sudo apt-get install git-core -y #安装git

  输入以下命令，如果有版本号输出则表示git安装成功

git --version

下载并安装Node.js

• Windows：请前往Node.js官网下载安装包并安装。不过更建议使用NVM来管理Node.js版本，此处不过多介绍nvm的安装和使用，建议自行搜索相关教程
• Ubuntu：使用如下命令安装。但是笔者首次建站是在windows上操作的，建议自行查找相关更权威的文档

  sudo apt update #更新软件包列表
  sudo apt install -y curl #安装curl
  curl -fsSL https://deb.nodesource.com/setup_23.x -o nodesource_setup.sh #下载Node.js安装脚本
  sudo -E bash nodesource_setup.sh #运行安装脚本
  sudo apt install -y nodejs #安装Node.js

  输入以下命令，如果有版本号输出则表示node.js安装成功

node -v

安装Hexo

在终端执行以下命令安装Hexo

npm install -g hexo-cli

输入以下命令，如果有一堆版本号输出则表示Hexo安装成功

hexo -v

创建博客

在你想要存放博客的目录下打开终端，执行以下命令

hexo init <folder>
cd <folder>
npm install

其中<folder>为你想要创建的博客目录名称,完成后项目文件夹将如下所示

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

具体各级文件夹分别是什么含义请自行查看官方文档，这里不需赘述

安装并启用redefine主题

在终端执行以下命令

npm install hexo-theme-redefine@latest

然后打开_config.yml文件，找到theme字段，将其值改为redefine

theme: redefine

配置redefine主题

创建一个_config.redefine.yml文件(请确保文件名完全一致)，并将此处内容复制进去,此时redefine主题会自动覆盖hexo默认主题的配置项。然后具体怎么按自己喜欢的样式配置请查看官方文档，内容过多此处不再赘述。

本地预览

在博客路径下的终端执行以下命令

hexo clean #清除缓存（可选）
hexo g #生成静态文件
hexo s #启动本地服务器

此时在浏览器访问http://localhost:4000即可预览博客

创建git仓库

创建一个GitHub仓库，且仓库名字必须是<github_username>.github.io，其中<github_username>为你的GitHub用户名，勾选Initialize this repository with a README，然后点击Create repository按钮创建仓库。

部署到GitHub Pages

在博客路径下的终端执行以下命令

npm install hexo-deployer-git --save #安装部署插件

然后打开_config.yml文件，找到deploy字段，修改为如下内容

deploy:
  type: git
  repository: git@github.com:用户名/用户名.github.io.git # 替换为你的仓库地址
  branch: main #如果你的默认分支是master则改为master

然后执行以下命令部署

hexo clean #清除缓存（可选）
hexo g #生成静态文件
hexo d #部署到GitHub Pages

此时访问https://<github_username>.github.io即可看到你的博客上线了

如何写文章

本教程是以草稿-正文的形式教学，即先创建草稿，草稿写完后发布为正式文章。但是实际使用过程中也可以直接新建正文具体操作为把第1步中的draft改为post即可。

创建一个草稿

在博客路径下的终端执行以下命令

hexo new draft "文章标题"

此时你的source/_drafts目录下会生成一个新的markdown文件，文件名为文章标题.md，打开该文件即可编辑文章内容
如果要预览草稿则输入以下命令

hexo clean #清除缓存（可选）
hexo g #生成静态文件
hexo server --draft #启动本地服务器（可查看草稿渲染）

发布文章

在博客路径下的终端执行以下命令

hexo publish draft "文章标题"

此时你的文件会从source/_drafts目录移动到source/_posts目录下

推送到GitHub Pages

在博客路径下的终端执行以下命令

hexo clean #清除缓存（可选）
hexo g #生成静态文件
hexo d #部署到GitHub Pages

跨平台管理博客

如果你想在多台电脑或者不同的操作系统上管理你的博客，可以使用git来同步博客内容。以下是具体操作步骤

笔者在刚开始建站的时候经验不足，使用了同一个仓库的不同分支来隔离博客源码和生成的静态文件，导致博客源码完全暴露在外，作为还未发布的草稿内容也可以被其他人看到，后来才意识到这是不安全的做法。不建议使用同一个仓库的不同分支作为隔离，还是建议新建一个私有仓库对博客源码进行管理

推送本地博客重要配置到远程仓库

不建议使用同一个仓库的不同分支作为隔离，建议新建一个私有仓库对博客源码进行管理，在博客路径下的终端执行以下命令

git checkout -b <branch> #新建并切换分支
git add . #添加所有文件
git commit -m "Initial commit" #提交更改
git remote add origin <url> #连接新的远程仓库
git push -u origin <branch> #推送到远程仓库

建议注意添加git忽略文件.gitignore隔离不同环境，内容如下

.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
_multiconfig.yml

在另一台电脑上克隆仓库

在另一台电脑上配置好博客需要的环境，然后在你想要存放博客的目录下打开终端，执行以下命令

git clone -b <branch> <url> #克隆远程仓库的指定分支
cd <folder> #进入博客目录

npm install #安装依赖
# 安装依赖可使用更保险的做法：
npm install --legacy-peer-deps

结束后尝试输入hexo -v如果有内容输出则说明安装完成

修改博客内容

写完后相同步骤生成并部署

hexo clean #清除缓存（可选）
hexo g #生成静态文件
hexo d #部署到GitHub Pages

将更改推送到远程仓库

git add . #添加所有文件
git commit -m "Update blog" #提交更改
git push origin <branch> #推送到远程仓库

更新博客内容

如果你在一台电脑上修改了博客内容，那么另一台电脑需要先拉取最新的更改，然后再进行修改

git pull origin <branch> #拉取远程仓库的最新更改