命令
- 1: hugo
- 2: hugo completion
- 3: hugo completion bash
- 4: hugo completion fish
- 5: hugo completion powershell
- 6: hugo completion zsh
- 7: hugo config
- 8: hugo config mounts
- 9: hugo convert
- 10: hugo convert toJSON
- 11: hugo convert toTOML
- 12: hugo convert toYAML
- 13: hugo deploy
- 14: hugo env
- 15: hugo gen
- 16: hugo gen chromastyles
- 17: hugo gen doc
- 18: hugo gen man
- 19: hugo import
- 20: hugo import jekyll
- 21: hugo list
- 22: hugo list all
- 23: hugo list drafts
- 24: hugo list expired
- 25: hugo list future
- 26: hugo mod
- 27: hugo mod clean
- 28: hugo mod get
- 29: hugo mod graph
- 30: hugo mod init
- 31: hugo mod npm
- 32: hugo mod npm pack
- 33: hugo mod tidy
- 34: hugo mod vendor
- 35: hugo mod verify
- 36: hugo new
- 37: hugo new site
- 38: hugo new theme
- 39: hugo server
- 40: hugo version
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 观察文件系统变化,并根据需要重新创建
另请参阅
- hugo completion - 为指定的 shell 生成自动补全脚本
- hugo config - 打印站点配置
- hugo convert - 将您的内容转换为不同格式
- hugo deploy - 将您的站点部署到云提供商。
- hugo env - 打印 Hugo 版本和环境信息
- hugo gen - 多个有用的生成器的集合。
- hugo import - 从其他来源导入您的站点。
- hugo list - 列出各种类型的内容
- hugo mod - 各种 Hugo 模块助手。
- hugo new - 为您的站点创建新内容
- hugo server - 一个高性能的网络服务器
- hugo version - 打印 Hugo 的版本号
另请参阅
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 冗长的日志记录
另请参阅
- hugo - hugo 构建您的站点
- hugo completion bash - 为 bash 生成自动补全脚本
- hugo completion fish - 为 fish 生成自动补全脚本
- hugo completion powershell - 为 powershell 生成自动补全脚本
- hugo completion zsh - 为 zsh 生成自动补全脚本
另请参阅
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 冗长的日志记录
另请参阅
- hugo completion - 为指定的shell生成自动完成脚本
另请参阅
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 冗长的日志记录
另请参阅
- hugo completion - 为指定的shell生成自动完成脚本
另请参阅
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 冗长的日志记录
另请参阅
- hugo completion - 为指定的shell生成自动完成脚本
另请参阅
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 冗长的日志记录
另请参阅
- hugo completion - 为指定的shell生成自动完成脚本
另请参阅
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 详细日志记录
另请参阅
- hugo - hugo构建您的站点
- hugo config mounts - 打印配置的文件挂载
另请参阅
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 详细日志记录
另请参阅
- hugo config - 打印站点配置
另请参阅
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 详细日志记录
另请参阅
- hugo - hugo 构建您的站点
- hugo convert toJSON - 将前置元数据转换为 JSON
- hugo convert toTOML - 将前置元数据转换为 TOML
- hugo convert toYAML - 将前置元数据转换为 YAML
另请参阅
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 输出详细日志记录
另请参阅
- hugo convert - 将您的内容转换为不同的格式
另请参阅
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 详细日志记录
另请参阅
- hugo convert - Convert your content to different formats
另请参阅
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 详细日志记录
另请参阅
- hugo convert - 将您的内容转换为不同的格式
另请参阅
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 详细日志记录
另请参阅
- hugo - hugo 构建您的站点
- hugo gen chromastyles - 生成 Chroma 代码高亮器的 CSS 样式表
- hugo gen doc - 为 Hugo CLI 生成 Markdown 文档。
- hugo gen man - 为 Hugo CLI 生成 man 页面
另请参阅
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 冗长日志记录
另请参阅
- hugo - hugo 构建您的站点
- hugo import jekyll - hugo import from Jekyll
另请参阅
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 输出详细日志记录
另请参阅
- hugo - hugo 构建您的站点
- hugo list all - 列出所有文章
- hugo list drafts - 列出所有草稿
- hugo list expired - 列出所有已过期的文章
- hugo list future - 列出所有将来发布的文章
另请参阅
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 详细日志记录
另请参阅
- hugo list - 列出各种类型的内容
另请参阅
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 详细记录日志
另请参阅
- hugo list - 列出各种类型的内容
另请参阅
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 冗长日志记录
另请参阅
- hugo list - 列出各种类型的内容
另请参阅
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 详细日志记录
另请参阅
- hugo list - 列出各种类型的内容
另请参阅
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 详细日志记录
另请参阅
- hugo - hugo 构建您的站点
- hugo mod clean - 删除当前项目的Hugo模块缓存。
- hugo mod get - 解析您当前的Hugo项目的依赖项。
- hugo mod graph - 打印模块依赖关系图表。
- hugo mod init - 将此项目初始化为Hugo模块。
- hugo mod npm - 各种npm助手。
- hugo mod tidy - 删除go.mod和go.sum中未使用的条目。
- hugo mod vendor - 将所有模块依赖项打包到_vendor目录中。
- hugo mod verify - 校验依赖关系。
另请参阅
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 详细日志记录
另请参阅
- hugo mod - 各种Hugo模块助手.
另请参阅
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 输出详细日志
另请参阅
- hugo mod - 各种 Hugo 模块助手。
另请参阅
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 详细日志记录
另请参阅
- hugo mod - 各种 Hugo 模块助手。
另请参阅
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 输出详细的日志记录
另请参阅
- hugo mod - 各种 Hugo 模块助手。
另请参阅
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 详细日志记录
另请参阅
- hugo mod npm - 各种 npm 助手。
另请参阅
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 详细日志记录
另请参阅
- hugo mod - 各种 Hugo 模块助手。
另请参阅
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 详细日志记录
另请参阅
- hugo mod - 各种 Hugo 模块助手。
另请参阅
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 详细日志记录
另请参阅
- hugo mod - 各种 Hugo 模块助手。
另请参阅
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 冗长的日志记录
另请参阅
- hugo - hugo 构建您的站点
- hugo new site - 创建一个新的站点(框架 (skeleton))
- hugo new theme - 创建一个新的主题
另请参阅
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 构建您的站点