Hexo 从零开始(2)Hexo部署到 GitHub Pages
1. 注册 GitHub
1.1 打开GitHub官网注册github账号: https://github.com/
1.2 新建username.github.io
个人仓库:
方法一:打开网站https://github.com/new,直接新建,**(**下方的Add a README file
记得勾上)
方法二:在github
首页单击头像
->Your repositories
新建仓库,(下方的Add a README file
记得勾上)
-
仓库名为什么要命名为username.github.io?
GitHub Pages
有两种类型:User/Organization Pages
和Project Pages
,而我所使用的是User Pages
。简单来说,User Pages
与Project Pages
的区别是:User Pages
是用来展示用户的,而Project Pages
是用来展示项目的- 用于存放
User Pages
的仓库必须使用username.github.io
的命名规则,而Project Pages
则没有特殊的要求 User Pages
通过https://username.github.io
进行访问,而Projects Pages
通过https://username.github.io/projectname
进行访问
-
新建个人仓库图示
2. 配置GitHub连接密钥
2.1 设置用户名称和邮件地址
此处为全局配置,所以可以在任意位置打开**git bash
**,
git config --global user.name "Github用户名"
git config --global user.email "Github邮箱"
2.2 创建 SSH 密钥
为了能够在本地使用git
管理github
上的项目,所以需要绑定SSHkey
运行以下命令创建
ssh-keygen -t rsa -C "Github邮箱"
less ~/.ssh/id_rsa.pub
2.3 添加 SSH 密钥
打开GitHub,点击右上角头像
->Setting
->左侧 SSH and GPG keysNew SSH key
,点击下面书签直达也行
复制并填写SSH Key
,随便取一个title
,保存即可
2.4 验证SSH密钥连接
在git bash
测试sshkey
是否添加成功,运行如下命令,
**ssh -T git@Github.com**
-
图示
3. 配置hexo本地内容并进行部署
3.1 首先安装依赖
站点部署到github必须要配置Deployment依赖
npm install hexo-deployer-git --save
3.2 修改 _config.yml
配置文件
修改底部的deploy
项,2选一进行修改并保存
务必记得把username替换为自己的用户名,(2020年10月后github新建仓库默认分支改为main),注意修改
deploy:
type: git
repo:
github:
url: git@github.com:username/username.github.io.git
branch: main
deploy:
type: git
repo:
github: git@github.com:username/username.github.io.git,main
3.3 部署到Git仓库
输入下面Hexo3连命令,把本地hexo
博客内容提交到git
仓库
hexo clean && hexo generate && hexo deploy
hexo c && hexo g && hexo d
每次在本地推送完后,还要等待GitHub
反应过来部署到他家的服务器上
-
网页部署阶段可能出现的bug
报错
ERROR Deployer not found: git
git用户名和邮箱配置错误,这里的%
,在正确的格式中是一个空格
,如果你之前没有打空格,那么邮箱和用户名根本就没有记录进去。回退到这一步重新进行git config --global user.name%"username" git config --global user.email%"username@example.com"
hexo-deployer-git
插件没有安装正确,重新在[Blogroot]
路径下右键->Git Bash Here,执行:npm install hexo-deployer-git –save # 重新安装之后,再尝试提交 hexo deploy
3.4 预览博客效果
浏览器访问https://yourname.github.io
即可看到博客内容
4. 配置自定义域名(可选)
4.1 购买域名
4.2 解析域名
为了能够使用自己的域名访问我们的博客,打开你的云服务器后台,进行域名解析
4.2.1 添加A
记录
值为你的服务器IP
(ping useneme.github.io获取)
4.2.2 添加CNAME
记录
值为username.github.io
,全部指向你的GitHub Pages
域名
4.3 绑定域名
在[Blogroot]\source\
目录下新建CNAME
文件(注意不要有后缀名,就叫CNAME
即可,什么.txt
、.js
之类的后缀都不能有),在CNAME
文件中添加上你购买的域名,【当你在本地hexo d
的时候,Github
上的CNAME
就会消失】
打开你的Github
仓库->Settings
->Pges
,在下方的Custom domain
填上你的域名并保存
4.4 访问博客
最后,重新部署一下hexo
即可通过你的域名来访问博客了
hexo clean
hexo generate
hexo depoly
5. 安装 SSL 证书
没有安装SSL
证书时,你的网站使用的是HTTP
协议,连接没有加密,会显示为不安全
而安装了SSL
证书之后,网站使用的就是HTTPS
协议,连接会被加密,图标会变成一把锁
• 使用个人站点的话请移步『Linux』Nginx 配置 SSL 证书
•如果是Github Page
的话,勾选下面的Enforce HTTPS
就可以了,GitHub
过一会儿会给你弄好的
部署到个人站点或者Github Pages
后,就可以在_config.yml
中正大光明地写上你的网站地址了