Update reference pages

docs/reference/formats/asciidoc.json

@@ -29,6 +29,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "quarto-required",
         "description": "A semver version range describing the supported quarto versions for this document\nor project.\n\nExamples:\n\n- `>= 1.1.0`: Require at least quarto version 1.1\n- `1.*`: Require any quarto versions whose major version number is 1\n"
@@ -186,11 +190,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },

docs/reference/formats/context.json

@@ -33,6 +33,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "pdf-engine",
         "description": "Use the specified engine when producing PDF output. If the engine is not\nin your PATH, the full path of the engine may be specified here. If this\noption is not specified, Quarto uses the following defaults\ndepending on the output format in use:\n\n- `latex`: `xelatex` (other options: `pdflatex`, `lualatex`,\n  `tectonic`, `latexmk`)\n- `context`: `context`\n- `html`:  `wkhtmltopdf` (other options: `prince`, `weasyprint`, `pagedjs-cli`;\n  see [print-css.rocks](https://print-css.rocks) for a good\n  introduction to PDF generation from HTML/CSS.)\n- `ms`:  `pdfroff`\n- `typst`: `typst`\n"
@@ -288,11 +292,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },

docs/reference/formats/dashboard.json

@@ -55,6 +55,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "theme",
         "description": "Theme name, theme scss file, or a mix of both."
@@ -346,11 +350,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       },
       {
         "name": "crossrefs-hover",

docs/reference/formats/docbook.json

@@ -25,6 +25,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "identifier-prefix",
         "description": "Specify a prefix to be added to all identifiers and internal links in HTML and\nDocBook output, and to footnote numbers in Markdown and Haddock output. \nThis is useful for preventing duplicate identifiers when generating fragments\nto be included in other pages.\n"
@@ -176,11 +180,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },

docs/reference/formats/docx.json

@@ -41,6 +41,10 @@
         "name": "reference-doc",
         "description": "Use the specified file as a style reference in producing a docx, \npptx, or odt file.\n"
       },
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "quarto-required",
         "description": "A semver version range describing the supported quarto versions for this document\nor project.\n\nExamples:\n\n- `>= 1.1.0`: Require at least quarto version 1.1\n- `1.*`: Require any quarto versions whose major version number is 1\n"
@@ -93,7 +97,7 @@
     "options": [
       {
         "name": "page-width",
-        "description": "Target page width for output (used to compute columns widths for `layout` divs).\nDefaults to 6.5 inches, which corresponds to default letter page settings in \ndocx and odt.\n"
+        "description": "Target body page width for output (used to compute columns widths for `layout` divs).\nDefaults to 6.5 inches, which corresponds to default letter page settings in \ndocx and odt (8.5 inches with 1 inch for each margins).\n"
       },
       {
         "name": "grid",
@@ -238,11 +242,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },

docs/reference/formats/epub.json

@@ -37,6 +37,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "css",
         "description": "One or more CSS style sheets."
@@ -350,11 +354,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },

docs/reference/formats/fb2.json

@@ -25,6 +25,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "quarto-required",
         "description": "A semver version range describing the supported quarto versions for this document\nor project.\n\nExamples:\n\n- `>= 1.1.0`: Require at least quarto version 1.1\n- `1.*`: Require any quarto versions whose major version number is 1\n"
@@ -182,11 +186,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },

docs/reference/formats/haddock.json

@@ -25,6 +25,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "identifier-prefix",
         "description": "Specify a prefix to be added to all identifiers and internal links in HTML and\nDocBook output, and to footnote numbers in Markdown and Haddock output. \nThis is useful for preventing duplicate identifiers when generating fragments\nto be included in other pages.\n"
@@ -186,11 +190,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },

docs/reference/formats/html.json

@@ -45,6 +45,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "theme",
         "description": "Theme name, theme scss file, or a mix of both."
@@ -520,11 +524,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       },
       {
         "name": "crossrefs-hover",

docs/reference/formats/icml.json

@@ -25,6 +25,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "quarto-required",
         "description": "A semver version range describing the supported quarto versions for this document\nor project.\n\nExamples:\n\n- `>= 1.1.0`: Require at least quarto version 1.1\n- `1.*`: Require any quarto versions whose major version number is 1\n"
@@ -182,11 +186,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },

docs/reference/formats/ipynb.json

@@ -25,6 +25,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "markdown-headings",
         "description": "Specify whether to use `atx` (`#`-prefixed) or\n`setext` (underlined) headings for level 1 and 2\nheadings (`atx` or `setext`).\n"
@@ -190,11 +194,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },

docs/reference/formats/jats.json

@@ -53,6 +53,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "quarto-required",
         "description": "A semver version range describing the supported quarto versions for this document\nor project.\n\nExamples:\n\n- `>= 1.1.0`: Require at least quarto version 1.1\n- `1.*`: Require any quarto versions whose major version number is 1\n"
@@ -210,11 +214,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },

docs/reference/formats/man.json

@@ -25,6 +25,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "section",
         "description": "The section number in man pages."
@@ -186,11 +190,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },

docs/reference/formats/markdown/commonmark.json

@@ -25,6 +25,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "identifier-prefix",
         "description": "Specify a prefix to be added to all identifiers and internal links in HTML and\nDocBook output, and to footnote numbers in Markdown and Haddock output. \nThis is useful for preventing duplicate identifiers when generating fragments\nto be included in other pages.\n"
@@ -204,11 +208,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },

docs/reference/formats/markdown/gfm.json

@@ -25,6 +25,10 @@
     "name": "options",
     "title": "Format Options",
     "options": [
+      {
+        "name": "brand",
+        "description": "Branding information to use for this document. If a string, the path to a brand file.\nIf false, don't use branding on this document. If an object, an inline brand\ndefinition.\n"
+      },
       {
         "name": "html-math-method",
         "description": "Method use to render math in HTML output (`plain`, `webtex`, `gladtex`, `mathml`, `mathjax`, `katex`).\n\nSee the Pandoc documentation on [Math Rendering in HTML](https://pandoc.org/MANUAL.html#math-rendering-in-html)\nfor additional details.\n"
@@ -212,11 +216,11 @@
   },
   {
     "name": "crossref",
-    "title": "Crossrefs",
+    "title": "Cross-References",
     "options": [
       {
         "name": "crossref",
-        "description": "Configuration for crossref labels and prefixes."
+        "description": "Configuration for cross-reference labels and prefixes. See [Cross-Reference Options](https://quarto.org/docs/reference/metadata/crossref.html) for more details."
       }
     ]
   },