前言

这篇文章讲的是基础中的基础部分,哪怕你搭建博客用的不是 Butterfly 主题,也是能看的,这也是我把它归到第0篇的原因。

本文主要讲述的有:

  • Hexo的环境搭建(Npm)
  • Hexo 安装及初始化
  • Git安装&Github账号注册
  • Git本地配置&Hexo源代码仓库连接远程
  • Hexo部署Githubpages

因为讲的东西比较多,根据篇幅个人可能会分成几篇分开的文章来讲,主要还是不想文章篇幅过长,看的也累。

那么,要说的闲言碎语说完了,我们开始吧。


Hexo 环境搭建

Hexo 是一个博客搭建的框架,而作为框架,自然也需要所需的环境——Nodejs。

在官方文档[1]中,给出了不同版本Hexo所需最低兼容的Nodejs版本:

Hexo 版本最低兼容 Node.js 版本
6.0+12.13.0
5.0+10.13.0
4.1 - 4.28.10
4.08.6
3.3 - 3.96.9
3.2 - 3.30.12
3.0 - 3.10.10 or iojs
0.0.1 - 2.80.10

不过这个对于你来说是没什么问题的,毕竟下都是下的最新版本的,除非版本迭代速度过快

在我也不知道有多久之前,Npm跟Nodejs是分开的,你得两个单独下,不过现在,Nodejs里面包含了Npm,所以只要下一个就行了。

下载链接-国内:下载 | Node.js 中文网 (nodejs.cn)

下载链接-国际:下载 | Node.js (nodejs.org)

到上面任意一个下载链接选择合适版本下载安装就行,一路跟着默认配置就好了。

当然,你也可以安到除C盘以外的其他盘,不过需要额外的配置,回头有时间我会把这部分拿出来写篇文章,毕竟个人的Node就是安在E:\Code\Environment\下面的

验证的话,打开命令行输入以下命令:

node -v
npm -v

看有没有返回版本,比如我的就是:

$user>node -v
v16.14.2

$user>npm -v
8.7.0

有返回值就是安装成功,可以执行下一步了。

没有的话自己查一下好了,我也不是万能的。


Hexo 安装及初始化

有了Npm就方便多了,安装Hexo脚手架只需要一行[2]:

npm install hexo-cli -g

轻轻松松搞定。

验证的话,跟上面的类似,随便找个命令行输入:

hexo -v

看返回值就行,比如个人就是:

$user>hexo -v
hexo-cli: 4.3.0
os: win32 10.0.19044
node: 16.14.2
v8: 9.4.146.24-node.20
uv: 1.43.0
zlib: 1.2.11
brotli: 1.0.9
ares: 1.18.1
modules: 93
nghttp2: 1.45.1
napi: 8
llhttp: 6.0.4
openssl: 1.1.1n+quic
cldr: 40.0
icu: 70.1
tz: 2021a3
unicode: 14.0
ngtcp2: 0.1.0-DEV
nghttp3: 0.1.0-DEV

上面的是全局安装,你也可以单独拿一个文件夹出来npm install hexo安装,不过检查效果就需要在该文件夹内打开命令行来检查了。

个人的建议是按个全局的脚手架,理由嘛,喜新厌旧算不算?

然后就是站点初始化,有两种方式:

  • 新建空白文件夹,文件夹命名随意,建议不要用中文,然后打开文件夹,打开命令行,输入以下内容即可:

    hexo init

    则该文件夹即为站点根目录。

  • 直接打开命令行,输入下列内容:

    hexo new [siteRoot]

    上面的[siteRoot]随意,于是你会发现多了个[siteRoot] 的文件夹,则该文件夹即为站点根目录。

    然后Hexo三连:hexo clhexo ghexo s,看终端输出的地址,一般而言都是localhost:4000,就可以在那边预览效果了。

在不考虑部署的情况下,其实本地已经可以安装主题并进行相应修改预览了,不过这部分内容我放到后面再讲。


Git安装&Github 账号注册

Git是一个开源的分布式版本控制系统,用于敏捷高效地处理任何或小或大的项目[3]。**GitHub[4]**是一个面向开源及私有[软件项目的托管平台,因为只支持Git作为唯一的版本库格式进行托管,故名GitHub。

Github账号注册在这里:>>点此链接进行注册<<

另:谢谢米游社官方帖给我的链接灵感

Git安装就比较麻烦一点了,不过也没有麻烦多少。

Git - Downloads (git-scm.com)这里选择你要下载的版本,然后一直按next就行,也就没有什么其他需要的配置。

如果你需要把Git安装到其他盘(默认C盘)的话,还得配置环境变量,这个以后有空再补充吧。

然后打开终端,输入以下命令查看返回值:

git --version

比如我这边返回的就是:

git version 2.36.0.windows.1

这样就说明你安装成功了。


Git本地配置&源代码仓库连接远程

Git本地配置主要还是配置ssh key。

右键打开Git bash,输入如下代码:

git config --global user.name "BTMuli"
git config --global user.email "BT-Muli@outlook.com"
ssh-keygen -t rsa -C "BT-Muli@outlook.com"
# 连按三次回车即可
cd ~/.ssh
cat id_rsa.pub

内容复制,添加到 Github 上。

测试连接:

ssh -T git@github.com
# 输入 yes

终端输入如下文字说明链接成功:

Hi BTMuli! You've successfully authenticated, but GitHub does not provide shell access.

然后就是源代码仓库连接远程了,这边建议直接本地创建仓库然后推送到远程,个人也是采用的这种方式,还有一种远程创建然后连接本地的个人试过没有成功,感兴趣的可以查查其他文章。

首先初始化仓库:git init

然后就是提交变更,编辑远程,编辑分支,推送。

方便快捷

感谢Jetbrains的Webstorm的Git上的支持。


Githubages部署

施工中...


  1. 文档 | Hexo ↩︎

  2. Hexo ↩︎

  3. Git 教程 | 菜鸟教程 (runoob.com) ↩︎

  4. Github_百度百科 (baidu.com) ↩︎