hexo创建blog流程(2022.3)

发表于 | 分类于 |

在本人依据网上教程创建blog的流程中，由于npm的版本、教程的年代过于久远等问题，踩了不少坑，因此写这篇blog在记录下使用hexo创建blog的基本流程与容易踩到的一些坑

预警：因为本人懒得截图，故具体操作没有附图

1.准备工作

  1. 下载并安装nodejs、git，注册git账号
  2. 进入Windows的cmd界面，输入node -v与npm -v检查是否安装了node、npm
  3. 检查后，输入npm install hexo-cli -g来安装hexo(注意，安装失败是正常的，多试几次，还可以使用国内的cnpm，cnpm下载流程具体百度)（-g表示全局安装，若没有-g则表示安装在当前文件夹下，若有-g则表示安装在config的路径中，可通过npm config get prefix来查询，一般是有默认路径，不建议根据网上流程进行更改，更改涉及到环境变量的更改，本人亲历改了一晚上也改不对）
  4. 输入hexo -v检查是否安装上

2.开始创建

  1. 进入你的git页面，创建一个新的repository（注意要public），命名格式必须为（username.github.io)
  2. 如果是第一次使用git，需要获取你的ssh密钥，并进行绑定(网上有流程，不赘述)
  3. 创建一个新的空文件夹，在该文件夹内调用git bash，输入hexo init对该文件夹初始化
  4. 可以看到文件夹中多出了许多文件，打开_config.yml文件，滑到最下面找到deploy一栏，顾名思义，这就是管deploy的，在type一栏输入git；在repository一栏输入你的repository地址，在仓库页面中的code中可复制；在brach一栏中输入main（注意：输入时，输入内容与:之间有个空格，比如type: git)
  5. 保存编辑后，再次在blog文件夹内git bash，输入hexo g来创建页面，再输入hexo s来预览页面，命令行会返回一个地址，在浏览器内输入该地址即可看到页面
  6. 按Ctrl+c关闭该页面，接下来我们要将该页面推送到git上，以便于其他人也能浏览该blog
  7. 在命令行输入hexo d(注意，出现error是正常的，多试几次即可)，若成功，会弹出弹窗让你输入git账号，注意：先别输入，先打开你的git界面，settings—developer settings—personal access tokens—generate new token，来创建token，名字随意，权限最好全勾上（虽然用不了那么多），时间即该token有效期，超出期限后要重复上述步骤，获取该token后，复制下来。
  8. 在之前的弹窗内输入你的username，再次出现弹窗要求你输入密码，此时将之前的token粘贴进去
  9. 成功后，访问username.github.io即可访问你的博客

3.后续的一些小坑

  1. 若更换theme后，访问网页出现乱码，可能是因为5.0之后的hexo不自带swig，需要手动安装，即输入npm i hexo-renderer-swig ，再依次输入hexo clean、hexo g即可解决
  2. 依然是theme问题，在next的_config.yml中，menu一栏中的多出个空格导致页面无法正常跳转：将’/‘与’||’之间的空格删掉即可，如：home: /|| home