快速开始

Mon, 01 Jan 0001 00:00:00 +0000

快速开始

本指南将帮助你在 5 分钟内搭建一个基于 PrimeEdge 主题的 Hugo 博客。

环境准备

安装 Hugo

PrimeEdge 需要 Hugo Extended 0.124.0 或更高版本。

macOS:

brew install hugo

Windows:

winget install Hugo.Hugo.Extended

Linux (Ubuntu/Debian):

sudo apt install hugo

验证安装:

hugo version
# 应该显示 hugo v0.124.0 或更高版本

创建博客

1. 创建新站点

hugo new site my-blog
cd my-blog
git init

2. 添加主题

方式一：Git Submodule（推荐）

git submodule add https://github.com/kok777/PrimeEdge.git themes/PrimeEdge

方式二：直接克隆

git clone https://github.com/kok777/PrimeEdge.git themes/PrimeEdge

3. 基础配置

创建 hugo.toml：

baseURL = 'https://yourdomain.com'
languageCode = 'zh-CN'
defaultContentLanguage = 'zh'
title = '我的博客'
theme = 'PrimeEdge'

[params]
  # 作者信息
  [params.author]
    name = "你的名字"
    bio = "一句话介绍自己"
    avatar = "/images/avatar.jpg"
  
  # 站点名称
  [params.header]
    site_name = "我的博客"
  
  # 导航菜单
  [[params.nav]]
    name = "首页"
    url = "/"
    icon = "fa-solid fa-house"
  
  [[params.nav]]
    name = "文章"
    url = "/posts/"
    icon = "fa-solid fa-pen-nib"
  
  [[params.nav]]
    name = "关于"
    url = "/about/"
    icon = "fa-solid fa-user"
  
  # 首页横幅
  [params.banner]
    subtitle = ["记录生活", "分享技术", "探索世界"]

4. 创建内容

# 创建关于页面
hugo new content about.md

# 创建第一篇文章
hugo new content posts/hello-world.md

5. 本地预览

hugo server -D

打开浏览器访问 http://localhost:1313

安装部署

Mon, 01 Jan 0001 00:00:00 +0000

安装部署

本章节介绍如何安装 PrimeEdge 主题，以及几种常见的部署方式。

环境要求

Hugo Extended 版本 0.120.0 或更高
Git

安装主题

方式一：作为 Git Submodule（推荐）

# 进入你的 Hugo 站点根目录
cd your-site

# 初始化 Git（如果还没初始化）
git init

# 添加主题为子模块
git submodule add https://github.com/kok777/PrimeEdge.git themes/PrimeEdge

# 更新主题
git submodule update --remote --merge

使用子模块的好处是后续可以方便地更新主题，同时保留自定义内容。

方式二：直接克隆

git clone https://github.com/kok777/PrimeEdge.git themes/PrimeEdge

这种方式简单直接，但更新主题时需要手动处理。

方式三：下载压缩包

从 GitHub Releases 页面下载主题压缩包，解压到 themes/PrimeEdge 目录。

启用主题

在 hugo.toml 中配置：

theme = 'PrimeEdge'

创建基础内容

复制主题的示例内容作为起点：

# 复制示例配置
cp themes/PrimeEdge/exampleSite/hugo.toml ./hugo.toml

# 创建基础页面
hugo new content _index.md
hugo new content about.md

本地预览

hugo server -D

访问 http://localhost:1313 预览站点。加上 -D 参数可以同时预览草稿内容。

主题介绍 on KOK博客

快速开始

快速开始

环境准备

安装 Hugo

创建博客

1. 创建新站点

2. 添加主题

3. 基础配置

4. 创建内容

5. 本地预览

安装部署

安装部署

环境要求

安装主题

方式一：作为 Git Submodule（推荐）

方式二：直接克隆

方式三：下载压缩包

启用主题

创建基础内容

本地预览