Hugo个人博客搭建指南

Hugo是一个快速、灵活的静态网站生成器，深受开发者和博客作者的喜爱。本文将详细介绍如何使用Hugo搭建个人博客，从安装到部署，一步步带您完成整个过程。

安装Hugo

Hugo支持多种操作系统，安装方式也各不相同：

Windows用户推荐使用Scoop包管理工具安装：

scoop install hugo

Mac用户如已安装HomeBrew，可直接执行：

brew install hugo

Linux用户以CentOS 7.6为例，需先安装git和go编译器：

Git安装及配置

# 安装git
yum install git

# 配置git
git config --global user.name "your_user_name"
git config --global user.email "your_mail"

# 查看配置是否生效
git config --list

# 生成本地ssh key添加到github
ssh-keygen -t rsa -C "your_mail"

# 查看公钥
cat /root/.ssh/id_rsa.pub

Go编译器安装

# 下载go
wget - https://go.dev/dl/go1.17.5.linux-amd64.tar.gz
tar -xzvf go1.17.5.linux-amd64.tar.gz
mv go /usr/bin

# 更改环境变量
export PATH=$PATH:/usr/local/go/bin
source ~/.bash_profile

# 验证安装
go version

Hugo安装（Linux）

推荐使用以下方式安装：

cd /etc/yum.repos.d
wget https://copr.fedorainfracloud.org/coprs/daftaupe/hugo/repo/epel-7/daftaupe-hugo-epel-7.repo -O hugo.repo
yum update
yum install hugo
hugo version

创建新站点

选择一个目录，创建名为MyBlog的新站点，并使用YAML格式的配置文件：

hugo new site MyBlog -f yml

添加主题

Hugo提供了丰富的主题选择，以PaperMod主题为例：

  1. 进入网站根目录，克隆主题：
git clone https://github.com/adityatelange/hugo-PaperMod themes/PaperMod --depth=1
  1. 更新主题（需要时）：
cd themes/PaperMod
git pull
  1. 修改config.yml文件配置：
baseURL = "/"
languageCode = 'en-us'
title = 'My New Hugo Site'
theme = "PaperMod"

创建文章

创建第一篇博客文章：

hugo new posts/first-blog.md

这将在content/posts目录下生成first-blog.md文件，内容如下：

---
title: "First Blog"
date: 2022-06-05T10:16:58+08:00
draft: true
---

注意：使用Markdown语法编写文章内容，完成后将draft改为false。

启动Hugo服务

在站点根目录下启动Hugo服务：

hugo server -D

启动后，可通过访问**http://localhost:1313/**预览博客。

生成静态文件

有两种方式生成静态文件：

  • hugo -D：只会向public文件夹添加内容
  • hugo -F --cleanDestinationDir：每次都会生成全新的public文件夹

通过以上步骤，您已成功搭建了一个基于Hugo的个人博客站点。接下来，您可以根据自己的需求进一步定制主题、添加更多功能，或将博客部署到GitHub Pages等平台上。