Skip to content

Commit e73444b

Browse files
jmooringwillfaught
andauthored
content: Clarify page title values
Co-authored-by: Will Faught <willfaught@users.noreply.github.com>
1 parent fd4c292 commit e73444b

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

content/en/methods/page/Title.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,16 @@ title = 'About us'
1919
{{ .Title }} → About us
2020
```
2121

22-
With section, taxonomy, and term pages not backed by a file, the `Title` method returns the section name, capitalized and pluralized. You can disable these transformations by setting [`capitalizeListTitles`] and [`pluralizeListTitles`] in your site configuration. For example:
22+
When a page is not backed by a file, the value returned by the `Title` method depends on the page [kind](g).
23+
24+
Page kind|Page title when the page is not backed by a file
25+
:--|:--
26+
home|site title
27+
section|section name (capitalized and pluralized)
28+
taxonomy|taxonomy name (capitalized and pluralized)
29+
term|term name (capitalized and pluralized)
30+
31+
You can disable automatic capitalization and pluralization in your site configuration:
2332

2433
{{< code-toggle file=hugo >}}
2534
capitalizeListTitles = false
@@ -32,8 +41,6 @@ You can change the capitalization style in your site configuration to one of `ap
3241
titleCaseStyle = "firstupper"
3342
{{< /code-toggle >}}
3443

35-
See&nbsp;[details].
44+
See&nbsp;[details].
3645

37-
[`capitalizeListTitles`]: /configuration/all/#capitalizelisttitles
38-
[`pluralizeListTitles`]: /configuration/all/#pluralizelisttitles
3946
[details]: /configuration/all/#title-case-style

0 commit comments

Comments
 (0)