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

Hugo Academic技术问题:Talk Widget未显示在首页锚点位置

问题描述

已成功在菜单栏添加了Talks菜单,但Talk Widget并未显示在首页的锚点位置,反而出现在[ROOT]/talk路径下。

补充操作细节

  • 在[ROOT]/config/_default/menus.toml中配置菜单指向锚点#talk:
    [[main]]
      name = "Talks"
      url = "#talk"
      weight = 25
    
  • 在[ROOT]/layouts/widgets目录下放置了talk.html,内容直接复制自主题的themes/academic/layouts/talk/single.html(单篇Talk的详情页模板)
  • 在[ROOT]/content/talk/BayesComp2023目录下添加了单篇Talk的内容文件index.md和图片featured.jpg
  • 在[ROOT]/content/home目录下创建了talk.md,配置首页Talk Widget的参数:
    +++
    # Recent and Upcoming Talks widget.
    widget = "talk"
    active = true
    date = "2016-04-20T00:00:00"
    
    title = "Invited Talks"
    subtitle = "Subtitle to the talks"
    
    # Order that this section will appear in.
    weight = 25
    
    # Number of talks to list.
    count = 10
    
    # List format.
    #   0 = Simple
    #   1 = Detailed
    list_format = 0
    
    +++
    
问题原因及修复方案

1. Widget模板文件用错了

你把单篇Talk的详情页模板(talk/single.html)当成了首页Widget的模板,这是核心问题。首页的Talk Widget需要的是用来展示Talk列表的模板,不是单页详情的模板,放错模板会导致Widget无法正常渲染,反而触发了单页路径的展示。

修复:
删除当前layouts/widgets/talk.html文件。如果不需要自定义Widget样式,直接用主题默认的Talk Widget模板即可;如果要自定义,去主题目录复制themes/academic/layouts/widgets/talk.html到自己的layouts/widgets目录后再修改。

2. 确保首页Widget正常加载

检查content/home/talk.md的active = true是否正确设置,这个参数控制Widget是否在首页显示。另外可调整weight值(比如改成15),让它在页面靠前位置显示,避免因排在页面底部看不到。

3. 验证锚点匹配

Academic主题默认会根据content/home下的Widget文件名生成锚点,talk.md对应的锚点就是#talk,所以菜单的url = "#talk"配置是正确的,只要Widget正常显示在首页,点击菜单就能跳转到对应位置。

4. 清理缓存重新构建

修改模板和配置后,删除网站的public和resources目录,重新执行Hugo构建命令,确保新配置生效。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.12 13:50:40