Github + Hexo 搭建博客踩坑指南

开博语

之前是用阿里云的服务器搭建博客，但学生优惠用完了，年费太贵，遂白嫖GitHub重新搭建博客。回顾之前的写作内容，深感个人输出能力极其欠缺，故借再开博客之机，重整旗鼓，用心写作，以练世事之洞察、情理之分析、表达之逻辑！

搭建博客中的坑

Github+Hexo的组合网上已有许多资料，我参考的是这份知乎高赞教程[1]，但在具体搭建过程中依然踩了不少坑，我将填这些坑的方案整理了一下，你如若也踩到了相似的坑，那也算是有缘~

  • 你需要再github上创建一个新repo，这个repo的名字是：用户名.github.io，一定得是你github的用户名
  • 配置git和hexo，见[1]
  • hexo d推送网站，需要输入你的用户名和密码，然后可能会出现如下问题：
    1
    Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
    这是由于github现在已经不支持username-passwd这套认证了，取而代之的是个人token认证
    解决方案是增添Windows普通凭据，参考[2]
  • 即使token配置成功了，hexo d仍会出现问题：
    1
    unable to access 'https://github.com/XXX/XXX.github.io.git/': Failed to connect to github.com port 443: Timed out
    这是墙的问题，解决方案就是全局proxy，参考[3]
  • 你推送网站成功了，但在浏览器上发现没啥变化，一点动静都没有。这很可能是github仓库的问题，推送的分支是master，但是github page上的是main分支。解决办法分两步：1. 进入repo->settings->pages，将source branch修改为master 2. 进入repo->settings->branches，修改默认分支为master（其实第2步可以不要）
  • 如果你有自己的域名想绑定，参考[1]，记住一定有CNAME文件，如果只在repo->settings->pages中设置custom domain，hexo d会刷新让其无效化
  • 嫌默认主题太丑，我更换了fluid主题[4]，想添加评论功能的话，参考[5]，想hexo new page XXX新建页，并在主页上显示的话，要在theme _config的menu下添加XXX

参考

  1. Github+Hexo搭建个人网站详细教程-知乎高赞-吴润 ↩
  2. github_token ↩
  3. 当Hexo部署遇到墙 ↩
  4. fluid主题 ↩
  5. utterance评论管理 ↩
  6. hexo_ssl_error ↩