入门指南

快速开始使用 HugoBlox 构建你的第一个项目

页面目录

本章将帮助你快速开始使用 HugoBlox。

前置要求

在开始之前,请确保你已经安装了以下工具:

  • Hugo Extended v0.120.0 或更高版本
  • Go v1.21.0 或更高版本
  • Node.js v18.0 或更高版本(可选,用于某些功能)
  • Git 用于版本控制

安装方式

方式一:使用模板(推荐)

使用 HugoBlox 模板是最简单的开始方式:

# 克隆模板
git clone https://github.com/HugoBlox/academic-cv my-project
cd my-project

# 安装依赖
hugo mod get

# 启动开发服务器
hugo server

方式二:手动安装

如果你想在现有项目中添加 HugoBlox:

  1. 创建 hugoblox.yaml 配置文件:
build:
  hugo_version: '0.154.2'
template:
  id: "academic-cv"
  name: "Academic CV"
  1. config/_default/module.yaml 中添加:
imports:
  - path: github.com/HugoBlox/hugo-blox-theme
  1. 运行安装命令:
hugo mod get

下一步

完成安装后,继续阅读以下章节: