Epic: Crossref Overhaul

[allenmanning]

ASAP

• chapter number and name doesn't show when hovering over cross-ref #8848
• Customizable categories for Float and Block crossreferences
  • Multiple Figure Numbering Environments #1655
  • Numbered and cross-referencable Remarks #3323
  • [Feature Request] Add more theorem types from amsthm (e.g. axiom, assumption, ...) #3979
• Add crossreferences to
  • floats (Tables, Figures, Listings, etc)
  • blocks
    • Callouts
    • Theorem environments
    • Proof environments
• Allow fine-grained control over crossref label formatting
  • A few suggestions for cross referencing and text layout #1095
  • General support for references to the name of a Section/Chapter/etc. rather than its number. #1196
  • Custom Section Numbering Not Functioning #1771
  • FR: customization options for cross references in book project #2356
  • Option for parentheses around equation numbers reference in addition to eq-prefix #2439
  • FR: Uniform Cross-Reference Styling #3440
  • Section crossref in pdf format need number-sections: true #4364
  • Feature request: Ability to show the title of the cross-referenced chapter/section instead of just its number #4532
  • Further customisation of cross-ref labels #5481
  • Cross-referencing unnumbered appendix slide in Revealjs presentation #5621
  • Crossref support for _tags_ #5652
  • Improve treatment of compound crossreferences
    • Use "and" before last reference in group cross references #1706
    • Use dash (-) with group cross references #1707
• Glossary support
  • Feature request: Glossary #1697
• Page number format control for page regions where collations (list of *) are put
  • Book PDF section numbering format #1889
• Crossref collations (list of figures, tables, equations, etc) in non-PDF formats
  • list of tables, list of figures and list of abbreviations in quarto book  #2138
• Equation numbering, multiple refs in a single block, tags
  • referencing equations inside $$ \begin{align} environment #2275
  • enhancement: add MathJax equation numbering for math environments in html #4136
• Short caption support for all Float crossrefs
  • Support -scap in Float crossrefs consistently across formats and input options #3498
  • Support short caption in formats other than latex #4776
• Niceties
  • Emit better error message in the presence of incorrect -labels specs #4938
• Crossref, TOC, knit_child interactions
  • TOC ignoring subsections from child document #3178
• Book parts should be referenceable
  • Cross-reference and link to book parts #2571
  • Support cross reference to book part #3234
• Add crossreferences to
  • inlines (Equations, arbitrary spans, anchors from headings, etc)

Later

• Subcaption issues with and without labels with KableExtra #4517
• fig-* support: layout interaction, non-crossreferenced images
  • #| out/fig-width: ignored when specifying #| layout-nrow/col: #2251
  • out-width is ignored if fig-width is also set in _quarto.yml #3370
• Referenced LaTeX table placed in {.column-margin} causes render error #8772

Uncategorized

• -cap-location control for all Float crossreferences as well as subfloats and non-crossreferenceable figures (such as Pandoc.Figure)
  • handle tbl-cap-location in cells #1829
  • Table caption located at bottom when you have subtables in docx format #1990
  • fig-cap-location:top does place the caption above the figure #2154
  • lst-cap-location #2196
  • Add possibility to change the table, figure captions (docx) #2221
  • Table number does not appear when using a single table inside a div element. #3931
  • crossref: subcaption location control #7456
  • crossrefs: margin everything #7455
  • fig cap location not changing in revealjs #8938
• Allow computational cell code to be decorated (with filename, etc)
  • Code filename not correctly placed when used on computational chunk #2683
• Crossref filter and citeproc interaction
  • Crossrefs: combined internal and external references don't work #1186
• autoref style cross-referencing for PDF engine #2443
• Cross-referencing list items #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):
  • Native Numbering for Cross-Refs in DOCX #2464
  • Cross-referencing to give native figure numbering in DOCX #2335
• Allow Different Types of Cross Reference-able Outputs from a Single Code Chunk #1229

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

• Crossref over multiple files #2900
• Quarto Book: reference chunk data in another file #431

[cscheid]

I'm starting to check off issues that are resolved on the branch feature/float-crossref. For quarto users reading this, please don't take the checked-off boxes in here to mean that this work is ready to use. (feature/float-crossref is specifically not in a usable state right now.)