quarto-dev / quarto-dev/quarto-cli

Website sidebar auto generation renders differently on Windows vs Linux

Open
#2,409 3 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
JavaScript
Stars
6k
Forks
458
Avg merge
1d 9h
Merged PRs (30d)
41

Description

Bug description

Description

Using the sidebar auto generation feature, I get different results between Windows and Linux. I have two nested folder structures with index.qmd files along content files for each section. On Windows, the index pages are added to the sidebar as expected, while on Linux, they are omitted.

Side-by-side comparison

quarto-sidebar-both

Version and OS info

Using Quarto v1.2.90 on

  • Windows 11 Pro 21H2 build 22000.856
  • Ubuntu 20.04.3 LTS through WSL2
  • GitHub Actions ubuntu-latest using the official quarto-setup action

Minimal, fully reproducible example

Directory structure:

.
├── _quarto.yml
├── home.qmd
└── section1
    ├── index.qmd
    ├── page1.qmd
    └── page2.qmd

_quarto.yml

project:
  type: website

website:
  sidebar:
    contents:
      - text: "Home"
        file: home.qmd
      - "---"
      - auto: section1

home.qmd

# Home
Homepage content

section1/index.qmd

# Section 1
Section 1 content

section1/page1.qmd

# Page 1
content page 1

section1/page2.qmd

# Page 2
content page 2
Checklist
  • Please include a minimal, fully reproducible example in a single .qmd file? Please provide the whole file rather than the snippet you believe is causing the issue.
  • Please format your issue so it is easier for us to read the bug report.
  • Please document the RStudio IDE version you're running (if applicable), by providing the value displayed in the "About RStudio" main menu dialog?
  • Please document the operating system you're running. If on Linux, please provide the specific distribution.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the reproducible website described in _quarto.yml, using home.qmd and section1/index.qmd, page1.qmd, and page2.qmd. Build it on Windows and Linux, compare the generated sidebars, and trace the auto: section1 path handling until the index page is consistently included.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
web-dev
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.