How to prevent multiple table captions when using gt header_repeat with longtable

[jtatria]

Description

I'm trying t format a very long table with repeated headers in each page using gt with latex options longtable and header_repeat, but I'm getting repeated table captions on each page, and multiple entries in the list of tables.

How can I accomplish a long table with repeated headers but a single caption?

I already tried using gt's own gt:tab_caption, but the caption wouldn't show in quarto.

MRE:

---
title: "gt demo"
format:
  pdf:
    documentclass: report
    lot: true
---

## Demo

```{r}
#| label: tbl-demo
#| tbl-cap: "Caption repeats"
	gt::gt( iris ) |> gt::tab_options(
		latex.use_longtable=TRUE,
		latex.header_repeat=TRUE
	)
```
```

Any help would be greatly appreciated. Thanks!

[mcanouil]

Could you properly format your post using code blocks for code and terminal outputs? Thanks.
If your code contains code blocks, you need to enclose it using more backticks, i.e., usually four ````.
See https://quarto.org/bug-reports.html#formatting-make-githubs-markdown-work-for-us.

---

Important

Accessibility: To improve accessibility, please add alternative text to your screenshots. This helps all users, including those using screen readers, to understand the context of the images. A brief description can make a big difference! See Good Alt Text, Bad Alt Text — Making Your Content Perceivable.

[mcanouil]

The issue is that Quarto needs to post-process the table to allow cross-reference.
LaTeX has many issues and longtable is one of the package that does not work well with various environments.

Quarto injects the \caption and \label into the longtable, but places them before \endhead without adding a separate \endfirsthead block. This causes the caption to repeat on every page.

The only workarounds:

• use Typst
• Post-process the tex file

[mcanouil]

I've opened an issue to track this.

• Cross-referenced longtable caption repeated on page break #14146