2 分钟
快速入门
这个快速入门在示例中使用了macOS。有关如何在其他操作系统上安装Hugo的说明,请参阅 安装
第1步:安装Hugo
brew install hugo
验证
hugo version
第2步:创建一个新网站
hugo new site quickstart
以上将在名为quickstart的文件夹中创建一个新的Hugo网站项目
第3步:添加一个主题
请参阅 themes.gohugo.io 以获取要考虑的主题列表。本快速入门使用了美丽的Ananke主题。
cd quickstart
# 下载主题
git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
# 非git用户请注意:
# - 如果您没有安装git,可以从 https://github.com/budparr/gohugo-theme-ananke/archive/master.zip 下载这个主题的最新版本的压缩包
# - 解压缩这个 .zip 文件到 "gohugo-theme-ananke-master" 目录
# - 重命名这个目录为 "ananke" ,并移动到 "themes" 目录
# 编辑config.toml配置文件
# 并添加Ananke主题
echo 'theme = "ananke"' >> config.toml
第4步:添加一些Content
hugo new posts/my-first-post.md
如果需要,编辑新创建的内容文件
第5步:启动Hugo服务器
使用启用草稿选项启动Hugo服务
▶ hugo server -D
| EN
+------------------+----+
Pages | 10
Paginator pages | 0
Non-page files | 0
Static files | 3
Processed images | 0
Aliases | 1
Sitemaps | 1
Cleaned | 0
Total in 11 ms
Watching for changes in /Users/bep/quickstart/{content,data,layouts,static,themes}
Watching for config changes in /Users/bep/quickstart/config.toml
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop
访问你的新网站: http://localhost:1313/
第6步:自定义主题
您的新网站看起来很棒,但在向公众发布之前,您需要稍微调整一下
网站配置
在一个文本编辑器中打开 config.toml
baseURL = "https://example.org/"
languageCode = "en-us"
title = "My New Hugo Site"
theme = "ananke"
用更个性化的东西替换上面的标题。此外,如果您已准备好域名,请设置baseURL。请注意,运行本地开发服务器时不需要此值。
提示:在Hugo服务器运行时对站点配置或站点中的任何其他文件进行更改,您将立即看到浏览器中的更改,但您可能需要清除缓存。
有关主题特定的配置选项,请参阅 主题网站
有关进一步的主题自定义,请参阅 自定义主题。