hexo+github pages搭建博客踩坑记

jasminecjc

原本是看一了一篇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: git@github.com: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解决

    跑起来的博客页面如下:

图片描述

阅读 2.4k

jascheng的前端学习
前端学习路上的笔记和总结
952 声望
37 粉丝
0 条评论
952 声望
37 粉丝
宣传栏