♻️ Move homepage recent articles to partial

exampleSite/config.toml

@@ -30,8 +30,8 @@ relativeURLs = true
 
 [params.homepage]
   layout = "custom"
-  showList = true
-  listSections = "samples"
+  showRecent = true
+  mainSections = ["samples"]
 
 [params.list]
   groupByYear = false

exampleSite/content/docs/configuration.md

@@ -57,8 +57,8 @@ Many of the article defaults here can be overridden on a per article basis by sp
 |Name|Type|Default|Description|
 | --- | --- | --- | --- |
 |`homepage.layout`|string|`"page"`|The layout of the homepage. Valid values are `page`, `profile` or `custom`. When set to `custom`, you must provide your own layout by creating a `/layouts/partials/home/custom.html` file. Refer to the [Homepage Layout](/docs/homepage-layout/) section for more details.|
-|`homepage.showList`|boolean|`false`|Whether or not recent articles are listed on the homepage beneath the page content. Refer to the [Recent Articles](/docs/homepage-layout/#recent-articles) docs for more details.|
-|`homepage.listSections`|array of strings|`["blog"]`|The sections of content to include in the recent list when `homepage.showList` is `true`.|
+|`homepage.showRecent`|boolean|`false`|Whether or not to display the recent articles list on the homepage.|
+|`homepage.mainSections`|array of strings|_Not set_|The sections that should be displayed in the recent articles list. If not provided the section with the greatest number of articles is used.|
 |`article.showDate`|boolean|`true`|Whether or not article dates are displayed.|
 |`article.dateFormat`|string|`"2 January 2006"`|How article dates are formatted. Refer to the [Hugo docs](https://gohugo.io/functions/format/#gos-layout-string) for acceptable formats.|
 |`article.showAuthor`|boolean|`true`|Whether or not the author box is displayed in the article footer.|

exampleSite/content/docs/homepage-layout/index.md

@@ -39,9 +39,11 @@ To enable the custom layout, set `homepage.layout = "custom"` in the `params.tom
 
 With the configuration value set, create a new `custom.html` file and place it in `layouts/partials/home/custom.html`. Now whatever is in the `custom.html` file will be placed in the content area of the site homepage. You can use whatever HTML, Tailwind, or Hugo templating functions to define your layout.
 
+To include recent articles on the custom layout, use the `recent-articles.html` partial.
+
 ## Recent articles
 
-All homepage layouts have the option of displaying recent articles below the main page content. To enable this, simply set the `homepage.showList` setting to `true` in the `params.toml` configuration file.
+All homepage layouts have the option of displaying recent articles below the main page content. To enable this, simply set the `homepage.showRecent` setting to `true` in the `params.toml` configuration file.
 
 ![Profile layout with recent articles](home-profile-list.jpg)
 

exampleSite/layouts/partials/home/custom.html

@@ -1,7 +1,7 @@
 <div id="page">
   {{ partial "partials/home/page.html" . }}
 </div>
-<div id="profile" class="hidden">
+<div id="profile" class="hidden h-full">
   {{ partial "partials/home/profile.html" . }}
 </div>