Skip to content

v0.2.0 - 阅读体验与 UI 优化版

Choose a tag to compare

View all tags
@Azek431 Azek431 released this 10 May 13:16
· 133 commits to main since this release
v0.2.0
68e2dc8

这是 cysj-data 的第二个正式发布版本。

本版本重点优化了创游世界资料库文档站的阅读体验，将原本较大的文档档案卡、站点工具卡和底部参与维护卡片，调整为更简洁、更克制、更适合长期阅读的文档站 UI。整体方向从“展示型大卡片”转向“正文优先、信息辅助、操作轻量”的专业知识库风格。

本次重点

  • 优化文档顶部元信息展示方式。
  • 将原来的大块“文档档案 / Knowledge Profile”改为一行式文档信息栏。
  • 新增写作日期、字数、阅读时间、最后更新、维护者等更直观的信息展示。
  • 移除右侧大块站点工具卡，减少对正文阅读的干扰。
  • 将底部“参与维护”区域改为轻量操作栏。
  • 保留编辑此页、反馈建议、复制链接、GitHub 入口等维护操作。
  • 继续优化 VitePress 主题结构与 UI 覆盖层。
  • 增加并更新文档 UI 检查脚本，方便后续快速检测主题文件是否完整。

UI 优化

文档顶部

原来的文档档案卡视觉较重，占用空间较大。
本版本将其改为更简洁的一行式元信息栏：

  • 写作日期
  • 文档字数
  • 阅读时间
  • 最后更新
  • 维护者

这样可以让用户快速了解文档状态，同时不会影响正文阅读。

右侧区域

移除了右侧“站点工具”卡片，避免遮挡视野或干扰目录阅读。
后续如果恢复工具入口，会优先采用更轻量的方式，例如顶部链接、底部入口或独立导航页。

底部参与维护

底部维护区域从大卡片调整为轻量操作栏，保留：

  • 编辑此页
  • 反馈建议
  • 复制链接
  • GitHub 仓库入口

这样既保留了协作入口，又不会破坏页面整体阅读节奏。

工程优化

  • 新增或更新 minimal-doc-ui.css，用于覆盖旧版较重的 UI 样式。
  • 更新 PageInfo.vue，实现轻量文档元信息展示。
  • 更新 PageActions.vue，实现简洁的底部维护操作栏。
  • 更新 Layout.vue，移除右侧站点工具插槽。
  • 更新 check-docs-ui.mjs，检查关键主题文件、UI 样式文件和静态资源文件是否存在。
  • 保持 docs/.vitepress/dist、.temp、cache 等构建产物不进入 Git 跟踪。

当前部署信息

  • 文档框架：VitePress
  • 托管平台：Cloudflare Pages
  • 源码仓库：GitHub
  • 生产分支：main
  • 构建命令：pnpm run docs:build
  • 构建输出目录：docs/.vitepress/dist
  • 当前线上站点：https://cysjdocs.dpdns.org/

本地验证

本版本在本地通过以下流程验证：

pnpm run docs:ui:check
pnpm run docs:build
pnpm run docs:preview
Assets 2
Loading