基本用法
测试您的安装
在 安装 Hugo 后,运行以下命令测试您的安装
hugo version
您应该会看到类似以下内容
hugo v0.123.0-3c8a4713908e48e6523f058ca126710397aa4ed5+extended linux/amd64 BuildDate=2024-02-19T16:32:38Z VendorInfo=gohugoio
显示可用命令
要查看可用命令和标志的列表
hugo help
要获取子命令的帮助,请使用 --help
标志。例如
hugo server --help
构建您的站点
要构建您的站点,请 cd
进入您的项目目录并运行
hugo
hugo
命令会构建您的站点,并将文件发布到 public
目录。要将您的站点发布到不同的目录,请使用 --destination
标志或在您的站点配置中设置 publishDir
。
草稿、未来和过期内容
Hugo 允许您在内容的 前言 中设置 draft
、date
、publishDate
和 expiryDate
。默认情况下,当以下情况时,Hugo 不会发布内容:
draft
值为true
date
是未来时间publishDate
是未来时间expiryDate
是过去时间
您可以使用命令行标志覆盖运行 hugo
或 hugo server
时的默认行为
hugo --buildDrafts # or -D
hugo --buildExpired # or -E
hugo --buildFuture # or -F
虽然您也可以在您的站点配置中设置这些值,但除非所有内容作者都知道并理解这些设置,否则可能会导致意想不到的结果。
开发和测试您的站点
要在开发布局或创建内容时查看您的站点,请 cd
进入您的项目目录并运行
hugo server
hugo server
命令会构建您的站点,并使用一个最小的 HTTP 服务器提供您的页面。当您运行 hugo server
时,它会显示您本地站点的 URL
Web Server is available at http://localhost:1313/
当服务器运行时,它会监视您的项目目录中资源、配置、内容、数据、布局、翻译和静态文件的更改。当它检测到更改时,服务器会重建您的站点,并使用 LiveReload 刷新您的浏览器。
大多数 Hugo 构建速度非常快,除非您直接查看浏览器,否则您可能不会注意到更改。
LiveReload
当服务器运行时,Hugo 会将 JavaScript 注入到生成的 HTML 页面中。LiveReload 脚本通过 Web Socket 创建从浏览器到服务器的连接。您不需要安装任何软件或浏览器插件,也不需要任何配置。
自动重定向
在编辑内容时,如果您希望浏览器自动重定向到您上次修改的页面,请运行
hugo server --navigateToChanged
部署您的站点
当您准备好部署您的站点时,运行
hugo
这将构建您的站点,并将文件发布到 public
目录。目录结构将如下所示:
public/
├── categories/
│ ├── index.html
│ └── index.xml <-- RSS feed for this section
├── posts/
│ ├── my-first-post/
│ │ └── index.html
│ ├── index.html
│ └── index.xml <-- RSS feed for this section
├── tags/
│ ├── index.html
│ └── index.xml <-- RSS feed for this section
├── index.html
├── index.xml <-- RSS feed for the site
└── sitemap.xml
在一个简单的托管环境中,您通常使用 ftp
、rsync
或 scp
将文件传输到虚拟主机的根目录,public
目录的内容是您所需要的全部。
我们的大多数用户使用 CI/CD 工作流程部署他们的站点,其中推送到1他们的 GitHub 或 GitLab 存储库会触发构建和部署。流行的提供商包括 AWS Amplify、CloudCannon、Cloudflare Pages、GitHub Pages、GitLab Pages 和 Netlify。
在 托管和部署 部分了解更多信息。
-
Git 存储库包含整个项目目录,通常排除
public
目录,因为站点是在推送之后构建的。 ↩︎