入门指南

PrimeEdge 快速开始

5 分钟搭建你的 PrimeEdge 博客

PrimeEdge 快速开始

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

环境要求

在开始之前，请确保你的系统已安装：

  • Hugo Extended 0.124.0 或更高版本
  • Git

安装 Hugo

macOS:

brew install hugo

Windows:

winget install Hugo.Hugo.Extended

Linux:

sudo apt install hugo

验证安装：

hugo version

创建新站点

1. 创建 Hugo 站点

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

2. 添加 PrimeEdge 主题

方法 1：使用 Git Submodule（推荐）

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

方法 2：直接克隆

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

目录结构

my-blog/
├── archetypes/          # 内容模板
├── assets/              # 资源文件
├── content/             # 网站内容
│   ├── posts/          # 文章
│   ├── about.md        # 关于页面
│   └── _index.md       # 首页
├── data/                # 数据文件
├── layouts/             # 布局模板（覆盖主题）
├── static/              # 静态文件
│   └── images/         # 图片
├── themes/              # 主题
│   └── PrimeEdge/      # PrimeEdge 主题
└── hugo.toml           # 站点配置

下一步

  • 了解更多配置选项
  • 学习如何写文章
  • 将博客部署到线上

常见问题

Q: Hugo 命令找不到？ A: 确保 Hugo 已正确安装并添加到系统 PATH。

Q: 主题样式没有生效？ A: 确保使用的是 Hugo Extended 版本，它支持 SCSS/SASS。

Q: 如何更新主题？ A: 如果使用 submodule，运行 git submodule update --remote。

Comments

0%