Linux下使用hexo在Github Pages搭建博客

本文最后更新于:10 个月前

安装Git

需要git把本地博客提交到github
Ubuntu/debian: sudo apt-get update && sudo apt-get install git
Centos: sudo yum update && sudo yum install git

安装nodejs

因为hexo是基于nodejs的,所以要先安装nodejs才能用
Linux安装命令:

1
2
3
4
5
6
7
8
mkdir /opt
wget https://nodejs.org/dist/v16.14.2/node-v16.14.2-linux-x64.tar.xz
tar -xvJf node-v16.14.2-linux-x64.tar.xz
mv node-v16.14.2-linux-x64 /opt/node
rm -rf node-v16.14.2-linux-x64
ln -s /opt/node/bin/node /usr/local/bin/
ln -s /opt/node/bin/npm /usr/local/bin/
ln -s /opt/node/bin/npx /usr/local/bin/

安装hexo

这里使用npm安装hexo

1
npm install -g hexo-cli

初始化博客

1
2
3
hexo init blog
cd blog
npm install

这里的blog用来存放博客文件
执行完成之后运行hexo server,访问IP:4000就能看见你的博客了

修改配置文件

创建完成后,目录结构如下
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

网站的配置文件是_config.yml,你可以在里面设置网站的大部分信息。
主要的参数:

参数 描述
title 网站标题
subtitle 网站副标题
author 网站作者
url 网址,必须已http/https开头
permalink 具体参考这里

其他的参数也可以参考这里点我

新建文章

使用hexo new 'Hello world'可以在sources/_posts生成一个Hello-world.md的文件,在这个文件里就能写文章了。

上传博客到GitHub pages

连接github

  1. 执行ssh-keygen –t rsa生成秘钥
  2. 使用cat ~/.ssh/id_rsa.pub拿到公钥
  3. Github提交你的公钥
  4. 在Github创建一个名为username.github.io的仓库username为你的github用户名
  5. 在blog目录输入
1
2
git init
git remote add origin git@github.com:username/username.github.io.git

username改成你的GitHub用户名

  1. 再输入npm install hexo-deployer-git --save安装hexo-deployer-git
  2. 修改配置文件_config.yml
1
2
3
4
deploy:
type: git
repo: git@github.com:username/username.github.io.git
branch: gh_pages
  1. 执行 执行 hexo clean && hexo d -g即可生成网站文件并自动推送到github
  2. 打开username.github.io仓库的settings,转到Pages项,将Branch设置为gh_pages,保存。
  3. 此时浏览器打开username.github.io即可访问你的博客!

Linux下使用hexo在Github Pages搭建博客
https://blog.xzh.gs/2022/04/07/hexo-github_pages/
作者
XZH
发布于
2022年4月7日
更新于
2022年4月20日
许可协议