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(subCmdVs ...*cobra.Command) 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 NewWatcher(port int) error
• func Reset() error
• func Undraft(cmd *cobra.Command, args []string) error

Variables

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 {
		if err := InitializeConfig(); err != nil {
			return err
		}

		if buildWatch {
			viper.Set("DisableLiveReload", true)
			watchConfig()
		}

		return build()
	},
}

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

var MainSite *hugolib.Site

MainSite represents the Hugo site 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.

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(subCmdVs ...*cobra.Command) 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 NewWatcher

func NewWatcher(port int) error

NewWatcher creates a new watcher to watch filesystem events.

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.