【问题标题】:Is there a way to embed a bookdown document as a blogdown post?有没有办法将 bookdown 文档嵌入到 blogdown 帖子中?
【发布时间】:2019-12-16 07:57:09
【问题描述】:

我创建了一个使用 Bookdown 的教程(我认为这是一个很好的格式),并且目前正在使用 Blogdown(雨果学术主题)创建一个网站。我希望能够将此教程作为 Bookdown 帖子添加到教程页面,但我不知道这是否可能。

我是 Blogdown 的新手,所以我无法找到任何解决方案。如果不可能,有没有办法将帖子链接更改为将用户带到已发布的 Bookdown 文件(可能是 bookdown.org)的超链接?

【问题讨论】:

  • 如何使用“项目”呢?我发现它比(博客)帖子更合适,并且很容易链接到外部站点。可以将 bookdown 的渲染输出集成到 blogdown 中,但这听起来很麻烦。
  • @RalfStubner,这似乎会做我感兴趣的事情,但是当我创建一个名为“教程”的新小部件页面时,(我复制了项目文件),它重定向到项目/ 关联项目的目录。是什么告诉它看那里,因为我在配置或索引文件中看不到任何东西?
  • 您的tutorials.md 中有page_type = "project" 吗?你应该把它改成page_type = "tutorials"
  • 是的,它位于content/tutorial/ 目录中,因为我不希望它出现在主屏幕上。它显示了指定的过滤器,而不是 content/tutorial/ 中的文档
  • 为了在主页以外的其他页面上使用小部件,您需要添加一个index.md 小部件页面,c.f. sourcethemes.com/academic/docs/managing-content/…

标签: hugo bookdown blogdown


【解决方案1】:

在我看来,将教程(使用bookdown 编写)与网站的其余部分(使用blogdown 编写)分开会更有意义。一种可能的解决方案是将“投资组合”小部件与使用external_link 的内容一起使用,类似于“外部项目”的工作方式。由于您不希望主页上出现教程小部件,因此您需要执行以下操作:

  1. 创建一个目录content/tutorial,其中包含每个教程的目录。这些目录中的每一个都包含一个以“外部项目”为模型的index.md,即具有external_link 属性。

  2. 使用index.md 小部件页面创建第二个目录content/tutorials,c.f. https://sourcethemes.com/academic/docs/managing-content/#create-a-widget-page

  3. second 目录中创建一个投资组合小部件,例如通过复制projects.md,将page_type 设置为tutorialfirst 目录的名称)。

关键是你需要两个目录。一个用于教程,一个用于小部件。完整示例在GitHub。当然,将指向/tutorials/(而不是/tutorial/!)的链接添加到您的站点菜单是有意义的。

【讨论】:

  • 这太完美了!感谢您的帮助拉尔夫!
猜你喜欢
  • 2021-03-12
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2018-07-26
  • 2011-03-08
相关资源
最近更新 更多