hugo 命令详解

显示行号 | 选择喜欢的代码风格

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

hugo 命令可以快速、灵活的生成静态站点，如：hugo new site path/to/site。主要卖点之一是速度：Hugo 仅需几秒钟即可生成具有数千页的网站。Smashing Magazine 最近从 WordPress 切换到了 Hugo，并且支持 Markdown。

hugo 命令安装：

-bash: hugo: command not found

#Binary (跨平台) 
#从 Hugo Releases 下载适合您平台的适当版本。
#下载后，二进制文件可以在任何地方运行。
#理想情况下，您应该将其安装在自己的某个位置 PATH 以便于使用。
#/usr/local/bin 是最可能的位置。
https://github.com/gohugoio/hugo/releases

#Debian
apt-get install hugo

#Ubuntu
apt-get install hugo

#Alpine
apk add hugo

#Arch Linux
pacman -S hugo

#Kali Linux
apt-get install hugo

#Fedora
dnf install hugo

#OS X
brew install hugo

#Raspbian
apt-get install hugo

#Docker
docker run cmd.cat/hugo hugo

#Windows (Chocolatey)
choco install hugo -confirm 
choco install hugo-extended -confirm #包括 Sass/SCSS version

#Windows (Scoop)
scoop install hugo
scoop install hugo-extended

hugo 命令补充说明：

hugo 是主要命令，用于构建您的 Hugo 网站。

hugo 是一种快速、灵活的静态网站生成器，由 Spf13 和 Go 实现构建。

有关完整的文档，请访问 Hugo 官网： https://gohugo.io

hugo 命令语法：

hugo [flags]
hugo [command]

hugo 命令选项：

Available Commands:
  check       包含一些验证检查
  config      打印站点配置
  convert     将您的内容转换为不同的格式
  env         打印Hugo版本和环境信息
  gen         几个有用的生成器的集合。
  help        有关任何命令的帮助
  import      从其他网站导入您的网站。
  list        列出各种类型的内容
  new         为您的网站创建新内容
  server      高性能的网络服务器
  version     打印 HUGO 的版本号

Flags:
  -b, --baseURL string         根的主机名（和路径）, e.g. https://spf13.com/
  -D, --buildDrafts            包括标记为草稿的内容
  -E, --buildExpired           包括过期内容
  -F, --buildFuture            包括将来带有发布日期的内容
      --cacheDir string        缓存目录的文件系统路径。 默认值：$TMPDIR/hugo_cache/
      --cleanDestinationDir    从静态目录中找不到的目标中删除文件
      --config string          配置文件（默认为 path/config.yaml  | json | toml）
      --configDir string       配置目录 (默认为 "config")
  -c, --contentDir string      内容目录的文件系统路径
      --debug                  debug 输出
  -d, --destination string     写入文件的文件系统路径
      --disableKinds strings   禁用其他类型的页面（主页，RSS等）
      --enableGitInfo          在页面上添加Git版本，日期和作者信息
  -e, --environment string     build 环境
      --forceSyncStatic        更改静态后复制所有文件。
      --gc                     在构建后启用运行一些清理任务（删除未使用的缓存文件）
  -h, --help                   hugo 帮助
      --i18n-warnings          打印缺少的翻译
      --ignoreCache            忽略缓存目录
  -l, --layoutDir string       布局目录的文件系统路径
      --log                    开启 Logging
      --logFile string         日志文件路径（如果设置，将自动启用日志记录）
      --minify                 缩小所有受支持的输出格式（HTML，XML等）
      --noChmod                不同步文件的权限模式
      --noTimes                不同步文件的修改时间
      --path-warnings          在重复的目标路径等上打印警告
      --quiet                  以安静模式构建
      --renderToMemory         渲染到内存（仅用于基准测试）
  -s, --source string          从中读取相对文件的文件系统路径
      --templateMetrics        显示有关模板执行的指标
      --templateMetricsHints   与--templateMetrics结合使用时可以计算一些改进提示
  -t, --theme strings          要使用的主题（位于 /themes/THEMENAME/ 中）
      --themesDir string       主题目录的文件系统路径
      --trace file             将跟踪信息写入文件（通常无用）
  -v, --verbose                详细输出
      --verboseLog             详细记录
  -w, --watch                  监视文件系统的更改并根据需要重新创建

hugo 命令实例

Hugo 创建一个新的 Hugo 主题（主题也可以从 https://themes.gohugo.io 下载）：

hugo new theme theme_name

Hugo 创建一个新页面：

hugo new section_name/filename

Hugo 在 ./public/ 目录中构建一个站点：

hugo

Hugo 建立一个站点，其中包含标记为 draft 的页面：

hugo --buildDrafts

Hugo 将站点构建到给定目录：

hugo --destination path/to/destination

Hugo 建立一个网站，启动一个网络服务器来为其服务，并在编辑页面时自动重新加载：

hugo server

部署您的 Hugo 网站：

在运行 hugo server 本地 Web 开发后，您需要执行最后的 hugo 运行而无需 server 命令的一部分来重建站点。可以通过将 public/ 目录复制到生产 Web 服务器来部署站点。

Hugo 会生成一个静态网站，因此您的网站可以使用任何 Web 服务器托管在任何地方。更多请参阅 Hugo 托管和部署。