Document how to avoid an empty `<h2>` on revealjs slides without a visible title
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 86/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- markdown
調査の方向性
リンクされた Slide Backgrounds Without a Title セクションから始め、関連する Auto Animate セクションと比較します。視覚的に非表示にする span のパターンを文書化し、見出しに .visually-hidden を適用するとスライド全体が非表示になることを警告し、Auto Animate をそのガイダンスにリンクします。レンダリングされた例で空の見出しを避ける方法が説明されていることを確認します。
索引モデルが issue の本文から書いたものです。
説明
The revealjs docs show slides with no title, for example ## {background-color="aquamarine"} in Slide Backgrounds Without a Title and ## {auto-animate=true} in Auto Animate. Each of these slides renders an empty <h2>. Screen reader users who move by headings land on a heading with no name, and axe reports empty-heading.
Authors can avoid the empty <h2> and still show no title. Put the title in a span with the .visually-hidden class:
## [Aquamarine slide]{.visually-hidden} {background-color="aquamarine"}
In Quarto 1.11.4, the title does not show on the slide, but Chrome's accessibility tree has heading "Aquamarine slide" [level=2]. The slide menu also lists "Aquamarine slide", not the first words of the slide text. The class works in revealjs, because Quarto defines its own .visually-hidden (_quarto-rules.scss L12-L22). The revealjs theme includes that file (format-reveal-theme.ts L177).
quarto.org does not document this pattern, and there is a trap: ## Title {.visually-hidden} hides the whole slide. In revealjs, Pandoc moves heading classes to the <section>.
Suggestion: In Slide Backgrounds Without a Title, show the .visually-hidden span as the way to have no visible title, and warn about the class on the heading. Auto Animate could link to it.
AI helped with this investigation. The work was grounded in a local clone of quarto-cli, as "Using AI tools to investigate" in CONTRIBUTING.md describes.
- 主要言語
- JavaScript
- スター
- 6k
- フォーク
- 461
- 平均マージ
- 12時間 42分
- マージ済み PR（30日）
- 54
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
quarto-dev/quarto-cli のほかの issue
-
accessibility bug embed websites
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
quarto-dev/quarto-cli#14972 ·
メンテナーはふだん 1 日以内に返信
-
accessibility revealjs
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
quarto-dev/quarto-cli#14970 ·
メンテナーはふだん 1 日以内に返信
-
accessibility embed
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
quarto-dev/quarto-cli#14968 ·
メンテナーはふだん 1 日以内に返信
-
accessibility revealjs themes
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
quarto-dev/quarto-cli#14963 ·
メンテナーはふだん 1 日以内に返信
-
accessibility revealjs themes
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
quarto-dev/quarto-cli#14962 ·
メンテナーはふだん 1 日以内に返信
quarto-dev/quarto-cli の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
FuRongJun-1999/dsh-memory#56 ·
メンテナーはふだん 1 日以内に返信
-
Bug
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
pgadmin-org/pgadmin4#10503 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
521xueweihan/HelloGitHub#3856 ·
-
needs-ac
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
Ikalus1988/MisakaNet#2845 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
neondatabase/website#6038 ·
メンテナーはふだん 1 日以内に返信