tpl

package
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 20, 2022 License: Apache-2.0 Imports: 11 Imported by: 0

Documentation

Index

Constants

View Source 
const TemplateVersion = 2

Increments on breaking changes.

Variables

View Source 
var DefaultParseConfig = ParseConfig{
	Version: TemplateVersion,
}
View Source 
var DefaultParseInfo = ParseInfo{
	Config: DefaultParseConfig,
}

Functions

func GetDataFromContext added in v1.0.0 

func GetDataFromContext(ctx context.Context) any

GetDataFromContext returns the template data context (usually .Page) from ctx if set. NOte: This is not fully implemented yet.

func GetHasLockFromContext added in v1.0.0 

func GetHasLockFromContext(ctx context.Context) bool

func SetHasLockInContext added in v1.0.0 

func SetHasLockInContext(ctx context.Context, hasLock bool) context.Context

func StripHTML added in v1.0.0 

func StripHTML(s string) string

StripHTML strips out all HTML tags in s.

Types

type FileInfo added in v1.0.0 

type FileInfo interface {
	Name() string
	Filename() string
}

type Info added in v1.0.0 

type Info interface {
	ParseInfo() ParseInfo

	// Identifies this template and its dependencies.
	identity.Provider
}

func NewInfo added in v1.0.0 

func NewInfo(id identity.Manager, parseInfo ParseInfo) Info

type InfoManager added in v1.0.0 

type InfoManager interface {
	ParseInfo() ParseInfo

	// Identifies and manages this template and its dependencies.
	identity.Manager
}

type ParseConfig added in v1.0.0 

type ParseConfig struct {
	Version int
}

type ParseInfo added in v1.0.0 

type ParseInfo struct {
	// Set for shortcode templates with any {{ .Inner }}
	IsInner bool

	// Set for partials with a return statement.
	HasReturn bool

	// Config extracted from template.
	Config ParseConfig
}

func (ParseInfo) IsZero added in v1.0.0 

func (info ParseInfo) IsZero() bool

type Template 

type Template interface {
	Name() string
	Prepare() (*texttemplate.Template, error)
}

Template is the common interface between text/template and html/template.

func WithInfo added in v1.0.0 

func WithInfo(templ Template, info Info) Template

WithInfo wraps the info in a template.

type TemplateDebugger added in v0.22.1 

type TemplateDebugger interface {
	Debug()
}

TemplateDebugger prints some debug info to stdout.

type TemplateFinder added in v0.20.1 

type TemplateFinder interface {
	TemplateLookup
	TemplateLookupVariant
}

TemplateFinder finds templates.

type TemplateFuncGetter added in v1.0.0 

type TemplateFuncGetter interface {
	GetFunc(name string) (reflect.Value, bool)
}

TemplateFuncGetter allows to find a template func by name.

type TemplateHandler added in v0.20.1 

type TemplateHandler interface {
	TemplateFinder
	Execute(t Template, wr io.Writer, data any) error
	ExecuteWithContext(ctx context.Context, t Template, wr io.Writer, data any) error
	LookupLayout(d output.LayoutDescriptor, f output.Format) (Template, bool, error)
	HasTemplate(name string) bool
}

TemplateHandler finds and executes templates.

type TemplateLookup added in v1.0.0 

type TemplateLookup interface {
	Lookup(name string) (Template, bool)
}

type TemplateLookupVariant added in v1.0.0 

type TemplateLookupVariant interface {
	// TODO(bep) this currently only works for shortcodes.
	// We may unify and expand this variant pattern to the
	// other templates, but we need this now for the shortcodes to
	// quickly determine if a shortcode has a template for a given
	// output format.
	// It returns the template, if it was found or not and if there are
	// alternative representations (output format, language).
	// We are currently only interested in output formats, so we should improve
	// this for speed.
	LookupVariant(name string, variants TemplateVariants) (Template, bool, bool)
	LookupVariants(name string) []Template
}

type TemplateManager added in v1.0.0 

type TemplateManager interface {
	TemplateHandler
	TemplateFuncGetter
	AddTemplate(name, tpl string) error
	MarkReady() error
}

TemplateManager manages the collection of templates.

type TemplateParseFinder added in v0.45.1 

type TemplateParseFinder interface {
	TemplateParser
	TemplateFinder
}

TemplateParseFinder provides both parsing and finding.

type TemplateParser added in v0.45.1 

type TemplateParser interface {
	Parse(name, tpl string) (Template, error)
}

TemplateParser is used to parse ad-hoc templates, e.g. in the Resource chain.

type TemplateVariants added in v1.0.0 

type TemplateVariants struct {
	Language     string
	OutputFormat output.Format
}

TemplateVariants describes the possible variants of a template. All of these may be empty.

type TemplatesProvider added in v1.0.0 

type TemplatesProvider interface {
	Tmpl() TemplateHandler
	TextTmpl() TemplateParseFinder
}

TemplatesProvider as implemented by deps.Deps.

type UnusedTemplatesProvider added in v1.0.0 

type UnusedTemplatesProvider interface {
	UnusedTemplates() []FileInfo
}

UnusedTemplatesProvider lists unused templates if the build is configured to track those.

Source Files

View all Source files

Directories

Path Synopsis
Package cast provides template functions for data type conversions.
 Package cast provides template functions for data type conversions.
Package collections provides template functions for manipulating collections such as arrays, maps, and slices.
 Package collections provides template functions for manipulating collections such as arrays, maps, and slices.
Package compare provides template functions for comparing values.
 Package compare provides template functions for comparing values.
Package crypto provides template functions for cryptographic operations.
 Package crypto provides template functions for cryptographic operations.
Package data provides template functions for working with external data sources.
 Package data provides template functions for working with external data sources.
Package debug provides template functions to help debugging templates.
 Package debug provides template functions to help debugging templates.
Package encoding provides template functions for encoding content.
 Package encoding provides template functions for encoding content.
Package fmt provides template functions for formatting strings.
 Package fmt provides template functions for formatting strings.
Package hugo provides template functions for accessing the Site Hugo object.
 Package hugo provides template functions for accessing the Site Hugo object.
Package images provides template functions for manipulating images.
 Package images provides template functions for manipulating images.
Package inflect provides template functions for the inflection of words.
 Package inflect provides template functions for the inflection of words.
go_templates/cfg
Package cfg holds configuration shared by the Go command and internal/testenv.
 Package cfg holds configuration shared by the Go command and internal/testenv.
go_templates/fmtsort
Package fmtsort provides a general stable ordering mechanism for maps, on behalf of the fmt and text/template packages.
 Package fmtsort provides a general stable ordering mechanism for maps, on behalf of the fmt and text/template packages.
go_templates/htmltemplate
Package template (html/template) implements data-driven templates for generating HTML output safe against code injection.
 Package template (html/template) implements data-driven templates for generating HTML output safe against code injection.
go_templates/testenv
Package testenv provides information about what functionality is available in different testing environments run by the Go team.
 Package testenv provides information about what functionality is available in different testing environments run by the Go team.
go_templates/texttemplate
Package template implements data-driven templates for generating textual output.
 Package template implements data-driven templates for generating textual output.
go_templates/texttemplate/parse
Package parse builds parse trees for templates as defined by text/template and html/template.
 Package parse builds parse trees for templates as defined by text/template and html/template.
resourcehelpers
Package js provides functions for building JavaScript resources
 Package js provides functions for building JavaScript resources
Package lang provides template functions for content internationalization.
 Package lang provides template functions for content internationalization.
Package math provides template functions for mathematical operations.
 Package math provides template functions for mathematical operations.
openapi
openapi3
Package os provides template functions for interacting with the operating system.
 Package os provides template functions for interacting with the operating system.
Package partials provides template functions for working with reusable templates.
 Package partials provides template functions for working with reusable templates.
Package path provides template functions for manipulating paths.
 Package path provides template functions for manipulating paths.
Package reflect provides template functions for run-time object reflection.
 Package reflect provides template functions for run-time object reflection.
Package resources provides template functions for working with resources.
 Package resources provides template functions for working with resources.
Package safe provides template functions for escaping untrusted content or encapsulating trusted content.
 Package safe provides template functions for escaping untrusted content or encapsulating trusted content.
Package site provides template functions for accessing the Site object.
 Package site provides template functions for accessing the Site object.
Package strings provides template functions for manipulating strings.
 Package strings provides template functions for manipulating strings.
Package templates provides template functions for working with templates.
 Package templates provides template functions for working with templates.
Package time provides template functions for measuring and displaying time.
 Package time provides template functions for measuring and displaying time.
Package transform provides template functions for transforming content.
 Package transform provides template functions for transforming content.
Package urls provides template functions to deal with URLs.
 Package urls provides template functions to deal with URLs.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.