安装 Hugo

2025-05-31

准备服务器

系统版本：Rocky Linux9.5mini 2C4G-40G硬盘

sed -i 's/^SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config && sudo setenforce 0
systemctl disable --now firewalld
dnf install -y wget tar zip unzip chrony nodejs npm
# 时间同步
bash -c 'echo "server ntp.ntsc.ac.cn iburst" >> /etc/chrony.conf'
systemctl restart chronyd
chronyc sources -v
chronyc tracking

安装Go

dnf install golang -y
# 配置go国内代理
echo "export GOPROXY=https://goproxy.cn,direct" >> ~/.bashrc
source ~/.bashrc  # 立即生效

Hugo版本类型区别

版本类型	功能特点	适用场景
*`hugo_\.tar.gz`（标准版）**	仅支持基本功能（Markdown → HTML），不支持 SCSS/SASS 编译	纯静态站点，无需 CSS 预处理
*`hugo_extended_\.tar.gz`（扩展版）**	包含 LibSASS/Dart Sass，支持 SCSS/SASS 编译	使用 SCSS/SASS 的主题（如 `reimu` 主题）
*`hugo_extended_withdeploy_\.tar.gz`**	扩展版 + 内置部署工具（如 Hugo Deploy）

下载Hugo

wget https://github.com/gohugoio/hugo/archive/refs/tags/v0.147.6.tar.gz
tar -zxvf v0.147.6.tar.gz
cd hugo-0.147.6
go install

# 验证安装
~/go/bin/hugo version

# 将 Hugo 加入系统 PATH
echo 'export PATH=$PATH:$HOME/go/bin' >> ~/.bashrc
source ~/.bashrc
hugo version

创建新站点

hugo new site mysite
cd mysite
# 会生成如下目录结构：
mysite/                  # 项目根目录
├── archetypes/          # 内容模板（Front Matter预设）
├── assets/              # 需要Hugo管道处理的静态资源（SCSS/JS等）
├── content/             # 网站内容（Markdown文件）
├── data/                # 自定义数据文件（YAML/JSON/TOML）
├── hugo.toml           # 主配置文件（旧版可能是config.toml）
├── i18n/                # 国际化翻译文件
├── layouts/             # 自定义模板（覆盖主题默认布局）
├── static/              # 静态文件（直接复制到输出目录）
└── themes/              # 存放主题的目录

添加主题

更多主题可以浏览 Hugo 官方主题站：https://themes.gohugo.io/

cd mysite

# 添加示例主题，主题贡献者给出的便捷安装命令
npm create thulite@latest -- --template doks

cd thulite-project
# 安装项目依赖
npm install
# 启动开发服务器
npm run dev

# 编辑 hugo.toml，添加主题配置
echo 'theme = "LoveIt-0.3.0"' >> hugo.toml

添加基础配置

编辑hugo.toml

[root@192 mysite]# pwd
/root/hugo-0.147.6/mysite

[root@192 mysite]# cat hugo.toml 
baseURL = "http://192.168.226.158:1313/"
languageCode = "en-us"
title = "My Hugo Site"
theme = "LoveIt-0.3.0"

创建示例内容

生成一篇测试文章：

hugo new posts/welcome.md

编辑 content/posts/welcome.md：

[root@192 mysite]# cat content/posts/welcome.md
+++
date = '2025-05-30T00:45:13+08:00'
draft = false
title = 'Welcome'
+++
## 这是一篇测试文章

欢迎来到我的 Hugo 网站！这里是一些测试内容：

- Hugo 是一个快速的静态网站生成器
- PaperMod 是一个简洁美观的主题
- 这里使用了 Markdown 格式

### 代码示例
```go
package main

import "fmt"

func main() {
    fmt.Println("Hello, Hugo!")
}
```

启动本地服务器

hugo server -D --bind=0.0.0.0 --disableFastRender --baseURL=http://192.168.226.158

浏览器访问站点：http://192.168.226.158

浏览器访问文章内容：http://192.168.226.158:1313/posts/welcome/

发现新版本