Hexo 部署 Github Pages
之前已经完成了本地化的部署,本地化只能自己欣赏,如果想要分享知识给其他人就必须要发布发布到公网上,供各位小伙伴观摩学习提出宝贵意见。
可以白嫖的平台有Github pages
、Netlify
、Vercel
,这里使用的是GitHub pages
托管静态网页。
部署到 Github
准备工作
- 如果没有注册账号,请前往Github 注册一个自己的账号。
- 新建一个公开仓库,仓库名格式为
username.github.io
假如你的 Github 用户名为hexoxo
,那么你这个仓库地址应该是hexoxo.github.io
- 创建完成后,记下该仓库的 HTTPS/SSH 地址,格式一般为
https://github.com/hexoxo/hexoxo.github.io.git
复制下来,下一步会用到。
配置 Git
如果你只是本地化部署了,并没有配置过你的 Git 和 GitHub 进行联动,如果设置了可以跳过。那接下来就是设置 Git 用户名和邮箱,在 Git Bash
里执行两条命令设置你的 git name 和 email。
1 | git config --global user.name "user_name" |
user_name
代表你的用户名email@xx.com
代表你的邮箱地址
用户名和邮箱建议根据你注册的 Github 的信息来进行修改,避免出错。
如果本地想和 GitHub 握手连接,还需要一把钥匙。下来就进行生成密匙。
1 | ssh-keygen -t rsa -b 4096 -C "email@xx.com" |
生成的过程会有提示,直接按三次回车即可。
生成的 rsa 私钥和 pub 公钥会存放在 ~/.ssh
目录下面。
打开 GitHub settings , 再找到 SSH and GPG keys ,新建一个新的 SSH-点击SSH keys
- Title
自己随便填一个。
在 Git Bash
查看公钥文件
1 | cat ~/.ssh/id_rsa.pub |
将输出的内容,复制粘贴到 Key
里面,点击 add SSH key
进行保存。
接下来就是测试钥匙是否能打开 Github 的大门。
1 | ssh -T git@github.com |
如果出现你的 name,那就是成功了。类似下面的输出:
1 | Hi hexoxo! You've successfully authenticated, but GitHub does not provide access. |
安装 Hexo 依赖
1 | npm install hexo-deployer-git --save |
安装完毕后,打开 hexo 的配置文件 _config.yml
修改 deploy
的配置。
1 | deploy: |
repo
修改为自己的公开仓库地址。branch
修改为项目的分支地址,一般都是 main
完成之后,就测试部署上传。
1 | hexo g -d |
稍后就一会,可以在 GitHub 的项目地址看看是否上传了网页文件,有文件后,可以在浏览器打开 http://name.github.io
请将name
替换成自己的用户名,就可以看到你的博客啦。
开始编写
博客搭好了,就可以撰写文章了。下面简单写一下!
1 | hexo new post 'hello 我的小伙伴' |
这样就在 /soure/_posts
下找到名为hello 我的小伙伴文章了,撰写按照 Markdown 格式进行排版,语法还是很简单,花几分钟记一下格式就好了。
编写完成后,在 Git Bash
执行以下命令。
1 | hexo cl |
这样可以在本地进行预览,地址为 localhost:4000
,预览没有问题再进行部署到 Github 上。
1 | hexo d |
这样就可以进行远程部署了。
Pages 自定义域名
在你的目录找到 setting
- Pages
- Custom domain
- 输入你的自定义域名
- save
即可。
然后在域名的 DNS 系统,创建 cname 即可指向你的博客地址。
自定义域名有时候会莫名其妙的丢失,这个问题可以在仓库的根目录下创建一个CNAME
的文件,编辑内容为你的自定义域名。这样本地推送的时候就不会莫名其妙的丢失绑定的域名了。