目录
- 前言
- 准备工作
- 搭建过程
- 填坑
- 注册Github
- 创建仓库
- 配置SSH key
- 安装Hexo
- 配置Hexo
- 发布文章
- 其他
1. 前言
搭博客前观望了很久,想来想去最后还是用了Github,不得不说用Github搭真的非常方便。要准备的东西不多,仅仅需要Github账号,Git客户端还有Node.js。网上有非常详细的搭建过程,这里就不详讲了,仅简单说下过程然后贴上我参考的博客:手把手教你用Hexo+Github 搭建属于自己的博客。
1.1. 准备工作
1.2. 搭建过程
- 注册Github
- 创建仓库
- 配置SSH key
- 安装Hexo
- 配置Hexo
- 发布文章
2. 填坑
2.1. 注册Github
按照提示慢慢来就好,注册完后默认公开邮箱,如果想要隐藏自己的邮箱的话点自己头像找到Settings点进去。找打Emails选项,找到Keep my email address private
并打勾,Block command line pushes that expose my email
前面的勾取消,不取消的话会在部署的时候阻止部署并提示你的邮箱是private需要改成public等等。(神烦,找了一晚上才找打这个问题)
- Keep my email address private
- Block command line pushes that expose my email
2.2 创建仓库
唯一需要注意的是仓库名严格按照yourname.github.io
格式,其中yourname
是自己的username,其他默认就行。
2.3 配置SSH key
注意要正确配置好SSH key防止部署Hexo时报错。
Bash下输入:1
2git config --global user.name "username"
git config --global user.email "email"
其中username
与email
是自己的Github用户名与邮箱。然后输入:1
ssh-keygen -t rsa -C "email"
然后一路默认就好,最后将生成的公匙添加到github上。其他的详情见Connecting to GitHub with SSH。
2.4 安装Hexo
可能最麻烦的步骤就是这里了,因为官方源非常慢,经常下载一半停止,强行退出后需要强制清理下缓存:1
npm cache clean --force
更改源:1
npm config set registry "https://registry.npm.taobao.org"
安装Hexo官方文档步骤安装:1
npm install -g hexo-cli
打开你要放博客的位置初始化Hexo:1
hexo init blog
该命令在当前路径下创建一个blog文件夹并在内完成初始化。进入blog文件夹安装Hexo扩展:1
2cd blog
npm install
到此Hexo就安装完了。blog里文件的详细介绍可以看Hexo官方文档。
2.5 配置Hexo
主要是修改./blog
文件夹下的_config.yml
文件里Deployment
的配置:1
2
3
4deploy:
type: git
repo: git@github.com:yourname/yourname.github.io.git
branch: master
或者1
2
3
4deploy:
type: git
repo: https://github.com/yourname/yourname.github.io.git
branch: master
前者为SSH形式,后者为https形式。
2.6 发布文章
首先安装扩展,防止发布文章时报错:1
npm install hexo-deployer-git --save
用以下命令部署Hexo:1
hexo clean && d -g
第一次部署可能会让你登录Github,如果Github里设置了邮箱隐藏而且Block command line pushes that expose my email
前面的勾未取消会导致部署被阻止。
发布文章1
hexo new post "article"
在./source/_posts
路径下将会看到article.md
文件。编辑完该文件后需要重新部署:1
hexo d -g
3. 其他
其他一些Hexo用法可以参照Hexo官方文档,例如更换主题等。
转载请注明原博客地址