package resources

import "github.com/gohugoio/hugo/tpl/resources"

Package resources provides template functions for working with resources.

Index ¶

• type Namespace
• func New(deps *deps.Deps) (*Namespace, error)
• func (ns *Namespace) Babel(args ...interface{}) (resource.Resource, error)
• func (ns *Namespace) Concat(targetPathIn interface{}, r interface{}) (resource.Resource, error)
• func (ns *Namespace) ExecuteAsTemplate(args ...interface{}) (resource.Resource, error)
• func (ns *Namespace) Fingerprint(args ...interface{}) (resource.Resource, error)
• func (ns *Namespace) FromString(targetPathIn, contentIn interface{}) (resource.Resource, error)
• func (ns *Namespace) Get(filename interface{}) (resource.Resource, error)
• func (ns *Namespace) GetMatch(pattern interface{}) (resource.Resource, error)
• func (ns *Namespace) GetRemote(args ...interface{}) resource.Resource
• func (ns *Namespace) Match(pattern interface{}) (resource.Resources, error)
• func (ns *Namespace) Minify(r resources.ResourceTransformer) (resource.Resource, error)
• func (ns *Namespace) PostCSS(args ...interface{}) (resource.Resource, error)
• func (ns *Namespace) PostProcess(r resource.Resource) (postpub.PostPublishedResource, error)
• func (ns *Namespace) ToCSS(args ...interface{}) (resource.Resource, error)

Types ¶

type Namespace ¶

type Namespace struct {
	// contains filtered or unexported fields
}

Namespace provides template functions for the "resources" namespace.

func New ¶

func New(deps *deps.Deps) (*Namespace, error)

New returns a new instance of the resources-namespaced template functions.

func (*Namespace) Babel ¶

func (ns *Namespace) Babel(args ...interface{}) (resource.Resource, error)

Babel processes the given Resource with Babel.

func (*Namespace) Concat ¶

func (ns *Namespace) Concat(targetPathIn interface{}, r interface{}) (resource.Resource, error)

Concat concatenates a slice of Resource objects. These resources must (currently) be of the same Media Type.

func (*Namespace) ExecuteAsTemplate ¶

func (ns *Namespace) ExecuteAsTemplate(args ...interface{}) (resource.Resource, error)

ExecuteAsTemplate creates a Resource from a Go template, parsed and executed with the given data, and published to the relative target path.

func (*Namespace) Fingerprint ¶

func (ns *Namespace) Fingerprint(args ...interface{}) (resource.Resource, error)

Fingerprint transforms the given Resource with a MD5 hash of the content in the RelPermalink and Permalink.

func (*Namespace) FromString ¶

func (ns *Namespace) FromString(targetPathIn, contentIn interface{}) (resource.Resource, error)

FromString creates a Resource from a string published to the relative target path.

func (*Namespace) Get ¶

func (ns *Namespace) Get(filename interface{}) (resource.Resource, error)

Get locates the filename given in Hugo's assets filesystem and creates a Resource object that can be used for further transformations.

func (*Namespace) GetMatch ¶

func (ns *Namespace) GetMatch(pattern interface{}) (resource.Resource, error)

GetMatch finds the first Resource matching the given pattern, or nil if none found.

It looks for files in the assets file system.

See Match for a more complete explanation about the rules used.

func (*Namespace) GetRemote ¶

func (ns *Namespace) GetRemote(args ...interface{}) resource.Resource

GetRemote gets the URL (via HTTP(s)) in the first argument in args and creates Resource object that can be used for further transformations.

A second argument may be provided with an option map.

Note: This method does not return any error as a second argument, for any error situations the error can be checked in .Err.

func (*Namespace) Match ¶

func (ns *Namespace) Match(pattern interface{}) (resource.Resources, error)

Match gets all resources matching the given base path 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 files name with path relative to the file system 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.

It looks for files in the assets file system.

See Match for a more complete explanation about the rules used.

func (*Namespace) Minify ¶

func (ns *Namespace) Minify(r resources.ResourceTransformer) (resource.Resource, error)

Minify minifies the given Resource using the MediaType to pick the correct minifier.

func (*Namespace) PostCSS ¶

func (ns *Namespace) PostCSS(args ...interface{}) (resource.Resource, error)

PostCSS processes the given Resource with PostCSS

func (*Namespace) PostProcess ¶

func (ns *Namespace) PostProcess(r resource.Resource) (postpub.PostPublishedResource, error)

func (*Namespace) ToCSS ¶

func (ns *Namespace) ToCSS(args ...interface{}) (resource.Resource, error)

ToCSS converts the given Resource to CSS. You can optional provide an Options object or a target path (string) as first argument.

Source Files ¶

init.go resources.go