content: Clarify affect of hasCJKLanguage and isCJKLanguage

Author: jmooring

content/en/configuration/all.md

@@ -127,7 +127,7 @@ aliases: [/getting-started/configuration/]
 : See [configure front matter][].
 
 `hasCJKLanguage`
-: (`bool`) Whether to automatically detect [CJK](g) languages in content. Affects the values returned by the [`WordCount`][] and [`FuzzyWordCount`][] methods. Default is `false`.
+: (`bool`) Whether to automatically detect [CJK](g) languages in content. Affects the values returned by the [`FuzzyWordCount`][], [`ReadingTime`][], [`Summary`][], and [`WordCount`][] methods. To override this behavior on a given page, set the [`isCJKLanguage`][] field in its front matter. Default is `false`.
 
 `HTTPCache`
 : See [configure HTTP cache][].
@@ -360,10 +360,12 @@ Some configuration settings, such as menus and custom parameters, can be defined
 [`GitInfo`]: /methods/page/gitinfo/
 [`Lastmod`]: /methods/page/lastmod/
 [`MainSections`]: /methods/site/mainsections/
+[`ReadingTime`]: /methods/page/readingtime/
 [`Summary`]: /methods/page/summary/
 [`WordCount`]: /methods/page/wordcount/
 [`disabled`]: /configuration/languages/#disabled
 [`erroridf`]: /functions/fmt/erroridf/
+[`isCJKLanguage`]: /content-management/front-matter/#iscjklanguage
 [`os.UserCacheDir`]: https://pkg.go.dev/os#UserCacheDir
 [`segments`]: /configuration/segments/
 [`strings.Title`]: /functions/strings/title/

content/en/content-management/front-matter.md

@@ -63,7 +63,7 @@ The most common front matter fields are `date`, `draft`, `title`, and `weight`,
 : (`bool`) Applicable to [leaf bundles][], whether to set the `render` and `list` [build options][] to `never`, creating a headless bundle of [page resources][].
 
 `isCJKLanguage`
-: (`bool`) Whether the content language is in the [CJK](g) family. This value determines how Hugo calculates word count, and affects the values returned by the [`WordCount`][], [`FuzzyWordCount`][], [`ReadingTime`][], and [`Summary`][] methods on a `Page` object.
+: (`bool`) Whether the content is in a [CJK](g) language. This value determines how Hugo calculates word count, and affects the values returned by the [`FuzzyWordCount`][], [`ReadingTime`][], [`Summary`][], and [`WordCount`][] methods on a `Page` object. When set, this value takes precedence over the automatic detection enabled by the [`hasCJKLanguage`][] setting in your project configuration.
 
 `keywords`
 : (`[]string`) An array of keywords, typically rendered within a `meta` element within the `head` element of the published HTML file, or used as a [taxonomy](g) to classify content. Access these values from a template using the [`Keywords`][] method on a `Page` object.
@@ -307,10 +307,10 @@ To override the default time zone, set the [`timeZone`][] in your project config
 [`Description`]: /methods/page/description/
 [`Draft`]: /methods/page/draft/
 [`ExpiryDate`]: /methods/page/expirydate/
-[`FuzzyWordCount`]: /methods/page/wordcount/
+[`FuzzyWordCount`]: /methods/page/fuzzywordcount/
 [`GetTerms`]: /methods/page/getterms/
 [`Keywords`]: /methods/page/keywords/
-[`Lastmod`]: /methods/page/date/
+[`Lastmod`]: /methods/page/lastmod/
 [`Layout`]: /methods/page/layout/
 [`LinkTitle`]: /methods/page/linktitle/
 [`Param`]: /methods/page/param/
@@ -325,6 +325,7 @@ To override the default time zone, set the [`timeZone`][] in your project config
 [`Type`]: /methods/page/type/
 [`Weight`]: /methods/page/weight/
 [`WordCount`]: /methods/page/wordcount/
+[`hasCJKLanguage`]: /configuration/all/#hascjklanguage
 [`timeZone`]: /configuration/all/#timezone
 [aliases]: /content-management/urls/#aliases
 [build options]: /content-management/build-options/

content/en/methods/page/FuzzyWordCount.md

@@ -16,7 +16,8 @@ params:
 To get the exact word count, use the [`WordCount`][] method.
 
 > [!NOTE]
-> For content in CJK languages (Chinese, Japanese, Korean), set [`hasCJKLanguage`][] to `true` in your site configuration. This setting affects FuzzyWordCount in the same way as WordCount.
+> For content in [CJK](g) languages, set [`hasCJKLanguage`][] to `true` in your project configuration. When enabled, Hugo applies CJK word counting rules to pages containing CJK characters. To override this behavior on a given page, set the [`isCJKLanguage`][] field in its front matter.
 
-[`hasCJKLanguage`]: /configuration/all/#hascjklanguage
 [`WordCount`]: /methods/page/wordcount/
+[`hasCJKLanguage`]: /configuration/all/#hascjklanguage
+[`isCJKLanguage`]: /content-management/front-matter/#iscjklanguage

content/en/methods/page/ReadingTime.md

@@ -9,12 +9,10 @@ params:
     signatures: [PAGE.ReadingTime]
 ---
 
-The estimated reading time is calculated by dividing the number of words in the content by the reading speed.
-
-By default, Hugo assumes a reading speed of 212 words per minute. For CJK languages, it assumes 500 words per minute.
+Hugo calculates the estimated reading time by dividing the number of words in the content by a reading speed of 212 words per minute.
 
 > [!NOTE]
-> To use the CJK reading speed, set [`hasCJKLanguage`][] to `true` in your site configuration. Hugo automatically applies the CJK rate when this setting is enabled and the page contains CJK characters.
+> For content in [CJK](g) languages, set [`hasCJKLanguage`][] to `true` in your project configuration. When enabled, Hugo applies CJK word counting rules and a reading speed of 500 words per minute to pages containing CJK characters. To override this behavior on a given page, set the [`isCJKLanguage`][] field in its front matter.
 
 ```go-html-template
 {{ printf "Estimated reading time: %d minutes" .ReadingTime }}
@@ -50,3 +48,4 @@ Then in your template:
 We cast the `.WordCount` to a float to obtain a float when we divide by the reading speed. Then round up to the nearest integer.
 
 [`hasCJKLanguage`]: /configuration/all/#hascjklanguage
+[`isCJKLanguage`]: /content-management/front-matter/#iscjklanguage

content/en/methods/page/WordCount.md

@@ -13,10 +13,11 @@ params:
 {{ .WordCount }} → 103
 ```
 
-To round up to nearest multiple of 100, use the [`FuzzyWordCount`][] method.
+To round up to the nearest multiple of 100, use the [`FuzzyWordCount`][] method.
 
 > [!NOTE]
-> For content in CJK languages (Chinese, Japanese, Korean), set [`hasCJKLanguage`][] to `true` in your site configuration. When enabled, Hugo applies CJK word counting rules to pages containing CJK characters.
+> For content in [CJK](g) languages, set [`hasCJKLanguage`][] to `true` in your project configuration. When enabled, Hugo applies CJK word counting rules to pages containing CJK characters. To override this behavior on a given page, set the [`isCJKLanguage`][] field in its front matter.
 
 [`FuzzyWordCount`]: /methods/page/fuzzywordcount/
 [`hasCJKLanguage`]: /configuration/all/#hascjklanguage
+[`isCJKLanguage`]: /content-management/front-matter/#iscjklanguage