目录

Hugo生成文章摘要的几种方式

摘要是一篇文章的灵魂

读者可以大致了解整篇的表述,来判断是否有继续读下去的必要

内容摘要

Hugo支持内容摘要的生成,生成的摘要可以使用.Summary变量调用

生成的摘要将呈现在首页的文章标题下,并自动增加阅读更多的按钮来指向整篇内容

生成方式

  • 自动生成
  • 手动生成
  • 前置参数生成

自动生成

默认情况下, Hugo 自动将内容的前 70 个单词作为摘要

可以通过修改配置文件中的summaryLength来自定义摘要的长度,例如修改为前120

summaryLength

Default value: 70

The length of text in words to show in a .Summary.

Configure Hugo | Hugo

1
summaryLength = 120
提示
尽管summary中支持HTML标签等元素,但是并不建议,这样可能会导致渲染错误

手动生成

摘要生成还可以通过在文章的开始部分增加标签来实现< !--more-- >

1
2
3
4
这是段落1
这是段落2
< !--more-- >
以下是正文部分...

< !--more-- >标签之前的内容将作为摘要部分,效果与自动生成相同

相比较于自动生成,可能需要额外增加一些内容来充当摘要部分

提示

由于渲染的问题,文中出现的所有< !--more-- >标签的<>都添加了一个空格

正确写法请到Content Summaries |Manual Summary Splitting查看

前置参数生成

Hugo支持在文章的Front Matter中添加summary变量来单独设置摘要

1
2
title: "文章标题"
summary: "这是文章的摘要部分"

Hugo将会把summary中的内容渲染为文章摘要,效果与自动生成、手动生成相同

相较于自动生成和手动生成,仍然需要额外增加内容,但是可以选择不再文章中体现,以实现摘要与文章分离

优先级

因为同时支持多种方式生成,Hugo给出了摘要生成的优先级顺序:

Front Matter > 手动生成 > 自动生成

若同时出现两种以上,则以前者为优先拆分摘要