XiaoDaiGua-Ray 403fdd589a feat!: rebuild Ray Template as a monorepo
Share workspace packages between Ray Admin and the interactive docs.

BREAKING CHANGE: v6 is a new major line. v5 stays on legacy/v5.
2026-11-04 14:01:28 +08:00
..

Ray Template 文档

旧站 · 模板源码 · 在线演示

从同级文档仓库的本地提交 e01751223cc91f9288484f6e7f50481b9482261d 导入站点。旧正文可在历史版本查阅。

本地开发

在 Ray Template 仓库根目录执行。Node 和 pnpm 以 .nvmrc 和根 package.json 为准。

pnpm install --frozen-lockfile
pnpm docs:dev
pnpm docs:check
pnpm docs:preview

按终端地址访问 /ray-template/docs/。pnpm docs:check 验证示例类型、站内链接和生产构建,产物位于 apps/docs/.vitepress/dist。pnpm check 包含此检查。生产部署使用根目录的 pnpm pages:build,在 dist/pages/docs 生成文档。指定 RAY_TEMPLATE_SITE_ORIGIN 后还会生成 dist/legacy-docs,作为原文档站的跳转产物。

  • guide/:上手、开发和部署任务。
  • migration.md:旧写法、新写法、兼容边界和验证方法。
  • reference/:组件、Hooks、Store、指令、工具和配置的 API 参考。
  • examples/:页内交互使用的 Vue 源文件,Markdown 直接引用同一文件展示代码。
  • .vitepress/:主题、导航和旧路径映射。迁址保留的相对路径会在生产构建生成跳转页。

应用变更影响公开 API 时,同步更新对应文档和示例。示例直接使用 workspace 包的公开入口。外壳预览使用文档自己的内存路由和示例菜单。预览生产构建,检查导航、搜索、主题、窄屏、旧路径和受影响示例。