hugo/docs/content/overview/usage.md at a2c887153391d3d85074ad7897b3078efa3b09d9

mirror of https://github.com/gohugoio/hugo.git synced 2024-12-26 12:32:18 +00:00

Anthony Fok b0181e278b Some more random copyediting of Hugo docs

- Change "livereload" and "live reload" to "LiveReload";
 - Add a `$ ` prompt before example command lines
   (not exhaustive, work in progress);
 - Remove unnecessary whitespace from partials;
 - Revise the blackfriday options table in overview/configuration.md
   to make it narrower.
 - Manually set the language for highlight.js where appropriate
 - Rename "404" to "Custom 404 page", and remove incorrect reference
   to "homepage"
 - Credit the author of tutorials/github_pages_blog.md
   (Similar notes are necessary for other contributed pages where
    "I" am not spf13 to avoid reader confusion.)
 - Add CSS for `kbd` and `table` etc. to css/style.css;
 - etc.

2015-01-09 11:51:15 -07:00

3 KiB

Raw Blame History

aliases

date

notoc

title

weight

/doc/usage/

2013-07-01

main

parent
getting started

/overview/configuration

true

/overview/installing

Using Hugo

Make sure either hugo is in your PATH or provide a path to it.

$ hugo help
A Fast and Flexible Static Site Generator
built with love by spf13 and friends in Go.

Complete documentation is available at http://gohugo.io

Usage:
  hugo [flags]
  hugo [command]

Available Commands:
  server                    Hugo runs its own webserver to render the files
  version                   Print the version number of Hugo
  check                     Check content in the source directory
  benchmark                 Benchmark hugo by building a site a number of times
  new [path]                Create new content for your site
  help [command]            Help about any command

 Available Flags:
  -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/
  -D, --buildDrafts=false: build content marked as draft
  -F, --buildFuture=false: build content with PublishDate in the future
      --config="": config file (default is path/config.yaml|json|toml)
  -d, --destination="": filesystem path to write files to
      --disableRSS=false: Do not build RSS files
      --disableSitemap=false: Do not build Sitemap file
      --log=false: Enable Logging
      --logFile="": Log File path (if set, logging enabled automatically)
  -s, --source="": filesystem path to read files relative from
      --stepAnalysis=false: display memory and timing of different steps of the program
  -t, --theme="": theme to use (located in /themes/THEMENAME/)
      --uglyUrls=false: if true, use /filename.html instead of /filename/
  -v, --verbose=false: verbose output
      --verboseLog=false: verbose logging
  -w, --watch=false: watch filesystem for changes and recreate as needed

Use "hugo help [command]" for more information about that command.

Common Usage Example

The most common use is probably to run hugo with your current directory being the input directory.

$ hugo
> X pages created
  in 8 ms

If you are working on things and want to see the changes immediately, tell Hugo to watch for changes.

Hugo will watch the filesystem for changes, rebuild your site as soon as a file is saved.

$ hugo -s ~/mysite --watch
   28 pages created
   in 18 ms
   Watching for changes in /Users/spf13/Code/hugo/docs/content
   Press ctrl+c to stop

Hugo can even run a server and create your site at the same time! Hugo implements LiveReload technology to automatically reload any open pages in all browsers (including mobile).

$ hugo server -ws ~/mysite
   Watching for changes in /Users/spf13/Code/hugo/docs/content
   Web Server is available at http://localhost:1313
   Press ctrl+c to stop
   28 pages created
   0 tags created
   in 18 ms

3 KiB Raw Blame History

Common Usage Example

3 KiB

Raw Blame History