template

Documentation

Overview

Package template is the legacy server HTML-template import path.

New code should import the focused replacement package:

import "github.com/InsideGallery/core/server/view"

Compatibility: existing template exports remain available for downstream consumers that still import server/template. Prefer server/view.NewWithDir or server/view.NewFromOptions so template directory configuration is explicit and call sites avoid a local name collision with html/template.

Index

• Constants
• Variables
• func GetDefaultTemplateDir(prefix string) string
• func SetDefaultTemplateDir(prefix string, d string)
• type Engine
  • func NewEngine() *Engine
  • func (e *Engine) Add(t *Template)
  • func (e *Engine) Execute(name string, data interface{}) ([]byte, error)
  • func (e *Engine) Exists(name string) bool
• type Options
• type Template
  • func NewTemplate(name, prefix string, source fs.FS, files ...string) (*Template, error)
  • func NewTemplateBySource(source embed.FS, name, pattern string) (*Template, error)
  • func NewTemplateFromOptions(options Options) (*Template, error)
  • func NewTemplateWithDir(name, dir string, source fs.FS, files ...string) (*Template, error)

Constants

const DefaultTemplateDir = "DEFAULT_TEMPLATE_DIR"

DefaultTemplateDir have constant for template

Variables

var (
	ErrExecuteTemplate  = errors.New("error execute template")
	ErrNotFoundTemplate = errors.New("error not found template")
)

templates related errors

Functions

func GetDefaultTemplateDir

func GetDefaultTemplateDir(prefix string) string

GetDefaultTemplateDir return default template dir

Deprecated: pass the directory to NewTemplateWithDir or NewTemplateFromOptions.

func SetDefaultTemplateDir

func SetDefaultTemplateDir(prefix string, d string)

SetDefaultTemplateDir set default template dir

Deprecated: pass the directory to NewTemplateWithDir or NewTemplateFromOptions.

Types

type Engine

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

Engine type template engine

func NewEngine

func NewEngine() *Engine

NewEngine return engine

func (*Engine) Add

func (e *Engine) Add(t *Template)

Add add template

func (*Engine) Execute

func (e *Engine) Execute(name string, data interface{}) ([]byte, error)

Execute execute current template and return parsed string

func (*Engine) Exists

func (e *Engine) Exists(name string) bool

Exists return true if page exists

type Options

type Options struct {
	Name  string
	Dir   string
	Files []string
	FS    fs.FS
}

Options configures template parsing without environment state.

type Template

type Template struct {
	*template.Template
	Name string
}

Template describe template

func NewTemplate

func NewTemplate(name, prefix string, source fs.FS, files ...string) (*Template, error)

NewTemplate return new template

Deprecated: use NewTemplateWithDir or NewTemplateFromOptions with explicit directory config.

func NewTemplateBySource

func NewTemplateBySource(source embed.FS, name, pattern string) (*Template, error)

NewTemplateBySource return new template bu source

func NewTemplateFromOptions

func NewTemplateFromOptions(options Options) (*Template, error)

NewTemplateFromOptions returns a new template from explicit options.

func NewTemplateWithDir

func NewTemplateWithDir(name, dir string, source fs.FS, files ...string) (*Template, error)

NewTemplateWithDir returns a new template using an explicit base directory.