Hexo博客搭建
发表于:2021-11-24 |

Hexo是个快速、简洁且高效的博客框架,它是一款基于Node.js的静态博客生成程序,作者是中国台湾tommy351。它的安装运行等甚至生成文章页面 生成目录,网站配置都是在爱代码模式下进行的。还有就是要学会使用Hexo,就得学会使用Git,并且对Git常用基础命令要有所了解,还有就是需要安装Node.js,这个软件是Hexo本地搭建必不可少的工具,值得一提的是Hexo博客可以部署到GitHub、Gitee、GitLab、Coding、七牛,都是完全免费的,可以让你实现免服务器,免域名搭建一个完整的博客。

Hexo官网:https://hexo.io

1. 安装Git

Git是目前世界上最先进的分布式版本控制系统,可以有效、高速的处理从很小到非常大的项目版本管理。也就是用来管理你的hexo博客文章,上传到GitHub的工具。

Windows:下载并安装 git:https://git-scm.com/download/win
对于中国大陆地区用户,可以前往 淘宝 Git for Windows 镜像 下载 git 安装包。

Linux (Ubuntu, Debian):sudo apt-get install git-core
Linux (Fedora, Red Hat, CentOS):sudo yum install git-core

2. 安装nodejs

Hexo是基于nodeJS编写的,所以需要安装一下nodeJs和里面的npm工具。

windows:打开nodejs:https://nodejs.org/en/download/ 选择LTS版本。

linux:安装完后,打开命令行

1
2
sudo apt-get install nodejs
sudo apt-get install npm

然后检查一下有没有安装成功

1
2
node -v
npm -v

3. 安装hexo

然后安装hexo,你可以先创建一个文件夹blog,在这个文件夹下的空白地方,右键git bash打开

1
npm install -g hexo-cli

然后初始化hexo,这个hexoblog可以随便填

1
hexo init hexoblog

用cd进入hexoblig里(或者直接打开这个文件夹,在空白地方右键 git bash打开 )

1
cd hexoblog

这个时候hexoblog文件夹里有指定文件夹目录下有:
node_modules: 依赖包
public:存放生成的页面
scaffolds:生成文章的一些模板
source:用来存放你的文章
themes:主题
_config.yml: 博客的配置文件
db.json:source解析所得到的
package.json:项目所需模块项目的配置信息

然后本地运行测试一下

1
2
hexo generate
hexo server

hexo generate 顾名思义,生成静态文章,可以用 hexo g缩写
hexo server 顾名思义,启动服务 本地运行,可以用 hexo s缩写

在浏览器输入 localhost:4000 就可以看到你生成的博客了。

使用ctrl+c可以把服务关掉。

4.在GitHub创建一个放博客文件的仓库

GitHub官网:https://github.com/

没有账号的注册一个,登录后,点击右上角New repository

创建一个和你用户名相同的仓库,后面加.github.io,只有这样,将来要部署到GitHub page的时候,才会被识别,也就是xxx.github.io,其中xxx就是你注册GitHub的用户名。我这里是已经建过了。点击create repository。

5. 生成SSH添加到GitHub

在博客根目录 右键点击 Git Bash Here

输入命令

1
2
git config --global user.name "yourname"
git config --global user.email "youremail"

yourname输入你GitHub用户名,youremail输入你GitHub的邮箱。(在双引号里面输入,双引号别删)

检查一下你有没有输对

1
2
git config user.name
git config user.email

输入下面命令( youremail 是GitHub邮箱)创建SSH ,然后一路回车

1
ssh-keygen -t rsa -C "youremail"

在你的C盘中找到这个文件夹。打开 id_rsa.pub

其中,id_rsa是你这台电脑的私人秘钥,不能给别人看的,id_rsa.pub是公共秘钥,可以随便给别人看。把这个公钥放在GitHub上,这样当你链接GitHub自己的账户时,它就会根据公钥匹配你的私钥,当能够相互匹配时,才能够顺利的通过git上传你的文件到GitHub上。

点击GitHub的右上角setting中 -> 点击左边SSH and GPG keys -> 点击New SSH key
title随便填,把C盘的id_rsa.pub里面的信息复制到key里。



回到git bash中,查看是否成功

1
ssh -T git@github.com

这个时候要输入一次yes,然后再回车

6. 将hexo部署到GitHub

打开站点配置文件 _config.yml,拉到最后,修改为
1422756921就是你的GitHub账户

1
2
3
4
deploy:
type: git
repo: git@github.com:1422756921/1422756921.github.io.git
branch: main

注意:现在GitHub的默认分支已经是main了,不是master !!!!

这个时候需要先安装deploy-git ,也就是部署的命令,这样你才能用命令部署到GitHub。

1
npm install hexo-deployer-git --save

然后

1
2
3
hexo clean
hexo g
hexo deploy

其中 hexo clean清除了你之前生成的东西
hexo deploy 部署文章,可以用hexo d缩写

输入hexo deploy之后会出现一个小弹窗,要你输入GitHub的username和password。(用户名是邮箱)

过一会儿就可以在https://1422756921.github.io 这个网站看到你的博客了!

关于站点文件配置请参考官方文档:https://hexo.io/zh-cn/docs/configuration.html

上一篇:
利用Github Actions自动化部署 Hexo博客
下一篇:
把博客从GitHub迁移到Gitee