quarto-dev / quarto-dev/quarto-cli

Overlap between margin citations and page-wide figure

Open
#6,301 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

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

Description

Bug description

A figure with layout .column-page may visually overlap with citations that are in the margin due to citation-location: margin.

I can work around the issue by placing the figure somewhere else in the text where there are just fewer citations in the margin.

image
Steps to reproduce
---
bibliography: [references.bib]
reference-location: margin
citation-location: margin
format:
  pdf:
    papersize: a4
---

## Data

__Police archives.__ The literature dismisses this source type as "biased", uninformative about the motives and organizers, uncomparable across regions, often unavailable or unobtainable, and because it is restricted to only registered demonstrations [@hutterProtestEventAnalysis2014; @wiedemannGeneralizedApproachProtest2022]. This criticism appears to me valid but overgeneralized, and there may well be regions where the advantages prevail over the problems. Especially for the goal of impact estimation, the avoidance of selection biases that are associated with newspaper articles [@hutterProtestEventAnalysis2014; @jamesozdenLiteratureReviewProtest2022] is a strong argument for using data from police and demonstration authorities.

![History of the number of protest events in Germany per week.](protest_history.png){.column-page}

references.bib:

@incollection{hutterProtestEventAnalysis2014,
  title     = {Protest {{Event Analysis}} and {{Its Offspring}}},
  booktitle = {Methodological {{Practices}} in {{Social Movement Research}}},
  author    = {Hutter, Swen},
  editor    = {family=Porta, given=Donatella, prefix=della, useprefix=true},
  date      = {2014-09-25},
  pages     = {335--367},
  publisher = {{Oxford University Press}},
  doi       = {10.1093/acprof:oso/9780198719571.003.0014},
  url       = {https://academic.oup.com/book/10558/chapter/158513194},
  urldate   = {2023-01-30},
  isbn      = {978-0-19-871957-1},
  langid    = {english}
}
@inproceedings{wiedemannGeneralizedApproachProtest2022,
  title     = {A {{Generalized Approach}} to {{Protest Event Detection}} in {{German Local News}}},
  booktitle = {Proceedings of the {{Thirteenth Language Resources}} and {{Evaluation Conference}}},
  author    = {Wiedemann, Gregor and Dollbaum, Jan Matti and Haunss, Sebastian and Daphi, Priska and Meier, Larissa Daria},
  date      = {2022-06},
  pages     = {3883--3891},
  publisher = {{European Language Resources Association}},
  location  = {{Marseille, France}},
  url       = {https://aclanthology.org/2022.lrec-1.413},
  urldate   = {2022-12-19}
}
@report{jamesozdenLiteratureReviewProtest2022,
  title       = {Literature {{Review}}: {{Protest Outcomes}}},
  author      = {{James Ozden} and {Sam Glover}},
  date        = {2022-04},
  institution = {{Social Change Lab}},
  url         = {https://www.socialchangelab.org/_files/ugd/503ba4_21103ca09bf247748a788c92c60371a0.pdf},
  urldate     = {2023-04-15}
}

protest_history.png:

protest_history

Expected behavior

The positions of the figure and the citations should be coordinated in some way.

For example, move the citation further down in the margin, such that it is below the figure.

Actual behavior

They are not coordinated and simply overlap, see screenshot above.

Your environment
  • IDE: latest VSCode
  • OS: MacOS Ventura 13.4.1 (c)
Quarto check output
[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.1.1: OK
      Dart Sass version 1.55.0: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
      Version: 1.3.361
      Path: /Applications/quarto/bin

[✓] Checking basic markdown render....OK

[✓] Checking Python 3 installation....OK
      Version: 3.10.10
      Path: /Users/david/Repositories/protest-impact/.venv/bin/python
      Jupyter: 5.3.1
      Kernels: ir, python3

[✓] Checking Jupyter engine render....OK

[✓] Checking R installation...........OK
      Version: 4.2.1
      Path: /Library/Frameworks/R.framework/Resources
      LibPaths:
        - /Library/Frameworks/R.framework/Versions/4.2-arm64/Resources/library
      knitr: 1.39
      rmarkdown: 2.14

[✓] Checking Knitr engine render......OK

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 by rendering the supplied .qmd example with Quarto's PDF format and the shown citation-location and .column-page settings. Inspect the generated PDF and the rendering path responsible for placing margin citations and page-wide figures; done means the figure and citations no longer overlap and the expected positioning is coordinated.

Written by the indexing model from the issue text.

Assessment

Domain
design
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.