package config

import "github.com/gohugoio/hugo/config"

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

	// Can be used to toggle off writing of the intellinsense /assets/jsconfig.js
	// file.
	NoJSConfigInAssets bool
}

Build holds some build related configuration.

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
	Force  bool
}

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

Source Files ¶

commonConfig.go configLoader.go configProvider.go env.go

Directories ¶