config

Documentation

Index

• Variables
• func FromFileToMap(fs afero.Fs, filename string) (map[string]interface{}, error)
• func GetNumWorkerMultiplier() int
• func GetStringSlicePreserveString(cfg Provider, key string) []string
• func IsValidConfigFilename(filename string) bool
• func RenameKeys(m map[string]interface{})
• func SetBaseTestDefaults(cfg Provider)
• func SetEnvVars(oldVars *[]string, keyValues ...string)
• func SplitEnvVar(v string) (string, string)
• type Build
  • func DecodeBuild(cfg Provider) Build
  • func (b Build) UseResourceCache(err error) bool
• type Headers
• type Provider
  • func FromConfigString(config, configType string) (Provider, error)
  • func FromFile(fs afero.Fs, filename string) (Provider, error)
• type Redirect
  • func (r Redirect) IsZero() bool
• type Server
  • func DecodeServer(cfg Provider) (*Server, error)
  • func (s *Server) MatchHeaders(pattern string) []types.KeyValueStr
  • func (s *Server) MatchRedirect(pattern string) Redirect
• type Sitemap
  • func DecodeSitemap(prototype Sitemap, input map[string]interface{}) Sitemap

Variables

var DefaultBuild = Build{
	UseResourceCacheWhen: "fallback",
	WriteStats:           false,
}

var (
	ValidConfigFileExtensions = []string{"toml", "yaml", "yml", "json"}
)

Functions

func FromFileToMap

func FromFileToMap(fs afero.Fs, filename string) (map[string]interface{}, error)

FromFileToMap is the same as FromFile, but it returns the config values as a simple map.

func GetNumWorkerMultiplier

func GetNumWorkerMultiplier() int

GetNumWorkerMultiplier returns the base value used to calculate the number of workers to use for Hugo's parallel execution. It returns the value in HUGO_NUMWORKERMULTIPLIER OS env variable if set to a positive integer, else the number of logical CPUs.

func GetStringSlicePreserveString

func GetStringSlicePreserveString(cfg Provider, key string) []string

GetStringSlicePreserveString returns a string slice from the given config and key. It differs from the GetStringSlice method in that if the config value is a string, we do not attempt to split it into fields.

func IsValidConfigFilename

func IsValidConfigFilename(filename string) bool

IsValidConfigFilename returns whether filename is one of the supported config formats in Hugo.

func RenameKeys

func RenameKeys(m map[string]interface{})

RenameKeys renames config keys in m recursively according to a global Hugo alias definition.

func SetBaseTestDefaults

func SetBaseTestDefaults(cfg Provider)

SetBaseTestDefaults provides some common config defaults used in tests.

func SetEnvVars

func SetEnvVars(oldVars *[]string, keyValues ...string)

SetEnvVars sets vars on the form key=value in the oldVars slice.

func SplitEnvVar

func SplitEnvVar(v string) (string, string)

Types

type Build

type Build struct {
	UseResourceCacheWhen string // never, fallback, always. Default is fallback

	// When enabled, will collect and write a hugo_stats.json with some build
	// related aggregated data (e.g. CSS class names).
	WriteStats bool
}

Build holds some build related condfiguration.

func DecodeBuild

func DecodeBuild(cfg Provider) Build

func (Build) UseResourceCache

func (b Build) UseResourceCache(err error) bool

type Headers

type Headers struct {
	For    string
	Values map[string]interface{}
}

type Provider

type Provider interface {
	GetString(key string) string
	GetInt(key string) int
	GetBool(key string) bool
	GetStringMap(key string) map[string]interface{}
	GetStringMapString(key string) map[string]string
	GetStringSlice(key string) []string
	Get(key string) interface{}
	Set(key string, value interface{})
	IsSet(key string) bool
}

Provider provides the configuration settings for Hugo.

func FromConfigString

func FromConfigString(config, configType string) (Provider, error)

FromConfigString creates a config from the given YAML, JSON or TOML config. This is useful in tests.

func FromFile

func FromFile(fs afero.Fs, filename string) (Provider, error)

FromFile loads the configuration from the given filename.

type Redirect

type Redirect struct {
	From   string
	To     string
	Status int
}

func (Redirect) IsZero

func (r Redirect) IsZero() bool

type Server

type Server struct {
	Headers   []Headers
	Redirects []Redirect
	// contains filtered or unexported fields
}

Config for the dev server.

func DecodeServer

func DecodeServer(cfg Provider) (*Server, error)

func (*Server) MatchHeaders

func (s *Server) MatchHeaders(pattern string) []types.KeyValueStr

func (*Server) MatchRedirect

func (s *Server) MatchRedirect(pattern string) Redirect

type Sitemap

type Sitemap struct {
	ChangeFreq string
	Priority   float64
	Filename   string
}

Sitemap configures the sitemap to be generated.

func DecodeSitemap

func DecodeSitemap(prototype Sitemap, input map[string]interface{}) Sitemap