quarto-dev / quarto-dev/quarto-cli
Don't use 'margin' page geometry in TOC / Title page of books
Nobody has claimed this yet.
- 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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