quarto-dev / quarto-dev/quarto-cli

moving a document from appendices to a chapter does not render/move article in sidebar for book

Open
#348 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

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

Description

Given a slightly simplified _quarto.yml:

book:
  title: "quarto-design"
  repo-url: https://github.com/dpastoor/quarto-design
  repo-actions: [edit, issue]
  chapters:
    - "index.qmd"
+     - part: user-journeys.qmd
+      chapters:
+        - rsc-user-journeys.qmd
  appendices:
     - appendix.qmd
-    - user-journeys.qmd

when making that shift, get the following:

GET: /user-journeys.html
ERROR: Book chapter 'rsc-user-journeys.qmd' not found # note then created it
GET: /user-journeys.html

the preview continues to work, but the chapter sidebar continues to render with user-journeys.qmd in the sidebar.

solution: takes exiting and restarting quarto preview to pick up the change.

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

Reproduce the case using the shown _quarto.yml and the user-journeys.qmd, rsc-user-journeys.qmd, and appendix.qmd files. Start by running quarto preview, move the article from appendices to chapters, and observe the requests and sidebar. Done means the moved article renders in the chapter sidebar without requiring a preview restart or producing the chapter-not-found error.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
cli
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.