Windows中使用hugo和Github Pages搭建个人博客（一）

Windows中使用hugo和Github Pages搭建个人博客（一）

1. 下载并安装hugo

方式一（建议）：包管理器安装

使用Windows中的包管理器直接进行安装，其中可选的包管理器包括Chocolatey, Scoop, Winget三种，每种包管理器具体的安装命令如下。

使用Chocolatey安装

choco install hugo-extended

如何安装Chocolatey?

1. 以管理员身份打开Powershell
2. 运行如下命令

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

3. 检查是否安装成功

choco

使用Scoop安装

scoop install hugo-extended

如何安装scoop?

1. 打开poweshell，设置执行策略

# 设置 PowerShell 执行策略
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

2. 下载安装脚本

# 下载安装脚本
irm get.scoop.sh -outfile 'install.ps1'

3. 执行安装

# 执行安装, --ScoopDir 参数指定 Scoop 安装路径
.\install.ps1 -ScoopDir 'C:\Scoop'

4. 检查是否安装成功

scoop --version

使用Winget安装

winget install Hugo.Hugo.Extended

方式二（不建议，较为麻烦）：二进制文件安装

使用预构建的二进制文件，下载地址hugo，安装步骤Windows | Hugo (gohugo.io)

查看hugo是否安装成功

在powershell终端输入如下命令

hugo version

2. 下载安装git

参考文章git安装教程

3. 使用hugo创建一个本地静态网站

创建项目目录结构

hugo new site quickstart #这里的quickstart可以根据需要进行修改，首次创建者不建议修改，先学会跑通整个流程

进入项目目录中

cd quickstart

初始化一个空的git仓库

git init

克隆Anake主题至themes目录中，将其作为一个git submoudle添加至项目中。

个人建议刚开始不要纠结于主题是否是自己喜欢的，先按照官网的教程跑通整个流程

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

打开quickstart目录下的hugo.toml文件，添加一行theme = 'ananke'，保存并推出

在本地启动hugo服务，在浏览器中输入 http://localhost:1313查看站点。（使用ctrl +c 停止）

hugo server

恭喜你，到这一步本地已经搭建成功。

4. 创建一篇博客

首先，创建一个新的page，位于目录content/posts/my-first-post.md

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

打开my-fisrt-post.md文件，修改其中的内容，保存并退出

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

This is **bold** text, and this is *emphasized* text.

Visit the [Hugo](https://gohugo.io) website!

再次启动hugo服务，并在浏览器中输入 http://localhost:1313查看站点。

注意：如果上述文字中的draft为true，启动时需要输入命令hugo server --buildDrafts或者hugo server -D

hugo server --buildDrafts
hugo server -D

恭喜你，本地搭建方式已经完成，接下来是部署至GitHub，使用域名能够访问。