Epic: Crossref Overhaul

ASAP

• https://github.com/quarto-dev/quarto-cli/issues/8848
• Customizable categories for Float and Block crossreferences
  • #1655
  • #3323
  • #3979
• Add crossreferences to
  • floats (Tables, Figures, Listings, etc)
  • blocks
    • Callouts
    • Theorem environments
    • Proof environments
• Allow fine-grained control over crossref label formatting
  • #1095
  • #1196
  • #1771
  • #2356
  • #2439
  • #3440
  • #4364
  • #4532
  • #5481
  • #5621
  • #5652
  • Improve treatment of compound crossreferences
    • #1706
    • #1707
• Glossary support
  • #1697
• Page number format control for page regions where collations (list of *) are put
  • #1889
• Crossref collations (list of figures, tables, equations, etc) in non-PDF formats
  • #2138
• Equation numbering, multiple refs in a single block, tags
  • #2275
  • #4136
• Short caption support for all Float crossrefs
  • #3498
  • #4776
• Niceties
  • #4938
• Crossref, TOC, knit_child interactions
  • #3178
• Book parts should be referenceable
  • #2571
  • #3234
• Add crossreferences to
  • inlines (Equations, arbitrary spans, anchors from headings, etc)

Later

• #4517
• fig-* support: layout interaction, non-crossreferenced images
  • #2251
  • #3370
• #8772

Uncategorized

• -cap-location control for all Float crossreferences as well as subfloats and non-crossreferenceable figures (such as Pandoc.Figure)
  • #1829
  • #1990
  • #2154
  • #2196
  • #2221
  • #3931
  • #7456
  • #7455
  • #8938
• Allow computational cell code to be decorated (with filename, etc)
  • #2683
• Crossref filter and citeproc interaction
  • #1186
• https://github.com/quarto-dev/quarto-cli/discussions/2443
• https://github.com/quarto-dev/quarto-cli/discussions/4045

Outstanding Tasks

• Are we testing Epub crossrefs right now?
  • run output through epubcheck
• Check the crossref label
• Check the issues that refer to this
• Consistency of CSS class names: "fig" vs "figure", etc.

Wontfix

• We don't know enough DocX to make it work in all our usecases (subfloats, custom crossrefs, etc):
  • https://github.com/quarto-dev/quarto-cli/discussions/2464
  • https://github.com/quarto-dev/quarto-cli/discussions/2335
• #1229

Needs project overhaul (so will be worked on after that epic)

• https://github.com/quarto-dev/quarto-cli/discussions/2900
• https://github.com/quarto-dev/quarto-cli/discussions/431