shithub: hugo

Download patch

ref: 3f45e729f4e0296bb1a3558d60087bec8321444b
parent: ffaa73dc8aa860edb3476b2a460774071b8470a4
author: Cameron Moore <[email protected]>
date: Thu Sep 6 13:00:19 EDT 2018

output: Fix golint godoc issues

--- a/output/layout_base.go
+++ b/output/layout_base.go
@@ -30,6 +30,7 @@
 	goTemplateInnerMarkers  = [][]byte{[]byte("{{define"), []byte("{{ define"), []byte("{{- define"), []byte("{{-define")}
 )
 
+// TemplateNames represents a template naming scheme.
 type TemplateNames struct {
 	// The name used as key in the template map. Note that this will be
 	// prefixed with "_text/" if it should be parsed with text/template.
@@ -39,6 +40,7 @@
 	MasterFilename  string
 }
 
+// TemplateLookupDescriptor describes the template lookup configuration.
 type TemplateLookupDescriptor struct {
 	// The full path to the site root.
 	WorkingDir string
@@ -62,6 +64,7 @@
 	return strings.HasPrefix(name, "shortcodes/") || strings.HasPrefix(name, "partials/")
 }
 
+// CreateTemplateNames returns a TemplateNames object for a given template.
 func CreateTemplateNames(d TemplateLookupDescriptor) (TemplateNames, error) {
 
 	name := filepath.ToSlash(d.RelPath)
--- a/output/outputFormat.go
+++ b/output/outputFormat.go
@@ -71,10 +71,8 @@
 	NotAlternative bool `json:"notAlternative"`
 }
 
+// An ordered list of built-in output formats.
 var (
-	// An ordered list of built-in output formats
-	//
-	// See https://www.ampproject.org/learn/overview/
 	AMPFormat = Format{
 		Name:      "AMP",
 		MediaType: media.HTMLType,
@@ -82,6 +80,7 @@
 		Path:      "amp",
 		Rel:       "amphtml",
 		IsHTML:    true,
+		// See https://www.ampproject.org/learn/overview/
 	}
 
 	CalendarFormat = Format{
@@ -150,6 +149,7 @@
 	}
 )
 
+// DefaultFormats contains the default output formats supported by Hugo.
 var DefaultFormats = Formats{
 	AMPFormat,
 	CalendarFormat,
@@ -166,6 +166,7 @@
 	sort.Sort(DefaultFormats)
 }
 
+// Formats is a slice of Format.
 type Formats []Format
 
 func (formats Formats) Len() int           { return len(formats) }
@@ -330,10 +331,12 @@
 	return decoder.Decode(input)
 }
 
+// BaseFilename returns the base filename of formats.
 func (formats Format) BaseFilename() string {
 	return formats.BaseName + formats.MediaType.FullSuffix()
 }
 
+// MarshalJSON returns the JSON encoding of formats.
 func (formats Format) MarshalJSON() ([]byte, error) {
 	type Alias Format
 	return json.Marshal(&struct {