Website navbar hides the notebook preview header
维护者通常 1 天内回复
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 78/100
调研方向
先从 src/resources/formats/html/embed/template.html 中预览标题附近的部分开始，然后使用提供的 _quarto.yml、index.qmd 和 source.qmd 文件，通过 quarto render 和 quarto preview 重现该问题。完成的标准是：笔记本预览标题（包括其 Back to Article、title 和 Download 控件）显示在网站导航栏下方。
由索引模型根据 Issue 内容生成。
描述
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
In a website with a navbar, the site navbar hides the header of a notebook preview page (*-preview.html). The hidden header has the "Back to Article" link, the notebook title, and the "Download" link. Readers cannot see these controls.
- Cause: the preview header (
#quarto-embed-header) and the site navbar (#quarto-header) both usefixed-top. Both are attop: 0with the same z-index. The navbar comes later in the DOM, so it shows on top. Template: https://github.com/quarto-dev/quarto-cli/blob/8487eaafe5d2f50536d5ebeac87c0f5e7c81b371/src/resources/formats/html/embed/template.html#L119-L133 - Impact: on quarto.org, the header is hidden on https://quarto.org/docs/authoring/penguins-preview.html.
- Related: #14968 (the same header is outside any landmark).
Steps to reproduce
Make a website project with these three files. Then run quarto render, then quarto preview and navigate to the notebook through the "Source: Source" link.
_quarto.yml:
project:
type: website
website:
title: "Embed test"
navbar:
left:
- index.qmd
format: html
index.qmd:
---
title: "Home"
---
{{< embed source.qmd#two >}}
source.qmd:
---
title: "Source"
---
```{python}
#| label: two
1 + 1
```
Actual behavior
The navbar shows at the top of the page. The preview header is not visible.
Expected behavior
The preview header shows below the navbar. If you remove website.navbar from _quarto.yml, the header shows correctly:
Your environment
- IDE: Positron 2026.10.0 (build 56)
- 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...
I used AI to help investigate. The investigation was grounded in a local clone of quarto-cli.
- 主要语言
- JavaScript
- 星标
- 6.1k
- 派生
- 463
- 平均合并
- 21 小时 10 分钟
- 30 天内合并 PR
- 61
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
quarto-dev/quarto-cli 的其他 Issue
-
bug callouts regression revealjs
难度 2/5 1-3 小时 新手友好度 72/100
quarto-dev/quarto-cli#15014 ·
维护者通常 1 天内回复
-
accessibility documentation revealjs
难度 2/5 1-3 小时 新手友好度 86/100
quarto-dev/quarto-cli#14971 ·
维护者通常 1 天内回复
-
accessibility revealjs
难度 2/5 1-3 小时 新手友好度 88/100
quarto-dev/quarto-cli#14970 · 1 条评论 ·
维护者通常 1 天内回复
-
a11y: notebook preview header is outside any landmark可能已有人在做 关联的 PR 仍在进行中或已合并。 未关闭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 天内回复
查看 quarto-dev/quarto-cli 的全部 Issue
相似的 Issue
-
chore v2
难度 2/5 1-3 小时 新手友好度 78/100
modelcontextprotocol/servers#5115 ·
维护者通常 1 天内回复
-
beginner bug good first issue
难度 1/5 1 小时以内 新手友好度 85/100
philaconvalley/website#168 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 66/100
druxt/umami.demo.druxtjs.org#527 ·
维护者通常 9 天内回复
-
难度 2/5 1-3 小时 新手友好度 62/100
NuSkooler/enigma-bbs#907 ·
维护者通常 1 天内回复
-
documentation good first issue
难度 2/5 1-3 小时 新手友好度 72/100