mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-29 08:12:06 -05:00
56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
---
|
|
title: Homepage template
|
|
description: The homepage of a website is often formatted differently than the other pages. For this reason, Hugo makes it easy for you to define your new site's homepage as a unique template.
|
|
categories: [templates]
|
|
keywords: [homepage]
|
|
menu:
|
|
docs:
|
|
parent: templates
|
|
weight: 70
|
|
weight: 70
|
|
toc: true
|
|
aliases: [/layout/homepage/,/templates/homepage-template/]
|
|
---
|
|
|
|
The homepage template is the *only* required template for building a site and therefore useful when bootstrapping a new site and template. It is also the only required template if you are developing a single-page website.
|
|
|
|
|
|
{{< youtube ut1xtRZ1QOA >}}
|
|
|
|
## Homepage template lookup order
|
|
|
|
See [Template Lookup](/templates/lookup-order/).
|
|
|
|
## Add content and front matter to the homepage
|
|
|
|
The homepage, similar to other [list pages in Hugo][lists], accepts content and front matter from an `_index.md` file. This file should live at the root of your `content` folder (i.e., `content/_index.md`). You can then add body copy and metadata to your homepage the way you would any other content file.
|
|
|
|
See the homepage template below or [Content Organization][contentorg] for more information on the role of `_index.md` in adding content and front matter to list pages.
|
|
|
|
## Example homepage template
|
|
|
|
{{< code file=layouts/index.html >}}
|
|
{{ define "main" }}
|
|
<main aria-role="main">
|
|
<header class="homepage-header">
|
|
<h1>{{ .Title }}</h1>
|
|
{{ with .Params.subtitle }}
|
|
<span class="subtitle">{{ . }}</span>
|
|
{{ end }}
|
|
</header>
|
|
<div class="homepage-content">
|
|
<!-- Note that the content for index.html, as a sort of list page, will pull from content/_index.md -->
|
|
{{ .Content }}
|
|
</div>
|
|
<div>
|
|
{{ range first 10 .Site.RegularPages }}
|
|
{{ .Render "summary" }}
|
|
{{ end }}
|
|
</div>
|
|
</main>
|
|
{{ end }}
|
|
{{< /code >}}
|
|
|
|
[contentorg]: /content-management/organization/
|
|
[lists]: /templates/lists/
|
|
[lookup]: /templates/lookup-order/
|