quarto-dev / quarto-dev/quarto-cli

Don't use 'margin' page geometry in TOC / Title page of books

Open
#5,143 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

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

Description

For books, we should use normal page geometry for pages that don't contain margin elements, like the TOC / Title page.

Discussed in https://github.com/quarto-dev/quarto-cli/discussions/5122

Originally posted by dominicwhite April 7, 2023
I am writing a Quarto book split over multiple chapter files.

I am trying to add margin notes following this guide here: https://quarto.org/docs/blog/posts/2022-02-17-advanced-layout/

If I add

reference-location: margin
citation-location: margin

to the pdf format section my _quarto.yml file for the whole book then I get footnotes correctly rendered in the margins in the individual chapters.

However, it also forces other sections, like the title page and the table of contents, to have that same margin, which I do not want.

I would like to have the margin space added just in the chapters (and not on the title page or table of contents), but when I add the two settings above to the top of individual chapter files instead, either using the recommended style from the blog post:

---
reference-location: margin
citation-location: margin
---

or as something like this:

---
format:
  pdf:
    documentclass: scrreport
    reference-location: margin
    citation-location: margin
---

then I get regular footnotes instead of margin notes.

Is it possible to turn on margin notes only for certain chapters, and if so, what I am doing wrong with my settings?

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 book layout using the _quarto.yml settings and chapter front matter shown in the issue, with PDF output and the scrreport document class. Compare the title page, table of contents, and chapter pages to determine where margin geometry is applied. Done means chapters retain margin notes while the title page and TOC use normal page geometry.

Written by the indexing model from the issue text.

Assessment

Tech stack
latex
Domain
documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 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.