Jekyll Minimal主题category分类子页面出现404错误该如何修复?
修复方案
问题根因
你使用的Jekyll Minimal主题默认未内置单分类/单标签页的自动生成逻辑,仅预置了分类总览页,因此访问具体分类子路径时会出现404。
方案1:使用官方插件自动生成(推荐)
GitHub Pages官方白名单已收录jekyll-archives插件,可自动生成所有分类、标签的独立页面,无需手动逐个创建:
- 第一步:修改站点根目录的
_config.yml文件,新增如下配置:
# 原有plugins配置下追加插件 plugins: - jekyll-feed - jekyll-archives # 新增这行 # 新增插件专属配置 jekyll-archives: enabled: - categories - tags layout: archive permalinks: category: '/category/:name/' tag: '/tag/:name/'
- 第二步:在
_layouts目录下新建archive.html布局文件,内容参考如下(可根据你的站点样式调整):
--- layout: default --- <div class="page-content"> <h1 class="page-title">{{ page.title }}</h1> <ul class="post-list"> {% for post in page.posts %} <li> <span class="post-meta">{{ post.date | date: "%Y-%m-%d" }}</span> <h2><a class="post-link" href="{{ post.url | relative_url }}">{{ post.title | escape }}</a></h2> </li> {% endfor %} </ul> </div>
- 第三步:提交所有修改推送到GitHub仓库,等待Pages自动构建完成即可访问分类子页面。
方案2:手动创建分类页(无插件场景)
如果不想使用插件,且站点分类数量较少,可以手动为每个分类创建独立页面:
- 在站点根目录新建
category文件夹,为每个分类创建对应Markdown文件,比如life.md,内容如下:
--- layout: archive title: "生活" permalink: /category/life/ ---
- 重复上述步骤为所有分类创建对应文件,推送后即可生效。
注意事项
- 文章头信息中的
categories字段拼写需和分类名完全一致,GitHub Pages服务对路径大小写敏感,需保证大小写匹配 - 本地预览时需先安装对应插件,执行
gem install jekyll-archives后再启动jekyll serve命令
内容的提问来源于stack exchange,提问作者Shayan Tawabi
相关产品推荐
相关产品推荐

