什么是Hexo?
Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
本文将介绍如何在没有域名和云主机的情况下,使用Hexo
和Gitee
完成静态博客搭建。
环境介绍
- NodeJS(Node.js 版本需不低于 8.10,建议使用 Node.js 10.0 及以上版本,本文演示使用v12.16.1)
- Git
安装NodeJS
和Git
就不再介绍,大家可以自行安装或通过搜索引擎查找相关教程。
开始安装
1. 安装Hexo
$ npm install -g hexo-cli
如果安装过程慢,可以配置npm
淘宝镜像加速,或者直接指定淘宝镜像地址,如下命令
$ npm install -g hexo-cli --registry=https://registry.npm.taobao.org
安装完成后验证是否安装成功
$ hexo version
输出如下
hexo: 4.2.0
hexo-cli: 3.1.0
os: Darwin 18.7.0 darwin x64
node: 12.16.1
v8: 7.8.279.23-node.31
uv: 1.34.0
zlib: 1.2.11
brotli: 1.0.7
ares: 1.15.0
modules: 72
nghttp2: 1.40.0
napi: 5
llhttp: 2.0.4
http_parser: 2.9.3
openssl: 1.1.1d
cldr: 35.1
icu: 64.2
tz: 2019c
unicode: 12.1
2. 创建博客站点
通过Hexo
创建新的站点
$ hexo init test
$ cd test
$ npm install
安装完成之后即可启动预览
$ hexo s
访问localhost,可以看到实际效果
如果不喜欢默认主题,还有更多的主题,点击下载,可以按照说明安装新主题
3. 部署
站点搭建完成之后,接下来需要将网页部署到Gitee
,首先需要注册Gitee
账号,注册完成之后,创建新的仓库
注意仓库名称一定要与Gitee个人空间地址完全一致,否则会导致部署不成
查看个人空间地址
设置 -> 个人空间地址
仓库创建完成之后,修改项目根目录_config.yml文件
deploy:
type: git
repo:
gitee: git@gitee.com:xxx/xxx.git
将其中的个人空间地址替换成实际地址,注意将本地ssh公钥添加到Gitee
,否则可能导致推送失败,如果没有生成过SSH,自行搜索相关教程即可。
$ cat ~/.ssh/id_rsa.pub // Windows到用户根目录找该文件
将内容添加到
设置 -> SSH公钥
安装部署工具
$ npm install hexo-deployer-git --save
打包并推送到仓库
$ hexo clean
$ hexo g // g=generate
$ hexo d // d=deploy
推送成功之后,点击Gitee Pages
,勾选强制使用HTTPS,点击更新,等一分钟左右可以访问自己的主页了,主页地址是 xxx.gitee.io