commands

Documentation

Overview

Package commands defines and implements command-line commands and flags used by Hugo. Commands and flags are implemented using Cobra.

Index

• Variables
• func AddCommands()
• func Execute()
• func InitializeConfig(running bool, doWithCommandeer func(c *commandeer) error, ...) (*commandeer, error)
• func NewContent(cmd *cobra.Command, args []string) error
• func NewSite(cmd *cobra.Command, args []string) error
• func NewTheme(cmd *cobra.Command, args []string) error
• func Reset() error
• func Undraft(cmd *cobra.Command, args []string) error

Variables

var Hugo *hugolib.HugoSites

Hugo represents the Hugo sites to build. This variable is exported as it is used by at least one external library (the Hugo caddy plugin). We should provide a cleaner external API, but until then, this is it.

var HugoCmd = &cobra.Command{
	Use:   "hugo",
	Short: "hugo builds your site",
	Long: `hugo is the main command, used to build your Hugo site.

Hugo is a Fast and Flexible Static Site Generator
built with love by spf13 and friends in Go.

Complete documentation is available at http://gohugo.io/.`,
	RunE: func(cmd *cobra.Command, args []string) error {

		cfgInit := func(c *commandeer) error {
			if buildWatch {
				c.Set("disableLiveReload", true)
			}
			c.Set("renderToMemory", renderToMemory)
			return nil
		}

		c, err := InitializeConfig(buildWatch, cfgInit)
		if err != nil {
			return err
		}

		if buildWatch {
			c.watchConfig()
		}

		return c.build()
	},
}

HugoCmd is Hugo's root command. Every other command attached to HugoCmd is a child command to it.

Functions

func AddCommands

func AddCommands()

AddCommands adds child commands to the root command HugoCmd.

func Execute

func Execute()

Execute adds all child commands to the root command HugoCmd and sets flags appropriately.

func InitializeConfig

func InitializeConfig(running bool, doWithCommandeer func(c *commandeer) error, subCmdVs ...*cobra.Command) (*commandeer, error)

InitializeConfig initializes a config file with sensible default configuration flags.

func NewContent

func NewContent(cmd *cobra.Command, args []string) error

NewContent adds new content to a Hugo site.

func NewSite

func NewSite(cmd *cobra.Command, args []string) error

NewSite creates a new Hugo site and initializes a structured Hugo directory.

func NewTheme

func NewTheme(cmd *cobra.Command, args []string) error

NewTheme creates a new Hugo theme.

func Reset

func Reset() error

Reset resets Hugo ready for a new full build. This is mainly only useful for benchmark testing etc. via the CLI commands.

func Undraft

func Undraft(cmd *cobra.Command, args []string) error

Undraft publishes the specified content by setting its draft status to false and setting its publish date to now. If the specified content is not a draft, it will log an error.