Skip to content

feat: 在 AI 赋能开发页面直接阅读教程 - #29

Merged
Qiyuanqiii merged 1 commit into
mainfrom
Qiyuanqiii/ai-inline-reading
Oct 19, 2026
Merged

Qiyuanqiii merged 1 commit into
mainfrom
Qiyuanqiii/ai-inline-reading

Conversation

@Qiyuanqiii

Copy link
Copy Markdown
Member

“AI 赋能开发”页面原先只提供“在线阅读”链接,需要再打开 PDF。现在序章和安装教程直接显示在页面中,可以就地滚动阅读,并保留各自的下载按钮和原始下载文件名。

阅读区保留 PDF 原有排版,默认从第一页按宽度显示。序章立即加载,后面的安装教程使用浏览器懒加载;阅读区高度随窗口调整。两个 PDF 文件的内容均未变更。

修改类型

  • 文档内容
  • 内容纠错
  • 工程配置
  • UI 或样式
  • 其他

修改页面

  • docs/development/ai.md:将两个阅读链接替换为直接展开的阅读区。
  • docs/.vitepress/theme/components/PdfReader.vue:页面内 PDF 阅读与下载组件,使用浏览器内置 PDF 阅读器。
  • docs/.vitepress/theme/index.ts:按需加载阅读组件。
  • .markdownlint-cli2.yaml:将阅读组件加入允许的组件列表。
  • .github/previews/ai-inline-reading.png:本地页面预览截图。

事实来源

沿用页面已有的教程与参考资料。本次只调整阅读方式。

风险确认

  • 是否涉及时间敏感信息
  • 是否包含个人信息
  • 是否涉及学校政策、办事流程、培养方案、考试、奖助或竞赛认定

已执行检查

  • pnpm check
  • pnpm build(由 pnpm check 执行)
  • Playwright 检查两个 PDF 的实际显示、目录跳转和教程下载文件名。
  • 检查 1440px 与 390px 宽度下的布局,页面没有横向溢出。
  • 核对构建后的 HTML,两个阅读区及原有下载入口均存在。

截图

安装教程在 AI 赋能开发页面直接显示

@Qiyuanqiii
Qiyuanqiii merged commit 6c09cb3 into main Oct 19, 2026
1 check passed
@Qiyuanqiii
Qiyuanqiii deleted the Qiyuanqiii/ai-inline-reading branch October 19, 2026 05:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant