2.6 KiB
| aliases | lastmod | date | menu | next | notoc | prev | title | weight | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
2015-08-04 | 2013-07-01 |
|
/templates/terms | true | /templates/list | Homepage | 50 |
The home page of a website is often formatted differently than the other pages. In Hugo you can define your own homepage template.
Homepage is a Page and have all the page
variables and site
variables available to use in the templates.
This is the only required template for building a site and useful when bootstrapping a new site and template. It is also the only required template when using a single page site.
In addition to the standard page variables, the homepage has access to
all site content accessible from .Data.Pages. Details on how to use the
list of pages can be found in the Lists Template.
Note that a home page can also have a content file with frontmatter, see [Source Organization]({{< relref "overview/source-directory.md#content-for-home-page-and-other-list-pages" >}}).
Which Template will be rendered?
Hugo uses a set of rules to figure out which template to use when rendering a specific page.
Hugo will use the following prioritized list. If a file isn’t present, then the next one in the list will be used. This enables you to craft specific layouts when you want to without creating more templates than necessary. For most sites, only the _default file at the end of the list will be needed.
- /layouts/index.html
- /layouts/_default/list.html
- /layouts/_default/single.html
- /themes/
THEME/layouts/index.html - /themes/
THEME/layouts/_default/list.html - /themes/
THEME/layouts/_default/single.html
Example index.html
This content template is used for spf13.com.
It makes use of partial templates and uses a similar approach as a List.
<!DOCTYPE html>
<html class="no-js" lang="en-US" prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb#">
<head>
<meta charset="utf-8">
{{ partial "meta.html" . }}
<base href="{{ .Site.BaseURL }}">
<title>{{ .Site.Title }}</title>
<link rel="canonical" href="{{ .Permalink }}">
<link href="{{ .RSSLink }}" rel="alternate" type="application/rss+xml" title="{{ .Site.Title }}" />
{{ partial "head_includes.html" . }}
</head>
<body lang="en">
{{ partial "subheader.html" . }}
<section id="main">
<div>
{{ range first 10 .Data.Pages }}
{{ .Render "summary"}}
{{ end }}
</div>
</section>
{{ partial "footer.html" . }}