主题 Press 配置

主题配置参考 ​

下表列出 Press 自身的 themeConfig 选项。站点级配置，例如 title、url、search、lastUpdated，仍然放在 siteConfig 下。

首页 ​

使用 layout: home，并在 frontmatter 中配置 hero 与 features。

---
layout: home

title: Acme Docs

hero:
  name: Acme
  text: 使用 Acme 更快构建
  tagline: 安装、配置与扩展 Acme 所需的一切。
  image:
    src: /logo.png
    alt: Acme Logo
  actions:
    - theme: brand
      text: 快速开始
      link: /guide/getting-started
      type: fly
    - theme: alt
      text: 查看 GitHub
      link: https://github.com/acme/project

features:
  - icon: i-logos:vitejs
    title: 快速
    details: 基于 Vite 与 Valaxy。
  - icon: i-logos:vue
    title: 可扩展
    details: 可以直接在 Markdown 中使用 Vue 组件。
---

hero.image 与 VitePress 的 ThemeableImage 格式一致，支持字符串、{ src, alt } 对象，以及 { light, dark, alt } 对象。Press 不再注入默认的 Valaxy Logo；未配置 hero.image 时，首页不会显示主视觉图片。根绝对图片路径会自动适配 Vite 的 base。

fly 类型按钮的悬停图标读取 siteConfig.favicon，不再使用主题内硬编码资源。

当 i18nRouting 启用时，首页按钮中的内部链接会自动补齐当前语言前缀。

首页布局与轨道动效 ​

首页默认采用分栏布局：左侧展示标题和入口，右侧展示 hero.image。未设置图片时自动使用居中布局，也可以通过 hero.layout: center 显式选择居中布局。

可选的 orbit 主视觉以 Valaxy 的「V + Galaxy」为灵感，让轨道与光点环绕你的 Logo。它始终使用 hero.image，不会替换成主题内置图标。

hero:
  name: VALAXY
  text: 下一代静态博客框架
  tagline: 简洁、强大、高性能。
  layout: split
  visual: orbit
  animation: true
  image:
    src: /valaxy-logo.png
    alt: Valaxy Logo
  imageCaption: V + Galaxy
  command: pnpm create valaxy
  actions:
    - theme: brand
      text: 快速上手
      link: /guide/getting-started

featuresTitle: 从一个想法，到你的宇宙。
featuresDescription: 专注写作，自由定制。其余的，交给 Valaxy。

轨道动效使用 CSS，不依赖视频或 WebGL。它支持手动暂停，离开视口时暂停，并遵循系统的「减少动态效果」偏好。浅色与深色图片仍可通过 { light, dark, alt } 配置。

已有 hero、features 配置无需迁移。PressHome 保留 home-hero-before、home-hero-after、home-features-before、home-features-after 和默认插槽；也可以通过同名组件覆盖 PressHomeOrbit.vue 或 PressHomeCommand.vue。

主题样式可使用 --pr-home-max-width、--pr-font-display、--pr-c-accent、--pr-c-orbit-glow 和 --pr-c-orbit-line 定制。主色继续读取 themeConfig.colors.primary。

页脚与编辑链接 ​

编辑链接会显示在文章页底部。pattern 中的 :path 会被替换为当前页面的相对路径。

export default defineValaxyConfig<PressTheme.Config>({
  siteConfig: {
    lastUpdated: true,
  },
  themeConfig: {
    editLink: {
      pattern: 'https://github.com/acme/project/edit/main/docs/:path',
      text: '编辑此页',
    },
    footer: {
      message: 'Released under the MIT License.',
      copyright: 'Copyright (c) 2026 Acme.',
    },
  },
})

如果某个页面不希望显示上一页/下一页导航，可以在页面 frontmatter 中设置 nav: false。

页面布局 ​

Press 提供以下常见布局：

归档页示例：

---
title: Posts
layout: posts
---

---
title: Tags
layout: tags
---

样式 ​

通过 themeConfig.colors.primary 设置主题色：

export default defineValaxyConfig<PressTheme.Config>({
  themeConfig: {
    colors: {
      primary: '#0078E7',
    },
  },
})

也可以在自己的样式文件中覆盖 Press CSS 变量：

:root {
  --pr-nav-height-mobile: 56px;
  --pr-nav-text: var(--va-c-text-1);
}

组件自定义 ​

和其他 Valaxy 主题一样，你可以在站点中创建同名组件来覆盖 Press 的默认组件。常见扩展点包括：

更底层的主题开发细节可参考 编写主题。