跳过正文
  1. 文档/

Front Matter

3 分钟· loading · loading · · ·
front matter 配置 文档
部署教程 - 这篇文章属于一个选集。
§ 7: 本文

除了 Hugo 中默认的 front matter,Blowfish 主题中还添加了大量的参数选项来自定义单个页面的展示方式。所有可用的扉页参数如下。

front matter 参数中的默认值是从 基础配置中继承的,所有只有当你想要覆盖默认值时,才需要在当前页面指定这些参数。

名称默认值描述
title文章名称。
description文章的描述信息,它会被添加在 HTML 的 <meta> 元数据中。
externalUrl如果文章发布在第三方网站上,这里提供只想对应文章的 URL 地址。提供 URL 将会组织生成内容页面,对这篇文章的任何引用都会直接跳转到第三方网站的 URL 上面。
editURLarticle.editURL当激活 showEdit 参数时,此参数用来设置编辑文章的 URL。
editAppendPatharticle.editAppendPath当激活 showEdit 参数时,该参数指定是否将当前文章路径添加到 editURL 设置的 URL 后面。
groupByYearlist.groupByYear是否在列表页面按年份对文章进行分组。
menu当设置此值,这篇内容的链接将会出现在菜单中。有效值是 mainfooter
robots支持搜索引擎的爬虫如何处理这篇文章。如果设置了此值,它将在页面头部输出。更多内容请参考 Google 文档
sharingLinksarticle.sharingLinks指定文章结尾显示哪些分享链接。如果没有设置或设置为 false ,则没有分享链接。
showAuthorarticle.showAuthor是否在页脚处显示作者框。
showAuthorBottomarticle.showAuthorBottom作者框显示在每页的底部而不是顶部。
authors用于展示多创作者的数组,如果设置了将会覆盖 showAuthor 设置。这里使用了多作者的特性,查看 这个页面来获取更多信息。
showAuthorsBadgesarticle.showAuthorsBadges是否在文章和列表页展示authors作者分类。想是它生效需要开启multiple authors多创作者和 authors 作者分类。 查看 这个页面来获取更多信息。
featureimage基于外部 URL 的特征图片链接。
featureimagecaption特征图片的说明,仅在 hero 样式的 big 风格下展示。
showHeroarticle.showHero是否在文章页面将所裸土作为文章页面内的 hero 图片显示。
heroStylearticle.heroStylehero 图片的风格,合法的值有: basicbigbackgroundthumbAndBackground
showBreadcrumbsarticle.showBreadcrumbs or list.showBreadcrumbs是否在文章或列表页面显示面包屑导航。
showDatearticle.showDate是否显示文章的日期。具体日期使用 date 参数设置。
showDateUpdatedarticle.showDateUpdated是否显示文章的更新日期。具体日期使用 lastmod 参数设置。
showEditarticle.showEdit是否显示编辑文章内容的链接。
showHeadingAnchorsarticle.showHeadingAnchors是否在文章的标题旁显示锚点链接。
showPaginationarticle.showPagination是否在文章页脚显示下一篇/上一篇链接。
invertPaginationarticle.invertPagination是否翻转下一篇/上一篇的链接方向。
showReadingTimearticle.showReadingTime是否显示文章的预估阅读时间。
showTaxonomiesarticle.showTaxonomies是否显示文章关联的分类/标签。
showTableOfContentsarticle.showTableOfContents是否显示文章目录。
showWordCountarticle.showWordCount是否显示文章字数统计。如果你的语言属于 CJK 语言,需要在 config.toml 中开启 hasCJKLanguage 参数。
showCommentsarticle.showComments是否在文章页脚显示 评论部分
showSummarylist.showSummary是否在文章或列表页显示摘要。
showViewsarticle.showViews是否显示文章和列表页面的阅读量。这需要集成 firebase ,具体可以看 这个页面来了解如何在 Blowfish 中集成firebase。
showLikesarticle.showLikes是否显示文章和列表页面的点赞量。这需要集成 firebase ,具体可以看 这个页面来了解如何在 Blowfish 中集成firebase。
seriesOpenedarticle.seriesOpened是否打开系列模块。
series文章所属的系列数组,我们建议每篇文章只属于一个系列。
series_order文章在系列中的编号。
summaryAuto generated using summaryLength (see site configuration)当启用 showSummary 时,这是作为这篇文章摘要的Markdown字符串。
xmltrue unless excluded by sitemap.excludedKinds是否将这篇文章包含在生成的 /sitemap.xml 文件中。
layoutBackgroundBlurtrue向下滚动主页时,是否模糊背景图。
layoutBackgroundHeaderSpacetrue在标题和正文之间添加空白区域间隔。
部署教程 - 这篇文章属于一个选集。
§ 7: 本文

相关文章

多创作者模式
3 分钟· loading · loading
作者 配置 文档
缩略图
1 分钟· loading · loading
缩略图 配置 文档
Partials
4 分钟· loading · loading
partials 统计服务 隐私 评论 网站图标 图标 文档
系列
1 分钟· loading · loading
系列 文档
进阶自定义
6 分钟· loading · loading
高级 CSS 文档
托管和部署
2 分钟· loading · loading
文档 托管 部署 github netlify 渲染器