From 556871b824f7379060b98098db11b89fee916569 Mon Sep 17 00:00:00 2001 From: Cell <1024@lruihao.cn> Date: Sun, 27 Oct 2024 01:59:07 +0800 Subject: [PATCH] =?UTF-8?q?Docs:=20=E5=A2=9E=E5=8A=A0=E7=9B=B8=E5=85=B3?= =?UTF-8?q?=E5=86=85=E5=AE=B9=E6=96=87=E6=A1=A3=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit TODO 中午翻译 --- .../related/featured-image.webp | Bin 0 -> 24256 bytes .../content-management/related/index.md | 121 +++++++++++++++++ .../content-management/related/index.md | 126 ++++++++++++++++++ 3 files changed, 247 insertions(+) create mode 100644 content/en/documentation/content-management/related/featured-image.webp create mode 100644 content/en/documentation/content-management/related/index.md create mode 100644 content/zh-cn/documentation/content-management/related/index.md diff --git a/content/en/documentation/content-management/related/featured-image.webp b/content/en/documentation/content-management/related/featured-image.webp new file mode 100644 index 0000000000000000000000000000000000000000..fbe9eec514fb7675bb8025ea3dd172195b5f4f2c GIT binary patch literal 24256 zcmdqH^Rwt&umyN*+qP}nHt(@*pL=ZEwr$(CZJTqy_g>Y^-!Q3U@BKs4)#*-ptzL*oSP)0#Q5D)+WkUft80D`4NbA?<)q)*?F zLT9+;nkBSfAObYRt}c!Y5OBFSdCDsmb^aGpLeDIpizI#4@Hu@`v4&>b8LjGDt0Bs3 z{DJ#D_xJzL`)_Y¨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 F003v40G|K= literal 0 HcmV?d00001 diff --git a/content/en/documentation/content-management/related/index.md b/content/en/documentation/content-management/related/index.md new file mode 100644 index 0000000..c4dc6cf --- /dev/null +++ b/content/en/documentation/content-management/related/index.md @@ -0,0 +1,121 @@ +--- +title: Related content +date: 2024-10-27T01:05:43+08:00 +description: List related content in "Related content" sections. +type: posts +tags: + - Related + - Content + - Advanced +categories: + - Documentation +collections: + - Content Management +resources: + - name: featured-image + src: featured-image.webp +--- + +List related content in "Related content" sections. + + + +Hugo uses a set of factors to identify a page's related content based on front matter parameters. This can be tuned to the desired set of indices and parameters or left to Hugo's default [Related Content configuration](#configure-related-content). + +## Enable related Content + +To enable related content, set the `page.related.enable` parameter to `true` in the site configuration file. + +```toml +[params] + [params.page] + [params.page.related] + enable = true + count = 5 +``` + +> [!NOTE] +> If you want to hide a page from the related posts, set the `hiddenFromRelated` parameter to `true` in the page's front matter. + +## Configure related content {#configure-related-content} + +Hugo provides a sensible default configuration of Related Content, but you can fine-tune this in your configuration, on the global or language level if needed. + +> This section may be outdated. Refer to the [Related content | Hugo][hugo-related] for the latest information. + +### Default configuration + +Without any `related` configuration set on the project, Hugo’s Related Content methods will use the following. + +```toml {data-open=true} +[related] + includeNewer = false + threshold = 80 + toLower = false + [[related.indices]] + applyFilter = false + cardinalityThreshold = 0 + name = 'keywords' + pattern = '' + toLower = false + type = 'basic' + weight = 100 + [[related.indices]] + applyFilter = false + cardinalityThreshold = 0 + name = 'date' + pattern = '' + toLower = false + type = 'basic' + weight = 10 + [[related.indices]] + applyFilter = false + cardinalityThreshold = 0 + name = 'tags' + pattern = '' + toLower = false + type = 'basic' + weight = 80 +``` + +Custom configuration should be set using the same syntax. + +> [!TIP] +> If you add a `related` configuration section, you need to add a complete configuration. It is not possible to just set, say, `includeNewer` and use the rest from the Hugo defaults. + +### Top level configuration options + +threshold +: (`int`) A value between 0-100. Lower value will give more, but maybe not so relevant, matches. + +includeNewer +: (`bool`) Set to `true` to include **pages newer than the current page** in the related content listing. This will mean that the output for older posts may change as new related content gets added. + +toLower +: (`bool`) Set to `true` to lower case keywords in both the indexes and the queries. This may give more accurate results at a slight performance penalty. Note that this can also be set per index. + +### Configuration options per index + +name +: (`string`) The index name. This value maps directly to a page parameter. Hugo supports string values (`author` in the example) and lists (`tags`, `keywords` etc.) and time and date objects. + +type +: (`string`) One of `basic`(default) or `fragments`. + +applyFilter +: (`string`) Apply a `type` specific filter to the result of a search. This is currently only used for the `fragments` type. + +weight +: (`int`) An integer weight that indicates how important this parameter is relative to the other parameters. It can be `0`, which has the effect of turning this index off, or even negative. Test with different values to see what fits your content best. + +cardinalityThreshold +: (`int`) If between 1 and 100, this is a percentage. All keywords that are used in more than this percentage of documents are removed. For example, setting this to `60` will remove all keywords that are used in more than 60% of the documents in the index. If `0`, no keyword is removed from the index. Default is `0`. + +pattern +: (`string`) This is currently only relevant for dates. When listing related content, we may want to list content that is also close in time. Setting “2006” (default value for date indexes) as the pattern for a date index will add weight to pages published in the same year. For busier blogs, “200601” (year and month) may be a better default. + +toLower +: (`bool`) See above. + + +[hugo-related]: https://gohugo.io/content-management/related/ diff --git a/content/zh-cn/documentation/content-management/related/index.md b/content/zh-cn/documentation/content-management/related/index.md new file mode 100644 index 0000000..879576d --- /dev/null +++ b/content/zh-cn/documentation/content-management/related/index.md @@ -0,0 +1,126 @@ +--- +title: 相关内容 +date: 2024-10-27T01:05:43+08:00 +description: List related content in "Related content" sections. +type: posts +tags: + - Related + - Content + - Advanced +categories: + - Documentation +collections: + - Content Management +resources: + - name: featured-image + src: featured-image.webp +--- + +> [!help]+ 中文文档翻译 +> 本文尚未翻译完成，欢迎 [参与翻译](https://github.com/hugo-fixit/docs/pulls)。 + +--- + +List related content in "Related content" sections. + + + +Hugo uses a set of factors to identify a page's related content based on front matter parameters. This can be tuned to the desired set of indices and parameters or left to Hugo's default [Related Content configuration](#configure-related-content). + +## Enable related Content + +To enable related content, set the `page.related.enable` parameter to `true` in the site configuration file. + +```toml +[params] + [params.page] + [params.page.related] + enable = true + count = 5 +``` + +> [!NOTE] +> If you want to hide a page from the related posts, set the `hiddenFromRelated` parameter to `true` in the page's front matter. + +## Configure related content {#configure-related-content} + +Hugo provides a sensible default configuration of Related Content, but you can fine-tune this in your configuration, on the global or language level if needed. + +> This section may be outdated. Refer to the [Related content | Hugo][hugo-related] for the latest information. + +### Default configuration + +Without any `related` configuration set on the project, Hugo’s Related Content methods will use the following. + +```toml {data-open=true} +[related] + includeNewer = false + threshold = 80 + toLower = false + [[related.indices]] + applyFilter = false + cardinalityThreshold = 0 + name = 'keywords' + pattern = '' + toLower = false + type = 'basic' + weight = 100 + [[related.indices]] + applyFilter = false + cardinalityThreshold = 0 + name = 'date' + pattern = '' + toLower = false + type = 'basic' + weight = 10 + [[related.indices]] + applyFilter = false + cardinalityThreshold = 0 + name = 'tags' + pattern = '' + toLower = false + type = 'basic' + weight = 80 +``` + +Custom configuration should be set using the same syntax. + +> [!TIP] +> If you add a `related` configuration section, you need to add a complete configuration. It is not possible to just set, say, `includeNewer` and use the rest from the Hugo defaults. + +### Top level configuration options + +threshold +: (`int`) A value between 0-100. Lower value will give more, but maybe not so relevant, matches. + +includeNewer +: (`bool`) Set to `true` to include **pages newer than the current page** in the related content listing. This will mean that the output for older posts may change as new related content gets added. + +toLower +: (`bool`) Set to `true` to lower case keywords in both the indexes and the queries. This may give more accurate results at a slight performance penalty. Note that this can also be set per index. + +### Configuration options per index + +name +: (`string`) The index name. This value maps directly to a page parameter. Hugo supports string values (`author` in the example) and lists (`tags`, `keywords` etc.) and time and date objects. + +type +: (`string`) One of `basic`(default) or `fragments`. + +applyFilter +: (`string`) Apply a `type` specific filter to the result of a search. This is currently only used for the `fragments` type. + +weight +: (`int`) An integer weight that indicates how important this parameter is relative to the other parameters. It can be `0`, which has the effect of turning this index off, or even negative. Test with different values to see what fits your content best. + +cardinalityThreshold +: (`int`) If between 1 and 100, this is a percentage. All keywords that are used in more than this percentage of documents are removed. For example, setting this to `60` will remove all keywords that are used in more than 60% of the documents in the index. If `0`, no keyword is removed from the index. Default is `0`. + +pattern +: (`string`) This is currently only relevant for dates. When listing related content, we may want to list content that is also close in time. Setting “2006” (default value for date indexes) as the pattern for a date index will add weight to pages published in the same year. For busier blogs, “200601” (year and month) may be a better default. + +toLower +: (`bool`) See above. + + +[hugo-related]: https://gohugo.io/content-management/related/