Hugo 的常用命令
Hugo 的常用命令
2024-09-14
本文基于的 hugo 版本:
hugo v0.134.2+extended darwin/amd64 BuildDate=2024-09-10T10:46:33Z VendorInfo=brew
- 版本号:0.134.2 扩展版
- 操作系统:macOS 64 位
- 构建时间:2024 年 9 月 10 日
- 安装来源:Homebrew 包管理器
常用命令
-
查看 hugo 版本
hugo version
-
创建一个新站点,存储在
newblog
文件夹内hugo new site newblog
-
创建一篇新文章,路径为
content/posts/newpost.md
hugo new posts/newpost.md
-
本地预览(生成静态文件并启动 web 服务) http://localhost:1313/
hugo server -w -D
hugo help 翻译
安装好 hugo 后,在终端输入 hugo help
会输出如下内容:
hugo is the main command, used to build your Hugo site.
Hugo is a Fast and Flexible Static Site Generator
built with love by spf13 and friends in Go.
Complete documentation is available at https://gohugo.io/.
Usage:
hugo [flags]
hugo [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
config Print the site configuration
convert Convert your content to different formats
deploy Deploy your site to a Cloud provider.
env Print Hugo version and environment info
gen A collection of several useful generators.
help Help about any command
import Import your site from others.
list Listing out various types of content
mod Various Hugo Modules helpers.
new Create new content for your site
server A high performance webserver
version Print Hugo version and environment info
Flags:
-b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
-D, --buildDrafts include content marked as draft
-E, --buildExpired include expired content
-F, --buildFuture include content with publishdate in the future
--cacheDir string filesystem path to cache directory
--cleanDestinationDir remove files from destination not found in static directories
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
--config string config file (default is hugo.yaml|json|toml)
--configDir string config dir (default "config")
-c, --contentDir string filesystem path to content directory
--debug debug output
-d, --destination string filesystem path to write files to
--disableKinds strings disable different kind of pages (home, RSS etc.)
--enableGitInfo add Git revision, date, author, and CODEOWNERS info to the pages
-e, --environment string build environment
--forceSyncStatic copy all files when static is changed.
--gc enable to run some cleanup tasks (remove unused cache files) after the build
-h, --help help for hugo
--ignoreCache ignores the cache directory
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
-l, --layoutDir string filesystem path to layout directory
--logLevel string log level (debug|info|warn|error)
--minify minify any supported output format (HTML, XML etc.)
--noBuildLock don't create .hugo_build.lock file
--noChmod don't sync permission mode of files
--noTimes don't sync modification time of files
--panicOnWarning panic on first WARNING log
--poll string set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes
--printI18nWarnings print missing translations
--printMemoryUsage print memory usage to screen at intervals
--printPathWarnings print warnings on duplicate target paths etc.
--printUnusedTemplates print warnings on unused templates.
--quiet build in quiet mode
--renderSegments strings named segments to render (configured in the segments config)
-M, --renderToMemory render to memory (mostly useful when running the server)
-s, --source string filesystem path to read files relative from
--templateMetrics display metrics about template executions
--templateMetricsHints calculate some improvement hints when combined with --templateMetrics
-t, --theme strings themes to use (located in /themes/THEMENAME/)
--themesDir string filesystem path to themes directory
--trace file write trace to file (not useful in general)
-v, --verbose verbose output
-w, --watch watch filesystem for changes and recreate as needed
Use "hugo [command] --help" for more information about a command.
借助 AI 对其进行翻译
Hugo 是主命令,用于构建你的 Hugo 网站。
Hugo 是一个快速且灵活的静态网站生成器,
由 spf13 和朋友们用 Go 语言编写,满怀热情打造。
完整的文档可以在 https://gohugo.io/ 上找到。
用法:
hugo [flags]
hugo [command]
可用命令:
completion 为指定的 shell 生成自动补全脚本
config 输出站点配置
convert 将你的内容转换为不同格式
deploy 将你的站点部署到云服务提供商
env 输出 Hugo 版本和环境信息
gen 一些有用的生成器集合
help 获取关于某个命令的帮助
import 从其他平台导入你的站点
list 列出各种类型的内容
mod 各种 Hugo 模块助手
new 为你的站点创建新内容
server 一个高性能的 Web 服务器
version 输出 Hugo 版本和环境信息
选项(Flags):
-b, --baseURL string 主机名 (及路径),例如 https://spf13.com/
-D, --buildDrafts 包含标记为草稿的内容
-E, --buildExpired 包含过期内容
-F, --buildFuture 包含发布日期在未来的内容
--cacheDir string 文件系统缓存目录的路径
--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 布局目录的文件系统路径
--logLevel string 日志级别 (debug|info|warn|error)
--minify 压缩任何支持的输出格式 (HTML, XML 等)
--noBuildLock 不创建 .hugo_build.lock 文件
--noChmod 不同步文件的权限模式
--noTimes 不同步文件的修改时间
--panicOnWarning 在首次出现 WARNING 日志时停止程序
--poll string 设置轮询间隔,例如 --poll 700ms,使用轮询方式监控文件系统变化
--printI18nWarnings 输出缺失的翻译警告
--printMemoryUsage 定期输出内存使用信息
--printPathWarnings 输出重复目标路径等警告
--printUnusedTemplates 输出未使用的模板警告
--quiet 静默模式构建
--renderSegments strings 渲染命名的部分 (在配置中定义)
-M, --renderToMemory 渲染到内存 (主要用于运行服务器时)
-s, --source string 读取文件的相对路径
--templateMetrics 显示模板执行的指标
--templateMetricsHints 结合 --templateMetrics 使用时计算一些优化提示
-t, --theme strings 使用的主题 (位于 /themes/THEMENAME/)
--themesDir string 主题目录的文件系统路径
--trace file 将跟踪信息写入文件 (通常不需要)
-v, --verbose 输出详细信息
-w, --watch 监视文件系统的变化并根据需要重新生成
使用 "hugo [command] --help" 获取某个命令的更多信息。
最后更新于