Truncated; .Site.Params; First function

* Add `.Truncated` bool to each page; will be set true if the
  `.Summary` is truncated and it's worth showing a "more" link of some
  kind.
* Add `Params` to the site config, defining `.Site.Params` accessible
  to each page; this lets the site maintainer associate arbitrary data
  with names, on a site-wide basis.
* Provide a `First` function to templates:
  * Use-case: `{{range First 5 .Site.Recent}}` or anything else which
    is a simple iterable provided by hugolib
* Tests by me for `.Truncated` and `First`

Also @noahcampbell contributed towards this:

* Add UnitTest for `.Site.Params`:
> Digging into this test case a bit more, I'm realizing that we need
> to create a param test case to ensure that for each type we render
> (page, index, homepage, rss, etc.) that the proper fields are
> represented.  This will help us refactor without fear in the
> future.

Sample config.yaml:

```yaml
title: "Test site"
params:
  Subtitle: "More tests always good"
  AuthorName: "John Doe"
  SidebarRecentLimit: 5
```

Signed-off-by: Noah Campbell <noahcampbell@gmail.com>

hugolib/config.go

@@ -33,6 +33,7 @@ type Config struct {
 	Title                                      string
 	Indexes                                    map[string]string // singular, plural
 	ProcessFilters                             map[string][]string
+	Params                                     map[string]interface{}
 	BuildDrafts, UglyUrls, Verbose             bool
 }
 

hugolib/page.go

@@ -38,6 +38,7 @@ type Page struct {
 	Images      []string
 	Content     template.HTML
 	Summary     template.HTML
+	Truncated   bool
 	plain       string // TODO should be []byte
 	Params      map[string]interface{}
 	contentType string
@@ -94,21 +95,26 @@ func (p Page) Plain() string {
 	return p.plain
 }
 
-func getSummaryString(content []byte, fmt string) []byte {
+// nb: this is only called for recognised types; so while .html might work for
+// creating posts, it results in missing summaries.
+func getSummaryString(content []byte, pagefmt string) (summary []byte, truncates bool) {
 	if bytes.Contains(content, summaryDivider) {
 		// If user defines split:
 		// Split then render
-		return renderBytes(bytes.Split(content, summaryDivider)[0], fmt)
+		truncates = true // by definition
+		summary = renderBytes(bytes.Split(content, summaryDivider)[0], pagefmt)
 	} else {
 		// If hugo defines split:
 		// render, strip html, then split
-		plain := StripHTML(StripShortcodes(string(renderBytes(content, fmt))))
-		return []byte(TruncateWordsToWholeSentence(plain, summaryLength))
+		plain := strings.TrimSpace(StripHTML(StripShortcodes(string(renderBytes(content, pagefmt)))))
+		summary = []byte(TruncateWordsToWholeSentence(plain, summaryLength))
+		truncates = len(summary) != len(plain)
 	}
+	return
 }
 
-func renderBytes(content []byte, fmt string) []byte {
-	switch fmt {
+func renderBytes(content []byte, pagefmt string) []byte {
+	switch pagefmt {
 	default:
 		return blackfriday.MarkdownCommon(content)
 	case "markdown":
@@ -522,8 +528,9 @@ func (page *Page) convertMarkdown(lines io.Reader) {
 	b.ReadFrom(lines)
 	content := b.Bytes()
 	page.Content = template.HTML(string(blackfriday.MarkdownCommon(RemoveSummaryDivider(content))))
-	summary := getSummaryString(content, "markdown")
+	summary, truncated := getSummaryString(content, "markdown")
 	page.Summary = template.HTML(string(summary))
+	page.Truncated = truncated
 }
 
 func (page *Page) convertRestructuredText(lines io.Reader) {
@@ -531,8 +538,9 @@ func (page *Page) convertRestructuredText(lines io.Reader) {
 	b.ReadFrom(lines)
 	content := b.Bytes()
 	page.Content = template.HTML(getRstContent(content))
-	summary := getSummaryString(content, "rst")
+	summary, truncated := getSummaryString(content, "rst")
 	page.Summary = template.HTML(string(summary))
+	page.Truncated = truncated
 }
 
 func (p *Page) TargetPath() (outfile string) {

hugolib/page_test.go

@@ -212,6 +212,19 @@ func checkPageDate(t *testing.T, page *Page, time time.Time) {
 	}
 }
 
+func checkTruncation(t *testing.T, page *Page, shouldBe bool, msg string) {
+	if page.Summary == "" {
+		t.Fatal("page has no summary, can not check truncation")
+	}
+	if page.Truncated != shouldBe {
+		if shouldBe {
+			t.Fatalf("page wasn't truncated: %s", msg)
+		} else {
+			t.Fatalf("page was truncated: %s", msg)
+		}
+	}
+}
+
 func TestCreateNewPage(t *testing.T) {
 	p, err := ReadFrom(strings.NewReader(SIMPLE_PAGE), "simple.md")
 	if err != nil {
@@ -222,6 +235,7 @@ func TestCreateNewPage(t *testing.T) {
 	checkPageSummary(t, p, "Simple Page")
 	checkPageType(t, p, "page")
 	checkPageLayout(t, p, "page/single.html", "single.html")
+	checkTruncation(t, p, false, "simple short page")
 }
 
 func TestPageWithDelimiter(t *testing.T) {
@@ -234,6 +248,7 @@ func TestPageWithDelimiter(t *testing.T) {
 	checkPageSummary(t, p, "<p>Summary Next Line</p>\n")
 	checkPageType(t, p, "page")
 	checkPageLayout(t, p, "page/single.html", "single.html")
+	checkTruncation(t, p, true, "page with summary delimiter")
 }
 
 func TestPageWithShortCodeInSummary(t *testing.T) {
@@ -273,7 +288,7 @@ func TestPageWithDate(t *testing.T) {
 }
 
 func TestWordCount(t *testing.T) {
-	p, err := ReadFrom(strings.NewReader(SIMPLE_PAGE_WITH_LONG_CONTENT), "simple")
+	p, err := ReadFrom(strings.NewReader(SIMPLE_PAGE_WITH_LONG_CONTENT), "simple.md")
 	if err != nil {
 		t.Fatalf("Unable to create a page with frontmatter and body content: %s", err)
 	}
@@ -289,6 +304,8 @@ func TestWordCount(t *testing.T) {
 	if p.MinRead != 3 {
 		t.Fatalf("incorrect min read. expected %v, got %v", 3, p.MinRead)
 	}
+
+	checkTruncation(t, p, true, "long page")
 }
 
 func TestCreatePage(t *testing.T) {

hugolib/site.go

@@ -70,6 +70,7 @@ type Site struct {
 	Alias      target.AliasPublisher
 	Completed  chan bool
 	RunMode    runmode
+	params     map[string]interface{}
 }
 
 type SiteInfo struct {
@@ -79,6 +80,7 @@ type SiteInfo struct {
 	LastChange time.Time
 	Title      string
 	Config     *Config
+	Params     map[string]interface{}
 }
 
 type runmode struct {
@@ -222,6 +224,7 @@ func (s *Site) initializeSiteInfo() {
 		Title:   s.Config.Title,
 		Recent:  &s.Pages,
 		Config:  &s.Config,
+		Params:  s.Config.Params,
 	}
 }
 

hugolib/siteinfo_test.go

@@ -0,0 +1,32 @@
+package hugolib
+
+import (
+	"testing"
+	"bytes"
+)
+
+const SITE_INFO_PARAM_TEMPLATE = `{{ .Site.Params.MyGlobalParam }}`
+
+
+func TestSiteInfoParams(t *testing.T) {
+	s := &Site{
+		Config: Config{Params: map[string]interface{}{"MyGlobalParam": "FOOBAR_PARAM"}},
+	}
+
+	s.initialize()
+	if s.Info.Params["MyGlobalParam"] != "FOOBAR_PARAM" {
+		t.Errorf("Unable to set site.Info.Param")
+	}
+	s.prepTemplates()
+	s.addTemplate("template", SITE_INFO_PARAM_TEMPLATE)
+	buf := new(bytes.Buffer)
+
+	err := s.renderThing(s.NewNode(), "template", buf)
+	if err != nil {
+		t.Errorf("Unable to render template: %s", err)
+	}
+
+	if buf.String() != "FOOBAR_PARAM" {
+		t.Errorf("Expected FOOBAR_PARAM: got %s", buf.String())
+	}
+}