ref: 9e029fe41204e2c06dc867b1cf8ab97e8c100397
parent: c5f1031e45f74e649a270359da2a3436e515c346
author: Joel Scoble <[email protected]>
date: Wed Oct 15 13:59:43 EDT 2014
#463 add summary.md page
--- a/docs/content/content/example.md
+++ b/docs/content/content/example.md
@@ -8,7 +8,7 @@
parent: content
next: /themes/overview
notoc: true
-prev: /content/ordering
+prev: /content/summaries
title: Example Content File
weight: 70
---
--- a/docs/content/content/ordering.md
+++ b/docs/content/content/ordering.md
@@ -4,7 +4,7 @@
menu:
main:
parent: content
-next: /content/example
+next: /content/summaries
prev: /content/archetypes
title: Ordering Content
weight: 60
--- /dev/null
+++ b/docs/content/content/summaries.md
@@ -1,0 +1,25 @@
+---
+date: 2013-07-01
+menu:
+ main:
+ parent: content
+next: /content/example
+notoc: true
+prev: /content/ordering
+title: Summaries
+weight: 65
+---
+
+Hugo generates summaries of content for easily showing snippets in summary views. The summary view snippets are automatically generated by Hugo. Where a piece of content's summary is split depends on whether the split is Hugo defined or use defined.
+
+Content summaries provide links to the original content, usually in the form of a `Read More` link.
+
+## Automatic summary split
+
+By default, Hugo automatically splits content after 70 words, with the content prior to the split being used for the content summary. This way you don't have to worry about content summary unless you want to customize it; the summary is automatically created for you, and available to be used by Hugo, without any additional work on your part.
+
+## User defined summary split
+
+Hugo also provides an easy way to customize a piece of content's split with its summary content divider: <code><!--more--></code>. If the summary content divider exists within a piece of content, Hugo will split the content at that point, instead of the default 70 words. The content prior to the summary content provider will be used as that content's summary. The summary content provider, <code><!--more--></code>, will be elided from the rendered content.
+
+The summary content divider only applies to the content that it appears in.