安装配置 | 技术站点

本文档提供 HugoBlox 的详细安装和配置说明。

系统要求

必需软件

软件	最低版本	推荐版本	说明
Hugo Extended	0.120.0	0.154.0+	静态站点生成器
Go	1.21.0	1.22.0+	Hugo 模块依赖
Git	2.0.0	最新版	版本控制

可选软件

Node.js v18.0+ - 用于 Tailwind CSS 等前端工具
Docker - 用于容器化部署

安装 Hugo

macOS

# 使用 Homebrew
brew install hugo

# 验证安装
hugo version

Linux

# Debian/Ubuntu
sudo apt install hugo

# Fedora
sudo dnf install hugo

# 或下载预编译二进制
wget https://github.com/gohugoio/hugo/releases/download/v0.154.0/hugo_extended_0.154.0_linux-amd64.tar.gz
tar -xzf hugo_extended_0.154.0_linux-amd64.tar.gz
sudo mv hugo /usr/local/bin/

Windows

# 使用 Chocolatey
choco install hugo-extended

# 或使用 Scoop
scoop install hugo-extended

项目配置

目录结构

一个典型的 HugoBlox 项目结构如下：

my-project/
├── config/
│   └── _default/
│       ├── hugo.yaml      # Hugo 主配置
│       ├── menus.yaml     # 导航菜单
│       ├── params.yaml    # 站点参数
│       └── module.yaml    # 模块配置
├── content/               # 内容文件
├── layouts/               # 自定义布局
├── static/                # 静态资源
├── assets/                # 需要处理的资源
└── hugoblox.yaml          # HugoBlox 配置

核心配置文件

hugo.yaml

baseURL: https://example.com/
languageCode: zh-cn
title: 我的网站
theme:
  - github.com/HugoBlox/hugo-blox-theme

params.yaml

features:
  blog:
    enable: true
  math:
    enable: true
  diagram:
    enable: true

marketing:
  seo:
    site_type: Organization

验证安装

运行以下命令验证安装：

# 启动开发服务器
hugo server -D

# 访问 http://localhost:1313

如果一切正常，你应该能看到 HugoBlox 的默认页面。

常见问题

Hugo 找不到

确保 Hugo 已添加到系统 PATH 中。运行 which hugo (Linux/macOS) 或 where hugo (Windows) 检查。

模块下载失败

# 清理缓存重新下载
hugo mod clean
hugo mod get

样式不加载

检查是否安装了 Hugo Extended 版本：

hugo version
# 输出应包含 /extended

下一步

安装完成后，继续学习基本用法。