Update reference pages (prerelease) (#2309)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

docs/cli/cli-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.11.6",
+  "version": "1.11.7",
   "commands": [
     {
       "name": "render",

docs/reference/cells/cells-jupyter.json

@@ -1390,8 +1390,10 @@
       },
       {
         "name": "fig-alt",
-        "description": "Alternative text to be used in the `alt` attribute of HTML images.\n",
+        "description": "Alternative text for figures, distinct from their visible caption.\n",
         "formats": [
+          "docx",
+          "typst",
           "dashboard",
           "html",
           "html4",
@@ -1403,7 +1405,10 @@
           "dzslides",
           "epub",
           "epub2",
-          "epub3"
+          "epub3",
+          "latex",
+          "pdf",
+          "beamer"
         ]
       },
       {

docs/reference/cells/cells-knitr.json

@@ -2631,8 +2631,10 @@
       },
       {
         "name": "fig-alt",
-        "description": "Alternative text to be used in the `alt` attribute of HTML images.\n",
+        "description": "Alternative text for figures, distinct from their visible caption.\n",
         "formats": [
+          "docx",
+          "typst",
           "dashboard",
           "html",
           "html4",
@@ -2644,7 +2646,10 @@
           "dzslides",
           "epub",
           "epub2",
-          "epub3"
+          "epub3",
+          "latex",
+          "pdf",
+          "beamer"
         ]
       },
       {

docs/reference/cells/cells-ojs.json

@@ -1244,8 +1244,10 @@
       },
       {
         "name": "fig-alt",
-        "description": "Alternative text to be used in the `alt` attribute of HTML images.\n",
+        "description": "Alternative text for figures, distinct from their visible caption.\n",
         "formats": [
+          "docx",
+          "typst",
           "dashboard",
           "html",
           "html4",
@@ -1257,7 +1259,10 @@
           "dzslides",
           "epub",
           "epub2",
-          "epub3"
+          "epub3",
+          "latex",
+          "pdf",
+          "beamer"
         ]
       },
       {

docs/reference/formats/html.json

@@ -744,29 +744,53 @@
         "name": "repo-actions",
         "description": "Setting this to false prevents the `repo-actions` from appearing on this page.\nOther possible values are `none` or one or more of `edit`, `source`, and `issue`, *e.g.* `[edit, source, issue]`.\n"
       },
+      {
+        "name": "bread-crumbs",
+        "description": "Setting this to false hides the navigation breadcrumbs on this page."
+      },
+      {
+        "name": "back-to-top-navigation",
+        "description": "Setting this to false hides the 'back to top' navigation button on this page."
+      },
+      {
+        "name": "page-navigation",
+        "description": "Show (`true`) or hide (`false`) the next and previous page links in the footer of this page."
+      },
+      {
+        "name": "margin-header",
+        "description": "Markdown to place above margin content on this page (text or file path), after the `website` margin header."
+      },
+      {
+        "name": "margin-footer",
+        "description": "Markdown to place below margin content on this page (text or file path), after the `website` margin footer."
+      },
       {
         "name": "aliases",
         "description": "URLs that alias this document, when included in a website."
       },
       {
         "name": "image",
-        "description": "The path to a preview image for this content. By default, \nQuarto will use the image value from the site: metadata. \nIf you provide an image, you may also optionally provide \nan image-width and image-height to improve \nthe appearance of your Twitter Card.\n\nIf image is not provided, Quarto will automatically attempt \nto locate a preview image.\n"
+        "description": "The path to a preview image for this content. By default, \nQuarto will use the image value from the `website` metadata.\nTo declare the size of the preview image for Open Graph,\nset `image-width` and `image-height` under `open-graph`.\n\nIf image is not provided, Quarto will automatically attempt\nto locate a preview image.\n"
+      },
+      {
+        "name": "image-alt",
+        "description": "The alt text for preview image on this page."
       },
       {
-        "name": "image-height",
-        "description": "The height of the preview image for this document."
+        "name": "image-title",
+        "description": "The title for the main image on the about page. Used when\n`about` does not set its own `image-title`.\n"
       },
       {
-        "name": "image-width",
-        "description": "The width of the preview image for this document."
+        "name": "open-graph",
+        "description": "Publish open graph metadata for this page. Options set here are merged\nwith the `open-graph` options of the `website` metadata. Set to `false`\nto omit open graph metadata from this page.\n"
       },
       {
-        "name": "image-alt",
-        "description": "The alt text for preview image on this page."
+        "name": "twitter-card",
+        "description": "Publish twitter card metadata for this page. Options set here are merged\nwith the `twitter-card` options of the `website` metadata. Set to `false`\nto omit twitter card metadata from this page.\n"
       },
       {
         "name": "image-lazy-loading",
-        "description": "Enables lazy loading for the preview image. If true, the preview image element \nwill have `loading=\"lazy\"`, and will only load when it comes into view.\n\nIf false, the preview image will load immediately.\n"
+        "description": "Enables lazy loading for this page's image when the page appears as an item\nin a listing. If true, the listing image element will have `loading=\"lazy\"`,\nand will only load when it comes into view.\n\nIf false, the image will load immediately. This overrides the listing's\n`image-lazy-loading` option for this item.\n"
       }
     ]
   },

docs/reference/metadata/brand.json

@@ -228,7 +228,7 @@
       },
       {
         "name": "files",
-        "description": "The font files to include. These can be local or online. Local file paths should be relative to the `brand.yml` file. Online paths should be complete URLs.\n"
+        "description": "A list of font files to include. These can be local or online. Local file paths should be relative to the `brand.yml` file. Online paths should be complete URLs.\n"
       }
     ]
   },

docs/reference/projects/book.json

@@ -545,7 +545,7 @@
   },
   {
     "name": "image",
-    "description": "Default site thumbnail image for `twitter` /`open-graph`\n"
+    "description": "Default site thumbnail image for `twitter` /`open-graph`, relative to the project directory.\n"
   },
   {
     "name": "image-alt",

docs/reference/projects/feed.json

@@ -13,7 +13,7 @@
   },
   {
     "name": "image",
-    "description": "The path to an image for this feed. If not specified, the image for the page the listing \nappears on will be used, otherwise an image will be used if specified for the site \nin the Quarto project.\n"
+    "description": "The path to an image for this feed. If not specified, the image for the page the listing \nappears on will be used, otherwise an image will be used if specified for the site \nin the Quarto project. A relative path set in the listing page front matter is relative to the project directory.\n"
   },
   {
     "name": "description",

docs/reference/projects/open-graph.json

@@ -9,19 +9,11 @@
   },
   {
     "name": "image",
-    "description": "The path to a preview image for the content. By default, Quarto will use\nthe `image` value from the format metadata. If you provide an \nimage, you may also optionally provide an `image-width` and `image-height`.\n"
+    "description": "The path to a preview image for the content. By default, Quarto will use\nthe `image` value from the format metadata.\n"
   },
   {
     "name": "image-alt",
-    "description": "The alt text for the preview image. By default, Quarto will use\nthe `image-alt` value from the format metadata. If you provide an \nimage, you may also optionally provide an `image-width` and `image-height`.\n"
-  },
-  {
-    "name": "image-width",
-    "description": "Image width (pixels)"
-  },
-  {
-    "name": "image-height",
-    "description": "Image height (pixels)"
+    "description": "The alt text for the preview image. By default, Quarto will use\nthe `image-alt` value from the format metadata.\n"
   },
   {
     "name": "locale",
@@ -30,5 +22,13 @@
   {
     "name": "site-name",
     "description": "Name that should be displayed for the overall site. If not explicitly \nprovided in the `open-graph` metadata, Quarto will use the website or\nbook `title` by default.\n"
+  },
+  {
+    "name": "image-width",
+    "description": "Image width (pixels)"
+  },
+  {
+    "name": "image-height",
+    "description": "Image height (pixels)"
   }
 ]

docs/reference/projects/twitter.json

@@ -9,19 +9,11 @@
   },
   {
     "name": "image",
-    "description": "The path to a preview image for the content. By default, Quarto will use\nthe `image` value from the format metadata. If you provide an \nimage, you may also optionally provide an `image-width` and `image-height`.\n"
+    "description": "The path to a preview image for the content. By default, Quarto will use\nthe `image` value from the format metadata.\n"
   },
   {
     "name": "image-alt",
-    "description": "The alt text for the preview image. By default, Quarto will use\nthe `image-alt` value from the format metadata. If you provide an \nimage, you may also optionally provide an `image-width` and `image-height`.\n"
-  },
-  {
-    "name": "image-width",
-    "description": "Image width (pixels)"
-  },
-  {
-    "name": "image-height",
-    "description": "Image height (pixels)"
+    "description": "The alt text for the preview image. By default, Quarto will use\nthe `image-alt` value from the format metadata.\n"
   },
   {
     "name": "card-style",