跳到主要内容
  1. 文档/

Front Matter

1 分钟·

除了默认 Hugo 的Front Matter变量之外,Congo 添加了许多额外的选项,以定制单个文章的呈现方式。以下是所有可用的主题前置变量参数。

Front Matter参数的默认值是从主题的基础配置中继承的,因此只有在要覆盖默认值时才需要在Front Matter变量中指定这些参数。

NameDefaultDescription
title未设置文章的标题。
description未设置文章的文本描述。用于 HTML 元数据。
feature"*feature*"用于匹配此文章的feature图片文件名的文本模式。
featureAlt""feature图片的替代文本描述。
cover"*cover*"用于匹配此文章的封面图片文件名的文本模式。
coverAltfeatureAlt封面图片的替代文本描述。
coverCaption未设置在封面图片下方显示的图注文本。
thumbnail"*thumb*"_用于匹配此文章的缩略图图片文件名的文本模式。
thumbnailAltfeatureAlt缩略图图片的替代文本描述。
externalUrl未设置如果此文章发表在第三方网站上,则为此文章的 URL。提供 URL 将阻止生成内容页面,并且对此文章的任何引用将直接链接到第三方网站。
editURLarticle.editURLshowEdit 激活时,编辑链接的 URL。
editAppendPatharticle.editAppendPathshowEdit 激活时,是否将当前文章的路径附加到 editURL 设置的 URL。
groupByYearlist.groupByYear文章在列表页面上是否按年份分组。
keywords未设置应包含在文章元数据中的任何关键字。
menu未设置提供数值时,此文章的链接将出现在指定的菜单中。有效值为 mainfooter
robots未设置指示爬虫机器人如何处理此文章的字符串。如果设置,它将输出到页面头部。参考Google文档获取有效值。
sharingLinksarticle.sharingLinks在文章末尾显示哪些分享链接。如果未提供或设置为 false,则不显示任何链接。
showAuthorarticle.showAuthor是否在文章页脚显示作者框。
showBreadcrumbsarticle.showBreadcrumbslist.showBreadcrumbs是否在文章或列表页眉中显示面包屑。
showDatearticle.showDate是否显示文章日期。日期使用 date 参数设置。
showDateUpdatedarticle.showDateUpdated是否显示文章的更新日期。日期使用 lastmod 参数设置。
showEditarticle.showEdit是否显示编辑文章内容的链接。
showHeadingAnchorsarticle.showHeadingAnchors是否在文章中的标题旁边显示标题锚链接。
showPaginationarticle.showPagination是否在文章页脚显示下一篇/上一篇文章的链接。
invertPaginationarticle.invertPagination是否翻转下一篇/上一篇文章链接的方向。
showReadingTimearticle.showReadingTime是否显示文章的阅读时间。
showTaxonomiesarticle.showTaxonomies是否显示与此文章相关的分类法。
showTableOfContentsarticle.showTableOfContents是否在文章中显示目录。
showWordCountarticle.showWordCount是否显示文章的字数统计。
showCommentsarticle.showComments是否在文章页脚后包含评论部分
showSummarylist.showSummary是否在列表页上显示文章摘要。
summary使用 summaryLength 自动生成(参见站点配置当启用 showSummary 时,用作此文章摘要的 Markdown 字符串。
xmltrue,除非被 sitemap.excludedKinds 排除此文章是否包含在生成的 /sitemap.xml 文件中。