在Academic主题的config.toml添加[permalinks]导致blogdown停止渲染

从你的描述来看，这个问题确实有点棘手——主题开发者无法复现，说明大概率不是主题本身的问题，而是blogdown、RStudio和Hugo三者交互时的特殊兼容场景导致的。结合你提供的版本信息和临时解决方案，我整理了几个可以尝试的排查方向：

1. 检查[permalinks]配置的语法细节 #

虽然控制台没有报错，但Hugo对config.toml的语法要求很严格，哪怕是微小的格式问题都可能导致静默异常。比如：

• 确保[permalinks]块下的规则格式正确，示例如下：

  [permalinks]
    post = "/:year/:month/:day/:slug/"
    project = "/project/:slug/"
  

• 检查是否有多余的空格、符号，或者规则中的占位符是否和你的内容类型匹配（比如你是否真的有post或project这类内容类型）

2. 绕过RStudio插件，手动启动服务 #

有时候RStudio的"Serve Site"插件可能会有隐藏的进程监听问题，你可以试试在R控制台手动运行：

blogdown::serve_site()

然后修改内容，仔细观察控制台输出——可能会出现RStudio插件没显示的警告或错误信息，帮你定位问题。

3. 升级相关工具版本 #

你当前使用的版本都比较老旧（比如blogdown 0.6是2018年的版本，Hugo 0.40.3也已经是多年前的版本），后续版本修复了很多兼容性问题：

• 先升级blogdown：install.packages("blogdown")
• 再用blogdown升级Hugo到兼容的稳定版：blogdown::install_hugo()
• 同时考虑升级RStudio到较新的稳定版，再重新测试添加[permalinks]的场景

4. 检查文件监听机制是否被干扰 #

blogdown的自动渲染依赖于对文件修改的监听，[permalinks]配置可能会改变Hugo生成站点的路径结构，导致RStudio的文件监听没有捕获到变化。你可以试试：

• 修改内容后手动保存所有文件，再刷新浏览器看是否有更新
• 暂时关闭RStudio的自动保存功能，手动保存后观察是否触发渲染

临时方案的过渡建议 #

既然你目前通过移除[permalinks]可以恢复正常，如果你需要自定义链接结构，也可以尝试在单个内容文件的YAML头中设置url字段来指定自定义链接，比如：

---
title: "My Post"
url: "/2024/05/my-custom-post-url/"
---

这种方式不需要全局的[permalinks]配置，也能实现自定义链接的需求，同时避免全局配置带来的兼容问题。

内容的提问来源于stack exchange，提问作者Ross Gayler