研究报告能生成网页,只是交付的起点。读者还要找到目录、进入代码块、打开源笔记,再回到正文。Quarto 在 10 月 14 日发布的 v1.11.6 预览版里,继续把这些阅读路径补齐:截至该版本的 1.11 更新记录,集中列出了无障碍操作和笔记预览的多项修正。
先分清版本状态和更新范围
GitHub 发布页将 v1.11.6 标为 Pre-release。页面所附的 changelog 汇总整个 1.11 分支截至这一版本的变化,因此下文关注的是这份累积清单。已经有稳定报告在使用的项目,可以另开副本体验新版本,把正式交付所用的版本号保留在项目记录里。
键盘用户能沿着页面继续走
截至 v1.11.6 的 1.11 更新记录显示:未使用 Bootstrap 的标签组中,焦点位于标签上时,方向键切换标签,Tab 键进入当前标签的内容。代码和侧栏控件也补齐了焦点提示,键盘用户能看清当前停在哪个控件。
对做课程或研究网站的人,可以沿一次真实阅读任务检查这些控件:从首页找到某篇报告,用键盘进入代码示例,随后回到章节目录。检查对象是能否完成这段路径,而不是页面上有多少可点击的图标。
从文章进入源笔记,再回到文章
Quarto 可以把计算笔记嵌进文章。1.11 的更新记录修复了几种会打断这条链路的情况:再次渲染后笔记预览丢失、笔记页头被网站导航遮住,以及从项目目录之外渲染时漏掉笔记源文件与预览。
这类变化对可复用的研究输出很具体:正文负责说明结果,源笔记承接计算过程。两者都在生成目录里、链接也能来回走,读者才便于进一步查找代码和上下文。准备升级时,可以把“文章→源笔记→返回文章”作为一条固定检查路径。
按自己的输出形式挑重点
如果交付的是演示文稿,更新记录还涉及 Revealjs 的键盘焦点与关闭菜单的读屏行为;如果主要做 HTML 研究网站,则先看目录、正文、代码块和笔记预览。Quarto 支持多种输出形式,版本变动也应落回自己实际使用的那一种。
一次小范围试用可以保留同一份源文件和数据,分别记录旧版与预览版的渲染命令及输出目录。这样遇到变化时,能定位到具体页面和操作,再决定项目何时升级。