前言

寒假封城,只能呆在家里鼓捣电脑,有一天看到了 b 站大佬CodeSheep手把手教你从 0 开始搭建自己的个人博客 |无坑版视频教程| hexo,看了之后着手搭建了属于自己的博客。
视频里博客是搭建在 Github 上的,但其终究是国外的网站,访问速度得不到保障。推荐使用 Gitee,Gitee 类似于国内的 Github,访问速度没问题。

环境要求

  • Windows 系统电脑(Mac 用户可以参考上面的视频)
  • Git
  • Node.js

安装 Git

因为我们要用到Git中的Git Bash,类似于 Windows 的 cmd 命令行,不过要好用许多(我开始是用 cmd 按视频的步骤来的,运行命令容易报错)。

  • 下载地址
  • 安装步骤:双击下载好的 exe 文件,一路点击 next 就好了
  • 安装完成之后打开 Git Bash,输入git version查看版本:(我这里安装的版本是 2.23.0)
1
2
$ git version
git version 2.23.0.windows.1
  • 能看到版本号就说明你安装成功了,之后的命令都是在这里运行的

安装 Node.js

Hexo是基于Node.js制作的静态博客,我们要用到 Node.js 里面的npm(node package manager)包管理器来安装插件,如果你想玩 Hexo 博客,那么这个 Node.js 是必装的。

  • 下载地址(选择自己电脑版本相对应的包来下载)
  • 安装步骤:双击下载好的 msi 文件,也是一路下一步就好了
  • 安装完成后打开 Git Bash,输入node -vnpm -v查看 node 和 npm 的版本:
1
2
3
4
5
$ node -v
v12.14.1

$ npm -v
6.13.4
  • 到这里前置步骤就已经算完成了,接下来我们就来安装 Hexo 博客

安装 Hexo

安装Hexo,我们需要借助npm这个工具来安装,但是我们国内下载镜像源的速度很慢,所以我们可以先利用 npm 工具来安装一个cnpm工具(国内的淘宝 npm 镜像源),这样一来速度会快很多。

  • 安装 cnpm:(安装完之后照样可以用cnpm -v来查看版本号验证是否成功)
1
$ npm install -g cnpm --registry=https://registry.npm.taobao.org
  • 用 cnpm 安装 Hexo
1
$ cnpm install -g hexo-cli
  • 接着用Hexo -v来验证是否安装成功
1
2
3
4
$ hexo -v
hexo-cli: 3.1.0
os: Windows_NT 10.0.17134 win32 x64
node: 12.14.1

如果出现以上信息,那么恭喜安装成功了

  • 到这里 Hexo 博客已经算是安装完成了,步骤还是非常简单的,重点是耐心~

初始化 Hexo

在你的电脑上建一个文件夹,命名没有要求,我这里创建的是 blog,文件夹路径也无所谓,最好装在出了系统盘的固态硬盘中,路径要自己找得到。

  • 在创建的文件夹目录下右键选择Git Bash Here,也就是在此处打开 Git Bash 终端
  • 输入 Hexo 初始化命令
1
$ hexo init

这个命令执行需要一定的时间,请耐心等待

  • 初始化完成之后可以查看指定文件夹目录下有:
    • node_modules: 依赖包
    • public:存放生成的页面
    • scaffolds:生成文章的一些模板
    • source:用来存放你的文章
    • themes:主题
    • _config.yml: 博客的配置文件
  • 打开 Hexo 服务
1
2
3
$ hexo s
INFO Start processing
INFO Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

这样你就可以再浏览器输入:localhost:4000 来访问你的博客啦,使用 Ctrl+C 可以关闭服务。
大概是这样:

  • 用 Hexo 写一篇博客
1
2
$ hexo n "我的第一篇博客"
INFO Created: E:\bolg\source\_posts\我的第一篇博客.md

到 E:\bolg\source_posts 目录下打开我的第一篇博客.md 进行编辑(推荐用 vscode 进行编辑,vscode 有预览 md 文件的插件):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
---
title: 我的第一篇博客
date: 2020-02-03 21:16:52
tags:
---

## 第一章

内容

---


## 第二章

内容

---

## 参考资料


https://ouwen.gitee.io

注意:这里的 md 文件是基于markdown语法进行编辑的,不了解的朋友可以百度学习一下,很简单的,几分钟就能看明白,相信你不是问题。

  • 编辑完保存文件,重启 Hexo 服务
1
2
3
$ hexo clean          # 清除所有记录
$ hexo generate # 生成静态网页 简写:hexo g
$ hexo server # 启动服务 简写:hexo s

打开浏览器输入 localhost:4000:

将博客部署到 Gitee 上

上面访问的 localhost:4000 是本地服务器端口,我们的博客不可能是放在本地服务器的,我们需要把博客部署到远端去。我这里推荐的一个免费的部署的方式就是部署到Gitee上,部署好之后就可以通过访问Gitee上的那个地址来访问我们的博客。

  • 进到Gitee官网,注册账号并登陆
  • 点击个人主页右上角新建个人仓库

  • 创建完成后进入仓库

  • 打开 Hexo 的配置文件_config.yml
1
2
3
4
deploy:
type: git
repo: https://gitee.com/ouwen666/test.git #仓库的url
branch: master
  • 这里先安装一个 Hexo 插件
1
2
3
4
5
cnpm install hexo-deployer-git --save  #通过cpnm安装git插件
git config --global user.email '******@qq.com' #设置gitee邮箱(gitee的注册邮箱)
git config --global user.name '****' #设置用户名(gitee的y注册昵称)
hexo d #上传到gitee的远端仓库
# 在上传时,需要再次输入gitee的用户名username和密码password
  • 上传成功仓库会多出一些文件

  • 接着打开 Gitee Page 服务

然后点击启动或更新即可。注意每次更改网页重新上传到仓库都要到这里来更新服务。

  • 访问 Gitee Page 服务的网站地址

从图中地址栏中的网址可以看出我们已经成功将本地的博客部署到了远端仓库,这样你的小伙伴也能在自己的电脑访问你的 Gitee Page 服务网站看到你的博客啦。

总结

Hexo 博客搭建总的来说还是比较简单的,搭配 Gitee 码云使用起来还是比较方便的,访问速度也还行。总结下面几点:

  1. Hexo 博客个性化定制的话,大家可以多参考 Hexo 官方中文文档
  2. 更新完代码可以访问 localhost:4000 预览效果再上传,上传后千万记得更新 Gitee Page 服务,否则刷新页面会出现没更新的情况
  3. Hexo 还支持很多主题,有兴趣的小伙伴可以自行搜索更改,参照官方文档进行操作也是不难的哦
  4. 小伙伴们注意将自己写的代码保存好哦!我是将代码备份到 Github 上保存的,将博客部署到 Gitee 码云进行访问