aboutsummaryrefslogtreecommitdiffstats
path: root/content/templates/homepage.md
diff options
context:
space:
mode:
Diffstat (limited to 'content/templates/homepage.md')
-rw-r--r--content/templates/homepage.md78
1 files changed, 78 insertions, 0 deletions
diff --git a/content/templates/homepage.md b/content/templates/homepage.md
new file mode 100644
index 0000000..f4dfc76
--- /dev/null
+++ b/content/templates/homepage.md
@@ -0,0 +1,78 @@
+---
+aliases:
+- /layout/homepage/
+date: 2013-07-01
+menu:
+ main:
+ parent: layout
+next: /templates/terms
+notoc: true
+prev: /templates/list
+title: Homepage
+weight: 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 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,
+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](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">
+
+ {{ 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" }}