K3vyn's Blog

输入关键词搜索文章

↑↓选择

Enter打开

Esc关闭

consts.ts 配置参考

按站点、页面、导航、首页、友链与评论分组说明全局配置。

3 分钟

全站可复用配置集中在 src/consts.ts。页面内容、文章 frontmatter 和纯视觉样式不放在这里：文章内容由 src/content/ 管理，颜色、字号与间距由 src/styles/global.css 管理。搜索索引由构建时从文章集合生成，SEARCH 只控制搜索入口和结果数量。

站点基础信息

SITE_TITLE

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

export const SITE_TITLE = "K3vyn's Blog";

SITE_DESCRIPTION

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

export const SITE_DESCRIPTION = "Welcome to my Blog!";

SITE_URL

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

export const SITE_URL = "https://kevynf.github.io";

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

export const COPYRIGHT_NAME = "K3vyn";

页面标题与概述

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: "正在播放《泛用型自动化解决方案0.3.2.9f2》",
    descriptionItalic: true,
  },
  about: {
    title: "关于",
    description: "关于作者、本站和内容授权。",
    descriptionItalic: false,
  },
} as const;

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

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

Header 导航

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/kevynf",
    icon: "social/github",
  },
] as const;

字段含义：

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

首页

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

export const HOME = {
  avatar: {
    src: "/avatar.svg",
    alt: "Kevynf Avatar",
  },
  motto: "Facciamo una pausa?",
  description: "Cominciamo.",
  recentPostsLimit: 6,
  commentsTitle: "近况",
} as const;
  • avatar.src：头像地址。
  • avatar.alt：头像替代文本。
  • motto：首页显示的个人格言，同时用于生成本站友链信息中的 Desc。
  • description：首页直接展示的个人简介，不从 About 正文自动提取。
  • recentPostsLimit：首页最近文章数量。
  • commentsTitle：首页底部评论区的标题，该评论区用于发布近况。

GitHub 活跃度

GH_CONTRIBUTE 控制首页 GitHub 贡献区块。

export const GH_CONTRIBUTE = {
  title: "GitHub 活跃度",
  description: "近期的贡献记录",
  username: "kevynf",
  profileUrl: "https://github.com/kevynf",
  errorMessage: "GitHub 贡献图暂时不可用。",
} as const;
  • title、description：区块标题和说明。
  • username：贡献图对应的 GitHub 用户名。
  • profileUrl：点击区块后前往的 GitHub 主页。
  • errorMessage：贡献图加载失败时显示的提示。

构建阶段通过 GITHUB_TOKEN 或 GH_TOKEN 访问 GitHub GraphQL API。令牌缺失或请求失败时只显示 errorMessage，不会使其他页面停止生成；部署工作流应在构建步骤注入令牌。

搜索

SEARCH 控制页头是否显示文章搜索入口，以及搜索结果的最大数量。索引由 src/pages/search-index.json.ts 在构建时生成，搜索内容包括文章标题、描述和标签。

export const SEARCH = {
  enabled: true,
  maxResults: 8,
} as const;
  • enabled：设为 false 时不渲染页头搜索按钮。
  • maxResults：单次最多显示的匹配文章数。

友链

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

export const FRIEND_LINKS = [
  {
    name: "K3vyn",
    link: "https://kevynf.github.io",
    avatar: "/avatar.svg",
    desc: "Facciamo una pausa?",
  },
];
  • name：站点名称，必填。
  • link：站点地址；旧数据中的 url 仍兼容。展示页会在新字段为空时回退到 url。
  • avatar：头像地址，可选；缺失时显示站点名称首字。
  • desc：一句话简介；旧数据中的 description 仍兼容。首页交换信息中的本站简介来自 HOME.motto。

评论

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

export const COMMENTS = {
  enabled: true,
  provider: "giscus",
  repo: "owner/repository",
  repoId: "R_...",
  category: "Announcements",
  categoryId: "DIC_...",
  mapping: "pathname",
  themeLight: "/giscus/light.css",
  themeDark: "/giscus/dark.css",
  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 主题。可填官方主题名，或以 / 开头的站内 CSS 路径；默认指向 public/giscus/ 下与站点配色一致的自定义主题。
  • lang：giscus 界面语言。

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

推荐修改顺序

  1. 修改 SITE_TITLE、SITE_DESCRIPTION、SITE_URL 和 COPYRIGHT_NAME。
  2. 修改 PAGE_COPY、NAV_LINKS 和 HOME，确定站点文案。
  3. 修改 SOCIAL_LINKS、GH_CONTRIBUTE 与 FRIEND_LINKS。
  4. 在仓库启用 Discussions 后配置 COMMENTS。
  5. 运行 pnpm check 和 pnpm build 验证配置。

评论