GETTING STARTED

快速入門

在本教程中，您將學會如何：

  1. 建立網站
  2. 添加內容
  3. 配置網站
  4. 發佈網站

先決條件

在開始本教程之前，您需要：

  1. 安裝 Hugo（需要擴展版本或部署版，v0.128.0 或更新版本）
  2. 安裝 Git

您還需要熟悉在命令行環境下操作。

建立網站

命令

驗證您是否已安裝 v0.128.0 或更新版本的 Hugo。

hugo version

運行以下命令以使用 Ananke 主題創建一個 Hugo 網站。下一節將解釋每個命令的用途。

hugo new site quickstart
cd quickstart
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
echo "theme = 'ananke'" >> hugo.toml
hugo server

在終端顯示的 URL 查看您的網站，按下 Ctrl + C 以停止 Hugo 的開發伺服器。

命令解釋

創建項目在 quickstart 目錄中的目錄結構。

hugo new site quickstart

切換當前工作目錄到項目的根目錄。

cd quickstart

在當前目錄初始化一個空的 Git 存儲庫。

git init

將 Ananke 主題克隆到 themes 目錄，並作為 Git 子模組 添加到項目。

git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke

向網站的配置檔案追加一行，指定當前主題。

echo "theme = 'ananke'" >> hugo.toml

啟動 Hugo 的開發伺服器來查看網站。

hugo server

按下 Ctrl + C 停止 Hugo 的開發伺服器。

添加內容

添加一個新頁面到您的網站。

hugo new content content/posts/my-first-post.md

Hugo 會在 content/posts 目錄創建該文件，打開文件進行編輯。

+++
title = 'My First Post'
date = 2024-01-14T07:07:07+01:00
draft = true
+++

注意，Front Matter 中的 draft 值為 true。默認情況下，Hugo 在構建網站時不會發佈草稿內容。了解更多 草稿、未來和過期內容。

向文章正文添加一些 Markdown，但不要更改 draft 值。

+++
title = 'My First Post'
date = 2024-01-14T07:07:07+01:00
draft = true
+++
## 簡介

這是 **加粗** 文本，這是 *斜體* 文本。

訪問 [Hugo](https://gohugo.io) 官網！

保存文件，然後啟動 Hugo 開發伺服器以查看網站。運行以下命令之一以包含草稿內容。

hugo server --buildDrafts
hugo server -D

在終端顯示的 URL 查看您的網站。繼續添加和更改內容時保持開發伺服器運行。

當對新內容感到滿意後，將 Front Matter 的 draft 參數設為 false。

配置網站

用編輯器打開根目錄中的網站配置文件（hugo.toml）。

baseURL = 'https://example.org/'
languageCode = 'en-us'
title = 'My New Hugo Site'
theme = 'ananke'

進行以下更改：

  1. 設置您生產網站的 baseURL。該值必須以協議開頭並以斜線結尾，如上所示。
  2. 設置 languageCode 為您的語言和區域。
  3. 為生產網站設置 title。

啟動 Hugo 開發伺服器以查看更改，並包括草稿內容。

hugo server -D

發佈網站

當您_發佈_您的網站時，Hugo 會在項目根目錄中的 public 目錄生成整個靜態網站。這包括 HTML 文件及圖片、CSS 文件和 JavaScript 文件等資源。

通常在發佈網站時，您並不希望包含 草稿、未來或過期內容。運行以下簡單命令：

hugo

要學習如何_部署_您的網站，請參閱託管與部署部分。

求助

Hugo 的論壇是活躍的用戶和開發者社區，在那裡大家回答問題、分享知識和提供示例。搜索 20,000 多個主題，通常可以找到您的答案。在發佈第一個問題之前，請確保閱讀求助指南。

其他資源

有關學習 Hugo 的其他資源（包括書籍和視頻教程），請參閱 外部學習資源 頁面。

簡介 Hugo Pipes