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

Pelican中/about页面返回404错误,求排查问题原因

Pelican添加/about页面出现404的修复方案

问题根源与修复步骤

1. 页面元数据格式不符合Pelican规范

你的about.md元数据没有使用Pelican识别的分隔结构,导致系统无法正确解析元数据(包括指定的模板)。修改/content/pages/about.md内容如下:

---
template: about.html
title: about us
---
# this is content of about us
  • 用---包裹元数据块是Pelican识别YAML格式元数据的标准方式
  • 元数据键名建议使用小写(如template而非Template),避免因大小写敏感导致解析失败

2. URL配置与访问路径不匹配

当前pelicanconf.py的配置会生成带.html后缀的页面:

PAGE_URL = '/{slug}.html'
PAGE_SAVE_AS = '/{slug}.html'

这意味着你的about页面实际生成路径是/about.html,但你访问的是/about,自然会返回404。有两种解决方式:

  • 直接访问正确路径:localhost:8000/about.html
  • 修改配置生成无后缀URL(更符合常规访问习惯),更新pelicanconf.py:
    PAGE_URL = '/{slug}/'
    PAGE_SAVE_AS = '/{slug}/index.html'
    
    此配置会生成/about/index.html,访问localhost:8000/about时服务器会自动加载该文件

3. 重启服务生效

修改完成后,需要重新生成静态文件并重启本地服务器:

pelican content
pelican --listen

内容的提问来源于stack exchange,提问作者Malvinka

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.05 20:10:07