Hugo 网站 academic 主题首页的文摘显示问题

在 RStudio 里用 R blogdown 来维护网站时，可以通过点击工具栏的 Addins - New Post 来创建新帖子，很方便。但是，如果用的是 Hugo 的 academic 主题，那么创建的新帖子在网站首页会显示全文，不大好看，尤其是全文很长的时候，根本就不像个首页了。这是因为，academic 首页的 posts 模块默认显示文摘。如果没有为每篇帖子设置文摘，就会显示全文。而上面说的创建新帖的方法里，并没有设置文摘的选项。那么，文摘在哪里设置呢？

直接说答案：手动在新帖的YAML文件头添加一行：

summary: "我的文摘别太长。"

答案来自blogdown 项目主页。

就这么个小问题，让我走了点弯路。我发现问题后，首先观察了一下主题自带的示例文档，文件头是这样的：

+++
date = "2016-04-20T11:00:00"
draft = false
tags = ["academic", "hugo"]
title = "Customizing the homepage with widgets"
math = false
summary = """
Enable/disable and configure widgets to customize your homepage.
"""
+++

跟 R blogdown 生成的 .md 和 .Rmd 文件的文件头不同，这个文件头居然是用前后各三个加号表示的。里面的summary开始数三行，就是用来设置文摘的。

于是我就把这三行拷贝粘贴到 .Rmd 文件里，当然是编译出错了。接着我想当然地把上面这段前后共六个加号的文件头拷贝粘贴到 .Rmd 里，仍然报错。问题搁置了几天，才想起去 blogdown 项目主页搜搜看，就找到了答案。

永远记不住的教训：遇到问题，别瞎试。上网搜，你绝不是第一个遇到这个问题的人。