关于Hexo搭建的一些坑

引入

今天完成了Hexo博客的搭建，在搭建过程中有一些坑这里记录一下。

永久链接

permalink 中的 :id 默认是随机生成的乱码 超级长 和Wordpress完全不同

所以设置了 :id 后 每篇文章需要在顶部加上 id: 值，以进行区分

私有化部署

deploy 时需要先使用 npm install hexo-deployer-git --save 安装 hexo-deployer-git 后运行 hexo clean && hexo deploy

若不希望除页面以外的其他内容上传到Github的应使用私有化部署。

自定义404错误页

上传一个404.html到 hexo的source目录即可实现自定义404错误页面.

本地测试

执行 hexo g 生成最新的文件后, 执行hexo server启动本地服务器

分类和标签

执行 hexo new page categories 新增分类目录
进入新增后的文件夹 source/categories 修改 index.md 为以下内容

---
title: 分类
date: 2020-05-29 19:00:00
type: "categories"
---

执行 hexo new page tags 新增标签目录
进入新增后的文件夹 source/tags 修改 index.md 为以下内容

---
title: 标签
date: 2020-05-29 19:00:00
type: "tags"
---

此后新建的文档 可使用categories自定义文章分类, tags定义标签. 例子如下

categories: 技术分享
tags:
  - hexo
  - 网页搭建

修改根目录的_config.yml, 使用category_map进行中英映射, 此后分类为分享即被映射为share, 而显示内容仍然为分享

category_map:
  分享: share

不进行映射, 将会使用输入的内容作为目录, 可能存在中文或符号的常见问题

特殊标签

<!-- more --> [阅读更多]标签

CNAME

请将CNAME文件放置于你的Hexo目录的source文件夹，保证每次deploy都能自动生成此文件，保证Github Pages解析生效。

参阅

将 Hexo 部署到 Github Pages