quarto-dev · cwickham · Dec 12, 2023 · Dec 12, 2023
diff --git a/_quarto.yml b/_quarto.yml
@@ -539,6 +539,8 @@ website:
                 href: docs/reference/globs.qmd
               - text: "Citations"
                 href: docs/reference/metadata/citation.qmd
+              - text: "Cross-References"
+                href: docs/reference/metadata/crossref.qmd
     - id: prerelease
       title: "Quarto 1.3"
       contents:

diff --git a/docs/reference/cells/cells-jupyter.json b/docs/reference/cells/cells-jupyter.json
@@ -1521,72 +1521,21 @@
         "name": "tbl-colwidths",
         "description": "Apply explicit table column widths for markdown grid tables and pipe\ntables that are more than `columns` characters wide (72 by default). \n\nSome formats (e.g. HTML) do an excellent job automatically sizing\ntable columns and so don't benefit much from column width specifications.\nOther formats (e.g. LaTeX) require table column sizes in order to \ncorrectly flow longer cell content (this is a major reason why tables \n> 72 columns wide are assigned explicit widths by Pandoc).\n\nThis can be specified as:\n\n- `auto`: Apply markdown table column widths except when there is a\n  hyperlink in the table (which tends to throw off automatic\n  calculation of column widths based on the markdown text width of cells).\n  (`auto` is the default for HTML output formats)\n\n- `true`: Always apply markdown table widths (`true` is the default\n  for all non-HTML formats)\n\n- `false`: Never apply markdown table widths.\n\n- An array of numbers (e.g. `[40, 30, 30]`): Array of explicit width percentages.\n",
         "formats": [
-          "asciidoc",
-          "asciidoctor",
+          "latex",
+          "pdf",
           "beamer",
-          "biblatex",
-          "bibtex",
-          "chunkedhtml",
-          "commonmark",
-          "commonmark_x",
-          "context",
-          "csljson",
-          "docbook",
-          "docbook4",
-          "docbook5",
-          "docx",
-          "dokuwiki",
-          "dzslides",
-          "epub",
-          "epub2",
-          "epub3",
-          "fb2",
-          "gfm",
-          "haddock",
+          "dashboard",
           "html",
           "html4",
           "html5",
-          "icml",
-          "ipynb",
-          "jats",
-          "jats_archiving",
-          "jats_articleauthoring",
-          "jats_publishing",
-          "jira",
-          "json",
-          "latex",
-          "man",
-          "markdown",
-          "markdown_github",
-          "markdown_mmd",
-          "markdown_phpextra",
-          "markdown_strict",
-          "markua",
-          "mediawiki",
-          "ms",
-          "muse",
-          "native",
-          "odt",
-          "opendocument",
-          "opml",
-          "org",
-          "pdf",
-          "plain",
-          "pptx",
-          "revealjs",
-          "rst",
-          "rtf",
-          "s5",
-          "slideous",
           "slidy",
-          "tei",
-          "texinfo",
-          "textile",
-          "typst",
-          "xwiki",
-          "zimwiki",
-          "md",
-          "dashboard"
+          "slideous",
+          "s5",
+          "revealjs",
+          "dzslides",
+          "epub",
+          "epub2",
+          "epub3"
         ],
         "contexts": [
           "document-tables"

diff --git a/docs/reference/cells/cells-knitr.json b/docs/reference/cells/cells-knitr.json
@@ -3585,72 +3585,21 @@
         "name": "tbl-colwidths",
         "description": "Apply explicit table column widths for markdown grid tables and pipe\ntables that are more than `columns` characters wide (72 by default). \n\nSome formats (e.g. HTML) do an excellent job automatically sizing\ntable columns and so don't benefit much from column width specifications.\nOther formats (e.g. LaTeX) require table column sizes in order to \ncorrectly flow longer cell content (this is a major reason why tables \n> 72 columns wide are assigned explicit widths by Pandoc).\n\nThis can be specified as:\n\n- `auto`: Apply markdown table column widths except when there is a\n  hyperlink in the table (which tends to throw off automatic\n  calculation of column widths based on the markdown text width of cells).\n  (`auto` is the default for HTML output formats)\n\n- `true`: Always apply markdown table widths (`true` is the default\n  for all non-HTML formats)\n\n- `false`: Never apply markdown table widths.\n\n- An array of numbers (e.g. `[40, 30, 30]`): Array of explicit width percentages.\n",
         "formats": [
-          "asciidoc",
-          "asciidoctor",
+          "latex",
+          "pdf",
           "beamer",
-          "biblatex",
-          "bibtex",
-          "chunkedhtml",
-          "commonmark",
-          "commonmark_x",
-          "context",
-          "csljson",
-          "docbook",
-          "docbook4",
-          "docbook5",
-          "docx",
-          "dokuwiki",
-          "dzslides",
-          "epub",
-          "epub2",
-          "epub3",
-          "fb2",
-          "gfm",
-          "haddock",
+          "dashboard",
           "html",
           "html4",
           "html5",
-          "icml",
-          "ipynb",
-          "jats",
-          "jats_archiving",
-          "jats_articleauthoring",
-          "jats_publishing",
-          "jira",
-          "json",
-          "latex",
-          "man",
-          "markdown",
-          "markdown_github",
-          "markdown_mmd",
-          "markdown_phpextra",
-          "markdown_strict",
-          "markua",
-          "mediawiki",
-          "ms",
-          "muse",
-          "native",
-          "odt",
-          "opendocument",
-          "opml",
-          "org",
-          "pdf",
-          "plain",
-          "pptx",
-          "revealjs",
-          "rst",
-          "rtf",
-          "s5",
-          "slideous",
           "slidy",
-          "tei",
-          "texinfo",
-          "textile",
-          "typst",
-          "xwiki",
-          "zimwiki",
-          "md",
-          "dashboard"
+          "slideous",
+          "s5",
+          "revealjs",
+          "dzslides",
+          "epub",
+          "epub2",
+          "epub3"
         ],
         "contexts": [
           "document-tables"

diff --git a/docs/reference/formats/asciidoc.json b/docs/reference/formats/asciidoc.json
@@ -156,10 +156,6 @@
     "name": "tables",
     "title": "Tables",
     "options": [
-      {
-        "name": "tbl-colwidths",
-        "description": "Apply explicit table column widths for markdown grid tables and pipe\ntables that are more than `columns` characters wide (72 by default). \n\nSome formats (e.g. HTML) do an excellent job automatically sizing\ntable columns and so don't benefit much from column width specifications.\nOther formats (e.g. LaTeX) require table column sizes in order to \ncorrectly flow longer cell content (this is a major reason why tables \n> 72 columns wide are assigned explicit widths by Pandoc).\n\nThis can be specified as:\n\n- `auto`: Apply markdown table column widths except when there is a\n  hyperlink in the table (which tends to throw off automatic\n  calculation of column widths based on the markdown text width of cells).\n  (`auto` is the default for HTML output formats)\n\n- `true`: Always apply markdown table widths (`true` is the default\n  for all non-HTML formats)\n\n- `false`: Never apply markdown table widths.\n\n- An array of numbers (e.g. `[40, 30, 30]`): Array of explicit width percentages.\n"
-      },
       {
         "name": "df-print",
         "description": "Method used to print tables in Knitr engine documents:\n\n-  `default`: Use the default S3 method for the data frame.\n-  `kable`: Markdown table using the `knitr::kable()` function.\n-  `tibble`: Plain text table using the `tibble` package.\n-  `paged`: HTML table with paging for row and column overflow.\n\nThe default printing method is `kable`.\n"
@@ -188,6 +184,16 @@
       }
     ]
   },
+  {
+    "name": "crossref",
+    "title": "Cross-References",
+    "options": [
+      {
+        "name": "crossref",
+        "description": "Configuration for crossref labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
+      }
+    ]
+  },
   {
     "name": "citation",
     "title": "Citation",

diff --git a/docs/reference/formats/context.json b/docs/reference/formats/context.json
@@ -254,10 +254,6 @@
     "name": "tables",
     "title": "Tables",
     "options": [
-      {
-        "name": "tbl-colwidths",
-        "description": "Apply explicit table column widths for markdown grid tables and pipe\ntables that are more than `columns` characters wide (72 by default). \n\nSome formats (e.g. HTML) do an excellent job automatically sizing\ntable columns and so don't benefit much from column width specifications.\nOther formats (e.g. LaTeX) require table column sizes in order to \ncorrectly flow longer cell content (this is a major reason why tables \n> 72 columns wide are assigned explicit widths by Pandoc).\n\nThis can be specified as:\n\n- `auto`: Apply markdown table column widths except when there is a\n  hyperlink in the table (which tends to throw off automatic\n  calculation of column widths based on the markdown text width of cells).\n  (`auto` is the default for HTML output formats)\n\n- `true`: Always apply markdown table widths (`true` is the default\n  for all non-HTML formats)\n\n- `false`: Never apply markdown table widths.\n\n- An array of numbers (e.g. `[40, 30, 30]`): Array of explicit width percentages.\n"
-      },
       {
         "name": "df-print",
         "description": "Method used to print tables in Knitr engine documents:\n\n-  `default`: Use the default S3 method for the data frame.\n-  `kable`: Markdown table using the `knitr::kable()` function.\n-  `tibble`: Plain text table using the `tibble` package.\n-  `paged`: HTML table with paging for row and column overflow.\n\nThe default printing method is `kable`.\n"
@@ -286,6 +282,16 @@
       }
     ]
   },
+  {
+    "name": "crossref",
+    "title": "Cross-References",
+    "options": [
+      {
+        "name": "crossref",
+        "description": "Configuration for crossref labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
+      }
+    ]
+  },
   {
     "name": "citation",
     "title": "Citation",

diff --git a/docs/reference/formats/docbook.json b/docs/reference/formats/docbook.json
@@ -146,10 +146,6 @@
     "name": "tables",
     "title": "Tables",
     "options": [
-      {
-        "name": "tbl-colwidths",
-        "description": "Apply explicit table column widths for markdown grid tables and pipe\ntables that are more than `columns` characters wide (72 by default). \n\nSome formats (e.g. HTML) do an excellent job automatically sizing\ntable columns and so don't benefit much from column width specifications.\nOther formats (e.g. LaTeX) require table column sizes in order to \ncorrectly flow longer cell content (this is a major reason why tables \n> 72 columns wide are assigned explicit widths by Pandoc).\n\nThis can be specified as:\n\n- `auto`: Apply markdown table column widths except when there is a\n  hyperlink in the table (which tends to throw off automatic\n  calculation of column widths based on the markdown text width of cells).\n  (`auto` is the default for HTML output formats)\n\n- `true`: Always apply markdown table widths (`true` is the default\n  for all non-HTML formats)\n\n- `false`: Never apply markdown table widths.\n\n- An array of numbers (e.g. `[40, 30, 30]`): Array of explicit width percentages.\n"
-      },
       {
         "name": "df-print",
         "description": "Method used to print tables in Knitr engine documents:\n\n-  `default`: Use the default S3 method for the data frame.\n-  `kable`: Markdown table using the `knitr::kable()` function.\n-  `tibble`: Plain text table using the `tibble` package.\n-  `paged`: HTML table with paging for row and column overflow.\n\nThe default printing method is `kable`.\n"
@@ -178,6 +174,16 @@
       }
     ]
   },
+  {
+    "name": "crossref",
+    "title": "Cross-References",
+    "options": [
+      {
+        "name": "crossref",
+        "description": "Configuration for crossref labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
+      }
+    ]
+  },
   {
     "name": "citation",
     "title": "Citation",

diff --git a/docs/reference/formats/docx.json b/docs/reference/formats/docx.json
@@ -196,10 +196,6 @@
     "name": "tables",
     "title": "Tables",
     "options": [
-      {
-        "name": "tbl-colwidths",
-        "description": "Apply explicit table column widths for markdown grid tables and pipe\ntables that are more than `columns` characters wide (72 by default). \n\nSome formats (e.g. HTML) do an excellent job automatically sizing\ntable columns and so don't benefit much from column width specifications.\nOther formats (e.g. LaTeX) require table column sizes in order to \ncorrectly flow longer cell content (this is a major reason why tables \n> 72 columns wide are assigned explicit widths by Pandoc).\n\nThis can be specified as:\n\n- `auto`: Apply markdown table column widths except when there is a\n  hyperlink in the table (which tends to throw off automatic\n  calculation of column widths based on the markdown text width of cells).\n  (`auto` is the default for HTML output formats)\n\n- `true`: Always apply markdown table widths (`true` is the default\n  for all non-HTML formats)\n\n- `false`: Never apply markdown table widths.\n\n- An array of numbers (e.g. `[40, 30, 30]`): Array of explicit width percentages.\n"
-      },
       {
         "name": "df-print",
         "description": "Method used to print tables in Knitr engine documents:\n\n-  `default`: Use the default S3 method for the data frame.\n-  `kable`: Markdown table using the `knitr::kable()` function.\n-  `tibble`: Plain text table using the `tibble` package.\n-  `paged`: HTML table with paging for row and column overflow.\n\nThe default printing method is `kable`.\n"
@@ -240,6 +236,16 @@
       }
     ]
   },
+  {
+    "name": "crossref",
+    "title": "Cross-References",
+    "options": [
+      {
+        "name": "crossref",
+        "description": "Configuration for crossref labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
+      }
+    ]
+  },
   {
     "name": "citation",
     "title": "Citation",

diff --git a/docs/reference/formats/epub.json b/docs/reference/formats/epub.json
@@ -348,6 +348,16 @@
       }
     ]
   },
+  {
+    "name": "crossref",
+    "title": "Cross-References",
+    "options": [
+      {
+        "name": "crossref",
+        "description": "Configuration for crossref labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
+      }
+    ]
+  },
   {
     "name": "citation",
     "title": "Citation",

diff --git a/docs/reference/formats/fb2.json b/docs/reference/formats/fb2.json
@@ -152,10 +152,6 @@
     "name": "tables",
     "title": "Tables",
     "options": [
-      {
-        "name": "tbl-colwidths",
-        "description": "Apply explicit table column widths for markdown grid tables and pipe\ntables that are more than `columns` characters wide (72 by default). \n\nSome formats (e.g. HTML) do an excellent job automatically sizing\ntable columns and so don't benefit much from column width specifications.\nOther formats (e.g. LaTeX) require table column sizes in order to \ncorrectly flow longer cell content (this is a major reason why tables \n> 72 columns wide are assigned explicit widths by Pandoc).\n\nThis can be specified as:\n\n- `auto`: Apply markdown table column widths except when there is a\n  hyperlink in the table (which tends to throw off automatic\n  calculation of column widths based on the markdown text width of cells).\n  (`auto` is the default for HTML output formats)\n\n- `true`: Always apply markdown table widths (`true` is the default\n  for all non-HTML formats)\n\n- `false`: Never apply markdown table widths.\n\n- An array of numbers (e.g. `[40, 30, 30]`): Array of explicit width percentages.\n"
-      },
       {
         "name": "df-print",
         "description": "Method used to print tables in Knitr engine documents:\n\n-  `default`: Use the default S3 method for the data frame.\n-  `kable`: Markdown table using the `knitr::kable()` function.\n-  `tibble`: Plain text table using the `tibble` package.\n-  `paged`: HTML table with paging for row and column overflow.\n\nThe default printing method is `kable`.\n"
@@ -184,6 +180,16 @@
       }
     ]
   },
+  {
+    "name": "crossref",
+    "title": "Cross-References",
+    "options": [
+      {
+        "name": "crossref",
+        "description": "Configuration for crossref labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
+      }
+    ]
+  },
   {
     "name": "citation",
     "title": "Citation",

diff --git a/docs/reference/formats/haddock.json b/docs/reference/formats/haddock.json
@@ -156,10 +156,6 @@
     "name": "tables",
     "title": "Tables",
     "options": [
-      {
-        "name": "tbl-colwidths",
-        "description": "Apply explicit table column widths for markdown grid tables and pipe\ntables that are more than `columns` characters wide (72 by default). \n\nSome formats (e.g. HTML) do an excellent job automatically sizing\ntable columns and so don't benefit much from column width specifications.\nOther formats (e.g. LaTeX) require table column sizes in order to \ncorrectly flow longer cell content (this is a major reason why tables \n> 72 columns wide are assigned explicit widths by Pandoc).\n\nThis can be specified as:\n\n- `auto`: Apply markdown table column widths except when there is a\n  hyperlink in the table (which tends to throw off automatic\n  calculation of column widths based on the markdown text width of cells).\n  (`auto` is the default for HTML output formats)\n\n- `true`: Always apply markdown table widths (`true` is the default\n  for all non-HTML formats)\n\n- `false`: Never apply markdown table widths.\n\n- An array of numbers (e.g. `[40, 30, 30]`): Array of explicit width percentages.\n"
-      },
       {
         "name": "df-print",
         "description": "Method used to print tables in Knitr engine documents:\n\n-  `default`: Use the default S3 method for the data frame.\n-  `kable`: Markdown table using the `knitr::kable()` function.\n-  `tibble`: Plain text table using the `tibble` package.\n-  `paged`: HTML table with paging for row and column overflow.\n\nThe default printing method is `kable`.\n"
@@ -188,6 +184,16 @@
       }
     ]
   },
+  {
+    "name": "crossref",
+    "title": "Cross-References",
+    "options": [
+      {
+        "name": "crossref",
+        "description": "Configuration for crossref labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
+      }
+    ]
+  },
   {
     "name": "citation",
     "title": "Citation",

diff --git a/docs/reference/formats/html.json b/docs/reference/formats/html.json
@@ -105,7 +105,7 @@
       },
       {
         "name": "toc-location",
-        "description": "Location for table of contents (`body`, `left`, `right` (default), 'left-body', 'right-body').\n`body` - Show the Table of Contents in the center body of the document.\n`left` - Show the Table of Contents in left margin of the document.\n`right` - Show the Table of Contents in right margin of the document.\n`left-body` - Show two Tables of Contents in both the center body and the left margin of the document.\n`right-body` - Show two Tables of Contents in both the center body and the right margin of the document.\n"
+        "description": "Location for table of contents:\n\n- `body`: Show the Table of Contents in the center body of the document. \n- `left`: Show the Table of Contents in left margin of the document.\n- `right`(default): Show the Table of Contents in right margin of the document.\n- `left-body`: Show two Tables of Contents in both the center body and the left margin of the document.\n- `right-body`: Show two Tables of Contents in both the center body and the right margin of the document.\n"
       },
       {
         "name": "toc-title",
@@ -500,6 +500,20 @@
       }
     ]
   },
+  {
+    "name": "crossref",
+    "title": "Cross-References",
+    "options": [
+      {
+        "name": "crossref",
+        "description": "Configuration for crossref labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
+      },
+      {
+        "name": "crossrefs-hover",
+        "description": "Enables a hover popup for cross references that shows the item being referenced."
+      }
+    ]
+  },
   {
     "name": "citation",
     "title": "Citation",