如何从 .Rmd 为 hugo-academic 中的帖子创建图像预览？答案

【问题标题】：How to create an image preview for a post in hugo-academic from .Rmd?如何从 .Rmd 为 hugo-academic 中的帖子创建图像预览？
【发布时间】：2018-05-02 11:29:17
【问题描述】：

我正在尝试使用 hugo-academic 为帖子添加图像预览，并使用 blogdown 从 .Rmd 进行编译，但我不知道在 YAML 序言中要做什么。

一些未提供解决方案的相关帖子包括：

-Include image preview in blogdown (.Rmd yaml header)

-How to add feature or thumbnail image for post in .Rmd file

Hugo-academic 希望在 TOML 序言中这样：

---
[header]
image="path"
---

根据blogdown book，这是TOML 中的一个表。但是方括号似乎是 YAML 中的流控制运算符，并且用反斜杠转义它们可以停止对编译的抱怨，但不会产生所需的行为； image: "path" 显然被忽略了，因为任何字符串都可以替换“路径”而不改变行为。至少 bookdown 是将图像放在 public/img/headers 中的正确位置。

那么我错过了什么？从 .Rmd 开始时，如何获得 hugo-academic 中帖子的图像预览？

【问题讨论】：

标签： hugo blogdown

【解决方案1】：

toml 标头中的 [] 可以在 yaml 中添加不带括号的内容，但以下参数会缩进。
在您的情况下，使用 academic 主题，YAML 标头需要编写如下（请记住，路径是相对于 static/img/ 文件夹）：

---
title: "Posts"
date: 2017-01-01
math: false
highlight: false
header:
  image: ""
  caption: ""
---

保存为 Rmd 文件的exampleSite 的getting-started 文件将具有以下YAML 标头（我对其进行了测试并且可以正常工作）：

---
date: 2016-04-20
lastmod: 2017-09-03
draft: false
tags: ["academic", "hugo"]
title: "Getting started with the Academic framework for Hugo"
math: true
summary: "Create a beautifully simple personal or academic website in under 10 minutes."
header:
  image: "headers/getting-started.png"
  caption: "Image credit: [**Academic**](https://github.com/gcushen/hugo-academic/)"
---

【讨论】：

【解决方案2】：

我遇到了与 Hugo-Academic 主题相同的问题，并且上述解决方案对我不起作用。

这是我的.Rmd 文件的YAML 标头，我的pizza.jpg 位于static/img/ 文件夹中。

如您所见，没有显示预览图像：

但是，您确实在项目中内看到了这张图片：

我如何才能正确获得与 academic 主题配合使用的图像预览？

如果您愿意，可以查看我的repo (https://github.com/moldach/moldach.github.com)……但我试图在此处提供足够的信息以供后代使用，因为它会在未来发生变化。

请注意：“Getting Started with...” 项目旁边的项目的图像预览之所以有效，是因为它们是指向.md 而非.Rmd 中的外部网站的链接

已解决：

好的，所以错误是您需要有preview_only:（而不是image_preview:）并注意image: 下的正确缩进（2 个空格键）。

确保您拥有Rmd 和预览图像（命名为featured.jpg/featured.png 位于project 文件夹中的一个子文件夹，如下所示：

可能最好复制粘贴，因为YAML 在适当的间距下很挑剔：

---
title: 'Shiny Dev and Software Release Cycles and Rayshader, Oh My!'
summary: ''
author: "Matthew J. Oldach"
tags: []
categories: []
date: "2019-11-23"
featured: false
draft: false

# Featured image
# To use, add an image named `featured.jpg/png` to your page's folder.
# Focal points: Smart, Center, TopLeft, Top, TopRight, Left, Right, BottomLeft, Bottom, BottomRight.
image:
  caption: ""
  focal_point: ""
  preview_only: true

# Projects (optional).
#   Associate this post with one or more of your projects.
#   Simply enter your project's folder or file name without extension.
#   E.g. `projects = ["internal-project"]` references `content/project/deep-learning/index.md`.
#   Otherwise, set `projects = []`.
projects: []
---

【讨论】：

【解决方案3】：

关于您的问题，唯一对我有用的是将 .rmd 文件重命名为 index.rmd。这解决了我所有的问题;-)

【讨论】：