diff --git a/docs/cli/cli-info.json b/docs/cli/cli-info.json index 48aa8374d9..b9c163b07a 100644 --- a/docs/cli/cli-info.json +++ b/docs/cli/cli-info.json @@ -1,5 +1,5 @@ { - "version": "1.11.6", + "version": "1.11.7", "commands": [ { "name": "render", diff --git a/docs/reference/cells/cells-jupyter.json b/docs/reference/cells/cells-jupyter.json index 25100b7633..5898f20644 100644 --- a/docs/reference/cells/cells-jupyter.json +++ b/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" ] }, { diff --git a/docs/reference/cells/cells-knitr.json b/docs/reference/cells/cells-knitr.json index 355ebbe12e..3d1c4be61e 100644 --- a/docs/reference/cells/cells-knitr.json +++ b/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" ] }, { diff --git a/docs/reference/cells/cells-ojs.json b/docs/reference/cells/cells-ojs.json index 057b369b1a..942218a8ca 100644 --- a/docs/reference/cells/cells-ojs.json +++ b/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" ] }, { diff --git a/docs/reference/formats/html.json b/docs/reference/formats/html.json index d6c7672966..1a90172a41 100644 --- a/docs/reference/formats/html.json +++ b/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" } ] }, diff --git a/docs/reference/metadata/brand.json b/docs/reference/metadata/brand.json index 4a5f360cde..b2531fbda8 100644 --- a/docs/reference/metadata/brand.json +++ b/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" } ] }, diff --git a/docs/reference/projects/book.json b/docs/reference/projects/book.json index 07e3729846..b1bd97909a 100644 --- a/docs/reference/projects/book.json +++ b/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", diff --git a/docs/reference/projects/feed.json b/docs/reference/projects/feed.json index 7238ad7724..50154e8faf 100644 --- a/docs/reference/projects/feed.json +++ b/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", diff --git a/docs/reference/projects/open-graph.json b/docs/reference/projects/open-graph.json index a79ff00261..5a96b0f63e 100644 --- a/docs/reference/projects/open-graph.json +++ b/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)" } ] \ No newline at end of file diff --git a/docs/reference/projects/twitter.json b/docs/reference/projects/twitter.json index 4d257202fe..f2711fbc56 100644 --- a/docs/reference/projects/twitter.json +++ b/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", diff --git a/docs/reference/projects/website.json b/docs/reference/projects/website.json index 5ff8f2f634..a1af4c4d34 100644 --- a/docs/reference/projects/website.json +++ b/docs/reference/projects/website.json @@ -117,7 +117,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",