mirror of
https://github.com/gohugoio/hugo.git
synced 2024-05-11 05:54:58 +00:00
78 lines
2.5 KiB
Markdown
78 lines
2.5 KiB
Markdown
|
---
|
|||
|
|
title: "Homepage"
|
|||
|
|
date: "2013-07-01"
|
|||
|
|
weight: 50
|
|||
|
|
notoc: true
|
|||
|
|
menu:
|
|||
|
|
main:
|
|||
|
|
parent: 'layout'
|
|||
|
|
aliases: ["/layout/homepage/"]
|
|||
|
|
prev: "/templates/list"
|
|||
|
|
next: "/templates/terms"
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
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 of the type "node" and have all the [node
|
|||
|
|
variables](/templates/variables/) and [site
|
|||
|
|
variables](/templates/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 node 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](/templates/list/)
|
|||
|
|
|
|||
|
|
## 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
|
|||
|
|
than the next one in the list will be used. This enables you to craft
|
|||
|
|
specific layouts when you want to without creating more templates
|
|||
|
|
then 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](http://spf13.com).
|
|||
|
|
|
|||
|
|
It makes use of [partial templates](/templates/partials) and uses a similar approach as a [List](/templates/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">
|
|||
|
|
|
|||
|
|
{{ template "partials/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 }}" />
|
|||
|
|
|
|||
|
|
{{ template "partials/head_includes.html" . }}
|
|||
|
|
</head>
|
|||
|
|
<body lang="en">
|
|||
|
|
|
|||
|
|
{{ template "partials/subheader.html" . }}
|
|||
|
|
|
|||
|
|
<section id="main">
|
|||
|
|
<div>
|
|||
|
|
{{ range first 10 .Data.Pages }}
|
|||
|
|
{{ .Render "summary"}}
|
|||
|
|
{{ end }}
|
|||
|
|
</div>
|
|||
|
|
</section>
|
|||
|
|
|
|||
|
|
{{ template "partials/footer.html" }}
|