PrimeEdge 主题教程

配置指南

PrimeEdge 主题配置详解

配置指南

PrimeEdge 提供了丰富的配置选项，让你可以轻松地定制自己的博客。

配置文件

当前博客项目使用根目录下的 config.toml 作为 Hugo 配置文件；新建站点时也可以使用 Hugo 默认支持的 hugo.toml。主题相关配置主要放在 [params] 节下。

配置结构

[params]
  # 作者信息
  [params.author]
    # ...
  
  # 站点头部
  [params.header]
    # ...
  
  # 首页风格
  [params.homepage]
    style = "personal"  # personal / minimal / tech / studio
    [params.homepage.minimal]
      # 简洁笔记风格子选项...
  
  # 导航菜单
  [[params.nav]]
    # ...
  
  # 社交链接
  [[params.social]]
    # ...
  
  # 首页横幅
  [params.banner]
    # ...
  
  # 评论系统
  [params.comments]
    # ...
  
  # 页脚
  [params.footer]
    # ...

配置章节

示例配置

以下是一个完整的配置示例：

baseURL = 'https://kok.plus'
languageCode = 'zh-CN'
defaultContentLanguage = 'zh'
title = 'KOK.PLUS'
theme = 'PrimeEdge'

[outputs]
  home = ["HTML", "RSS", "Search", "FullRSS", "Feed"]
  page = ["HTML"]
  section = ["HTML", "RSS"]

[outputFormats]
  [outputFormats.Search]
    mediaType = "application/json"
    baseName = "search"
    isPlainText = true

  [outputFormats.FullRSS]
    mediaType = "application/rss+xml"
    baseName = "rss"
    isPlainText = true
    noUgly = true

  [outputFormats.Feed]
    mediaType = "application/rss+xml"
    baseName = "feed"
    isPlainText = true
    noUgly = true

[params]
  [params.author]
    name = "KOK"
    bio = "Say what's on my mind, read books I enjoy"
    avatar = "/images/tx.jpeg"
  
  [params.header]
    logo = ""
    title = "KOK.PLUS"
  
  [[params.nav]]
    name = "首页"
    url = "/"
    icon = "fa-solid fa-house"
  
  [[params.nav]]
    name = "文档"
    url = "/docs/"
    icon = "fa-solid fa-book"
  
  [[params.nav]]
    name = "笔记"
    url = "/notes/"
    icon = "fa-solid fa-note-sticky"
  
  [[params.nav]]
    name = "博客"
    url = "/posts/"
    icon = "fa-solid fa-pen-nib"
  
  [[params.nav]]
    name = "好物"
    url = "/good-things/"
    icon = "fa-solid fa-heart"
  
  [[params.nav]]
    name = "相册"
    url = "/photos/"
    icon = "fa-solid fa-images"
  
  [[params.nav]]
    name = "书签"
    url = "/bookmarks/"
    icon = "fa-solid fa-bookmark"
  
  [[params.nav]]
    name = "友链"
    url = "/links/"
    icon = "fa-solid fa-link"
  
  [[params.nav]]
    name = "关于"
    url = "/about/"
    icon = "fa-solid fa-user"
  
  [[params.social]]
    name = "GitHub"
    url = "https://github.com/kok777"
    icon = "fa-brands fa-github"
  
  [[params.social]]
    name = "Twitter"
    url = "https://twitter.com/kok777"
    icon = "fa-brands fa-twitter"
  
  [params.banner]
    title = "KOK.PLUS"
    light = "/images/wallhaven-wqery6-light.webp"
    dark = "/images/wallhaven-wqery6-dark.webp"
    subtitle = [
      "Say what's on my mind, read books I enjoy",
      "Discuss what's around me, walk my own path",
      "An independent blog since 2007"
    ]
  
  [params.comments]
    provider = "waline"

  [params.waline]
    enable = true
    serverURL = "https://wl.example.com"
    geetestCaptchaId = ""

  [params.twikoo]
    enable = false
    envId = ""
    version = "1.7.3"
  
  [params.footer]
    startYear = "2007"
    icp = "京ICP备XXXXXXXX号"
    gongan = "京公网安备XXXXXXXX号"

继续阅读各章节了解详细配置方法。

评论

0%