这是本节的多页打印视图。 点击此处打印.

返回本页常规视图.

命令

Commands - 命令

https://gohugo.io/commands/

1 - hugo

hugo

https://gohugo.io/commands/hugo/

hugo

​ hugo 构建您的站点

概要

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

​ Hugo 是一个用 Go 语言编写的快速且灵活的静态站点生成器，由 spf13 和朋友们倾情打造。

​ 完整文档请访问 https://gohugo.io/。

hugo [flags]

选项

  -b, --baseURL string             主机名（和根路径），例如https://spf13.com/
  -D, --buildDrafts                包含标记为草稿的内容
  -E, --buildExpired               包含已过期的内容
  -F, --buildFuture                包含将来发布日期的内容
      --cacheDir string            缓存目录的文件系统路径。默认值：$TMPDIR/hugo_cache/
      --cleanDestinationDir        从目标目录中删除未在静态目录中找到的文件
      --clock string               设置Hugo使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为 "config"）
  -c, --contentDir string          内容目录的文件系统路径
      --debug                      调试输出
  -d, --destination string         写入文件的文件系统路径
      --disableKinds strings       禁用不同类型的页面（首页、RSS 等）
      --enableGitInfo              将 Git 修订、日期、作者和 CODEOWNERS 信息添加到页面
  -e, --environment string         构建环境
      --forceSyncStatic            当静态内容发生更改时，复制所有文件。
      --gc                         启用在构建后运行一些清理任务（删除未使用的缓存文件）
  -h, --help                       hugo 的帮助
      --ignoreCache                忽略缓存目录
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径中的任何 _vendor
  -l, --layoutDir string           布局目录的文件系统路径
      --log                        启用日志
      --logFile string             日志文件路径（如果设置，日志自动启用）
      --minify                     最小化任何支持的输出格式（HTML、XML 等）
      --noBuildLock                不创建.hugo_build.lock文件
      --noChmod                    不同步文件的权限模式
      --noTimes                    不同步文件的修改时间
      --panicOnWarning             在第一个警告日志上发生恐慌
      --poll string                将其设置为轮询间隔，例如 --poll 700ms，以使用基于轮询的方法来监视文件系统更改
      --printI18nWarnings          打印缺失的翻译
      --printMemoryUsage           在间隔期内将内存使用情况打印到屏幕上
      --printPathWarnings          打印关于重复目标路径等的警告
      --printUnusedTemplates       打印未使用的模板的警告。
      --quiet                      安静模式构建
      --renderToMemory             将渲染结果存储到内存中（仅对基准测试有用）
  -s, --source string              从中读取文件的文件系统路径
      --templateMetrics            显示关于模板执行的指标
      --templateMetricsHints       在与 --templateMetrics 结合使用时，计算一些改进提示
  -t, --theme strings              要使用的主题（位于/themes/THEMENAME/）
      --themesDir string           主题目录的文件系统路径
      --trace file                 将跟踪写入文件（通常没有用处）
  -v, --verbose                    详细输出
      --verboseLog                 详细日志
  -w, --watch                      观察文件系统变化，并根据需要重新创建

另请参阅

另请参阅

2 - hugo completion

hugo completion

https://gohugo.io/commands/hugo_completion/

hugo 自动补全

​ 生成指定 shell 的 hugo 自动补全脚本。

概要

​ 生成指定 shell 的 hugo 自动补全脚本。有关如何使用生成的脚本的详细信息，请参阅每个子命令的帮助。

选项

  -h, --help   help for completion

从父命令继承的选项

	 --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
     --config string              配置文件 (默认为 hugo.yaml|json|toml)
     --configDir string           配置目录 (默认 "config")
     --debug                      调试输出
 -e, --environment string         构建环境
     --ignoreVendorPaths string   忽略任何与给定 Glob 模式匹配的模块路径的 _vendor
     --log                        启用日志记录
     --logFile string             日志文件路径（如果设置，自动启用日志记录）
     --quiet                      安静模式下构建
 -s, --source string              文件系统路径，从中读取相对文件
     --themesDir string           主题目录的文件系统路径
 -v, --verbose                    冗长的输出
     --verboseLog                 冗长的日志记录

另请参阅

另请参阅

3 - hugo completion bash

hugo completion bash

https://gohugo.io/commands/hugo_completion_bash/

hugo completion bash

​ 生成bash shell的自动补全脚本。

概要

​ 生成bash shell的自动补全脚本。

​ 此脚本依赖于bash-completion软件包。如果尚未安装，则可以通过操作系统的包管理器安装它。

​ 要在当前shell会话中加载自动补全：

source <(hugo completion bash)

​ 要为每个新会话加载自动补全，请执行以下操作一次：

Linux:

hugo completion bash > /etc/bash_completion.d/hugo

macOS:

hugo completion bash > $(brew --prefix)/etc/bash_completion.d/hugo

​ 您需要启动一个新的shell才能使此设置生效。

hugo completion bash

选项

  -h, --help              help for bash
      --no-descriptions   禁用completion说明

从父命令继承的选项

	 --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
     --config string              配置文件 (默认为 hugo.yaml|json|toml)
     --configDir string           配置目录 (默认 "config")
     --debug                      调试输出
 -e, --environment string         构建环境
     --ignoreVendorPaths string   忽略任何与给定 Glob 模式匹配的模块路径的 _vendor
     --log                        启用日志记录
     --logFile string             日志文件路径（如果设置，自动启用日志记录）
     --quiet                      安静模式下构建
 -s, --source string              文件系统路径，从中读取相对文件
     --themesDir string           主题目录的文件系统路径
 -v, --verbose                    冗长的输出
     --verboseLog                 冗长的日志记录

另请参阅

另请参阅

4 - hugo completion fish

hugo completion fish

https://gohugo.io/commands/hugo_completion_fish/

hugo completion fish

​ 生成fish shell的自动补全脚本。

概要

​ 生成fish shell的自动补全脚本。

​ 要在当前的shell会话中加载自动补全：

hugo completion fish | source

​ 要为每个新会话加载自动补全，请执行以下操作一次：

hugo completion fish > ~/.config/fish/completions/hugo.fish

​ 您需要启动一个新的shell才能使此设置生效。

hugo completion fish [flags]

选项

  -h, --help              help for fish
      --no-descriptions   禁用completion说明

从父命令继承的选项

	 --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
     --config string              配置文件 (默认为 hugo.yaml|json|toml)
     --configDir string           配置目录 (默认 "config")
     --debug                      调试输出
 -e, --environment string         构建环境
     --ignoreVendorPaths string   忽略任何与给定 Glob 模式匹配的模块路径的 _vendor
     --log                        启用日志记录
     --logFile string             日志文件路径（如果设置，自动启用日志记录）
     --quiet                      安静模式下构建
 -s, --source string              文件系统路径，从中读取相对文件
     --themesDir string           主题目录的文件系统路径
 -v, --verbose                    冗长的输出
     --verboseLog                 冗长的日志记录

另请参阅

另请参阅

5 - hugo completion powershell

hugo completion powershell

hugo completion powershell

​ 生成powershell shell的自动补全脚本。

概要

​ 生成powershell shell的自动补全脚本。

​ 要在当前的shell会话中加载自动补全：

hugo completion powershell | Out-String | Invoke-Expression

​ 要在每个新会话中加载自动补全，请将上述命令的输出添加到您的 powershell 配置文件中。

hugo completion powershell [flags]

选项

  -h, --help              help for powershell
      --no-descriptions   disable completion descriptions

从父命令继承的选项

	 --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
     --config string              配置文件 (默认为 hugo.yaml|json|toml)
     --configDir string           配置目录 (默认 "config")
     --debug                      调试输出
 -e, --environment string         构建环境
     --ignoreVendorPaths string   忽略任何与给定 Glob 模式匹配的模块路径的 _vendor
     --log                        启用日志记录
     --logFile string             日志文件路径（如果设置，自动启用日志记录）
     --quiet                      安静模式下构建
 -s, --source string              文件系统路径，从中读取相对文件
     --themesDir string           主题目录的文件系统路径
 -v, --verbose                    冗长的输出
     --verboseLog                 冗长的日志记录

另请参阅

另请参阅

6 - hugo completion zsh

hugo completion zsh

https://gohugo.io/commands/hugo_completion_zsh/

hugo completion zsh

​ 生成zsh shell的自动补全脚本。

概要

​ 生成zsh shell的自动补全脚本。

​ 如果您的环境中没有启用 shell 自动补全，您需要启用它。您可以执行以下命令：

echo "autoload -U compinit; compinit" >> ~/.zshrc

​ 为了在当前的 shell 会话中载入自动补全：

source <(hugo completion zsh); compdef _hugo hugo

​ 要为每个新会话加载自动补全，请执行以下操作一次：

Linux:

hugo completion zsh > "${fpath[1]}/_hugo"

macOS:

hugo completion zsh > $(brew --prefix)/share/zsh/site-functions/_hugo

​ 您需要启动一个新的shell才能使此设置生效。

hugo completion zsh [flags]

选项

  -h, --help              help for zsh
      --no-descriptions   禁用completion说明

从父命令继承的选项

	 --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
     --config string              配置文件 (默认为 hugo.yaml|json|toml)
     --configDir string           配置目录 (默认 "config")
     --debug                      调试输出
 -e, --environment string         构建环境
     --ignoreVendorPaths string   忽略任何与给定 Glob 模式匹配的模块路径的 _vendor
     --log                        启用日志记录
     --logFile string             日志文件路径（如果设置，自动启用日志记录）
     --quiet                      安静模式下构建
 -s, --source string              文件系统路径，从中读取相对文件
     --themesDir string           主题目录的文件系统路径
 -v, --verbose                    冗长的输出
     --verboseLog                 冗长的日志记录

另请参阅

另请参阅

7 - hugo config

hugo config

https://gohugo.io/commands/hugo_config/

hugo config

​ 打印站点配置

概要

​ 打印站点配置，包括默认和自定义设置。

hugo config [flags]

选项

      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
  -e, --environment string         build environment
  -h, --help                       help for config
      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
  -s, --source string              filesystem path to read files relative from
      --themesDir string           filesystem path to themes directory
      
      --clock string               设置Hugo使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
  -e, --environment string         构建环境
  -h, --help                       帮助配置
      --ignoreVendorPaths string   忽略任何与给定Glob模式匹配的模块路径的_vendor
  -s, --source string              相对于读取文件的文件系统路径
      --themesDir string           文件系统路径到主题目录

从父命令继承的选项

      --config string      配置文件（默认为hugo.yaml | json | toml）
      --configDir string   配置目录（默认值为“config”）
      --debug              调试输出
      --log                启用日志记录
      --logFile string     日志文件路径（如果设置，则自动启用日志记录）
      --quiet              静默模式下构建
  -v, --verbose            详细输出
      --verboseLog         详细日志记录

另请参阅

另请参阅

8 - hugo config mounts

hugo config mounts

https://gohugo.io/commands/hugo_config_mounts/

hugo config mounts

​ 打印已配置的文件挂载

hugo config mounts [flags]

选项

  -h, --help   help for mounts

从父命令继承的选项

	  --clock string               设置Hugo使用的时钟，例如--clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为hugo.yaml|json|toml）
      --configDir string           配置目录（默认为“config”）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略任何与给定Glob模式匹配的模块路径的_vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，则自动启用日志记录）
      --quiet                      静默模式下构建
  -s, --source string              从文件系统中读取文件的相对路径
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    详细输出
      --verboseLog                 详细日志记录

另请参阅

另请参阅

9 - hugo convert

hugo convert

https://gohugo.io/commands/hugo_convert/

hugo convert

​ 将您的内容转换为不同的格式

概要

​ 将您的内容（例如前置元数据）转换为不同的格式。

​ 有关更多信息，请参见转换的子命令 toJSON、toTOML 和 toYAML。

选项

	  --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
  -e, --environment string         构建环境
  -h, --help                       convert 的帮助信息
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径的任何 _vendor
  -o, --output string              要将文件写入的文件系统路径
  -s, --source string              从中读取文件的文件系统路径相对路径
      --themesDir string           主题目录的文件系统路径
      --unsafe                     启用不安全的操作，请先备份

从父命令继承的选项

	  --config string      配置文件（默认为 hugo.yaml|json|toml）
      --configDir string   配置目录（默认为“config”）
      --debug              调试输出
      --log                启用日志记录
      --logFile string     日志文件路径（如果设置，将自动启用日志记录）
      --quiet              安静模式构建
  -v, --verbose            详细输出
      --verboseLog         详细日志记录

另请参阅

另请参阅

10 - hugo convert toJSON

hugo convert toJSON

https://gohugo.io/commands/hugo_convert_tojson/

hugo convert toJSON

​ 将前置元数据转换为 JSON 格式。

概要

​ toJSON 将内容目录中的所有前置元数据转换为使用 JSON 格式的前置元数据。

hugo convert toJSON [flags]

选项

  -h, --help   help for toJSON

从父命令继承的选项

	  --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为 "config"）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略所有与给定 Glob 模式匹配的模块路径的 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，将自动启用日志记录）
  -o, --output string              写入文件的文件系统路径
      --quiet                      静默模式构建
  -s, --source string              相对读取文件的文件系统路径
      --themesDir string           主题目录的文件系统路径
      --unsafe                     启用不太安全的操作，请先备份
  -v, --verbose                    输出详细信息
      --verboseLog                 输出详细日志记录

另请参阅

另请参阅

11 - hugo convert toTOML

hugo convert toTOML

https://gohugo.io/commands/hugo_convert_totoml/

hugo convert toTOML

​ 将前置元数据转换为 TOML格式。

概要

​ toTOML 将内容目录中的所有前置元数据转换为使用 TOML 格式的前置元数据。

hugo convert toTOML [flags]

选项

  -h, --help   help for toTOML

从父命令继承的选项

	  --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为“config”）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径的任何 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，将自动启用日志记录）
  -o, --output string              写入文件的文件系统路径
      --quiet                      静音模式下进行构建
  -s, --source string              从文件系统路径读取与文件相关的文件
      --themesDir string           主题目录的文件系统路径
      --unsafe                     启用更少安全的操作，请先备份
  -v, --verbose                    详细输出
      --verboseLog                 详细日志记录

另请参阅

另请参阅

12 - hugo convert toYAML

hugo convert toYAML

https://gohugo.io/commands/hugo_convert_toyaml/

hugo convert toYAML

​ 将前置元数据转换为 YAML格式。

概要

​ toYAML 将内容目录中的所有前置元数据转换为使用 YAML 格式的前置元数据。

hugo convert toYAML [flags]

选项

  -h, --help   help for toYAML

从父命令继承的选项

	  --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为“config”）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定 Glob 匹配的模块路径的 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，日志记录将自动启用）
  -o, --output string              用于写入文件的文件系统路径
      --quiet                      安静模式构建
  -s, --source string              文件系统路径，从中读取文件相对路径
      --themesDir string           文件系统路径，主题目录
      --unsafe                     启用更少安全操作，请首先备份
  -v, --verbose                    详细输出
      --verboseLog                 详细日志记录

另请参阅

另请参阅

13 - hugo deploy

hugo deploy

https://gohugo.io/commands/hugo_deploy/

hugo deploy

​ 将您的站点部署到云提供商。

概要

​ 将您的站点部署到云提供商。

​ 请参阅 https://gohugo.io/hosting-and-deployment/hugo-deploy/ 以获取详细的文档。

hugo deploy [flags]

选项

	  --clock string               设置Hugo使用的时钟，例如--clock 2021-11-06T22:30:00.00+09:00
      --confirm                    在对目标进行更改之前要求确认
      --dryRun                     干况运行
  -e, --environment string         构建环境
      --force                      强制上传所有文件
  -h, --help                       deploy的帮助信息
      --ignoreVendorPaths string   忽略匹配给定Glob模式的模块路径中的任何_vendor
      --invalidateCDN              使部署目标中列出的CDN缓存失效（默认值为true）
      --maxDeletes int             要删除的文件的最大数量，或-1禁用（默认值为256）
      --workers int                传输文件的工作者数。（默认值为10）
  -s, --source string              从其中读取文件的文件系统路径
      --target string              部署目标中的目标部署在配置文件中；默认为第一个
      --themesDir string           主题目录的文件系统路径

从父命令继承的选项

	  --config string      配置文件（默认为hugo.yaml|json|toml）
      --configDir string   配置目录（默认为“config”）
      --debug              调试输出
      --log                启用日志记录
      --logFile string     日志文件路径（如果设置，将自动启用日志记录）
      --quiet              静默模式下构建
  -v, --verbose            冗长输出
      --verboseLog         冗长日志记录

另请参阅

  • hugo - 构建您的站点

另请参阅

14 - hugo env

hugo env

https://gohugo.io/commands/hugo_env/

hugo env

​ 输出Hugo版本和环境信息

概要

​ 输出Hugo版本和环境信息。这在Hugo错误报告中非常有用。

​ 如果加上-v标志，您将得到一个完整的依赖项列表。

hugo env [flags]

选项

  -h, --help   help for env

从父命令继承的选项

	  --clock string               设置Hugo使用的时钟，例如--clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为hugo.yaml|json|toml）
      --configDir string           配置目录（默认为“config”）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略任何与给定Glob模式匹配的模块路径的_vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，自动启用日志记录）
      --quiet                      静默模式下构建
  -s, --source string              从文件系统路径读取相对文件
      --themesDir string           文件系统路径到主题目录
  -v, --verbose                    详细输出
      --verboseLog                 详细记录日志

另请参阅

  • hugo - 构建您的站点

另请参阅

15 - hugo gen

hugo gen

https://gohugo.io/commands/hugo_gen/

hugo gen

​ 一个包含多个有用生成器的集合。

选项

  -h, --help   help for gen

从父命令继承的选项

      --clock string               设置 Hugo 使用的时钟，例如：--clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为 "config"）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略任何与给定 Glob 模式匹配的模块路径的 _vendor 目录
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，则自动启用日志记录）
      --quiet                      安静模式下构建
  -s, --source string              读取文件的文件系统路径（相对路径）
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    详细输出
      --verboseLog                 详细日志记录

另请参阅

另请参阅

16 - hugo gen chromastyles

hugo gen chromastyles

https://gohugo.io/commands/hugo_gen_chromastyles/

hugo gen chromastyles

​ 为 Chroma 代码高亮器生成 CSS 样式表

概要

​ 为给定样式的 Chroma 代码高亮器生成 CSS 样式表。如果在配置中禁用了 markup.highlight.noClasses，则需要此样式表。

​ 请参阅 https://xyproto.github.io/splash/docs/all.html 以预览可用的样式。

hugo gen chromastyles [flags]

选项

	-h, --help                    帮助信息
        --highlightStyle string   用于突出显示行的样式（请参阅 https://github.com/alecthomas/chroma）（默认值为“bg:#ffffcc”）
        --linesStyle string       用于行号的样式（请参阅 https://github.com/alecthomas/chroma）
        --style string            高亮器样式（请参阅 https://xyproto.github.io/splash/docs/）（默认值为“friendly”）

从父命令继承的选项

	  --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为“config”）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径中的任何 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，将自动启用日志记录）
      --quiet                      在安静模式下构建
  -s, --source string              从文件系统路径读取相对文件
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    冗长输出
      --verboseLog                 冗长的日志记录

另请参阅

  • hugo gen - 一个包含多个有用生成器的集合。

另请参阅

17 - hugo gen doc

hugo gen doc

https://gohugo.io/commands/hugo_gen_doc/

hugo gen doc

Generate Markdown documentation for the Hu CLI.

​ 为 Hugo CLI 生成 Markdown 文档。

概要

​ 为 Hugo CLI 生成 Markdown 文档。

​ 这个命令主要用于为 https://gohugo.io/ 的 Hugo 命令行接口创建最新的文档。

​ 它为每个命令创建一个带有适合在 Hugo 中渲染的前置元数据的 Markdown 文件。

hugo gen doc [flags]

选项

      --dir string   要写入文档的目录。(默认值为 "/tmp/hugodoc/")
  -h, --help         help for doc

从父命令继承的选项

--clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认值为 "config"）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径的任何 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，日志记录将自动启用）
      --quiet                      静默模式构建
  -s, --source string              从中读取文件的文件系统路径
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    冗长输出
      --verboseLog                 冗长日志

另请参阅

  • hugo gen - 一个包含多个有用生成器的集合。

另请参阅

18 - hugo gen man

hugo gen man

https://gohugo.io/commands/hugo_gen_man/

hugo gen man

​ 为 Hugo CLI 生成 man 页面

概要

​ 该命令可以自动生成最新版本的Hugo CLI 的man页。默认情况下，它会在当前目录下的"man"目录中创建man页文件。

hugo gen man [flags]

选项

      --dir string   写入man页的目录 (默认值为 "man/")
  -h, --help         help for man

从父命令继承的选项

      --clock string               设置Hugo使用的时钟，例如--clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件 (默认为 hugo.yaml|json|toml)
      --configDir string           配置目录 (默认为 "config")
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略匹配给定Glob模式的模块路径中的任何_vendor
      --log                        启用日志记录
      --logFile string             日志文件路径 (如果设置，则自动启用日志记录)
      --quiet                      静默模式构建
  -s, --source string              读取文件的文件系统路径相对于哪里
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    详细输出
      --verboseLog                 详细日志记录

另请参阅

  • hugo gen - 一个包含多个有用生成器的集合。

另请参阅

19 - hugo import

hugo import

https://gohugo.io/commands/hugo_import/

hugo import

​ 从其他站点生成器导入您的站点。

概要

​ 从其他站点生成器（如Jekyll）导入您的站点。

​ 导入需要一个子命令，例如 hugo import jekyll jekyll_root_path target_path 。

选项

  -h, --help   help for import

从父命令继承的选项

	 --clock string               设置Hugo使用的时钟，例如：--clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为hugo.yaml | json | toml）
      --configDir string           配置目录（默认为“config”）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定Glob模式匹配的模块路径的任何_vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置了，则自动启用日志记录）
      --quiet                      在静默模式下构建
  -s, --source string              用于读取文件的文件系统路径
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    冗长输出
      --verboseLog                 冗长日志记录

另请参阅

另请参阅

20 - hugo import jekyll

hugo import jekyll

https://gohugo.io/commands/hugo_import_jekyll/

hugo import jekyll

hugo import from Jekyll

概要

hugo import from Jekyll.

​ 从 Jekyll 导入需要两个路径，例如： hugo import jekyll jekyll_root_path target_path.

hugo import jekyll [flags]

选项

      --force   允许导入到非空目标目录中
  -h, --help    help for jekyll

从父命令继承的选项

      --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为 "config"）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略匹配给定 Glob 模式的模块路径下的任何 _vendor
      --log                        启用日志
      --logFile string             日志文件路径（如果设置，自动启用日志记录）
      --quiet                      安静模式下构建
  -s, --source string              从文件系统路径中相对读取文件
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    显示详细输出

另请参阅

  • hugo import - 从其他站点生成器导入您的站点。

另请参阅

21 - hugo list

hugo list

https://gohugo.io/commands/hugo_list/

hugo list

​ 列出各种类型的内容

概要

​ 列出各种类型的内容。

​ List 命令需要一个子命令，例如 hugo list drafts。

选项

      --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
  -e, --environment string         构建环境
  -h, --help                       列出帮助信息
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径中的任何 _vendor 文件夹
  -s, --source string              从文件系统路径读取文件的相对路径
      --themesDir string           主题目录的文件系统路径

从父命令继承的选项

      --config string      配置文件（默认为 hugo.yaml|json|toml）
      --configDir string   配置目录（默认为“config”）
      --debug              调试输出
      --log                启用日志记录
      --logFile string     日志文件路径（如果设置了该选项，则会自动启用日志记录）
      --quiet              静默模式下构建
  -v, --verbose            输出详细信息
      --verboseLog         输出详细日志记录

另请参阅

另请参阅

22 - hugo list all

hugo list all

https://gohugo.io/commands/hugo_list_all/

hugo list all

​ 列出所有文章

概要

​ 列出您内容目录中的所有文章，包括草稿、未来和过期的页面。

hugo list all [flags]

选项

  -h, --help   help for all

从父命令继承的选项

	  --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为 "config"）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略匹配给定 Glob 模式的模块路径中的任何 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，将自动启用日志记录）
      --quiet                      静默模式下构建
  -s, --source string              文件系统路径，相对于该路径读取文件
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    冗长输出
      --verboseLog                 详细日志记录

另请参阅

另请参阅

23 - hugo list drafts

hugo list drafts

https://gohugo.io/commands/hugo_list_drafts/

hugo list drafts

​ 列出所有草稿

概要

列出您内容目录中的所有草稿。

hugo list drafts [flags]

选项

  -h, --help   help for drafts

从父命令继承的选项

	  --clock string               设置Hugo使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为hugo.yaml | json | toml）
      --configDir string           配置目录（默认为“config”）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定通配符匹配的模块路径中的任何_vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，则会自动启用日志记录）
      --quiet                      以安静模式构建
  -s, --source string              从中读取文件的文件系统路径
      --themesDir string           进入主题目录的文件系统路径
  -v, --verbose                    详细输出
      --verboseLog                 详细记录日志

另请参阅

另请参阅

24 - hugo list expired

hugo list expired

https://gohugo.io/commands/hugo_list_expired/

hugo list expired

​ 列出已过期的所有文章

概要

​ 列出您内容目录中所有已过期的文章。

hugo list expired [flags]

选项

  -h, --help   help for expired

从父命令继承的选项

      --clock string               设置 Hugo 使用的时钟，例如：--clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为 "config"）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径的任何 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，则自动启用日志记录）
      --quiet                      静默模式构建
  -s, --source string              从文件系统路径读取相对文件
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    冗长输出
      --verboseLog                 冗长日志记录

另请参阅

另请参阅

25 - hugo list future

hugo list future

https://gohugo.io/commands/hugo_list_future/

hugo list future

​ 列出所有日期为将来的文章

概要

​ 列出您内容目录中所有将来发布的文章。

hugo list future [flags]

选项

  -h, --help   help for future

从父命令继承的选项

	  --clock string               设置 Hugo 使用的时钟，比如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为 "config"）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径的任何 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置了，则自动启用日志记录）
      --quiet                      静默模式构建
  -s, --source string              从文件系统路径读取文件的相对路径
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    详细输出
      --verboseLog                 详细日志记录

另请参阅

另请参阅

26 - hugo mod

hugo mod

https://gohugo.io/commands/hugo_mod/

hugo mod

​ 各种 Hugo 模块的辅助工具。

概要

​ 提供各种辅助工具，以帮助管理项目依赖图中的模块。

​ 大多数操作需要在您的系统上安装 Go 版本（>= Go 1.12）和相关的版本控制系统客户端（通常是 Git）。如果您仅在 /themes 内操作模块或通过 “hugo mod vendor” 将它们标记为供应商，则不需要安装它们。

​ 这里的大多数操作需要在您的系统上安装了Go版本（>= Go 1.12）和相关的VCS客户端（通常是Git）。如果您只操作/themes中的模块，或者通过 “hugo mod vendor” 将它们打包到_vendor目录，那么不需要这些依赖。

​ 请注意，Hugo将始终首先解析站点配置中定义的组件，这些组件由_vendor目录（如果没有提供-ignoreVendorPaths标志）、Go模块或主题目录内的文件夹提供，按照此顺序解析。

​ 有关更多信息，请参见 https://gohugo.io/hugo-modules/。

选项

  -b, --baseURL string             根目录的主机名（和路径），例如 https://spf13.com/
  -D, --buildDrafts                包括被标记为草稿的内容
  -E, --buildExpired               包括已过期的内容
  -F, --buildFuture                包括未来发布日期的内容
      --cacheDir string            缓存目录的文件系统路径。默认为：$TMPDIR/hugo_cache/
      --cleanDestinationDir        删除目标中未在静态目录中找到的文件
      --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
  -c, --contentDir string          内容目录的文件系统路径
  -d, --destination string         要写入文件的文件系统路径
      --disableKinds strings       禁用不同类型的页面（主页、RSS 等）
      --enableGitInfo              将 Git 版本、日期、作者和 CODEOWNERS 信息添加到页面中
  -e, --environment string         构建环境
      --forceSyncStatic            当静态文件更改时复制所有文件。
      --gc                         启用以运行一些清理任务（删除未使用的缓存文件）。
  -h, --help                       查看 mod 帮助
      --ignoreCache                忽略缓存目录
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径的任何 _vendor
  -l, --layoutDir string           布局目录的文件系统路径
      --minify                     最小化任何支持的输出格式（HTML、XML 等）
      --noBuildLock                不创建 .hugo_build.lock 文件
      --noChmod                    不同步文件的权限模式
      --noTimes                    不同步文件的修改时间
      --panicOnWarning             在第一个 WARNING 日志上引发 panic
      --poll string                将其设置为轮询

从父命令继承的选项

	  --config string      配置文件（默认为hugo.yaml|json|toml）
      --configDir string   配置目录（默认为 "config"）
      --debug              调试输出
      --log                启用日志
      --logFile string     日志文件路径（如果设置，自动启用日志）
      --quiet              安静模式构建
  -v, --verbose            详细输出
      --verboseLog         详细日志记录

另请参阅

另请参阅

27 - hugo mod clean

hugo mod clean

https://gohugo.io/commands/hugo_mod_clean/

hugo mod clean

​ 删除当前项目的Hugo模块缓存。

概要

​ 删除当前项目的Hugo模块缓存。

​ 请注意，运行此命令后，所有依赖项将在下次运行"hugo"时重新下载。

​ 还要注意，如果为"modules"文件缓存配置了正的maxAge，则也将在"hugo –gc"中清除它。

hugo mod clean [flags]

选项

      --all              清除整个模块缓存
  -h, --help             清除帮助
      --pattern string   匹配要清除的模块路径的模式（如果未设置，则为全部），例如“**hugo*”

从父命令继承的选项

	  --clock string               设置Hugo使用的时钟，例如--clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为hugo.yaml|json|toml）
      --configDir string           配置目录（默认为“config”）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略匹配给定Glob模式的模块路径的任何_vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，自动启用日志记录）
      --quiet                      安静模式构建
  -s, --source string              从文件系统路径读取文件的相对路径
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    冗长输出
      --verboseLog                 详细日志记录

另请参阅

另请参阅

28 - hugo mod get

hugo mod get

https://gohugo.io/commands/hugo_mod_get/

hugo mod get

​ 解析您当前 Hugo 项目的依赖项。

概要

​ 解析您当前 Hugo 项目的依赖项。

​ 以下是一些示例：

​ 安装给定模块的最新版本：

hugo mod get github.com/gohugoio/testshortcodes

​ 安装特定版本：

hugo mod get github.com/gohugoio/testshortcodes@v0.3.0

​ 安装所有模块依赖的最新版本：

hugo mod get -u
hugo mod get -u ./... (recursive)

​ 运行 “go help get” 以获取更多信息。所有 “go get” 可用的标志在此处也是相关的。

​ 请注意，Hugo将始终首先解析站点配置中定义的组件，这些组件由_vendor目录（如果没有提供-ignoreVendorPaths标志）、Go模块或主题目录内的文件夹提供，按照此顺序解析。

​ 有关详细信息，请参阅 https://gohugo.io/hugo-modules/。

hugo mod get [flags]

选项

  -h, --help   help for get

从父命令继承的选项

	  --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为 "config"）
      --debug                      调试输出
  -e，--environment string         构建环境
      --ignoreVendorPaths string   忽略匹配给定 Glob 模式的模块路径的任何 _vendor 
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，自动启用日志记录）
      --quiet                      安静模式下构建
  -s，--source string              从文件系统路径读取文件，相对路径
      --themesDir string           主题目录的文件系统路径
  -v，--verbose                    输出详细信息
      --verboseLog                 输出详细日志

另请参阅

另请参阅

29 - hugo mod graph

hugo mod graph

https://gohugo.io/commands/hugo_mod_graph/

hugo mod graph

​ 打印模块依赖图。

概要

​ 打印包含有关模块状态（禁用、供应商）信息的模块依赖图。请注意，对于供应商模块，将列出版本而不是来自 go.mod 的版本。

hugo mod graph [flags]

选项

  -h, --help   help for graph

从父命令继承的选项

	  --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为 "config"）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径中的任何 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，则自动启用日志记录）
      --quiet                      安静模式构建
  -s, --source string              文件系统路径，以相对路径读取文件
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    详细输出
      --verboseLog                 详细日志记录

另请参阅

另请参阅

30 - hugo mod init

hugo mod init

https://gohugo.io/commands/hugo_mod_init/

hugo mod init

​ 将此项目初始化为 Hugo 模块。

概要

​ 将该项目初始化为 Hugo 模块。它会尝试猜测模块路径，但您也可以通过参数来指定，例如：

hugo mod init github.com/gohugoio/testshortcodes

​ 请注意，Hugo 模块支持多模块项目，因此您可以在 GitHub 的子文件夹中初始化 Hugo 模块，作为一个示例。

hugo mod init [flags]

选项

  -h, --help   help for init

从父命令继承的选项

      --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为“config”）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略任何 _vendor 目录，以匹配给定的 Glob 模式的模块路径
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，将自动启用日志记录）
      --quiet                      在安静模式下构建
  -s, --source string              从文件系统路径读取文件的相对路径
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    输出详细信息
      --verboseLog                 输出详细的日志记录

另请参阅

另请参阅

31 - hugo mod npm

hugo mod npm

https://gohugo.io/commands/hugo_mod_npm/

hugo mod npm

​ 各种npm助手。

概要

​ 各种npm（Node包管理器）助手。

hugo mod npm [flags]

选项

  -h, --help   help for npm

从父命令继承的选项

	  --clock string               设置Hugo使用的时钟，例如 --clock 2021-11-06T22: 30: 00.00 + 09: 00
      --config string              配置文件（默认为hugo.yaml| json | toml）
      --configDir string           配置目录（默认为“config”）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略匹配给定Glob模式的模块路径中的任何_vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，则自动启用日志记录）
      --quiet                      静默模式构建
  -s, --source string              相对于该文件系统路径读取文件的路径
      --themesDir string           主题目录所在的文件系统路径
  -v, --verbose                    详细输出
      --verboseLog                 详细日志记录

另请参阅

  • hugo mod - 各种 Hugo 模块助手。
  • hugo mod npm pack - 实验性功能：为您的项目准备并编写一个组合的package.json文件。

另请参阅

32 - hugo mod npm pack

hugo mod npm pack

https://gohugo.io/commands/hugo_mod_npm_pack/

hugo mod npm pack

​ 实验性功能：准备并写入项目的组合 package.json 文件。

概要

​ 准备并写入项目的组合 package.json 文件。

​ 第一次运行时，如果项目根目录中没有"package.hugo.json"文件，则会创建该文件。此文件将用作具有基本依赖项集合的模板文件。

​ 该集合将与在依赖树中找到的所有"package.hugo.json"文件合并，选择最接近项目的版本。

​ 此命令标记为 Experimental。我们认为这是一个很好的想法，因此不太可能从 Hugo 中删除，但我们需要在"real life"中进行测试以了解它的感觉，因此在未来的Hugo版本中它可能会/将更改。

hugo mod npm pack [flags]

选项

  -h, --help   help for pack

从父命令继承的选项

      --clock string               设置 Hugo 使用的时钟，例如--clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认值为“config”）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径中的任何 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，则自动启用日志记录）
      --quiet                      静默模式下构建
  -s, --source string              从文件系统路径读取相对文件
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    详细输出
      --verboseLog                 详细日志记录

另请参阅

另请参阅

33 - hugo mod tidy

hugo mod tidy

https://gohugo.io/commands/hugo_mod_tidy/

hugo mod tidy

​ 删除 go.mod 和 go.sum 中未使用的条目。

hugo mod tidy [flags]

选项

  -h, --help   help for tidy

从父命令继承的选项

	  --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为 "config"）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径的任何 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，则自动启用日志记录）
      --quiet                      静默模式下进行构建
  -s, --source string              读取相对文件的文件系统路径
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    详细输出
      --verboseLog                 详细日志记录

另请参阅

另请参阅

34 - hugo mod vendor

hugo mod vendor

https://gohugo.io/commands/hugo_mod_vendor/

hugo mod vendor

​ 将所有模块依赖项打包到 _vendor 目录中。

概要

​ 将所有模块依赖项打包到 _vendor 目录中。

​ 如果一个模块被打包了，Hugo 将在 _vendor 目录中查找它的依赖项。

hugo mod vendor [flags]

选项

  -h, --help   help for vendor

从父命令继承的选项

	  --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为 "config"）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径的任何 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，则自动启用日志记录）
      --quiet                      静默模式下进行构建
  -s, --source string              读取相对文件的文件系统路径
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    详细输出
      --verboseLog                 详细日志记录

另请参阅

另请参阅

35 - hugo mod verify

hugo mod verify

https://gohugo.io/commands/hugo_mod_verify/

hugo mod verify

​ 验证依赖项。

概要

​ verify 检查当前模块的依赖项是否已被下载到本地源缓存中，在下载后是否已被修改。

hugo mod verify [flags]

选项

      --clean   如果验证失败则删除依赖项的模块缓存
  -h, --help    help for verify

从父命令继承的选项

	  --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为 hugo.yaml|json|toml）
      --configDir string           配置目录（默认为 "config"）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径的任何 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，则自动启用日志记录）
      --quiet                      静默模式下进行构建
  -s, --source string              读取相对文件的文件系统路径
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    详细输出
      --verboseLog                 详细日志记录

另请参阅

另请参阅

36 - hugo new

hugo new

https://gohugo.io/commands/hugo_new/

hugo new

​ 为您的站点创建新内容

概要

​ 创建一个新的内容文件并自动设置日期和标题。它将根据提供的路径猜测要创建哪种类型的文件。

​ 您还可以使用-k KIND指定种类。

​ 如果您的主题或站点中提供了原型模板，它们将被使用。

​ 请确保在站点的根目录中运行此命令。

hugo new [path] [flags]

选项

  -b, --baseURL string             站点根目录的主机名（和路径），例如 https://spf13.com/
  -D, --buildDrafts                包括标记为草稿的内容
  -E, --buildExpired               包括过期内容
  -F, --buildFuture                包括发布日期在未来的内容
      --cacheDir string            缓存目录的文件系统路径。默认值：$TMPDIR/hugo_cache/。
      --cleanDestinationDir        删除目标文件夹中未在静态目录中找到的文件
      --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
  -c, --contentDir string          内容文件夹的文件系统路径
  -d, --destination string         写入文件的文件系统路径
      --disableKinds strings       禁用不同种类的页面（主页、RSS 等）
      --editor string              使用此编辑器编辑新内容（如果提供）
      --enableGitInfo              添加 Git 版本、日期、作者和 CODEOWNERS 信息到页面中
  -e, --environment string         构建环境
  -f, --force                      如果文件已经存在，则覆盖文件
      --forceSyncStatic            当静态文件发生更改时复制所有文件。
      --gc                         构建后启用以运行一些清理任务（删除未使用的缓存文件）
  -h, --help                       hugo new 的帮助信息
      --ignoreCache                忽略缓存目录
      --ignoreVendorPaths string   忽略匹配给定 Glob 模式的模块路径下的 _vendor。
  -k, --kind string                要创建的内容类型
  -l, --layoutDir string           布局文件夹的文件系统路径
      --minify                     缩小任何受支持的输出格式（HTML、XML 等）
      --noBuildLock                不创建 .hugo_build.lock 文件
      --noChmod                    不同步文件的权限模式
      --noTimes                    不同步文件的修改时间
      --panicOnWarning             在第一个 WARNING 日志上发生崩溃
      --poll string                将其设置为轮询间隔，例如 --poll 700ms，使其使用基于轮询的方法来监视文件系统更改
      --printI18nWarnings          打印缺少的翻译
      --printMemoryUsage           定期在屏幕上打印内存使用情况
      --printPathWarnings          打印有关重复目标路径的警告等
      --printUnusedTemplates       打印未使用模板的警告。
  -s, --source string              从中读取文件的文件系统路径
      --templateMetrics            显示有关模板执行的指标
      --templateMetricsHints       与 --templateMetrics 结合使用时，计算某些改进提示
  -t, --theme strings              要使用的主题（位于 /themes/THEMENAME/ 中）
      --themesDir string           主题文件夹的文件系统路径
      --trace file                 将跟踪写入文件（通常不会有用）

从父命令继承的选项

      --config string      配置文件（默认为 hugo.yaml|json|toml）
      --configDir string   配置目录（默认为 "config"）
      --debug              调试输出
      --log                启用日志记录
      --logFile string     日志文件路径（如果设置，自动启用日志记录）
      --quiet              安静模式下构建
  -v, --verbose            冗长的输出
      --verboseLog         冗长的日志记录

另请参阅

另请参阅

37 - hugo new site

hugo new site

https://gohugo.io/commands/hugo_new_site/

hugo new site

​ 创建新站点（框架）

概要

​ 在指定的目录中创建新站点。新站点将具有正确的结构，但尚未包含任何内容或主题。使用 hugo new [contentPath] 创建新的内容。

hugo new site [path] [flags]

选项

      --clock string               设置 Hugo 使用的时钟，例如：--clock 2021-11-06T22:30:00.00+09:00
  -e, --environment string         构建环境
      --force                      在非空目录中初始化
  -f, --format string              配置文件格式（默认为 "toml"）
  -h, --help                       site 的帮助信息
      --ignoreVendorPaths string   忽略匹配给定 Glob 模式的模块路径中的任何 _vendor
  -s, --source string              从文件系统路径中读取相对文件的路径
      --themesDir string           主题目录的文件系统路径

从父命令继承的选项

      --config string      配置文件（默认为 hugo.yaml|json|toml）
      --configDir string   配置目录（默认为 "config"）
      --debug              调试输出
      --log                启用日志记录
      --logFile string     日志文件路径（如果设置，则自动启用日志记录）
      --quiet              静默模式下构建
  -v, --verbose            冗长输出
      --verboseLog         冗长的日志记录

另请参阅

  • hugo new - 为您的站点创建新内容

另请参阅

38 - hugo new theme

hugo new theme

https://gohugo.io/commands/hugo_new_theme/

hugo new theme

​ 创建一个新的主题

概要

​ 在./themes中创建一个名为[name]的新主题（框架）。新主题是一个框架，请在相关文件中添加内容。在许可证的版权行中添加您的名字，并根据需要调整theme.toml文件。

hugo new theme [name] [flags]

选项

	  --clock string               设置Hugo使用的时钟，例如：--clock 2021-11-06T22:30:00.00+09:00
  -e, --environment string         构建环境
  -h, --help                       帮助主题
      --ignoreVendorPaths string   忽略与给定Glob模式匹配的模块路径中的任何_vendor
  -s, --source string              从文件系统路径读取文件的路径
      --themesDir string           主题目录的文件系统路径

从父命令继承的选项

      --config string      配置文件 (默认为hugo.yaml|json|toml)
      --configDir string   配置目录 (默认为“config”)
      --debug              调试输出
      --log                启用日志记录
      --logFile string     日志文件路径（如果设置，自动启用日志记录）
      --quiet              静默模式构建
  -v, --verbose            详细输出
      --verboseLog         详细日志记录

另请参阅

  • hugo new - 为您的站点创建新内容

另请参阅

39 - hugo server

hugo server

https://gohugo.io/commands/hugo_server/

hugo server

​ 一个高性能的 Web 服务器

概要

​ Hugo 提供了自己的 Web 服务器，可以构建和提供站点。虽然 hugo server 性能很高，但它是一个选项有限的 Web 服务器。许多人在生产中运行它，但标准行为是在开发中使用它，（在生成中）使用更全面的服务器，例如 Nginx 或 Caddy。

​ ‘hugo server’ 将避免将渲染和提供的内容写入磁盘，而是将其存储在内存中。

​ 默认情况下，hugo 也会监视您所做的任何更改并自动重新构建站点。然后它将实时重新加载任何打开的浏览器页面并将最新内容推送到它们。由于大多数 Hugo 站点只需要几秒钟就可以构建完毕，因此您几乎可以立即保存和查看更改。

hugo server [flags]

选项

	  --appendPort                 将端口附加到 baseURL 上（默认为 true）
  -b, --baseURL string             主机名（和路径）到根目录，例如 https://spf13.com/
      --bind string                服务器将绑定的接口（默认为 "127.0.0.1"）
  -D, --buildDrafts                包括标记为草稿的内容
  -E, --buildExpired               包括过期的内容
  -F, --buildFuture                包括发布日期在未来的内容
      --cacheDir string            缓存目录的文件系统路径。默认值：$TMPDIR/hugo_cache/
      --cleanDestinationDir        删除在静态目录中找不到的目标文件
      --clock string               设置 Hugo 使用的时钟，例如 --clock 2021-11-06T22:30:00.00+09:00
  -c, --contentDir string          内容目录的文件系统路径
  -d, --destination string         写入文件的文件系统路径
      --disableBrowserError        不要在浏览器中显示构建错误
      --disableFastRender          启用完全重渲染以响应更改
      --disableKinds strings       禁用不同类型的页面（主页、RSS 等）
      --disableLiveReload          在重建时不启用实时浏览器重新加载
      --enableGitInfo              向页面添加 Git 修订版、日期、作者和 CODEOWNERS 信息
  -e, --environment string         构建环境
      --forceSyncStatic            当静态文件发生更改时复制所有文件。
      --gc                         启用后可在构建后运行一些清理任务（删除未使用的缓存文件）
  -h, --help                       server 的帮助信息
      --ignoreCache                忽略缓存目录
      --ignoreVendorPaths string   忽略与给定 Glob 模式匹配的模块路径的 _vendor
  -l, --layoutDir string           布局目录的文件系统路径
      --liveReloadPort int         实时重新加载端口（例如 HTTPS 代理情况下的 443）（默认为 -1）
      --meminterval string         每隔一段时间轮询内存使用情况（需要 --memstats），有效的时间单位为 "ns"、"us"（或 "µs"）、"ms"、"s"、"m"、"h"。（默认为 "100ms"）
      --memstats string            将内存使用情况记录到这个文件中
      --minify                     缩小任何受支持的输出格式（HTML、XML 等）
      --navigateToChanged          在实时浏览器重新加载时导航到更改的内容文件
      --noBuildLock                不创建 .hugo_build.lock 文件
      --noChmod                    不同步文件的权限模式
      --noHTTPCache                防止 HTTP 缓存
      --noTimes                    不同步文件的修改时间
      --panicOnWarning             在第一个 WARNING 日志时 panic
      --poll string                将此设置为轮询间隔，例如 --poll 700ms，以使用基于轮询的方法来监视文件系统更改
  -p, --port int                   服务器将监听的端口（默认为 1313）
      --printI18nWarnings          打印缺少的翻译
      --printMemoryUsage           在一定间隔内将内存使用情况打印到屏幕上
      --printPathWarnings          打印有关重复目标路径等的警告
      --printUnusedTemplates       打印有关未使用模板的警告。
      --renderStaticToDisk         从磁盘提供静态文件，从内存提供动态文件
      --renderToDisk               从磁盘提供所有文件（默认情况下从内存提供）
  -s, --source string              相对于读取文件的文件系统路径
      --templateMetrics            显示有关模板执行的指标
      --templateMetricsHints       与 --templateMetrics 结合使用时计算一些改进提示
  -t, --theme strings              要使用的主题（位于 /themes/THEMENAME/ 中）
      --themesDir string           主题目录的文件系统路径
      --trace file                 将跟踪写入文件（通常不太有用）
  -w, --watch                      监视文件系统以进行更改，并根据需要重新创建（默认情况下为 true）

从父命令继承的选项

      --config string      配置文件（默认为 hugo.yaml|json|toml）
      --configDir string   配置目录（默认为 "config"）
      --debug              调试输出
      --log                启用日志记录
      --logFile string     日志文件路径（如果设置，自动启用日志记录）
      --quiet              静默模式下构建
  -v, --verbose            冗长输出
      --verboseLog         冗长日志记录

另请参阅

  • hugo - hugo 构建您的站点

另请参阅

40 - hugo version

hugo version

https://gohugo.io/commands/hugo_version/

hugo version

​ 打印 Hugo 的版本号。

概要

​ 所有软件都有版本号。这是 Hugo 的版本号。

hugo version [flags]

选项

  -h, --help   help for version

从父命令继承的选项

     --clock string               设置 Hugo 使用的时钟，例如：--clock 2021-11-06T22:30:00.00+09:00
      --config string              配置文件（默认为hugo.yaml|json|toml）
      --configDir string           配置目录（默认为“config”）
      --debug                      调试输出
  -e, --environment string         构建环境
      --ignoreVendorPaths string   忽略匹配给定 Glob 模式的模块路径中的任何 _vendor
      --log                        启用日志记录
      --logFile string             日志文件路径（如果设置，则自动启用日志记录）
      --quiet                      静默模式下构建
  -s, --source string              从文件系统读取文件的相对路径
      --themesDir string           主题目录的文件系统路径
  -v, --verbose                    冗长输出
      --verboseLog                 冗长日志记录

另请参阅

  • hugo - hugo 构建您的站点

另请参阅