hexo+github搭建个人博客

本文介绍hexo+github搭建个人的免费博客,由于网上的教程都太早了,有许多的改动,我自己在搭建的过程中踩了不少坑,在此记录一下。

什么是hexo? Hexo是一款基于Node.js的静态博客框架,可以deploy到Github上。我们首先需要安装Node.js, git, hexo.配置好本地博客之后需要注册Github账户并创建库。

Node.js

进入Node.js官网下载适合自己系统的版本并安装。
Node.js下载官网

Node.js下载界面

  • Windowsd 的话直接下载双击安装
  • Linux 下载对应的版本后是一个压缩文件

我下载的是64位

1
2
3
wget https://npm.taobao.org/mirrors/node/v10.5.0/node-v10.5.0-linux-x64.tar.xz
tar -xvJf node-v10.5.0-linux-x64.tar.xz
mv node-v10.5.0-linux-x64 node

配置环境变量

1
2
mv node/ /usr/local/
vim ~/.profile

增加下面内容

1
2
export NODE_HOME=/usr/local/node   	  #node路径 
export PATH=$NODE_HOME/bin:$PATH

更新配置

source ~/.profile
测试是否配置正确

node -v

配置正确截图

到此为止我们的Node.js就配置好了


下载安装git并配置环境

Windows用户 进入管网进行下载安装,安装时注意选择”Use Git from the Windows Command Promot” 即可.

git下载官网

Linux 用户一般系统就会默认安装Git

如果没有安装则用命令安装即可

Ubuntu系

sudo apt install git

Centos系

sudo yum install -y git

安装好后查看版本

git --version

正确配置后的版本截图
git设置用户名和邮箱

1
2
3
4
#将此处的“yourname”替换成自己的用户名
git config --global user.name "yourname"
#将此处的“youremail”替换成自己的邮箱
git config --global user.email "youremail"

查看配置的用户名和邮箱
git config -l
生成SSH Key
ssh-keygen -t rsa -C "youremail@example" #将邮箱换成自己的

一路回车之后就生成了自己的SSH Key。默认保存在用户主目录的.ssh目录下。.ssh目录下有 id_rsaid_rsa.pub 两个文件。这两个就是SSH Key的秘钥对。id_rsa 是私钥,id_rsa.pub 是公钥。


安装hexo

  • npm更换淘宝源

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

配置成功后可通过如下命令来验证是否成功。

npm info express
或者

npm config get registry

  • 新建一个文件夹hexo,进入并执行命令
1
2
npm install -g hexo-cli
npm install hexo-deployer-git --save

查看成功安装的版本

hexo -v

hexo版本

  • 新建一个文件夹 blog 用来存放博客

进入blog 并执行命令

1
2
hexo init
npm install

之后你的目录大概就是这样

目录

  • 启动hexo
1
2
hexo g
hexo server -p 8000

打开浏览器输入 localhost:8000 就可以看到页面啦

  • hexo 常用命令
1
2
3
4
5
6
hexo init #初始化
hexo n "文章标题" == hexo new "文章标题" #写文章
hexo g #生成静态网页
hexo s = hexo server #启动服务预览
hexo server -p 8000 #更改端口号
hexo clean #清理生成的静态文件

配置Github

  • 注册Github

点击Github官网,进去注册自己的账户

Github官网

  • 新建库,名字为 : xxx.github.io #xxx为你的用户名

新建库

注意更改名字

新建库

进入刚刚建好的库找到setting

setting截图

下拉 找到 Github Pages 开通github pages

Github Pages截图

  • 添加SSH Key

找到之前生成的SSH Key 的公钥 id_rsa.pub

登录Github,打开“Account settings”,“SSH Keys”,将 id_rsa.pub 的内容添加进去。

ssh_key

添加之后测试是否可以连接上

ssh -T git@github.com

成功连接就会得到类似于截图的提示

测试ssh连接截图


将博客推送到Github上

  • 配置主配置文件

deploy配置

如图,将 repo 位置处填上刚刚的库地址.在刚刚的库里面的 Clone or download 可以复制自己的库地址。

注意!! 配置文件里 : 后面有一个空格

库地址

保存退出后在博客目录下执行如下命令。

hexo clean

hexo g

hexo d

使用 hexo d 命令,第一次会要求你输入用户名和密码,用户名和密码就是你注册 github 时候使用的用户名和密码。

如果没有报错,则博客已经搭建起来了。进入浏览器输入 yourname.github.io 就可以看你的博客了。

最后欢迎大家访问我的博客: 徐先生的小窝

------本文结束感谢阅读------