Hexo 搭建

安装 Node.js

Node.js 官网

推荐安装长期维护版。

完成安装后打开命令提示符输入:

1
node -v

出现版本号即为安装成功。

安装完成后建议更换源为淘宝镜像源,默认的源是国外服务器,对国内速度不友好。

在命令行输入下面命令即可:

1
npm config set registry https://registry.npm.taobao.org

安装 git

git 官网

git 具体用法这里不在阐述,具体用法自行百度。

安装后在任意地方右键打开 git Bash。

在 git bash 中输入下列命令,引号中的内容替换为自己的信息,需要逐行输入。

1
2
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"

之后生成 ssh 密钥文件。

1
ssh-keygen -t rsa -C "你的GitHub注册邮箱"

然后直接三个回车即可,默认不需要设置密码。

安装 Hexo

前面 git 和 nodejs 安装好后,就可以安装 hexo 了。

在命令提示符中输入:

1
npm install -g hexo-cli

输入下列命令查看是否安装成功:

1
hexo -v

如下图所示即为安装成功。

配置 GitHub 仓库

找到安装 git 时生成的.ssh 的文件夹中的 id_rsa.pub 密钥,将内容全部复制。

  • .ssh 文件夹需要显示隐藏文件。
  • .ssh 路径默认为下图所示。

打开GitHub_Settings_keys 页面,新建 new SSH Key.

Title 为标题,任意填即可,将刚刚复制的 id_rsa.pub 内容粘贴进去,最后点击 Add SSH key。

在 Git Bash 中检测 GitHub 公钥设置是否成功,输入 :

1
ssh git@github.com

如上则说明成功。这里之所以设置 GitHub 密钥原因是,通过非对称加密的公钥与私钥来完成加密,公钥放置在 GitHub 上,私钥放置在自己的电脑里。GitHub 要求每次推送代码都是合法用户,所以每次推送都需要输入账号密码验证推送用户是否是合法用户,为了省去每次输入密码的步骤,采用了 ssh,当你推送的时候,git 就会匹配你的私钥跟 GitHub 上面的公钥是否是配对的,若是匹配就认为你是合法用户,则允许推送。这样可以保证每次的推送都是正确合法的。

创建 Hexo

此时我们本地的环境已经配置好,下面就是注册 Vercel。

Vercel 官网

注册过程不多赘述,注册好后绑定自己的 GitHub 账号。

点击 New Project 按钮,然后点击 Browse All Templates → 按钮,搜索框搜索Hexo创建即可。

仓库选择 GitHub 仓库,然后点击 GitHubGIT SCOPE 处选择你想要储存 Hexo 的用户,在 REPOSITORY NAME 处填上你想要储存 Hexo 的仓库,并勾选 Create private Git Repository 选项,这个选项是将该仓库设为私有仓库,对他人不可见。然后点击 Continue 按钮,然后什么都不需要修改,直接点击 Deploy,等待它自动完成构建,3 分钟之内完成,并分发一个免费的二级域名,可以暂时用于使用(不会回收,但不建议使用),构建完成如下图所示:

克隆到本地

在 Vercel 创建完成后打开 GitHub 刚刚创建的仓库,选择 Code,再选择 SSH,将里面的内容复制下来。

之后在自己电脑上新建个文件夹用于保存内容。在文件夹中打开 git bash。一定要在文件夹中打开。

输入:

1
git clone +刚刚复制的内容

按下回车键稍等一会即可看到已经将 GitHub 仓库的文件克隆到本地了。

配置本地仓库

我们刚刚只是将仓库的主要内容克隆下来,仓库运行所需的 npm 包在我们本地并没有,所以需要关掉刚刚的 git bash,进入刚刚克隆下的仓库之后打开命令提示符,输入:

1
npm install

稍等一会就能下载完,下载完后再次输入命令安装 hexo 推送插件:

1
npm install hexo-deployer-git --save

再输入下列命令在本地生成博客预览:

1
hexo s

出现下图内容证明所有所需已经配置完成,在本地打开 http://localhost:4000/就可以看到你的 Hexo 博客的本地预览。

在命令提示符中按 Ctrl+C 键即可关闭。

在命令提示符中输入下列命令就可以生成第一篇博客:

1
hexo new first

再次输入本地运行命令:

1
hexo s

再次打开 http://localhost:4000/即可看到第一篇文章已经生成成功。

按 Ctrl+C 键关闭本地预览。

在 Vercel 中打开自己的项目,然后再打开 Deployments,再点击网站域名就可以查看 DOMAINS 下的 Vercel 默认生成的域名,这个域名就是属于你的了,把此域名复制下来一会用。

再打开 Settings 找到 Build & Development Settings,选择 other,开关如下图所示即可。

填写完成后记得点击 Save

之后打开文件夹下的_config.yml 文件。

下表是 Site 的设置描述:

环境 描述
title 您网站的标题
subtitle 您网站的副标题
description 您网站的描述
keywords 您网站的关键字。支持多个值。
author 你的名字
language 您网站的语言。使用2 个字母的 ISO-639-1 代码或其变体(可选) 。默认为en
timezone 您网站的时区。Hexo 默认使用您计算机上的设置。您可以在此处找到可用时区的列表。一些示例是America/New_YorkJapanUTC

填完 Site 之后将自己刚刚复制的 Vercel 生成的域名赋值到 Url 后面。

修改完后如图所示: 在冒号后面要加一个空格再填入内容,否则会报错!!!

再往下进行,找到 external_link。

修改

1
2
external_link:
enable: true|false

1
2
3
4
external_link:
enable: true # Open external links in new tab
field: site # Apply to the whole site
exclude: ''

再滑到文件最底部修改 deploy:

1
2
3
4
deploy:
type: git
repository: git@github.com:GitHub名/GitHub仓库名.git
branch: main

如果不知道自己的 GitHub 名或者仓库名是什么的可以直接在自己的 GitHub 仓库名下根据下图所示复制后填到 repository 后。

修改完后如下图所示:

推送到 GitHub 仓库

在本地命令提示符下输入 Hexo 构建命令:

1
hexo g

再输入 Hexo 推送命令:

1
hexo d

如下图所示为推送成功!

再次打开我们网站就可以看到网页已经更新了。