跳转到内容

配置

Read.Wiki 的全部站点配置集中在 astro.config.mjs。

版本与 base 路径

const VERSION = process.env.VERSION || 'main';
const base = VERSION === 'main' ? '/' : `/${VERSION}/`;

export default defineConfig({
  site: 'https://read.wiki',
  base,
  output: 'server',
  adapter: node({ mode: 'standalone' }),
  // ...
});

构建命令：

# 主版本
pnpm build
# 旧版本
VERSION=v2.0 pnpm build

把构建产物放到同域不同路径下（/、/v2.0/、/v1.0/）即可。

双语 locale

starlight({
  defaultLocale: 'zh',
  locales: {
    zh: { label: '简体中文', lang: 'zh-CN' },
    en: { label: 'English' },
  },
});

文档源放在 src/content/docs/{zh,en}/...，目录结构两侧应保持平行，否则语言切换会落空。

自定义组件

components: {
  Banner: './src/components/Banner.astro',
  Header: './src/components/Header.astro',
  Search: './src/components/Search.astro',
  Head: './src/components/Head.astro',
},
customCss: ['./src/styles/custom.css'],

Head.astro 委托给 Starlight 默认 Head，再追加 JSON-LD、AI 发现链接、robots。
Header.astro 增加版本下拉与搜索快捷键提示。
custom.css 覆写 --sl-color-accent-* 为本站的茶绿主题。

环境变量

变量	用途	默认
`VERSION`	构建版本 → `base` 路径	`main`
`BUILD_TIME`	`/llms-full.txt` 的 “Generated” 时间戳	模块加载时间
`SOURCE_DATE_EPOCH`	同上，秒级 Unix 时间，方便 reproducible builds	—

下一步