hexo 搭建的坑

hexo 搭建过程踩坑

页面没有 css 样式

复现：按照官网给出的快速开始，依次执行

npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server

即可稳定复现，打开的页面没有 css 样式，全是默认 html 元素的样子。

尝试以下方案均无效：

• 删除 node_modules 文件夹，重新 npm install
• 更新 hexo-cli
• 删除整个项目，重新 hexo init

解决：项目目录的路径出现了 # 符号，更改其他路径即可。问题非常隐蔽，翻的 github issues 最后有一条提到了

安装主题后无法显示 tags 和分类

• 新建一个标签页面 hexo new page tags
• source 文件夹下有了 tags\index.md 打开 index.md
• 修改 index.md 文件

---
title: "tags"
type: tags
---

• 新建一个分类页面 hexo new page categories
• source 文件夹下有了 categories\index.md 打开 index.md
• 修改 index.md 文件

---
title: "categories"
type: categories
---

上传图片

按照文档打开 post_asset_folder 后，所有的图片链接都会被加上 /.com/ 的前缀，形成类似 /.com//test.jpg 这样的链接，直到目前无法定位问题，顾关闭 post_asset_folder，手动管理图片。

按照文档使用 {% asset_img path.jpg %} 后，无效，此图片不会被显示，也不出现图片错误的图标。

解决方案：

在 source 文件夹下新建一个文件夹 images，将图片放入文件夹内，在 post 文件夹下新建一个图片的 md 文件，将图片的链接改为 /images/test.jpg，即可正常显示图片。

images 目录可以嵌套，规则和静态文件托管一致。

deploy 时出现 error: RPC failed； HTTP 400 curl 56

设置 git 的缓存

git config --global http.postBuffer 524288000