consts.ts 配置参考

全站可复用配置集中在 src/consts.ts。页面内容、文章 frontmatter 和纯视觉样式不放在这里：文章内容由 src/content/ 管理，颜色、字号与间距由 src/styles/global.css 管理。

站点基础信息

SITE_TITLE

站点名称，用于 Header、首页标题、浏览器标题和 RSS。

export const SITE_TITLE = "LogFlow Theme";

SITE_DESCRIPTION

站点级默认描述，用于首页和 RSS。各静态页面的独立概述由 PAGE_COPY 管理。

export const SITE_DESCRIPTION = "A compact Astro theme for writing and publishing.";

SITE_URL

生产环境的完整站点地址，用于 Astro 的 site 配置、canonical URL、sitemap、RSS 和友链交换信息。不要添加末尾斜杠。

export const SITE_URL = "https://example.com";

COPYRIGHT_NAME

页脚版权名称，可以填写个人名、组织名或品牌名。

export const COPYRIGHT_NAME = "Your Name";

页面标题与概述

PAGE_COPY 统一维护静态页面的标题和概述。每项文案同时提供给页面标题区域与 SEO description，避免在页面组件内重复填写。

export const PAGE_COPY = {
  blog: {
    title: "文章",
    description: "按时间浏览全部文章。",
    descriptionItalic: false,
  },
  collections: {
    title: "专题",
    description: "按系列阅读相关文章。",
    descriptionItalic: false,
  },
  tags: {
    title: "标签",
    description: "按主题浏览全部文章。",
    descriptionItalic: false,
  },
  years: {
    title: "文章归档",
    description: "按发布时间浏览全部文章。",
    descriptionItalic: false,
  },
  friends: {
    title: "友链",
    description: "收藏一些值得长期拜访的个人站点。",
    descriptionItalic: false,
  },
  about: {
    title: "关于",
    description: "关于作者、本站和内容授权。",
    descriptionItalic: false,
  },
} as const;

标签详情页的概述会根据标签名动态生成；专题详情页优先读取文章 frontmatter 中的 collectionDescription，缺失时回退到专题页概述。

每个页面的 descriptionItalic 都控制对应页面概述是否使用斜体，默认建议设为 false。

NAV_LINKS 控制 Header 的桌面端和移动端导航。href 使用站内绝对路径，构建时会自动处理 Astro 的 base 路径。

export const NAV_LINKS = [
  { href: "/", label: "首页" },
  { href: "/blog", label: "文章" },
  { href: "/friends", label: "友链" },
  { href: "/about", label: "关于" },
] as const;

页脚社交链接

SOCIAL_LINKS 控制页脚图标链接。

export const SOCIAL_LINKS = [
  {
    label: "GitHub",
    href: "https://github.com/your-name",
    icon: "social/github",
  },
] as const;

字段含义：

label：无障碍名称。
href：外部主页地址。
icon：SocialIcon.astro 内置图标键名，当前支持 social/github、social/twitter 和 social/bilibili。

首页

HOME 只管理首页个人信息和内容数量，不管理字号或布局。

export const HOME = {
  avatar: {
    src: "https://github.com/identicons/logflow-theme.png?size=256",
    alt: "LogFlow Theme avatar",
  },
  motto: "Build in public.",
  description: "一个窄版、紧凑的 Astro 博客主题。",
  recentPostsLimit: 6,
} as const;

avatar.src：头像地址。
avatar.alt：头像替代文本。
motto：首页显示的个人格言，同时用于生成本站友链信息中的 Desc。
description：首页直接展示的个人简介，不从 About 正文自动提取。
recentPostsLimit：首页最近文章数量。

GitHub 活跃度

GH_CONTRIBUTE 控制首页 GitHub 贡献区块。

export const GH_CONTRIBUTE = {
  title: "GitHub 活跃度",
  description: "最近一年的开源贡献记录",
  username: "withastro",
  profileUrl: "https://github.com/withastro",
  errorMessage: "GitHub 贡献图暂时不可用。",
} as const;

title、description：区块标题和说明。
username：贡献图对应的 GitHub 用户名。
profileUrl：点击区块后前往的 GitHub 主页。
errorMessage：贡献图加载失败时显示的提示。

友链

FRIEND_LINKS 从 src/config/friend-links.ts 导出，友链较多时无需继续增大主配置文件。

export const FRIEND_LINKS = [
  {
    name: "Example Blog",
    link: "https://example.com",
    avatar: "https://example.com/avatar.png",
    desc: "一句话介绍这个站点。",
  },
];

name：站点名称，必填。
link：站点地址；旧数据中的 url 仍兼容。
avatar：头像地址，可选；缺失时显示站点名称首字。
desc：一句话简介；旧数据中的 description 仍兼容。

COMMENTS 管理 giscus 的开关、仓库、Discussion 分类、映射方式、主题与语言。

export const COMMENTS = {
  enabled: true,
  provider: "giscus",
  repo: "owner/repository",
  repoId: "R_...",
  category: "Announcements",
  categoryId: "DIC_...",
  mapping: "pathname",
  themeLight: "light_protanopia",
  themeDark: "transparent_dark",
  lang: "zh-CN",
} as const;

enabled：评论总开关。
provider：当前保持为 giscus。
repo、repoId：已启用 Discussions 的公开仓库及其 ID。
category、categoryId：用于评论的 Discussion 分类及其 ID。
mapping：页面与讨论串的映射方式，常用值为 pathname、title、url 或 og:title。
themeLight、themeDark：跟随站点明暗模式切换的 giscus 主题。
lang：giscus 界面语言。

仓库和分类 ID 可通过 giscus 配置页获取。