quarto-dev / quarto-dev/quarto-cli

Table caption located at bottom when you have subtables in docx format

Open
#1,990 7 comments 0 reactions 1 assignee View on GitHub

Nobody has claimed this yet.

bug crossref docx tables
Dominant language
JavaScript
Stars
6k
Forks
458
Avg merge
1d 9h
Merged PRs (30d)
41

Description

Bug description

When using docx format and generating a table with multiple sub-tables, the overall caption of the tables appears at the bottom of the table instead of the top. For example, compare the two tables in this document:

---
title: "Bad caption placement"
format: docx
---

# Single table with caption on top

```{r}
#| label: tbl-one
#| tbl-cap: "Caption on top"
library(knitr)
kable(head(cars))
```

# Sub-tables with overall caption on bottom

```{r}
#| label: tbl-two
#| tbl-cap-location: top
#| tbl-cap: "Caption on bottom"
#| tbl-subcap: 
#|   - "Cars"
#|   - "Pressure"
library(knitr)
kable(head(cars))
kable(head(pressure))
```

The second table has the overall caption at the bottom. This behavior is inconsistent with other output formats (both html and pdf place the overall caption at the top) and does not appear to be controllable with tbl-cap-location.

quarto check Output
[✓] Checking Quarto installation......OK
      Version: 1.0.38
      Path: /opt/quarto/bin

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

[✓] Checking Python 3 installation....OK
      Version: 3.8.10
      Path: /usr/bin/python3
      Jupyter: 4.11.1
      Kernels: python3

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

[✓] Checking R installation...........OK
      Version: 4.2.1
      Path: /usr/lib/R
      LibPaths:
        - /home/dmk/R/x86_64-pc-linux-gnu-library/4.2
        - /usr/local/lib/R/site-library
        - /usr/lib/R/site-library
        - /usr/lib/R/library
      rmarkdown: 2.14

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

quarto tools check Output
[✓] Inspecting tools

Tool         Status            Installed     Latest  
chromium     Not installed     ---           869685  
tinytex      Not installed     ---           v2022.08
Checklist
  • formatted your issue so it is easier for us to read?
  • included a minimal, fully reproducible example in a single .qmd file? Please provide the whole file rather than the snippet you believe is causing the issue.
  • documented the quarto version you're running, by pasting the output from running quarto check in the "Quarto Check Output" text area?
  • documented the version of the quarto tools you're running, by providing the output from running quarto tools check in the "Quarto Tools Check Output" text area?
  • documented the RStudio IDE version you're running (if applicable), by providing the value displayed in the "About RStudio" main menu dialog?
  • documented which operating system you're running? If on Linux, please provide the specific distribution as well.
  • upgraded to the latest version, including your versions of R, the RStudio IDE, and relevant R packages?

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.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.