a7e1e9be8 Clarify front matter date fields 69df4fc22 Clarify how to determine if .Inner is populated 9046bf424 Document strings.ContainsNonSpace 8dbe5df90 Fix indentation and broken image 48ad4124e Typo: functions/after.md d4c01b57b Link to detailed descriptions of canonfiyURLs and relativeURLs 4d9597302 Explain behaviour when appending to a slice containing other slices 69e24e44e Standardize right arrow usage 01b378726 Remove references to Google's Universal Analytics and the async template d415bae24 Use shared file to describe regex syntax e75dee6b8 snap: How to enable or revoke access to SSH keys feed2d1c0 Remove hasPrefix and hasSuffix in favor of namespaced versions 3c6d2cfe5 security: Use default execution settings 461b5fcaf netlify: Hugo 0.116.1 95fac27a5 configuration: correct cacheDir description cd9f1f929 configuration: Fix broken link 605394de4 netlify: Upgrade to Hugo 0.116.0 baf2a0f7b Merge branch 'tempv0.116.0' ee51a9323 Update requirements for building from source 40189956d Editor tools: Remove duplicate sentence fb0ff2621 docs: Regenerate CLI docs e8a5665c4 Update where.md 7bc5cf15d Update hosting instructions 018a04314 docs: Update where d33ae91cf docs: Update where function operators 9a108a664 docs: Rework the cacheDir documentation git-subtree-dir: docs git-subtree-split: a7e1e9be851b95e636ab5360e5151156b4f89044
2.4 KiB
title | description | categories | keywords | menu | weight | aliases | toc | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Homepage template | 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. |
|
|
|
70 |
|
true |
Homepage is a Page
and therefore has all the page variables and site variables available for use.
{{% note %}} 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. {{% /note %}}
{{< youtube ut1xtRZ1QOA >}}
Homepage template lookup order
See Template Lookup.
Add content and front matter to the homepage
The homepage, similar to other list pages in Hugo, 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 for more information on the role of _index.md
in adding content and front matter to list pages.
Example homepage template
The following is an example of a homepage template that uses partial, base templates, and a content file at content/_index.md
to populate the {{ .Title }}
and {{ .Content }}
page variables.
{{< code file="layouts/index.html" >}} {{ define "main" }}