hugo

Documentation

Index

• Constants
• Variables
• func BuildVersionString() string
• func CompareVersion(version interface{}) int
• type Info
  • func NewInfo(environment string) Info
  • func (i Info) Generator() template.HTML
  • func (i Info) Version() VersionString
• type Site
• type Version
  • func MustParseVersion(s string) Version
  • func ParseVersion(s string) (Version, error)
  • func (v Version) Next() Version
  • func (v Version) NextPatchLevel(level int) Version
  • func (v Version) Prev() Version
  • func (v Version) ReleaseVersion() Version
  • func (v Version) String() string
  • func (v Version) Version() VersionString
• type VersionString
  • func (h VersionString) Compare(other interface{}) int
  • func (h VersionString) Eq(other interface{}) bool
  • func (h VersionString) String() string

Constants

const (
	EnvironmentDevelopment = "development"
	EnvironmentProduction  = "production"
)

Variables

var CurrentVersion = Version{
	Number:     0.54,
	PatchLevel: 0,
	Suffix:     "",
}

CurrentVersion represents the current build version. This should be the only one.

Functions

func BuildVersionString

func BuildVersionString() string

BuildVersionString creates a version string. This is what you see when running "hugo version".

func CompareVersion

func CompareVersion(version interface{}) int

CompareVersion compares the given version string or number against the running Hugo version. It returns -1 if the given version is less than, 0 if equal and 1 if greater than the running version.

Types

type Info

type Info struct {
	CommitHash string
	BuildDate  string

	// The build environment.
	// Defaults are "production" (hugo) and "development" (hugo server).
	// This can also be set by the user.
	// It can be any string, but it will be all lower case.
	Environment string
}

Info contains information about the current Hugo environment

func NewInfo

func NewInfo(environment string) Info

NewInfo creates a new Hugo Info object.

func (Info) Generator

func (i Info) Generator() template.HTML

Generator a Hugo meta generator HTML tag.

func (Info) Version

func (i Info) Version() VersionString

Version returns the current version as a comparable version string.

type Site

type Site interface {
	Language() *langs.Language
	IsServer() bool
	Hugo() Info
}

Site represents a site in the build. This is currently a very narrow interface, but the actual implementation will be richer, see hugolib.SiteInfo.

type Version

type Version struct {
	// Major and minor version.
	Number float32

	// Increment this for bug releases
	PatchLevel int

	// HugoVersionSuffix is the suffix used in the Hugo version string.
	// It will be blank for release versions.
	Suffix string
}

Version represents the Hugo build version.

func MustParseVersion

func MustParseVersion(s string) Version

MustParseVersion parses a version string and panics if any error occurs.

func ParseVersion

func ParseVersion(s string) (Version, error)

ParseVersion parses a version string.

func (Version) Next

func (v Version) Next() Version

Next returns the next Hugo release version.

func (Version) NextPatchLevel

func (v Version) NextPatchLevel(level int) Version

NextPatchLevel returns the next patch/bugfix Hugo version. This will be a patch increment on the previous Hugo version.

func (Version) Prev

func (v Version) Prev() Version

Prev returns the previous Hugo release version.

func (Version) ReleaseVersion

func (v Version) ReleaseVersion() Version

ReleaseVersion represents the release version.

func (Version) String

func (v Version) String() string

func (Version) Version

func (v Version) Version() VersionString

Version returns the Hugo version.

type VersionString

type VersionString string

VersionString represents a Hugo version string.

func (VersionString) Compare

func (h VersionString) Compare(other interface{}) int

Compare implements the compare.Comparer interface.

func (VersionString) Eq

func (h VersionString) Eq(other interface{}) bool

Eq implements the compare.Eqer interface.

func (VersionString) String

func (h VersionString) String() string