首页 > 解决方案 > RStudio blogdown:在学术主题中将 [permalinks] 添加到 config.toml 似乎会停止渲染

问题描述

我一直在尝试使用 RStudio、blogdown包、学术主题和 blogdown“服务站点”RStudio 插件建立一个个人网站。

我对这一切几乎一无所知,并且一直按照 Alison Presmanes Hill 的博客blogdown书中的说明进行操作。

一切进展顺利,即当我对内容的文本进行更改并保存时,服务站点插件会检测到更改并在本地重新呈现站点。(这对我的开发 PC 来说都是本地的。我还没有尝试通过 Netlify 进行部署。)

然后我尝试按照blogdown book 中的建议为帖子启用永久链接。这是通过在靠近顶部的某处添加以下文本来完成的config.toml

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

添加这些行后,该站点将不会重新呈现。也就是说,如果我更改了内容文件中的任何文本,则呈现的输出不会接收到更改。RStudio 控制台中没有错误消息。

我在 hugo-academic 中似乎是相关问题上提交了此文件,但所有者无法将其复制为纯粹的雨果/学术问题。

@rgayler 我已经在示例站点的测试环境中为所有 4 种类型的内容设置了 [永久链接],运行最新版本的 Hugo 和 Academic,并且无法重现您描述的问题。因此,根据您提供的详细信息,它可能是与 Blogdown/Rstudio 相关的错误。

在另一个关于 blogdown 的永久链接问题的回复中,hugo-academic 所有者还建议这个(其他,可能相关的)问题只出现在 blogdown 用户身上——所以可能是 blogdown 问题。

@jananiravi 看来这个问题只影响 Blogdown/RStudio 用户,可能与 Blogdown/RStudio 与 Hugo 的永久链接和 GetPage 功能的兼容性有关。

我创建了一个最小的示例。不幸的是,它是由 blogdown 生成的整个网站的两个快照(提交)。第 6 次提交 (SHA = cc0f2cb) 显示网站正在运行。它对应于按照说明安装的 Academic示例。第 7 次提交 (SHA = 2b0eefa) 在添加永久链接行并将其保存到 之后显示网站config.toml,然后更改并保存about.md. 不会呈现此更改。

任何关于这里发生的事情的线索将不胜感激。目前我正在通过不使用永久链接来解决这个问题。

FWIW 我正在使用:

标签: rrenderingpermalinkshugoblogdown

解决方案


同时存在三个问题:

  1. RStudio V1.1 有一个错误,该错误会阻止来自本地 Web 服务器的错误消息显示在控制台中。解决此问题的说明如下:https ://github.com/rstudio/rstudio/issues/2248#issuecomment-387453849

  2. hugo-academic 主题中存在一个问题,即站点中存在断开的链接会导致站点构建失败。这已通过使用 2018-05-09 之后的 hugo-academic 版本修复。

  3. 我误解了如何在 TOML 中解析表 - 一个表运行到下一个表或 EOF。我在 config .toml 顶部附近和一些任意键/值对之前插入了永久链接表,这些键/值对因此包含在永久链接表中。这已通过将永久链接表移动到 config.toml 中的第一个其他表之前立即修复


推荐阅读