Github+hexo搭建博客(填坑)

总算是决定动手搭博客了。。。

目录

  • 前言
    • 准备工作
    • 搭建过程
  • 填坑
    • 注册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
2
git config --global user.name "username"
git config --global user.email "email"

其中usernameemail是自己的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
2
cd blog
npm install

到此Hexo就安装完了。blog里文件的详细介绍可以看Hexo官方文档

2.5 配置Hexo

主要是修改./blog文件夹下的_config.yml文件里Deployment的配置:

1
2
3
4
deploy:
type: git
repo: git@github.com:yourname/yourname.github.io.git
branch: master

或者

1
2
3
4
deploy:
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官方文档,例如更换主题等。

转载请注明原博客地址

坚持原创技术分享,您的支持将鼓励我继续创作!