From e77051ccc4b47951bfa4fde2be436b1bb2fb113b Mon Sep 17 00:00:00 2001 From: Christoph Cullmann Date: Sun, 28 Apr 2024 17:33:09 +0200 Subject: use https://github.com/nunocoracao/blowfish.git --- .../content/docs/front-matter/background.svg | 574 ++++++++++ .../content/docs/front-matter/featured.svg | 1100 ++++++++++++++++++++ .../content/docs/front-matter/index.it.md | 58 ++ .../content/docs/front-matter/index.ja.md | 58 ++ .../exampleSite/content/docs/front-matter/index.md | 58 ++ .../content/docs/front-matter/index.zh-cn.md | 58 ++ 6 files changed, 1906 insertions(+) create mode 100644 themes/blowfish/exampleSite/content/docs/front-matter/background.svg create mode 100644 themes/blowfish/exampleSite/content/docs/front-matter/featured.svg create mode 100644 themes/blowfish/exampleSite/content/docs/front-matter/index.it.md create mode 100644 themes/blowfish/exampleSite/content/docs/front-matter/index.ja.md create mode 100644 themes/blowfish/exampleSite/content/docs/front-matter/index.md create mode 100644 themes/blowfish/exampleSite/content/docs/front-matter/index.zh-cn.md (limited to 'themes/blowfish/exampleSite/content/docs/front-matter') diff --git a/themes/blowfish/exampleSite/content/docs/front-matter/background.svg b/themes/blowfish/exampleSite/content/docs/front-matter/background.svg new file mode 100644 index 0000000..a3dc3e7 --- /dev/null +++ b/themes/blowfish/exampleSite/content/docs/front-matter/background.svg @@ -0,0 +1,574 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/themes/blowfish/exampleSite/content/docs/front-matter/featured.svg b/themes/blowfish/exampleSite/content/docs/front-matter/featured.svg new file mode 100644 index 0000000..116289b --- /dev/null +++ b/themes/blowfish/exampleSite/content/docs/front-matter/featured.svg @@ -0,0 +1,1100 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/themes/blowfish/exampleSite/content/docs/front-matter/index.it.md b/themes/blowfish/exampleSite/content/docs/front-matter/index.it.md new file mode 100644 index 0000000..38c477b --- /dev/null +++ b/themes/blowfish/exampleSite/content/docs/front-matter/index.it.md @@ -0,0 +1,58 @@ +--- +title: "Front Matter" +date: 2020-08-10 +draft: false +description: "All the front matter variables available in Blowfish." +slug: "front-matter" +tags: ["front matter", "config", "docs"] +series: ["Documentation"] +series_order: 7 +--- + +In addition to the [default Hugo front matter parameters](https://gohugo.io/content-management/front-matter/#front-matter-variables), Blowfish adds a number of additional options to customise the presentation of individual articles. All the available theme front matter parameters are listed below. + +Front matter parameter default values are inherited from the theme's [base configuration]({{< ref "configuration" >}}), so you only need to specify these parameters in your front matter when you want to override the default. + + +| Name | Default | Description | +| ----------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `title` | _Not set_ | The name of the article. | +| `description` | _Not set_ | The text description for the article. It is used in the HTML metadata. | +| `externalUrl` | _Not set_ | If this article is published on a third-party website, the URL to this article. Providing a URL will prevent a content page being generated and any references to this article will link directly to the third-party website. | +| `editURL` | `article.editURL` | When `showEdit` is active, the URL for the edit link. | +| `editAppendPath` | `article.editAppendPath` | When `showEdit` is active, whether or not the path to the current article should be appended to the URL set at `editURL`. | +| `groupByYear` | `list.groupByYear` | Whether or not articles are grouped by year on list pages. | +| `menu` | _Not set_ | When a value is provided, a link to this article will appear in the named menus. Valid values are `main` or `footer`. | +| `robots` | _Not set_ | String that indicates how robots should handle this article. If set, it will be output in the page head. Refer to [Google's docs](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) for valid values. | +| `sharingLinks` | `article.sharingLinks` | Which sharing links to display at the end of this article. When not provided, or set to `false` no links will be displayed. | +| `showAuthor` | `article.showAuthor` | Whether or not the author box for the default author is displayed in the article footer. | +| `showAuthorBottom` | `article.showAuthorBottom` | Author boxes are displayed at the bottom of each page instead of the top. | +| `authors` | _Not set_ | Array of values for authors, if set it overrides `showAuthor` settings for page or site. Used on the multiple authors feature, check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature. | +| `showAuthorsBadges` | `article.showAuthorsBadges` | Whether the `authors` taxonomies are are displayed in the article or list header. This requires the setup of `multiple authors` and the `authors` taxonomy. Check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature. | +| `featureimage` | _Not set_ | External URL for feature image | +| `featureimagecaption` | _Not set_ | Caption for feature image. Only displayed in heroStyle `big` | +| `showHero` | `article.showHero` | Whether the thumbnail image will be shown as a hero image within the article page. | +| `heroStyle` | `article.heroStyle` | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | +| `showBreadcrumbs` | `article.showBreadcrumbs` or `list.showBreadcrumbs` | Whether the breadcrumbs are displayed in the article or list header. | +| `showDate` | `article.showDate` | Whether or not the article date is displayed. The date is set using the `date` parameter. | +| `showDateUpdated` | `article.showDateUpdated` | Whether or not the date the article was updated is displayed. The date is set using the `lastmod` parameter. | +| `showEdit` | `article.showEdit` | Whether or not the link to edit the article content should be displayed. | +| `showHeadingAnchors` | `article.showHeadingAnchors` | Whether or not heading anchor links are displayed alongside headings within this article. | +| `showPagination` | `article.showPagination` | Whether or not the next/previous article links are displayed in the article footer. | +| `invertPagination` | `article.invertPagination` | Whether or not to flip the direction of the next/previous article links. | +| `showReadingTime` | `article.showReadingTime` | Whether or not the article reading time is displayed. | +| `showTaxonomies` | `article.showTaxonomies` | Whether or not the taxonomies that relate to this article are displayed. | +| `showTableOfContents` | `article.showTableOfContents` | Whether or not the table of contents is displayed on this article. | +| `showWordCount` | `article.showWordCount` | Whether or not the article word count is displayed. | +| `showComments` | `article.showComments` | Whether or not the [comments partial]({{< ref "partials#comments" >}}) is included after the article footer. | +| `showSummary` | `list.showSummary` | Whether or not the article summary should be displayed on list pages. | +| `showViews` | `article.showViews` | Whether or not the article views should be displayed in lists and detailed view. This requires a firebase integration. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish | +| `showLikes` | `article.showLikes` | Whether or not the article likes should be displayed in lists and detailed view. This requires a firebase integration. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish | +| `seriesOpened` | `article.seriesOpened` | Whether or not the series module will be displayed open by default or not. | +| `series` | _Not set_ | Array of series the article belongs to, we recommend using only one series per article. | +| `series_order` | _Not set_ | Number of the article within the series. | +| `summary` | Auto generated using `summaryLength` (see [site configuration]({{< ref "configuration#site-configuration" >}})) | When `showSummary` is enabled, this is the Markdown string to be used as the summary for this article. | +| `xml` | `true` unless excluded by `sitemap.excludedKinds` | Whether or not this article is included in the generated `/sitemap.xml` file. | +| `layoutBackgroundBlur` | `true` | Makes the background image in the background heroStyle blur with the scroll | +| `layoutBackgroundHeaderSpace` | `true` | Add space between the header and the body. | + diff --git a/themes/blowfish/exampleSite/content/docs/front-matter/index.ja.md b/themes/blowfish/exampleSite/content/docs/front-matter/index.ja.md new file mode 100644 index 0000000..38c477b --- /dev/null +++ b/themes/blowfish/exampleSite/content/docs/front-matter/index.ja.md @@ -0,0 +1,58 @@ +--- +title: "Front Matter" +date: 2020-08-10 +draft: false +description: "All the front matter variables available in Blowfish." +slug: "front-matter" +tags: ["front matter", "config", "docs"] +series: ["Documentation"] +series_order: 7 +--- + +In addition to the [default Hugo front matter parameters](https://gohugo.io/content-management/front-matter/#front-matter-variables), Blowfish adds a number of additional options to customise the presentation of individual articles. All the available theme front matter parameters are listed below. + +Front matter parameter default values are inherited from the theme's [base configuration]({{< ref "configuration" >}}), so you only need to specify these parameters in your front matter when you want to override the default. + + +| Name | Default | Description | +| ----------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `title` | _Not set_ | The name of the article. | +| `description` | _Not set_ | The text description for the article. It is used in the HTML metadata. | +| `externalUrl` | _Not set_ | If this article is published on a third-party website, the URL to this article. Providing a URL will prevent a content page being generated and any references to this article will link directly to the third-party website. | +| `editURL` | `article.editURL` | When `showEdit` is active, the URL for the edit link. | +| `editAppendPath` | `article.editAppendPath` | When `showEdit` is active, whether or not the path to the current article should be appended to the URL set at `editURL`. | +| `groupByYear` | `list.groupByYear` | Whether or not articles are grouped by year on list pages. | +| `menu` | _Not set_ | When a value is provided, a link to this article will appear in the named menus. Valid values are `main` or `footer`. | +| `robots` | _Not set_ | String that indicates how robots should handle this article. If set, it will be output in the page head. Refer to [Google's docs](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) for valid values. | +| `sharingLinks` | `article.sharingLinks` | Which sharing links to display at the end of this article. When not provided, or set to `false` no links will be displayed. | +| `showAuthor` | `article.showAuthor` | Whether or not the author box for the default author is displayed in the article footer. | +| `showAuthorBottom` | `article.showAuthorBottom` | Author boxes are displayed at the bottom of each page instead of the top. | +| `authors` | _Not set_ | Array of values for authors, if set it overrides `showAuthor` settings for page or site. Used on the multiple authors feature, check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature. | +| `showAuthorsBadges` | `article.showAuthorsBadges` | Whether the `authors` taxonomies are are displayed in the article or list header. This requires the setup of `multiple authors` and the `authors` taxonomy. Check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature. | +| `featureimage` | _Not set_ | External URL for feature image | +| `featureimagecaption` | _Not set_ | Caption for feature image. Only displayed in heroStyle `big` | +| `showHero` | `article.showHero` | Whether the thumbnail image will be shown as a hero image within the article page. | +| `heroStyle` | `article.heroStyle` | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | +| `showBreadcrumbs` | `article.showBreadcrumbs` or `list.showBreadcrumbs` | Whether the breadcrumbs are displayed in the article or list header. | +| `showDate` | `article.showDate` | Whether or not the article date is displayed. The date is set using the `date` parameter. | +| `showDateUpdated` | `article.showDateUpdated` | Whether or not the date the article was updated is displayed. The date is set using the `lastmod` parameter. | +| `showEdit` | `article.showEdit` | Whether or not the link to edit the article content should be displayed. | +| `showHeadingAnchors` | `article.showHeadingAnchors` | Whether or not heading anchor links are displayed alongside headings within this article. | +| `showPagination` | `article.showPagination` | Whether or not the next/previous article links are displayed in the article footer. | +| `invertPagination` | `article.invertPagination` | Whether or not to flip the direction of the next/previous article links. | +| `showReadingTime` | `article.showReadingTime` | Whether or not the article reading time is displayed. | +| `showTaxonomies` | `article.showTaxonomies` | Whether or not the taxonomies that relate to this article are displayed. | +| `showTableOfContents` | `article.showTableOfContents` | Whether or not the table of contents is displayed on this article. | +| `showWordCount` | `article.showWordCount` | Whether or not the article word count is displayed. | +| `showComments` | `article.showComments` | Whether or not the [comments partial]({{< ref "partials#comments" >}}) is included after the article footer. | +| `showSummary` | `list.showSummary` | Whether or not the article summary should be displayed on list pages. | +| `showViews` | `article.showViews` | Whether or not the article views should be displayed in lists and detailed view. This requires a firebase integration. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish | +| `showLikes` | `article.showLikes` | Whether or not the article likes should be displayed in lists and detailed view. This requires a firebase integration. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish | +| `seriesOpened` | `article.seriesOpened` | Whether or not the series module will be displayed open by default or not. | +| `series` | _Not set_ | Array of series the article belongs to, we recommend using only one series per article. | +| `series_order` | _Not set_ | Number of the article within the series. | +| `summary` | Auto generated using `summaryLength` (see [site configuration]({{< ref "configuration#site-configuration" >}})) | When `showSummary` is enabled, this is the Markdown string to be used as the summary for this article. | +| `xml` | `true` unless excluded by `sitemap.excludedKinds` | Whether or not this article is included in the generated `/sitemap.xml` file. | +| `layoutBackgroundBlur` | `true` | Makes the background image in the background heroStyle blur with the scroll | +| `layoutBackgroundHeaderSpace` | `true` | Add space between the header and the body. | + diff --git a/themes/blowfish/exampleSite/content/docs/front-matter/index.md b/themes/blowfish/exampleSite/content/docs/front-matter/index.md new file mode 100644 index 0000000..38c477b --- /dev/null +++ b/themes/blowfish/exampleSite/content/docs/front-matter/index.md @@ -0,0 +1,58 @@ +--- +title: "Front Matter" +date: 2020-08-10 +draft: false +description: "All the front matter variables available in Blowfish." +slug: "front-matter" +tags: ["front matter", "config", "docs"] +series: ["Documentation"] +series_order: 7 +--- + +In addition to the [default Hugo front matter parameters](https://gohugo.io/content-management/front-matter/#front-matter-variables), Blowfish adds a number of additional options to customise the presentation of individual articles. All the available theme front matter parameters are listed below. + +Front matter parameter default values are inherited from the theme's [base configuration]({{< ref "configuration" >}}), so you only need to specify these parameters in your front matter when you want to override the default. + + +| Name | Default | Description | +| ----------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `title` | _Not set_ | The name of the article. | +| `description` | _Not set_ | The text description for the article. It is used in the HTML metadata. | +| `externalUrl` | _Not set_ | If this article is published on a third-party website, the URL to this article. Providing a URL will prevent a content page being generated and any references to this article will link directly to the third-party website. | +| `editURL` | `article.editURL` | When `showEdit` is active, the URL for the edit link. | +| `editAppendPath` | `article.editAppendPath` | When `showEdit` is active, whether or not the path to the current article should be appended to the URL set at `editURL`. | +| `groupByYear` | `list.groupByYear` | Whether or not articles are grouped by year on list pages. | +| `menu` | _Not set_ | When a value is provided, a link to this article will appear in the named menus. Valid values are `main` or `footer`. | +| `robots` | _Not set_ | String that indicates how robots should handle this article. If set, it will be output in the page head. Refer to [Google's docs](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) for valid values. | +| `sharingLinks` | `article.sharingLinks` | Which sharing links to display at the end of this article. When not provided, or set to `false` no links will be displayed. | +| `showAuthor` | `article.showAuthor` | Whether or not the author box for the default author is displayed in the article footer. | +| `showAuthorBottom` | `article.showAuthorBottom` | Author boxes are displayed at the bottom of each page instead of the top. | +| `authors` | _Not set_ | Array of values for authors, if set it overrides `showAuthor` settings for page or site. Used on the multiple authors feature, check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature. | +| `showAuthorsBadges` | `article.showAuthorsBadges` | Whether the `authors` taxonomies are are displayed in the article or list header. This requires the setup of `multiple authors` and the `authors` taxonomy. Check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature. | +| `featureimage` | _Not set_ | External URL for feature image | +| `featureimagecaption` | _Not set_ | Caption for feature image. Only displayed in heroStyle `big` | +| `showHero` | `article.showHero` | Whether the thumbnail image will be shown as a hero image within the article page. | +| `heroStyle` | `article.heroStyle` | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | +| `showBreadcrumbs` | `article.showBreadcrumbs` or `list.showBreadcrumbs` | Whether the breadcrumbs are displayed in the article or list header. | +| `showDate` | `article.showDate` | Whether or not the article date is displayed. The date is set using the `date` parameter. | +| `showDateUpdated` | `article.showDateUpdated` | Whether or not the date the article was updated is displayed. The date is set using the `lastmod` parameter. | +| `showEdit` | `article.showEdit` | Whether or not the link to edit the article content should be displayed. | +| `showHeadingAnchors` | `article.showHeadingAnchors` | Whether or not heading anchor links are displayed alongside headings within this article. | +| `showPagination` | `article.showPagination` | Whether or not the next/previous article links are displayed in the article footer. | +| `invertPagination` | `article.invertPagination` | Whether or not to flip the direction of the next/previous article links. | +| `showReadingTime` | `article.showReadingTime` | Whether or not the article reading time is displayed. | +| `showTaxonomies` | `article.showTaxonomies` | Whether or not the taxonomies that relate to this article are displayed. | +| `showTableOfContents` | `article.showTableOfContents` | Whether or not the table of contents is displayed on this article. | +| `showWordCount` | `article.showWordCount` | Whether or not the article word count is displayed. | +| `showComments` | `article.showComments` | Whether or not the [comments partial]({{< ref "partials#comments" >}}) is included after the article footer. | +| `showSummary` | `list.showSummary` | Whether or not the article summary should be displayed on list pages. | +| `showViews` | `article.showViews` | Whether or not the article views should be displayed in lists and detailed view. This requires a firebase integration. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish | +| `showLikes` | `article.showLikes` | Whether or not the article likes should be displayed in lists and detailed view. This requires a firebase integration. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish | +| `seriesOpened` | `article.seriesOpened` | Whether or not the series module will be displayed open by default or not. | +| `series` | _Not set_ | Array of series the article belongs to, we recommend using only one series per article. | +| `series_order` | _Not set_ | Number of the article within the series. | +| `summary` | Auto generated using `summaryLength` (see [site configuration]({{< ref "configuration#site-configuration" >}})) | When `showSummary` is enabled, this is the Markdown string to be used as the summary for this article. | +| `xml` | `true` unless excluded by `sitemap.excludedKinds` | Whether or not this article is included in the generated `/sitemap.xml` file. | +| `layoutBackgroundBlur` | `true` | Makes the background image in the background heroStyle blur with the scroll | +| `layoutBackgroundHeaderSpace` | `true` | Add space between the header and the body. | + diff --git a/themes/blowfish/exampleSite/content/docs/front-matter/index.zh-cn.md b/themes/blowfish/exampleSite/content/docs/front-matter/index.zh-cn.md new file mode 100644 index 0000000..bee8213 --- /dev/null +++ b/themes/blowfish/exampleSite/content/docs/front-matter/index.zh-cn.md @@ -0,0 +1,58 @@ +--- +title: "Front Matter" +date: 2020-08-10 +draft: false +description: "文本主要介绍 Blowfish 中页面中可以添加的所有的 Front Matter 参数。" +slug: "front-matter" +tags: ["front matter", "配置", "文档"] +series: ["部署教程"] +series_order: 7 +--- + +除了 [Hugo 中默认的 front matter](https://gohugo.io/content-management/front-matter/#front-matter-variables)，Blowfish 主题中还添加了大量的参数选项来自定义单个页面的展示方式。所有可用的扉页参数如下。 + +front matter 参数中的默认值是从[基础配置]({{< ref "configuration" >}})中继承的，所有只有当你想要覆盖默认值时，才需要在当前页面指定这些参数。 + + +| 名称 | 默认值 | 描述 | +| ----------------------------- | --------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `title` | 无 | 文章名称。 | +| `description` | 无 | 文章的描述信息，它会被添加在 HTML 的 `` 元数据中。 | +| `externalUrl` | 无 | 如果文章发布在第三方网站上，这里提供只想对应文章的 URL 地址。提供 URL 将会组织生成内容页面，对这篇文章的任何引用都会直接跳转到第三方网站的 URL 上面。 | +| `editURL` | `article.editURL` | 当激活 `showEdit` 参数时，此参数用来设置编辑文章的 URL。 | +| `editAppendPath` | `article.editAppendPath` | 当激活 `showEdit` 参数时，该参数指定是否将当前文章路径添加到 `editURL` 设置的 URL 后面。 | +| `groupByYear` | `list.groupByYear` | 是否在列表页面按年份对文章进行分组。 | +| `menu` | 无 | 当设置此值，这篇内容的链接将会出现在菜单中。有效值是 `main` 或 `footer`。 | +| `robots` | 无 | 支持搜索引擎的爬虫如何处理这篇文章。如果设置了此值，它将在页面头部输出。更多内容请参考 [Google 文档](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives)。 | +| `sharingLinks` | `article.sharingLinks` | 指定文章结尾显示哪些分享链接。如果没有设置或设置为 `false` ，则没有分享链接。 | +| `showAuthor` | `article.showAuthor` | 是否在页脚处显示作者框。 | +| `showAuthorBottom` | `article.showAuthorBottom` | 作者框显示在每页的底部而不是顶部。 | +| `authors` | 无 | 用于展示多创作者的数组，如果设置了将会覆盖 `showAuthor` 设置。这里使用了多作者的特性，查看[这个页面]({{< ref "multi-author" >}})来获取更多信息。 | +| `showAuthorsBadges` | `article.showAuthorsBadges` | 是否在文章和列表页展示`authors`作者分类。想是它生效需要开启`multiple authors`多创作者和 `authors` 作者分类。 查看[这个页面]({{< ref "multi-author" >}})来获取更多信息。 | +| `featureimage` | 无 | 基于外部 URL 的特征图片链接。 | +| `featureimagecaption` | 无 | 特征图片的说明，仅在 hero 样式的 `big` 风格下展示。 | +| `showHero` | `article.showHero` | 是否在文章页面将所裸土作为文章页面内的 hero 图片显示。 | +| `heroStyle` | `article.heroStyle` | hero 图片的风格，合法的值有： `basic`、`big`、`background`、`thumbAndBackground`。 | +| `showBreadcrumbs` | `article.showBreadcrumbs` or `list.showBreadcrumbs` | 是否在文章或列表页面显示面包屑导航。 | +| `showDate` | `article.showDate` | 是否显示文章的日期。具体日期使用 `date` 参数设置。 | +| `showDateUpdated` | `article.showDateUpdated` | 是否显示文章的更新日期。具体日期使用 `lastmod` 参数设置。 | +| `showEdit` | `article.showEdit` | 是否显示编辑文章内容的链接。 | +| `showHeadingAnchors` | `article.showHeadingAnchors` | 是否在文章的标题旁显示锚点链接。 | +| `showPagination` | `article.showPagination` | 是否在文章页脚显示下一篇/上一篇链接。 | +| `invertPagination` | `article.invertPagination` | 是否翻转下一篇/上一篇的链接方向。 | +| `showReadingTime` | `article.showReadingTime` | 是否显示文章的预估阅读时间。 | +| `showTaxonomies` | `article.showTaxonomies` | 是否显示文章关联的分类/标签。 | +| `showTableOfContents` | `article.showTableOfContents` | 是否显示文章目录。 | +| `showWordCount` | `article.showWordCount` | 是否显示文章字数统计。如果你的语言属于 CJK 语言，需要在 `config.toml` 中开启 `hasCJKLanguage` 参数。 | +| `showComments` | `article.showComments` | 是否在文章页脚显示 [评论部分]({{< ref "partials#comments" >}})。 | +| `showSummary` | `list.showSummary` | 是否在文章或列表页显示摘要。 | +| `showViews` | `article.showViews` | 是否显示文章和列表页面的阅读量。这需要集成 firebase ，具体可以看[这个页面]({{< ref "firebase-views" >}})来了解如何在 Blowfish 中集成firebase。 | +| `showLikes` | `article.showLikes` | 是否显示文章和列表页面的点赞量。这需要集成 firebase ，具体可以看[这个页面]({{< ref "firebase-views" >}})来了解如何在 Blowfish 中集成firebase。 | +| `seriesOpened` | `article.seriesOpened` | 是否打开系列模块。 | +| `series` | 无 | 文章所属的系列数组，我们建议每篇文章只属于一个系列。 | +| `series_order` | 无 | 文章在系列中的编号。 | +| `summary` | Auto generated using `summaryLength` (see [site configuration]({{< ref "configuration#site-configuration" >}})) | 当启用 `showSummary` 时，这是作为这篇文章摘要的Markdown字符串。 | +| `xml` | `true` unless excluded by `sitemap.excludedKinds` | 是否将这篇文章包含在生成的 `/sitemap.xml` 文件中。 | +| `layoutBackgroundBlur` | `true` | 向下滚动主页时，是否模糊背景图。 | +| `layoutBackgroundHeaderSpace` | `true` | 在标题和正文之间添加空白区域间隔。 | + -- cgit v1.2.3