quarto-dev / quarto-dev/quarto-cli

Project Book Do not start a new chapter at every file

Open
#7,649 7 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

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

Description

Bug description

In the project configuration for a book, every file listed as chapter starts a new chapter. This limits freedom in breaking the project into files.

I wish to break some chapters into multiple files (which should render as a continuous chapter), and at times i do not want a chapter level at all, and I want each file to be a section.

I suspect that an option to suppress starting new chapters would fix this issue and allow manual chaptering and sectioning of the book.

Steps to reproduce

No response

Expected behavior

No response

Actual behavior

No response

Your environment

No response

Quarto check output

No response

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

The issue does not name files, tests, or entry points. Start by tracing how project configuration for a book turns listed files into chapters, then determine how continuous chapters and file-level sections should be represented. Done means a documented configuration behavior that supports the requested chapter and section arrangements, with coverage for the relevant book-rendering cases.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
content
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.