搭建博客遇到的小问题和解决办法

记录下搭建博客遇到的一些小问题，以防再次遇到又要去搜索。

npm install 安装慢/失败

npm 默认镜像源是国外的，所以国内网络环境使用会非常慢甚至经常失败。

使用以下命令更换镜像源为淘宝镜像：

npm config set registry https://registry.npm.taobao.org

切换回原镜像：

npm config set registry http://registry.npmjs.org

查询当前使用的镜像源：

npm config get registry

缺少module

配置博客过程中遇到了两次错误提示如下：

Error: cannot find module 'js-yaml'
Error: cannot find module 'Hexo-util'

使用 npm 安装即可，命令如下：

npm install js-yaml
npm install Hexo-util

镜像源管理

使用以下命令：

npm install -g nrm

然后使用 nrm ls

可以查看可以切换的镜像源，以及现在使用的镜像源（标*的为现在使用的镜像源）

  npm ---------- https://registry.npmjs.org/
  yarn --------- https://registry.yarnpkg.com/
  tencent ------ https://mirrors.cloud.tencent.com/npm/
* cnpm --------- https://r.cnpmjs.org/
  taobao ------- https://registry.npmmirror.com/
  npmMirror ---- https://skimdb.npmjs.com/registry/

切换需要的镜像源 nrm use XXX

永久链接

使用 abbrlink 设置文章永久链接

安装 npm install Hexo-abbrlink --save

修改博客根目录下的 config.yml 文件

url: 博客地址
permalink: posts/:abbrlink/
abbrlink:
    alg: crc16   
    rep: dec     
permalink_defaults:
pretty_urls:
  trailing_index: true # Set to false to remove trailing 'index.html' from permalinks
  trailing_html: true # Set to false to remove trailing '.html' from permalinks

更详细的介绍见 abbrlink 。

Hexo d失败

终于最后一步了，结果 Hexo 报错嘞😶‍🌫️

检查 SSH ✅

检查下 config.yml ✅

deploy:
   type: git
   repository: https://github.com/{yourname}/{yourname}.github.io
   branch: master

搜索了一圈，可能是 Git 协议问题，修改为以下格式。

deploy:
   type: git
   repository: git@github.com:{yourname}/{yourname}.github.io.git
   branch: master

万事俱备

一键三连 Hexo clean && Hexo g && Hexo d

🚀🚀🚀

蛋不肉damn bro

我的 CNAME 和 README 没了😶‍🌫️，每次执行 Hexo d 会丢失，把 CNAME 和 README 文件放在本地博客根目录下的 source 文件夹内。然后发现 README 文件被转换成了 HTML 文件。

所以需要 README 文件不被解析转换。

打开博客根目录下的 _config.yml 找到 skip_render

**增加 README.md**即可

skip_render: README.md

万事俱备

一键三连 Hexo clean && Hexo g && Hexo d

🚀🚀🚀🚀🚀🚀