解决hexo博客标签页配置问题

本文介绍hexo博客搭建标签页, 并且找了网上各种解决标签页部署404问题,最后终于找到有效的解决解决方案

新建页面

利用hexo新建一个页面。输入以下命令。

hexo new page tags

修改页面头部

在根目录下的source 文件夹中找到 tags 文件夹,并打开里面的index.md文件。

在根目录下的source 文件夹中找到 tags 文件夹,并打开里面的index.md文件。
在头部里面添加以下代码:

layout: tags //此databases可以任取,但为方便管理,推荐这样取名。并且需要记住此名称,因为后面还需要用到。

1
2
3
4
title: tags
date: 2022-05-24 00:55:21
type: tags
layout: tags

主题配置文件

在配置文件里面,根目录的配置文件。找到类似的代码的地方。如:友链页、自定义页、关于页、标签页、分类页、归档页等写配置的地方。不一定和这个一模一样的,找到类似的代码的地方即可

1
2
3
4
5
6
7
menu:
- { key: "home", link: "/", icon: "iconfont icon-home-fill" }
- { key: "archive", link: "/archives/", icon: "iconfont icon-archive-fill" }
- { key: "category", link: "/categories/", icon: "iconfont icon-category-fill" }
- { key: "tag", link: "/tags/", icon: "iconfont icon-tags-fill" }
- { key: "about", link: "/about/", icon: "iconfont icon-user-fill" }
#- { key: "links", link: "/links/", icon: "iconfont icon-link-fill" }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

#---------------------------
# 标签页
# Tag Page
#---------------------------
tag:
enable: true
banner_img: /img/default.png
banner_img_height: 80
banner_mask_alpha: 0.3
tagcloud:
min_font: 15
max_font: 30
unit: px
start_color: "#BBBBEE"
end_color: "#337ab7"

确定ejs文件

这也是最重要的一步。添加文件。在主题目录(themes文件夹)下,打开自己的主题文件夹,找到 layout 文件夹,如果有tags.ejs即可,没有则,需要复制about.ejs 文件(根据自行的配置,找对应的文件)一份,并将其命名为 tags.ejs (名称即在第四步中的那个名称)。

然后修改,其实就只是修改了第三行的代码,其他的都没有改变。将第三行代码原来的 about 改为了 tags 而已。这个名称就是第四步里面的名称。

文章加入标签

1
2
3
title: 解决hexo博客标签页配置问题
date: 2022-05-24 07:52:43
tags: hexo

以上为建立标签页的步骤,至此正常来说标签页就已经搭建完成可以正常使用。

但我的博客Fluid主题就是报页面不存在,不过应该跟主题没关系。

尝试过各种方案并且删除tags文件夹再重建后,依然不行。以下是亲测有效的解决方案

解决标签页访问404问题

探索过程

hexo s上去可以正常显示标签页,但是hexo g和hexo d部署上去就不能正常显示。

至此开始搜索hexo本地预览跟部署服务器不一致怎么解决。

搜索到可以查看提交到GitHub的repository,结果发现提交的是Tags文件夹,博客的url访问尝试改成Tags则可以正常访问。而我创建的tags文件夹。于是考虑提交git时候是不是自动转成大写了。

结果检索发现Git配置默认忽略了大小写

检查hexo生成的.deploy_git文件夹内的文件名确实是大写的,而使用hexo d提交到github上之后的目录还是小写,这是因为git默认是忽略大小写的!.deploy_git是隐藏文件夹。mac本 command + shit + ,即可展示隐藏文件夹。

解决方法

  1. 删除.deploy_git目录
  2. 再次运行hexo d提交,hexo会重置git仓库,并重新生成所有文件!
  3. 打开github查看,问题解决!

可以使用下面语句设置git大小写敏感,防止下次出现这样的问题:

git config core.ignorecase false


觉得不错的话,给点打赏吧 ୧(๑•̀⌄•́๑)૭



wechat pay



alipay

解决hexo博客标签页配置问题
http://yuting0907.github.io/2022/05/24/解决hexo博客标签页配置问题/
作者
Echo Yu
发布于
2022年5月24日
许可协议