You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.24 00:24:05