consts.ts 配置总览：全部参数与可选值说明

这篇文章集中说明 src/consts.ts 中所有可配置项，适合在模板初始化时逐项对照修改。

SITE_TITLE

  • 默认值：LogFlow Theme
  • 用途：站点主标题，显示在导航与页面标题相关区域。
  • 建议：改成你的品牌名或站点名，避免使用过长文本。

SITE_DESCRIPTION

  • 默认值：A clean Astro theme for blogging and content publishing.
  • 用途：全局描述，影响首页文案与 SEO 描述字段。
  • 建议：控制在 120~160 字符以内。
  • 默认值：LogFlow Theme
  • 用途：页脚版权名称。
  • 建议：可填写个人名、组织名或品牌名。
  • 用途：控制顶部与底部的社交图标链接。
  • 数据结构：
{
	label: string;
	href: string;
	icon: string;
}
  • icon 可选值：
    • social/github
    • social/twitter
    • social/bilibili
  • 用途：Friends 页面友链卡片数据源。
  • 数据结构：
{
	name: string;
	url: string;
	avatar: string;
	description: string;
}
  • 建议：
    • avatar 使用站点 favicon 或清晰头像地址。
    • description 用一句话说明站点定位。

GH_CONTRIBUTE

  • 用途：首页 GitHub 贡献图区块配置。
  • 字段说明：
    • title：区块标题
    • description：区块描述
    • username：GitHub 用户名
    • profileUrl：GitHub 主页链接
    • errorMessage：加载失败时提示文案

HOME_PROFILE

  • 用途：控制首页头像区、昵称区、标语区和部分布局参数。
  • 字段说明：
    • avatarSrc：头像地址
    • avatarAlt：头像替代文本
    • nickname：昵称
    • nicknameFontSize：昵称字号（如 2rem）
    • tagline：标语文案
    • taglineFontSize：标语字号（如 1em）
    • taglineItalic：是否斜体（true/false）
    • homePostsColumnRatio：首页左右列比例（如 1fr、0.9fr）
    • homeTagsMinWidth：标签区域最小宽度（如 300px）
    • aboutExcerptLength：About 摘要截断长度
    • recentPostsLimit：首页最新文章数量

BLOG_PAGE

  • 用途：Blog 页面文案配置。
  • 字段说明：
    • title：文章列表标题
    • collectionsTitle：合集区标题
    • tagsTitle：标签区标题

COMMENTS

  • 用途：评论系统总配置，当前支持 Giscus。

  • 字段说明：

    • enabled：评论开关，false 时不加载评论
    • provider：评论提供方，保持 giscus
    • repo：仓库名，格式 owner/repo
    • repoId：仓库 ID
    • category：Discussion 分类名
    • categoryId：分类 ID
    • mapping：文章与讨论串映射方式
    • themeLight：浅色主题
    • themeDark：深色主题
    • lang：评论语言

  • mapping 常见可选值：

    • pathname
    • title
    • url
    • og:title

推荐修改顺序

  1. 先改 SITE_TITLE、SITE_DESCRIPTION、COPYRIGHT_NAME
  2. 再改 SOCIAL_LINKS、HOME_PROFILE
  3. 需要评论时再改 COMMENTS
  4. 最后补充 FRIEND_LINKS 与 GH_CONTRIBUTE

Comments