mirror of
https://github.com/XiaoDaiGua-Ray/ray-template.git
synced 2026-11-17 16:13:36 +08:00
Share workspace packages between Ray Admin and the interactive docs. BREAKING CHANGE: v6 is a new major line. v5 stays on legacy/v5.
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 包的公开入口。外壳预览使用文档自己的内存路由和示例菜单。预览生产构建,检查导航、搜索、主题、窄屏、旧路径和受影响示例。