Hacktoberfest 2026：维护者为十月标记出来的 issue，仍然开放、适合新手。 浏览 Hacktoberfest issue

revealjs removes the `href` from code line-number links

未关闭 适合新手
  • 哪里不对？
#14,961 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
84/100
Issue 类型
缺陷
描述清晰度
描述清楚
活跃度
活跃
技术栈
typescript
领域
accessibility, frontend

调研方向

从 src/format/reveal/format-reveal.ts 中链接行号的处理开始，然后阅读 src/core/html.ts 中的 fixEmptyHrefs 以及 src/command/render/pandoc.ts 中的网站路径。使用提供的 deck.qmd 和 axe 命令复现；完成标准是 revealjs 为行号保留 href="#cb1-1"，点击后仍停留在幻灯片上，并且 axe 在两种项目类型中都不报告行号违规。

由索引模型根据 Issue 内容生成。

描述

accessibility bug revealjs

I have:

  • searched the issue tracker for similar issues
  • installed the latest version of Quarto CLI
  • formatted my issue following the Bug Reports guide

Bug description

For revealjs, Quarto removes the href from each code line-number link (format-reveal.ts). The comment says these links "can't work because ids are used for sections". That is no longer true. Since reveal.js 5, links to element ids work (f8e3406, hakimel/reveal.js#3444).

Removing the href now causes two bugs:

  1. Single file: fixEmptyHrefs (html.ts) sets href="". A click on a line number, or Enter on it, goes to the title slide.
  2. Website project: fixEmptyHrefs is skipped (pandoc.ts), so the anchor has no href. The aria-label from #14662 is then on an <a> that is not a link. axe reports aria-prohibited-attr (WCAG 4.1.2).

If the href is kept, revealjs gets the same markup as format: html: <a href="#cb1-1" aria-label="1">. I tested this by putting the href back in the rendered output. A click or Enter stays on the slide, stepped code-line-numbers highlights are not changed, and axe reports no line-number problems in either project type.

We found this with an axe scan of quarto.org: 87 instances on 7 revealjs pages, for example the revealjs demo.

Investigation was AI-assisted and grounded in a local clone of quarto-cli, per CONTRIBUTING.md's note on using AI tools.

Steps to reproduce

deck.qmd:

---
title: Deck
format: revealjs
---

## Code

```python
x = 1
y = 2
```
  1. Run quarto render deck.qmd. Open deck.html, go to the "Code" slide, and click a line number.
  2. Put deck.qmd in a website project (project: type: website, plus an index.qmd). Run quarto render, then quarto call axe _site --pages deck.html.

Actual behavior

  1. Single file: the line anchor is <a href="" aria-label="1"></a>. The click goes to the title slide.
  2. Website: the line anchor is <a aria-label="1"></a>. axe reports aria-prohibited-attr on each line anchor.

Expected behavior

Line numbers are links to their line, as in format: html: <a href="#cb1-1" aria-label="1"></a>. A click stays on the slide, and axe reports no violation.

Your environment

  • IDE: Positron 2026.10.0 (build 54)
  • OS: macOS 26.6.2 (build 25G83)

Quarto check output

Quarto 1.11.4
[✓] Checking environment information...
      Quarto cache location: /Users/charlottewickham/Library/Caches/quarto
[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.10.0: OK
      Dart Sass version 1.101.0: OK
      Deno version 2.7.14: OK
      Typst version 0.15.1: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
      Version: 1.11.4
      Path: /Applications/quarto/bin

[✓] Checking tools....................OK
      TinyTeX: v2026.04
      Chrome Headless Shell: 150.0.7871.115
      VeraPDF: 1.28.2

[✓] Checking LaTeX....................OK
      Using: TinyTex
      Path: /Users/charlottewickham/Library/TinyTeX/bin/universal-darwin
      Version: 2026

[✓] Checking Chrome Headless....................OK
      Using: Chrome Headless Shell installed by Quarto
      Path: /Users/charlottewickham/Library/Application Support/quarto/chrome-headless-shell/chrome-headless-shell-mac-arm64/chrome-headless-shell
      Version: 150.0.7871.115

[✓] Checking basic markdown render....OK

[✓] Checking R installation...........OK
      Version: 4.6.0
      Path: /Library/Frameworks/R.framework/Versions/4.6/Resources
      LibPaths:
        - /Users/charlottewickham/Library/R/arm64/4.6/library
        - /Library/Frameworks/R.framework/Versions/4.6/Resources/library
      knitr: 1.51
      rmarkdown: 2.31

[✓] Checking Knitr engine render......OK

[✓] Checking Python 3 installation....OK
      Version: 3.12.2
      Path: /Users/charlottewickham/.pyenv/versions/3.12.2/bin/python3
      Jupyter: 5.9.1
      Kernels: python3

[✓] Checking Jupyter engine render....OK

[✓] Checking Julia installation...
主要语言
JavaScript
星标
6k
派生
461
平均合并
16 小时 22 分钟
30 天内合并 PR
54

环境准备

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

quarto-dev/quarto-cli 的其他 Issue

查看 quarto-dev/quarto-cli 的全部 Issue

相似的 Issue

更多 JavaScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。