hexo+github pages搭建博客踩坑记

原本是看一了一篇5分钟搭建博客的文章，结果遇上各种坑花了三小时才搞定，事实证明解决问题一个不变的真理就是重装，再来一遍，本文的目的主要是先把博客放到github上可访问，先跑起来再说

前提

• github账户

• 本地安装git

• 本地安装nodejs

• 本地安装Hexo

  npm install hexo-cli -g

• 创建github仓库
  Respository name 中的username.github.io 的username 一定与你的github账号名 一致

• ssh方式连接github(此处有坑)
  方式看本文

• 项目目录下安装hexo-deployer-git(此处有坑)

编写，发布

1. hexo 初始化
   hexo init yourblog && cd yourblog

2. 选择主题
   主题页面,这一步没什么坑，选一个主题照着说明配置就行

3. 基础配置
   配置site下的字段和theme
   主要是配置deploy下的字段要小心

   • hexo3以后配置的type都是git，而且要注意空格的问题

   • repo选择仓库地址，前面我用ssh方式是因为原本我用的是https方式，此处用ssh的地址就行
     使用https方式的问题描述见此

   • branch的问题： 如果用master分支，仓库必须起名叫username.github.io，访问页面为https://username.github.io ，建议用master分支，我试过用gh-pages分支，结果404了，这个帖子有解释，我没有仔细研究gh-pages分支的问题，改为直接用master分支

   最终我的配置如下:

   deploy:
     type: git
     repo: [e-mail]:jasminecjc/jasminecjc.github.io.git
     branch: master

4. 编写新博客
   主要是照着source/_posts/hello-world.md里提示的步骤新建博客
   简单点就是新建博客，运行hexo s 端口号是4000，在本地查看无误之后就可以放到github上了
   直接运行hexo clean && hexo g && hexo d
   如果没什么问题，等成功你就可以打开username.github.io可以看到了
   这里遇到的坑主要是在执行 hexo d 后,出现 error deployer not found:github 的错误
   相关帖子如下,最终我是通过重装了hexo-deployer-git解决

   跑起来的博客页面如下：