Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
GitHub Pages 是由 GitHub 官方提供的一种免费的静态站点托管服务,让我们可以在 GitHub 仓库里托管和发布自己的静态网站页面。
Hexo 基于 Node.js,搭建过程中还需要使用 npm(Node.js 已带) 和 git,因此先搭建本地操作环境,以 Linux 操作系统为例,安装 Node.js 和 Git。
从官网下载 Node.js 长期维护版安装包 , 例如:node-v16.14.2-linux-x64.tar.xz
新建~/software文件夹,解压 Node.js 安装包文件到~/software文件夹下
$ mkdir ~/software
$ tar -Jxf node-v16.14.2-linux-x64.tar.xz -C ~/software
$ mv ~/software/node-v16.14.2-linux-x64 ~/software/nodejs
$ sudo ln -s /home/username/software/nodejs/bin/npm /usr/local/bin/
$ sudo ln -s /home/username/software/nodejs/bin/node /usr/local/bin/
$ node -v
v16.14.2
$ npm -v
8.5.0
$ sudo apt-get install git
$ git --version
git version 2.20.1
$ npm install -g hexo-cli
$ sudo ln -s /home/username/software/nodejs/bin/hexo /usr/local/bin/
$ hexo -v
hexo: 6.2.0
hexo-cli: 4.3.0
os: linux 5.17.3-amd64-desktop Deepin 20.6 20.6
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
官方强烈建议安装最新版本的 Hexo,以及推荐的 Node.js 版本。
$ npm update -g hexo-cli # 升级 hexo 软件到最新版
软件兼容适配表
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 |
在家目录创建个人博客文件夹 blog_folder
mkdir ~/blog_folder
$ cd ~
$ hexo init blog_folder # 初始化博客目录文件
$ cd blog_folder # 进入博客目录
$ npm install # 安装程序组件
$ hexo generate # 生成静态文件
$ hexo server # 启动网站服务
使用浏览器访问 http://localhost:4000 ,出现 Hexo 默认页面,代表本地博客安装成功了
注意:如果出现页面加载不出来,可能是默认端口被占用了,
终端执行快捷键 Ctrl+C 关闭服务器,重新运行 hexo server -p 6000 更改端口号,
重新使用浏览器访问 http://localhost:6000 ,查看是否出现 Hexo 默认页面。
进入 github 的官网:https://github.com/ 在主页“Email Address”处输入自己的邮箱,然后点击“Sign up for Github ” 按钮,输入将来登录Github的密码,注册属于自己的帐号。
注意:
1、用户名:起名字要慎重,建议用有自己特色、简单易记不重复的,它将决定你博客的网络地址、仓库名称等。
2、电子邮箱地址:不要乱填,填写你真实的常用邮箱,注册时Github是要发激活链接到你邮箱的。
3、用户密码:不少于8个字符( 包括数字和字母),输入完会有一个人机验证,你只需把图片矫正即可。4、账户类型:选择个人免费版。
5、问卷调查:选择你感兴趣的信息。
6、验证邮箱:登录注册邮箱,完成帐号激活。
$ git config --global user.name "GitHub 用户名"
$ git config --global user.email "GitHub 邮箱"
$ sudo apt install ssh # 安装软件
$ ssh-keygen -t rsa -C "GitHub 邮箱" # 创建密钥,然后一路默认回车
$ ls ~/.ssh
id_rsa id_rsa.pub
$ vim ~/.ssh/id_rsa.pub
$ ssh -T [email protected]
出现 “Are you sure you want to continue connecting ? ”,输入 yes 回车确认,
最后显示 “Hi username ! You've successfully authenticated……” 即连接成功。
由于 github 在 2021 年 8 月 13日将原有的用户密码验证方式替换成了"personal access token",因此我们这里需要将用户密码替换成"personal access token",用于部署Hexo 到 GitHub Pages 时验证用户身份。
$ git clone https://github.com/username/repo.git
Username: your_username
Password: your_token
本地博客测试成功后,就是上传到 GitHub 进行部署,使其能够在网络上访问。
$ cd ~/blog_folder
$ npm install hexo-deployer-git --save
deploy:
type: git # 部署类型
repo: https://github.com/<username>/<project> # 仓库地址
# example, https://github.com/shallingzhang/shallingzhang.github.io
branch: main # 分支名称
$ cd ~/blog_folder
$ hexo clean # 清除缓存
$ hexo generate # 生成页面
$ hexo deploy # 上传部署