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

使用RStudio中blogdown构建Academic主题站点时baseURL丢失求助

问题排查与解决方案

针对你遇到的baseURL未被正确应用的问题,试试以下几个方向:

  • 检查主题菜单配置文件
    打开config/_default/menus.toml(或主题对应的菜单配置文件),确认每个菜单项的url是相对路径(比如/#experience)而非硬编码的绝对URL。如果是硬写了https://heima.hafro.is/#experience,Hugo会直接忽略你设置的baseURL。

  • 核对Hugo版本
    即使回滚了blogdown,Hugo版本可能已经更新,导致路径生成逻辑变化。先运行blogdown::hugo_version()查看当前版本,对比之前站点正常时的版本,然后回退到旧版本:

    blogdown::install_hugo(version = "你之前用的版本号")
    
  • 调整Hugo核心配置参数
    在config.yaml里补充或修改这两个参数:

    relativeURLs: false
    canonifyURLs: true
    

    relativeURLs设为false会强制生成绝对URL,canonifyURLs会确保所有URL都基于baseURL拼接。

  • 清理缓存后重新构建
    先手动删掉站点根目录的public文件夹,再运行blogdown::build_site(local = FALSE)——本地预览的serve_site()和生产构建逻辑有差异,用这个命令模拟线上构建环境,看看路径是否正常。

  • 检查自定义模板/短代码
    如果之前修改过主题的菜单模板(比如layouts/partials/menu.html这类文件),确认模板里是用{{ .Site.BaseURL }}来拼接路径,而不是硬写根路径/。如果模板被主题更新覆盖,可能需要重新调整。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.05 01:51:04