前言
这篇文章讲的是基础中的基础部分,哪怕你搭建博客用的不是 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.2 | 8.10 |
4.0 | 8.6 |
3.3 - 3.9 | 6.9 |
3.2 - 3.3 | 0.12 |
3.0 - 3.1 | 0.10 or iojs |
0.0.1 - 2.8 | 0.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 cl
、hexo g
、hexo 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上的支持。