如何在 Windows 上配置 Hugo 环境的详细步骤

以下是如何在 Windows 上配置 Hugo 环境的详细步骤，确保简单易懂。

---

步骤 1：安装 Chocolatey

如果你的电脑已经安装了 Chocolatey，可以跳到 步骤 2。否则，跟着下面的操作来安装：

1. 打开 PowerShell：

   • 按下 Win + R，输入 powershell，按回车。
   • 右键点击左上角的 PowerShell 图标，选择 以管理员身份运行。

2. 在 PowerShell 中，运行以下命令安装 Chocolatey：

   Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
   

3. 安装完成后，输入以下命令检查 Chocolatey 是否安装成功：

   choco -v
   

   如果返回版本号（如 2.2.2），说明安装成功！

---

步骤 2：使用 Chocolatey 安装 Hugo

1. 确保你正在 以管理员权限运行的 PowerShell 或 CMD。
2. 运行以下命令安装 Hugo：

   choco install hugo -y
   

3. 等待安装完成后，检查 Hugo 是否安装成功：

   hugo version
   

   如果返回 Hugo 的版本号，例如 hugo v0.117.0+extended, 说明安装成功。

---

步骤 3：配置 Hugo 环境

1. 创建一个新站点：

   • 在 CMD 或 PowerShell 中，进入你想创建 Hugo 网站的目录。例如：

     cd D:\MyProjects
     

   • 创建一个新站点：

     hugo new site my-website
     

   • Hugo 会生成 my-website 文件夹，其中包含默认的项目结构。

2. 添加主题：

   • 进入站点目录：

     cd my-website
     

   • 添加一个主题（以 Ananke 为例）：

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

   • 启用主题：
     编辑 config.toml 文件（使用记事本打开），添加以下内容：

     theme = "ananke"
     

3. 创建一篇文章：

   hugo new posts/first-post.md
   

   编辑生成的 Markdown 文件，内容可以是：

   ---
   title: "我的第一篇文章"
   date: 2024-11-16
   draft: false
   ---
   你好，Hugo！
   

4. 本地运行网站：

   hugo server
   

   打开浏览器访问 http://localhost:1313/，即可预览网站。

---

总结

• Chocolatey 安装完成后，可以用一行命令快速安装 Hugo。
• Hugo 网站配置简单，生成后用 Markdown 文件即可添加内容。