resource

Documentation

Index

• type Cloner
• type ContentResource
• type Identifier
• type OpenReadSeekCloser
• type ReadSeekCloserResource
• type Resource
• type Resources
  • func (r Resources) ByType(tp string) Resources
  • func (r Resources) GetMatch(pattern string) Resource
  • func (r Resources) Match(pattern string) Resources
  • func (r Resources) MergeByLanguage(r2 Resources) Resources
  • func (r Resources) MergeByLanguageInterface(in interface{}) (interface{}, error)
• type ResourcesConverter
• type ResourcesLanguageMerger
• type Source

Types

type Cloner

type Cloner interface {
	WithNewBase(base string) Resource
}

Cloner is an internal template and not meant for use in the templates. It may change without notice.

type ContentResource

type ContentResource interface {

	// Content returns this resource's content. It will be equivalent to reading the content
	// that RelPermalink points to in the published folder.
	// The return type will be contextual, and should be what you would expect:
	// * Page: template.HTML
	// * JSON: String
	// * Etc.
	Content() (interface{}, error)
	// contains filtered or unexported methods
}

ContentResource represents a Resource that provides a way to get to its content. Most Resource types in Hugo implements this interface, including Page. This should be used with care, as it will read the file content into memory, but it should be cached as effectively as possible by the implementation.

type Identifier

type Identifier interface {
	Key() string
}

Identifier identifies a resource.

type OpenReadSeekCloser

type OpenReadSeekCloser func() (hugio.ReadSeekCloser, error)

OpenReadSeekCloser allows setting some other way (than reading from a filesystem) to open or create a ReadSeekCloser.

type ReadSeekCloserResource

type ReadSeekCloserResource interface {
	ReadSeekCloser() (hugio.ReadSeekCloser, error)
	// contains filtered or unexported methods
}

ReadSeekCloserResource is a Resource that supports loading its content.

type Resource

type Resource interface {

	// Permalink represents the absolute link to this resource.
	Permalink() string

	// RelPermalink represents the host relative link to this resource.
	RelPermalink() string

	// ResourceType is the resource type. For most file types, this is the main
	// part of the MIME type, e.g. "image", "application", "text" etc.
	// For content pages, this value is "page".
	ResourceType() string

	// Name is the logical name of this resource. This can be set in the front matter
	// metadata for this resource. If not set, Hugo will assign a value.
	// This will in most cases be the base filename.
	// So, for the image "/some/path/sunset.jpg" this will be "sunset.jpg".
	// The value returned by this method will be used in the GetByPrefix and ByPrefix methods
	// on Resources.
	Name() string

	// Title returns the title if set in front matter. For content pages, this will be the expected value.
	Title() string

	// Resource specific data set by Hugo.
	// One example would be.Data.Digest for fingerprinted resources.
	Data() interface{}

	// Params set in front matter for this resource.
	Params() map[string]interface{}
	// contains filtered or unexported methods
}

Resource represents a linkable resource, i.e. a content page, image etc.

type Resources

type Resources []Resource

Resources represents a slice of resources, which can be a mix of different types. I.e. both pages and images etc.

func (Resources) ByType

func (r Resources) ByType(tp string) Resources

ByType returns resources of a given resource type (ie. "image").

func (Resources) GetMatch

func (r Resources) GetMatch(pattern string) Resource

GetMatch finds the first Resource matching the given pattern, or nil if none found. See Match for a more complete explanation about the rules used.

func (Resources) Match

func (r Resources) Match(pattern string) Resources

Match gets all resources matching the given base filename prefix, e.g "*.png" will match all png files. The "*" does not match path delimiters (/), so if you organize your resources in sub-folders, you need to be explicit about it, e.g.: "images/*.png". To match any PNG image anywhere in the bundle you can do "**.png", and to match all PNG images below the images folder, use "images/**.jpg". The matching is case insensitive. Match matches by using the value of Resource.Name, which, by default, is a filename with path relative to the bundle root with Unix style slashes (/) and no leading slash, e.g. "images/logo.png". See https://github.com/gobwas/glob for the full rules set.

func (Resources) MergeByLanguage

func (r Resources) MergeByLanguage(r2 Resources) Resources

MergeByLanguage adds missing translations in r1 from r2.

func (Resources) MergeByLanguageInterface

func (r Resources) MergeByLanguageInterface(in interface{}) (interface{}, error)

MergeByLanguageInterface is the generic version of MergeByLanguage. It is here just so it can be called from the tpl package.

type ResourcesConverter

type ResourcesConverter interface {
	ToResources() Resources
}

ResourcesConverter converts a given slice of Resource objects to Resources.

type ResourcesLanguageMerger

type ResourcesLanguageMerger interface {
	MergeByLanguage(other Resources) Resources
	// Needed for integration with the tpl package.
	MergeByLanguageInterface(other interface{}) (interface{}, error)
}

ResourcesLanguageMerger describes an interface for merging resources from a different language.

type Source

type Source interface {
	Publish() error
}

Source is an internal template and not meant for use in the templates. It may change without notice.