diff --git a/docs/cli/cli-info.json b/docs/cli/cli-info.json index 0ccbfe7887..a20385d2de 100644 --- a/docs/cli/cli-info.json +++ b/docs/cli/cli-info.json @@ -1,5 +1,5 @@ { - "version": "1.11.1", + "version": "1.9.10", "commands": [ { "name": "render", @@ -1210,112 +1210,6 @@ "equalsSign": false, "typeDefinition": "" }, - { - "global": true, - "name": "quiet", - "description": "Suppress console output.", - "args": [], - "flags": [ - "--quiet" - ], - "equalsSign": false, - "typeDefinition": "" - } - ], - "usage": "", - "examples": [ - { - "name": "Configure project to use Binder", - "description": "quarto use binder" - } - ], - "commands": [] - }, - { - "name": "brand", - "hidden": false, - "description": "Use a brand for this project.", - "options": [ - { - "name": "force", - "description": "Skip all prompts and confirmations", - "args": [], - "flags": [ - "--force" - ], - "equalsSign": false, - "typeDefinition": "" - }, - { - "name": "dry-run", - "description": "Show what would happen without making changes", - "args": [], - "flags": [ - "--dry-run" - ], - "equalsSign": false, - "typeDefinition": "" - }, - { - "global": true, - "name": "log", - "description": "Path to log file", - "args": [ - { - "optional": false, - "name": "file", - "action": "string", - "variadic": false, - "list": false, - "type": "string" - } - ], - "flags": [ - "--log" - ], - "equalsSign": false, - "typeDefinition": "" - }, - { - "global": true, - "name": "log-level", - "description": "Log level (debug, info, warning, error, critical)", - "args": [ - { - "optional": false, - "name": "level", - "action": "string", - "variadic": false, - "list": false, - "type": "string" - } - ], - "flags": [ - "--log-level" - ], - "equalsSign": false, - "typeDefinition": "" - }, - { - "global": true, - "name": "log-format", - "description": "Log format (plain, json-stream)", - "args": [ - { - "optional": false, - "name": "format", - "action": "string", - "variadic": false, - "list": false, - "type": "string" - } - ], - "flags": [ - "--log-format" - ], - "equalsSign": false, - "typeDefinition": "" - }, { "global": true, "name": "quiet", @@ -1339,11 +1233,11 @@ "typeDefinition": "" } ], - "usage": "", + "usage": "", "examples": [ { - "name": "Use a brand from Github", - "description": "quarto use brand /" + "name": "Configure project to use Binder", + "description": "quarto use binder" } ], "commands": [] @@ -1532,7 +1426,7 @@ { "name": "update", "hidden": false, - "description": "Updates an extension or global dependency (TinyTeX, Chromium (deprecated), Chrome Headless Shell, VeraPDF).", + "description": "Updates an extension or global dependency.", "options": [ { "standalone": true, @@ -1682,8 +1576,8 @@ "description": "quarto update tool tinytex" }, { - "name": "Update Chrome Headless Shell", - "description": "quarto update tool chrome-headless-shell" + "name": "Update Chromium", + "description": "quarto update tool chromium" }, { "name": "Choose tool to update", @@ -1972,7 +1866,7 @@ }, { "name": "engine", - "description": "Use execution engine (jupyter, knitr, markdown, ...)", + "description": "Use execution engine ([object Object], [object Object], [object Object], [object Object])", "args": [ { "optional": false, @@ -2981,7 +2875,7 @@ { "name": "install", "hidden": false, - "description": "Installs a global dependency (TinyTeX, Chromium (deprecated), Chrome Headless Shell, VeraPDF).", + "description": "Installs a global dependency (TinyTex or Chromium).", "options": [ { "standalone": true, @@ -3110,8 +3004,8 @@ "description": "quarto install tinytex" }, { - "name": "Install Chrome Headless Shell", - "description": "quarto install chrome-headless-shell" + "name": "Install Chromium", + "description": "quarto install chromium" }, { "name": "Choose tool to install", @@ -3151,7 +3045,7 @@ { "name": "uninstall", "hidden": false, - "description": "Uninstalls a global dependency (TinyTeX, Chromium (deprecated), Chrome Headless Shell, VeraPDF).", + "description": "Removes an extension.", "options": [ { "standalone": true, @@ -3276,12 +3170,8 @@ "usage": "[tool]", "examples": [ { - "name": "Uninstall TinyTeX", - "description": "quarto uninstall tinytex" - }, - { - "name": "Uninstall Chrome Headless Shell", - "description": "quarto uninstall chrome-headless-shell" + "name": "Remove extension using name", + "description": "quarto remove " } ], "commands": [ @@ -3377,7 +3267,7 @@ { "name": "publish", "hidden": false, - "description": "Publish a document or project to a provider.\n\nAvailable providers include:\n\n - Quarto Pub (quarto-pub)\n - GitHub Pages (gh-pages)\n - Posit Connect (connect)\n - Posit Connect Cloud (posit-connect-cloud)\n - Netlify (netlify)\n - Confluence (confluence)\n - Hugging Face Spaces (huggingface)\n\nAccounts are configured interactively during publishing.\nManage/remove accounts with: quarto publish accounts", + "description": "Publish a document or project to a provider.\n\nAvailable providers include:\n\n - Quarto Pub (quarto-pub)\n - GitHub Pages (gh-pages)\n - Posit Connect (connect)\n - Netlify (netlify)\n - Confluence (confluence)\n - Hugging Face Spaces (huggingface)\n\nAccounts are configured interactively during publishing.\nManage/remove accounts with: quarto publish accounts", "options": [ { "standalone": true, @@ -3600,10 +3490,6 @@ "name": "Publish with explicit credentials", "description": "quarto publish connect --server example.com --token 01A24233E294" }, - { - "name": "Publish project to Posit Connect Cloud", - "description": "quarto publish posit-connect-cloud" - }, { "name": "Publish without confirmation prompt", "description": "quarto publish --no-prompt" @@ -4490,155 +4376,20 @@ ], "equalsSign": false, "typeDefinition": "" - } - ], - "usage": " [args...:string]", - "examples": [], - "commands": [ - { - "name": "help", - "hidden": false, - "description": "Show this help or the help of a sub-command.", - "options": [ - { - "standalone": true, - "global": true, - "prepend": true, - "name": "help", - "description": "Show this help.", - "args": [], - "flags": [ - "-h", - "--help" - ], - "equalsSign": false, - "typeDefinition": "", - "aliases": [ - "h" - ] - } - ], - "usage": "[command:command]", - "examples": [], - "commands": [] - } - ] - }, - { - "name": "build-ts-extension", - "hidden": false, - "description": "Build TypeScript execution engine extensions.\n\nThis command type-checks and bundles TypeScript extensions into single JavaScript files using Quarto's bundled deno bundle.\n\nThe entry point is determined by:\n 1. [entry-point] command-line argument (if specified)\n 2. bundle.entryPoint in deno.json (if specified)\n 3. Single .ts file in src/ directory\n 4. src/mod.ts (if multiple .ts files exist)", - "options": [ - { - "standalone": true, - "global": true, - "prepend": true, - "name": "help", - "description": "Show this help.", - "args": [], - "flags": [ - "-h", - "--help" - ], - "equalsSign": false, - "typeDefinition": "", - "aliases": [ - "h" - ] - }, - { - "name": "check", - "description": "Type-check only (skip bundling)", - "args": [], - "flags": [ - "--check" - ], - "equalsSign": false, - "typeDefinition": "" - }, - { - "name": "init-config", - "description": "Generate deno.json with absolute importMap path", - "args": [], - "flags": [ - "--init-config" - ], - "equalsSign": false, - "typeDefinition": "" }, { "global": true, - "name": "log", - "description": "Path to log file", - "args": [ - { - "optional": false, - "name": "file", - "action": "string", - "variadic": false, - "list": false, - "type": "string" - } - ], - "flags": [ - "--log" - ], - "equalsSign": false, - "typeDefinition": "" - }, - { - "global": true, - "name": "log-level", - "description": "Log level (debug, info, warning, error, critical)", - "args": [ - { - "optional": false, - "name": "level", - "action": "string", - "variadic": false, - "list": false, - "type": "string" - } - ], - "flags": [ - "--log-level" - ], - "equalsSign": false, - "typeDefinition": "" - }, - { - "global": true, - "name": "log-format", - "description": "Log format (plain, json-stream)", - "args": [ - { - "optional": false, - "name": "format", - "action": "string", - "variadic": false, - "list": false, - "type": "string" - } - ], - "flags": [ - "--log-format" - ], - "equalsSign": false, - "typeDefinition": "" - }, - { - "global": true, - "name": "quiet", - "description": "Suppress console output.", + "name": "profile", + "description": "Active project profile(s)", "args": [], "flags": [ - "--quiet" + "--profile" ], "equalsSign": false, "typeDefinition": "" } ], - "usage": "[entry-point:string]", + "usage": "", "examples": [], "commands": [ { @@ -4667,132 +4418,94 @@ "usage": "[command:command]", "examples": [], "commands": [] - } - ] - }, - { - "name": "typst-gather", - "hidden": false, - "description": "Gather Typst packages for a format extension.\n\nThis command scans Typst files for @preview imports and downloads the packages to a local directory for offline use.\n\nConfiguration is determined by:\n 1. typst-gather.toml in current directory (if present)\n 2. Auto-detection from _extension.yml (template and template-partials)", - "options": [ - { - "standalone": true, - "global": true, - "prepend": true, - "name": "help", - "description": "Show this help.", - "args": [], - "flags": [ - "-h", - "--help" - ], - "equalsSign": false, - "typeDefinition": "", - "aliases": [ - "h" - ] - }, - { - "name": "init-config", - "description": "Generate a starter typst-gather.toml in current directory", - "args": [], - "flags": [ - "--init-config" - ], - "equalsSign": false, - "typeDefinition": "" }, { - "global": true, - "name": "log", - "description": "Path to log file", - "args": [ + "name": "julia", + "hidden": false, + "description": "Access functionality specific to the julia rendering engine.", + "options": [ { - "optional": false, - "name": "file", - "action": "string", - "variadic": false, - "list": false, - "type": "string" - } - ], - "flags": [ - "--log" - ], - "equalsSign": false, - "typeDefinition": "" - }, - { - "global": true, - "name": "log-level", - "description": "Log level (debug, info, warning, error, critical)", - "args": [ + "global": true, + "name": "log", + "description": "Path to log file", + "args": [ + { + "optional": false, + "name": "file", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log" + ], + "equalsSign": false, + "typeDefinition": "" + }, { - "optional": false, - "name": "level", - "action": "string", - "variadic": false, - "list": false, - "type": "string" - } - ], - "flags": [ - "--log-level" - ], - "equalsSign": false, - "typeDefinition": "" - }, - { - "global": true, - "name": "log-format", - "description": "Log format (plain, json-stream)", - "args": [ + "global": true, + "name": "log-level", + "description": "Log level (debug, info, warning, error, critical)", + "args": [ + { + "optional": false, + "name": "level", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log-level" + ], + "equalsSign": false, + "typeDefinition": "" + }, { - "optional": false, - "name": "format", - "action": "string", - "variadic": false, - "list": false, - "type": "string" - } - ], - "flags": [ - "--log-format" - ], - "equalsSign": false, - "typeDefinition": "" - }, - { - "global": true, - "name": "quiet", - "description": "Suppress console output.", - "args": [], - "flags": [ - "--quiet" - ], - "equalsSign": false, - "typeDefinition": "" - }, - { - "global": true, - "name": "profile", - "description": "Active project profile(s)", - "args": [], - "flags": [ - "--profile" - ], - "equalsSign": false, - "typeDefinition": "" - } - ], - "usage": "", - "examples": [], - "commands": [ - { - "name": "help", - "hidden": false, - "description": "Show this help or the help of a sub-command.", - "options": [ + "global": true, + "name": "log-format", + "description": "Log format (plain, json-stream)", + "args": [ + { + "optional": false, + "name": "format", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log-format" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "quiet", + "description": "Suppress console output.", + "args": [], + "flags": [ + "--quiet" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "profile", + "description": "Active project profile(s)", + "args": [], + "flags": [ + "--profile" + ], + "equalsSign": false, + "typeDefinition": "" + }, { "standalone": true, "global": true, @@ -4811,9 +4524,737 @@ ] } ], - "usage": "[command:command]", + "usage": "", "examples": [], - "commands": [] + "commands": [ + { + "name": "help", + "hidden": false, + "description": "Show this help or the help of a sub-command.", + "options": [ + { + "standalone": true, + "global": true, + "prepend": true, + "name": "help", + "description": "Show this help.", + "args": [], + "flags": [ + "-h", + "--help" + ], + "equalsSign": false, + "typeDefinition": "", + "aliases": [ + "h" + ] + } + ], + "usage": "[command:command]", + "examples": [], + "commands": [] + }, + { + "name": "status", + "hidden": false, + "description": "Get status information on the currently running Julia server process.", + "options": [ + { + "global": true, + "name": "log", + "description": "Path to log file", + "args": [ + { + "optional": false, + "name": "file", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "log-level", + "description": "Log level (debug, info, warning, error, critical)", + "args": [ + { + "optional": false, + "name": "level", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log-level" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "log-format", + "description": "Log format (plain, json-stream)", + "args": [ + { + "optional": false, + "name": "format", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log-format" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "quiet", + "description": "Suppress console output.", + "args": [], + "flags": [ + "--quiet" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "profile", + "description": "Active project profile(s)", + "args": [], + "flags": [ + "--profile" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "standalone": true, + "global": true, + "prepend": true, + "name": "help", + "description": "Show this help.", + "args": [], + "flags": [ + "-h", + "--help" + ], + "equalsSign": false, + "typeDefinition": "", + "aliases": [ + "h" + ] + } + ], + "usage": "", + "examples": [], + "commands": [ + { + "name": "help", + "hidden": false, + "description": "Show this help or the help of a sub-command.", + "options": [ + { + "standalone": true, + "global": true, + "prepend": true, + "name": "help", + "description": "Show this help.", + "args": [], + "flags": [ + "-h", + "--help" + ], + "equalsSign": false, + "typeDefinition": "", + "aliases": [ + "h" + ] + } + ], + "usage": "[command:command]", + "examples": [], + "commands": [] + } + ] + }, + { + "name": "kill", + "hidden": false, + "description": "Kill the control server if it is currently running. This will also kill all notebook worker processes.", + "options": [ + { + "global": true, + "name": "log", + "description": "Path to log file", + "args": [ + { + "optional": false, + "name": "file", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "log-level", + "description": "Log level (debug, info, warning, error, critical)", + "args": [ + { + "optional": false, + "name": "level", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log-level" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "log-format", + "description": "Log format (plain, json-stream)", + "args": [ + { + "optional": false, + "name": "format", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log-format" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "quiet", + "description": "Suppress console output.", + "args": [], + "flags": [ + "--quiet" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "profile", + "description": "Active project profile(s)", + "args": [], + "flags": [ + "--profile" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "standalone": true, + "global": true, + "prepend": true, + "name": "help", + "description": "Show this help.", + "args": [], + "flags": [ + "-h", + "--help" + ], + "equalsSign": false, + "typeDefinition": "", + "aliases": [ + "h" + ] + } + ], + "usage": "", + "examples": [], + "commands": [ + { + "name": "help", + "hidden": false, + "description": "Show this help or the help of a sub-command.", + "options": [ + { + "standalone": true, + "global": true, + "prepend": true, + "name": "help", + "description": "Show this help.", + "args": [], + "flags": [ + "-h", + "--help" + ], + "equalsSign": false, + "typeDefinition": "", + "aliases": [ + "h" + ] + } + ], + "usage": "[command:command]", + "examples": [], + "commands": [] + } + ] + }, + { + "name": "log", + "hidden": false, + "description": "Print the content of the julia server log file if it exists which can be used to diagnose problems.", + "options": [ + { + "global": true, + "name": "log", + "description": "Path to log file", + "args": [ + { + "optional": false, + "name": "file", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "log-level", + "description": "Log level (debug, info, warning, error, critical)", + "args": [ + { + "optional": false, + "name": "level", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log-level" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "log-format", + "description": "Log format (plain, json-stream)", + "args": [ + { + "optional": false, + "name": "format", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log-format" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "quiet", + "description": "Suppress console output.", + "args": [], + "flags": [ + "--quiet" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "profile", + "description": "Active project profile(s)", + "args": [], + "flags": [ + "--profile" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "standalone": true, + "global": true, + "prepend": true, + "name": "help", + "description": "Show this help.", + "args": [], + "flags": [ + "-h", + "--help" + ], + "equalsSign": false, + "typeDefinition": "", + "aliases": [ + "h" + ] + } + ], + "usage": "", + "examples": [], + "commands": [ + { + "name": "help", + "hidden": false, + "description": "Show this help or the help of a sub-command.", + "options": [ + { + "standalone": true, + "global": true, + "prepend": true, + "name": "help", + "description": "Show this help.", + "args": [], + "flags": [ + "-h", + "--help" + ], + "equalsSign": false, + "typeDefinition": "", + "aliases": [ + "h" + ] + } + ], + "usage": "[command:command]", + "examples": [], + "commands": [] + } + ] + }, + { + "name": "close", + "hidden": false, + "description": "Close the worker for a given notebook. If it is currently running, it will not be interrupted.", + "options": [ + { + "global": true, + "name": "log", + "description": "Path to log file", + "args": [ + { + "optional": false, + "name": "file", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "log-level", + "description": "Log level (debug, info, warning, error, critical)", + "args": [ + { + "optional": false, + "name": "level", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log-level" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "log-format", + "description": "Log format (plain, json-stream)", + "args": [ + { + "optional": false, + "name": "format", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log-format" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "quiet", + "description": "Suppress console output.", + "args": [], + "flags": [ + "--quiet" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "profile", + "description": "Active project profile(s)", + "args": [], + "flags": [ + "--profile" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "standalone": true, + "global": true, + "prepend": true, + "name": "help", + "description": "Show this help.", + "args": [], + "flags": [ + "-h", + "--help" + ], + "equalsSign": false, + "typeDefinition": "", + "aliases": [ + "h" + ] + }, + { + "default": false, + "name": "force", + "description": "Force closing. This will terminate the worker if it is running.", + "args": [], + "flags": [ + "-f", + "--force" + ], + "equalsSign": false, + "typeDefinition": "", + "aliases": [ + "f" + ] + } + ], + "usage": "", + "examples": [], + "commands": [ + { + "name": "help", + "hidden": false, + "description": "Show this help or the help of a sub-command.", + "options": [ + { + "standalone": true, + "global": true, + "prepend": true, + "name": "help", + "description": "Show this help.", + "args": [], + "flags": [ + "-h", + "--help" + ], + "equalsSign": false, + "typeDefinition": "", + "aliases": [ + "h" + ] + } + ], + "usage": "[command:command]", + "examples": [], + "commands": [] + } + ] + }, + { + "name": "stop", + "hidden": false, + "description": "Send a message to the server that it should close all notebooks and exit. This will fail if any notebooks are not idle.", + "options": [ + { + "global": true, + "name": "log", + "description": "Path to log file", + "args": [ + { + "optional": false, + "name": "file", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "log-level", + "description": "Log level (debug, info, warning, error, critical)", + "args": [ + { + "optional": false, + "name": "level", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log-level" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "log-format", + "description": "Log format (plain, json-stream)", + "args": [ + { + "optional": false, + "name": "format", + "action": "string", + "variadic": false, + "list": false, + "type": "string" + } + ], + "flags": [ + "--log-format" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "quiet", + "description": "Suppress console output.", + "args": [], + "flags": [ + "--quiet" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "global": true, + "name": "profile", + "description": "Active project profile(s)", + "args": [], + "flags": [ + "--profile" + ], + "equalsSign": false, + "typeDefinition": "" + }, + { + "standalone": true, + "global": true, + "prepend": true, + "name": "help", + "description": "Show this help.", + "args": [], + "flags": [ + "-h", + "--help" + ], + "equalsSign": false, + "typeDefinition": "", + "aliases": [ + "h" + ] + } + ], + "usage": "", + "examples": [], + "commands": [ + { + "name": "help", + "hidden": false, + "description": "Show this help or the help of a sub-command.", + "options": [ + { + "standalone": true, + "global": true, + "prepend": true, + "name": "help", + "description": "Show this help.", + "args": [], + "flags": [ + "-h", + "--help" + ], + "equalsSign": false, + "typeDefinition": "", + "aliases": [ + "h" + ] + } + ], + "usage": "[command:command]", + "examples": [], + "commands": [] + } + ] + } + ] } ] } diff --git a/docs/cli/includes/_call-engine-julia-close.md b/docs/cli/includes/_call-engine-julia-close.md index 9fa94a13d7..5eaf93213f 100644 --- a/docs/cli/includes/_call-engine-julia-close.md +++ b/docs/cli/includes/_call-engine-julia-close.md @@ -26,7 +26,7 @@ quarto call engine julia close --log-level - Log level (info, warning, error, critical) + Log level (debug, info, warning, error, critical) --log-format diff --git a/docs/cli/includes/_call-engine-julia-kill.md b/docs/cli/includes/_call-engine-julia-kill.md index eece62d552..d143f9669f 100644 --- a/docs/cli/includes/_call-engine-julia-kill.md +++ b/docs/cli/includes/_call-engine-julia-kill.md @@ -26,7 +26,7 @@ quarto call engine julia kill --log-level - Log level (info, warning, error, critical) + Log level (debug, info, warning, error, critical) --log-format diff --git a/docs/cli/includes/_call-engine-julia-log.md b/docs/cli/includes/_call-engine-julia-log.md index bfa2ce8090..0464a4d5de 100644 --- a/docs/cli/includes/_call-engine-julia-log.md +++ b/docs/cli/includes/_call-engine-julia-log.md @@ -26,7 +26,7 @@ quarto call engine julia log --log-level - Log level (info, warning, error, critical) + Log level (debug, info, warning, error, critical) --log-format diff --git a/docs/cli/includes/_call-engine-julia-status.md b/docs/cli/includes/_call-engine-julia-status.md index 8106158461..888a408a2b 100644 --- a/docs/cli/includes/_call-engine-julia-status.md +++ b/docs/cli/includes/_call-engine-julia-status.md @@ -26,7 +26,7 @@ quarto call engine julia status --log-level - Log level (info, warning, error, critical) + Log level (debug, info, warning, error, critical) --log-format diff --git a/docs/cli/includes/_call-engine-julia-stop.md b/docs/cli/includes/_call-engine-julia-stop.md index 7414a7d72b..15ab9e1122 100644 --- a/docs/cli/includes/_call-engine-julia-stop.md +++ b/docs/cli/includes/_call-engine-julia-stop.md @@ -26,7 +26,7 @@ quarto call engine julia stop --log-level - Log level (info, warning, error, critical) + Log level (debug, info, warning, error, critical) --log-format diff --git a/docs/cli/includes/_call-engine-julia.md b/docs/cli/includes/_call-engine-julia.md index d08c000fb8..a334da3ce8 100644 --- a/docs/cli/includes/_call-engine-julia.md +++ b/docs/cli/includes/_call-engine-julia.md @@ -26,7 +26,7 @@ quarto call engine julia --log-level - Log level (info, warning, error, critical) + Log level (debug, info, warning, error, critical) --log-format diff --git a/docs/cli/includes/_call-engine.md b/docs/cli/includes/_call-engine.md index 41a54068eb..e1cee6b5da 100644 --- a/docs/cli/includes/_call-engine.md +++ b/docs/cli/includes/_call-engine.md @@ -1,7 +1,7 @@ Access functionality specific to quarto's different rendering engines. ``` {.bash} -quarto call engine [args...:string] +quarto call engine ``` @@ -43,6 +43,11 @@ quarto call engine [args...:string] Suppress console output. + + --profile + + Active project profile(s) + ``` @@ -65,6 +70,10 @@ quarto call engine [args...:string] help Show this help or the help of a sub-command. + + julia + Access functionality specific to the julia rendering engine. + ``` diff --git a/docs/cli/includes/_call.md b/docs/cli/includes/_call.md index 94b7e0f70b..47865ac6e4 100644 --- a/docs/cli/includes/_call.md +++ b/docs/cli/includes/_call.md @@ -49,28 +49,6 @@ quarto call engine Access functionality specific to quarto's different rendering engines. - - build-ts-extension - Build TypeScript execution engine extensions. - -This command type-checks and bundles TypeScript extensions into single JavaScript files using Quarto's bundled deno bundle. - -The entry point is determined by: - 1. [entry-point] command-line argument (if specified) - 2. bundle.entryPoint in deno.json (if specified) - 3. Single .ts file in src/ directory - 4. src/mod.ts (if multiple .ts files exist) - - - typst-gather - Gather Typst packages for a format extension. - -This command scans Typst files for @preview imports and downloads the packages to a local directory for offline use. - -Configuration is determined by: - 1. typst-gather.toml in current directory (if present) - 2. Auto-detection from _extension.yml (template and template-partials) - ``` diff --git a/docs/cli/includes/_cli-commands.md b/docs/cli/includes/_cli-commands.md index fcbdbe0fa4..8a65ddcd2b 100644 --- a/docs/cli/includes/_cli-commands.md +++ b/docs/cli/includes/_cli-commands.md @@ -1,23 +1,23 @@ -|Command |Description | -|:------------|:-----------------------------------------------------------------------------------------------------------| -|[render](render.qmd)|Render files or projects to various document types. | -|[preview](preview.qmd)|Render and preview a document or website project. | -|[serve](serve.qmd)|Serve a Shiny interactive document. | -|[create](create.qmd)|Create a Quarto project or extension | -|[use](use.qmd)|Automate document or project setup tasks. | -|[add](add.qmd)|Add an extension to this folder or project | -|[update](update.qmd)|Updates an extension or global dependency (TinyTeX, Chromium (deprecated), Chrome Headless Shell, VeraPDF). | -|[remove](remove.qmd)|Removes an extension. | -|[convert](convert.qmd)|Convert documents to alternate representations. | -|[pandoc](pandoc.qmd)|Run the version of Pandoc embedded within Quarto. | -|[typst](typst.qmd)|Run the version of Typst embedded within Quarto. | -|[run](run.qmd)|Run a TypeScript, R, Python, or Lua script. | -|[list](list.qmd)|Lists an extension or global dependency. | -|[install](install.qmd)|Installs a global dependency (TinyTeX, Chromium (deprecated), Chrome Headless Shell, VeraPDF). | -|[uninstall](uninstall.qmd)|Uninstalls a global dependency (TinyTeX, Chromium (deprecated), Chrome Headless Shell, VeraPDF). | -|[tools](tools.qmd)|Display the status of Quarto installed dependencies | -|[publish](publish.qmd)|Publish a document or project to a provider. | -|[capabilities](capabilities.qmd)|Query for current capabilities (formats, engines, kernels etc.) | -|[inspect](inspect.qmd)|Inspect a Quarto project or input path. | -|[check](check.qmd)|Verify correct functioning of Quarto installation. | -|[call](call.qmd)|Access functions of Quarto subsystems such as its rendering engines. | +|Command |Description | +|:------------|:--------------------------------------------------------------------| +|[render](render.qmd)|Render files or projects to various document types. | +|[preview](preview.qmd)|Render and preview a document or website project. | +|[serve](serve.qmd)|Serve a Shiny interactive document. | +|[create](create.qmd)|Create a Quarto project or extension | +|[use](use.qmd)|Automate document or project setup tasks. | +|[add](add.qmd)|Add an extension to this folder or project | +|[update](update.qmd)|Updates an extension or global dependency. | +|[remove](remove.qmd)|Removes an extension. | +|[convert](convert.qmd)|Convert documents to alternate representations. | +|[pandoc](pandoc.qmd)|Run the version of Pandoc embedded within Quarto. | +|[typst](typst.qmd)|Run the version of Typst embedded within Quarto. | +|[run](run.qmd)|Run a TypeScript, R, Python, or Lua script. | +|[list](list.qmd)|Lists an extension or global dependency. | +|[install](install.qmd)|Installs a global dependency (TinyTex or Chromium). | +|[uninstall](uninstall.qmd)|Removes an extension. | +|[tools](tools.qmd)|Display the status of Quarto installed dependencies | +|[publish](publish.qmd)|Publish a document or project to a provider. | +|[capabilities](capabilities.qmd)|Query for current capabilities (formats, engines, kernels etc.) | +|[inspect](inspect.qmd)|Inspect a Quarto project or input path. | +|[check](check.qmd)|Verify correct functioning of Quarto installation. | +|[call](call.qmd)|Access functions of Quarto subsystems such as its rendering engines. | diff --git a/docs/cli/includes/_install.md b/docs/cli/includes/_install.md index 6f64a62392..856625cfcc 100644 --- a/docs/cli/includes/_install.md +++ b/docs/cli/includes/_install.md @@ -1,4 +1,4 @@ -Installs a global dependency (TinyTeX, Chromium (deprecated), Chrome Headless Shell, VeraPDF). +Installs a global dependency (TinyTex or Chromium). ``` {.bash} quarto install [target...] @@ -93,10 +93,10 @@ quarto install [target...] quarto install tinytex ``` -### Install Chrome Headless Shell +### Install Chromium ``` {.bash filename='Terminal'} -quarto install chrome-headless-shell +quarto install chromium ``` ### Choose tool to install diff --git a/docs/cli/includes/_publish.md b/docs/cli/includes/_publish.md index 7a793bb97c..af4538d1be 100644 --- a/docs/cli/includes/_publish.md +++ b/docs/cli/includes/_publish.md @@ -5,7 +5,6 @@ Available providers include: - Quarto Pub (quarto-pub) - GitHub Pages (gh-pages) - Posit Connect (connect) - - Posit Connect Cloud (posit-connect-cloud) - Netlify (netlify) - Confluence (confluence) - Hugging Face Spaces (huggingface) @@ -168,12 +167,6 @@ quarto publish connect quarto publish connect --server example.com --token 01A24233E294 ``` -### Publish project to Posit Connect Cloud - -``` {.bash filename='Terminal'} -quarto publish posit-connect-cloud -``` - ### Publish without confirmation prompt ``` {.bash filename='Terminal'} diff --git a/docs/cli/includes/_uninstall.md b/docs/cli/includes/_uninstall.md index 73c9db4559..8221c5be86 100644 --- a/docs/cli/includes/_uninstall.md +++ b/docs/cli/includes/_uninstall.md @@ -1,4 +1,4 @@ -Uninstalls a global dependency (TinyTeX, Chromium (deprecated), Chrome Headless Shell, VeraPDF). +Removes an extension. ``` {.bash} quarto uninstall [tool] @@ -87,15 +87,9 @@ quarto uninstall [tool] ## Examples -### Uninstall TinyTeX +### Remove extension using name ``` {.bash filename='Terminal'} -quarto uninstall tinytex -``` - -### Uninstall Chrome Headless Shell - -``` {.bash filename='Terminal'} -quarto uninstall chrome-headless-shell +quarto remove ``` diff --git a/docs/cli/includes/_update.md b/docs/cli/includes/_update.md index 2aad1f74d2..d11c9b6272 100644 --- a/docs/cli/includes/_update.md +++ b/docs/cli/includes/_update.md @@ -1,4 +1,4 @@ -Updates an extension or global dependency (TinyTeX, Chromium (deprecated), Chrome Headless Shell, VeraPDF). +Updates an extension or global dependency. ``` {.bash} quarto update [target...] @@ -111,10 +111,10 @@ quarto update extension quarto update tool tinytex ``` -### Update Chrome Headless Shell +### Update Chromium ``` {.bash filename='Terminal'} -quarto update tool chrome-headless-shell +quarto update tool chromium ``` ### Choose tool to update diff --git a/docs/cli/includes/_use-binder.md b/docs/cli/includes/_use-binder.md index 0906ce455b..af91e3bd04 100644 --- a/docs/cli/includes/_use-binder.md +++ b/docs/cli/includes/_use-binder.md @@ -43,6 +43,11 @@ quarto use binder Suppress console output. + + --profile + + Active project profile(s) + ``` diff --git a/docs/cli/includes/_use.md b/docs/cli/includes/_use.md index c276e3f108..e61061e25a 100644 --- a/docs/cli/includes/_use.md +++ b/docs/cli/includes/_use.md @@ -49,10 +49,6 @@ quarto use [target:string] binder Configure the current project with Binder support. - - brand - Use a brand for this project. - ``` diff --git a/docs/reference/cells/cells-jupyter.json b/docs/reference/cells/cells-jupyter.json index 25100b7633..c1d941e608 100644 --- a/docs/reference/cells/cells-jupyter.json +++ b/docs/reference/cells/cells-jupyter.json @@ -2281,7 +2281,6 @@ "name": "cap-location", "description": "Where to place figure and table captions (`top`, `bottom`, or `margin`)", "formats": [ - "typst", "dashboard", "html", "html4", @@ -2303,7 +2302,6 @@ "name": "fig-cap-location", "description": "Where to place figure captions (`top`, `bottom`, or `margin`)", "formats": [ - "typst", "dashboard", "html", "html4", @@ -2326,7 +2324,6 @@ "name": "tbl-cap-location", "description": "Where to place table captions (`top`, `bottom`, or `margin`)", "formats": [ - "typst", "dashboard", "html", "html4", diff --git a/docs/reference/cells/cells-knitr.json b/docs/reference/cells/cells-knitr.json index 355ebbe12e..e3d09bef20 100644 --- a/docs/reference/cells/cells-knitr.json +++ b/docs/reference/cells/cells-knitr.json @@ -4345,7 +4345,6 @@ "name": "cap-location", "description": "Where to place figure and table captions (`top`, `bottom`, or `margin`)", "formats": [ - "typst", "dashboard", "html", "html4", @@ -4367,7 +4366,6 @@ "name": "fig-cap-location", "description": "Where to place figure captions (`top`, `bottom`, or `margin`)", "formats": [ - "typst", "dashboard", "html", "html4", @@ -4390,7 +4388,6 @@ "name": "tbl-cap-location", "description": "Where to place table captions (`top`, `bottom`, or `margin`)", "formats": [ - "typst", "dashboard", "html", "html4", diff --git a/docs/reference/cells/cells-ojs.json b/docs/reference/cells/cells-ojs.json index 057b369b1a..2fe7d11c48 100644 --- a/docs/reference/cells/cells-ojs.json +++ b/docs/reference/cells/cells-ojs.json @@ -2107,7 +2107,6 @@ "name": "cap-location", "description": "Where to place figure and table captions (`top`, `bottom`, or `margin`)", "formats": [ - "typst", "dashboard", "html", "html4", @@ -2129,7 +2128,6 @@ "name": "fig-cap-location", "description": "Where to place figure captions (`top`, `bottom`, or `margin`)", "formats": [ - "typst", "dashboard", "html", "html4", @@ -2152,7 +2150,6 @@ "name": "tbl-cap-location", "description": "Where to place table captions (`top`, `bottom`, or `margin`)", "formats": [ - "typst", "dashboard", "html", "html4", diff --git a/docs/reference/formats/asciidoc.json b/docs/reference/formats/asciidoc.json index a20fd7cfa4..06f12c30b2 100644 --- a/docs/reference/formats/asciidoc.json +++ b/docs/reference/formats/asciidoc.json @@ -71,6 +71,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/context.json b/docs/reference/formats/context.json index fc0a12cea9..d336130117 100644 --- a/docs/reference/formats/context.json +++ b/docs/reference/formats/context.json @@ -113,7 +113,7 @@ }, { "name": "linestretch", - "description": "For HTML output sets the CSS `line-height` property on the html\nelement, which is preferred to be unitless.\n\nFor LaTeX output, adjusts line spacing using the\n[setspace](https://ctan.org/pkg/setspace) package, e.g. 1.25, 1.5.\n\nFor Typst output, adjusts the spacing between lines of text.\n" + "description": "For HTML output sets the CSS `line-height` property on the html \nelement, which is preferred to be unitless.\n\nFor LaTeX output, adjusts line spacing using the \n[setspace](https://ctan.org/pkg/setspace) package, e.g. 1.25, 1.5.\n" }, { "name": "interlinespace", @@ -135,7 +135,7 @@ "options": [ { "name": "linkcolor", - "description": "For HTML output, sets the CSS `color` property on all links.\n\nFor LaTeX output, The color used for internal links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor),\nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor ConTeXt output, sets the color for both external links and links within the document.\n\nFor Typst output, sets the color of internal hyperlinks using Typst color syntax.\n" + "description": "For HTML output, sets the CSS `color` property on all links.\n\nFor LaTeX output, The color used for internal links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor), \nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor ConTeXt output, sets the color for both external links and links within the document.\n" }, { "name": "contrastcolor", @@ -151,6 +151,10 @@ "name": "layout", "description": "The options for margins and text layout for this document.\n\nSee [ConTeXt Layout](https://wiki.contextgarden.net/Layout) for additional information.\n" }, + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + }, { "name": "margin-left", "description": "For HTML output, sets the `margin-left` property on the Body element.\n\nFor LaTeX output, sets the left margin if `geometry` is not \nused (otherwise `geometry` overrides this value)\n\nFor ConTeXt output, sets the left margin if `layout` is not used, \notherwise `layout` overrides these.\n\nFor `wkhtmltopdf` sets the left page margin.\n" diff --git a/docs/reference/formats/dashboard.json b/docs/reference/formats/dashboard.json index 8452bbe07c..942027aca4 100644 --- a/docs/reference/formats/dashboard.json +++ b/docs/reference/formats/dashboard.json @@ -145,6 +145,10 @@ "name": "classoption", "description": "For LaTeX/PDF output, the options set for the document\nclass.\n\nFor HTML output using KaTeX, you can render display\nmath equations flush left using `classoption: fleqn`\n" }, + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + }, { "name": "max-width", "description": "Adds a css `max-width` to the body Element." @@ -200,8 +204,8 @@ "description": "The style to use when displaying code annotations. Set this value\nto false to hide code annotations.\n" }, { - "name": "syntax-highlighting", - "description": "Specifies the coloring style to be used in highlighted source code.\n\nValid values:\n\n- `none`: Disables syntax highlighting for code blocks.\n- `idiomatic`: Uses the format's native syntax highlighter\n (e.g., Typst's built-in highlighting, LaTeX `listings` package,\n or reveal.js highlight.js plugin).\n- A style name (e.g., `pygments`, `tango`, `github`): Uses\n Pandoc's skylighting with the specified theme.\n- A path to a `.theme` file: Uses a custom KDE syntax\n highlighting theme.\n\nFor adaptive light/dark themes, specify an object with `light`\nand `dark` properties pointing to theme files.\n" + "name": "highlight-style", + "description": "Specifies the coloring style to be used in highlighted source code.\n\nInstead of a *STYLE* name, a JSON file with extension\n` .theme` may be supplied. This will be parsed as a KDE\nsyntax highlighting theme and (if valid) used as the\nhighlighting style.\n" }, { "name": "syntax-definitions", @@ -390,16 +394,6 @@ } ] }, - { - "name": "a11y", - "title": "Accessibility", - "options": [ - { - "name": "axe", - "description": "When defined, run axe-core accessibility tests on the document." - } - ] - }, { "name": "includes", "title": "Includes", diff --git a/docs/reference/formats/docbook.json b/docs/reference/formats/docbook.json index 47ea81a5ca..f1e00f6098 100644 --- a/docs/reference/formats/docbook.json +++ b/docs/reference/formats/docbook.json @@ -61,6 +61,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/docx.json b/docs/reference/formats/docx.json index 3d91cdb6d8..7b3efb622d 100644 --- a/docs/reference/formats/docx.json +++ b/docs/reference/formats/docx.json @@ -98,6 +98,10 @@ { "name": "page-width", "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", + "description": "Properties of the grid system used to layout Quarto HTML pages." } ] }, @@ -110,8 +114,8 @@ "description": "The style to use when displaying code annotations. Set this value\nto false to hide code annotations.\n" }, { - "name": "syntax-highlighting", - "description": "Specifies the coloring style to be used in highlighted source code.\n\nValid values:\n\n- `none`: Disables syntax highlighting for code blocks.\n- `idiomatic`: Uses the format's native syntax highlighter\n (e.g., Typst's built-in highlighting, LaTeX `listings` package,\n or reveal.js highlight.js plugin).\n- A style name (e.g., `pygments`, `tango`, `github`): Uses\n Pandoc's skylighting with the specified theme.\n- A path to a `.theme` file: Uses a custom KDE syntax\n highlighting theme.\n\nFor adaptive light/dark themes, specify an object with `light`\nand `dark` properties pointing to theme files.\n" + "name": "highlight-style", + "description": "Specifies the coloring style to be used in highlighted source code.\n\nInstead of a *STYLE* name, a JSON file with extension\n` .theme` may be supplied. This will be parsed as a KDE\nsyntax highlighting theme and (if valid) used as the\nhighlighting style.\n" }, { "name": "syntax-definitions", diff --git a/docs/reference/formats/epub.json b/docs/reference/formats/epub.json index 0c32b5b5d7..12016af2c5 100644 --- a/docs/reference/formats/epub.json +++ b/docs/reference/formats/epub.json @@ -119,6 +119,10 @@ "name": "contributor", "description": "Contributors to this publication." }, + { + "name": "subject", + "description": "The subject of the publication." + }, { "name": "type", "description": "Text describing the specialized type of this publication.\n\nAn informative registry of specialized EPUB Publication \ntypes for use with this element is maintained in the \n[TypesRegistry](https://www.w3.org/publishing/epub32/epub-packages.html#bib-typesregistry), \nbut Authors may use any text string as a value.\n" @@ -181,6 +185,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "formatting", "title": "Formatting", @@ -220,8 +234,8 @@ "description": "The style to use when displaying code annotations. Set this value\nto false to hide code annotations.\n" }, { - "name": "syntax-highlighting", - "description": "Specifies the coloring style to be used in highlighted source code.\n\nValid values:\n\n- `none`: Disables syntax highlighting for code blocks.\n- `idiomatic`: Uses the format's native syntax highlighter\n (e.g., Typst's built-in highlighting, LaTeX `listings` package,\n or reveal.js highlight.js plugin).\n- A style name (e.g., `pygments`, `tango`, `github`): Uses\n Pandoc's skylighting with the specified theme.\n- A path to a `.theme` file: Uses a custom KDE syntax\n highlighting theme.\n\nFor adaptive light/dark themes, specify an object with `light`\nand `dark` properties pointing to theme files.\n" + "name": "highlight-style", + "description": "Specifies the coloring style to be used in highlighted source code.\n\nInstead of a *STYLE* name, a JSON file with extension\n` .theme` may be supplied. This will be parsed as a KDE\nsyntax highlighting theme and (if valid) used as the\nhighlighting style.\n" }, { "name": "syntax-definitions", @@ -410,10 +424,6 @@ "name": "metadata", "title": "Metadata", "options": [ - { - "name": "subject", - "description": "The document subject" - }, { "name": "date-meta", "description": "Sets the date metadata for the document" diff --git a/docs/reference/formats/fb2.json b/docs/reference/formats/fb2.json index 3b691ea253..c12d254f16 100644 --- a/docs/reference/formats/fb2.json +++ b/docs/reference/formats/fb2.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/haddock.json b/docs/reference/formats/haddock.json index 152bdffede..a2206752a0 100644 --- a/docs/reference/formats/haddock.json +++ b/docs/reference/formats/haddock.json @@ -71,6 +71,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/html.json b/docs/reference/formats/html.json index d6c7672966..97e3e50b18 100644 --- a/docs/reference/formats/html.json +++ b/docs/reference/formats/html.json @@ -177,7 +177,7 @@ }, { "name": "linestretch", - "description": "For HTML output sets the CSS `line-height` property on the html\nelement, which is preferred to be unitless.\n\nFor LaTeX output, adjusts line spacing using the\n[setspace](https://ctan.org/pkg/setspace) package, e.g. 1.25, 1.5.\n\nFor Typst output, adjusts the spacing between lines of text.\n" + "description": "For HTML output sets the CSS `line-height` property on the html \nelement, which is preferred to be unitless.\n\nFor LaTeX output, adjusts line spacing using the \n[setspace](https://ctan.org/pkg/setspace) package, e.g. 1.25, 1.5.\n" } ] }, @@ -191,7 +191,7 @@ }, { "name": "linkcolor", - "description": "For HTML output, sets the CSS `color` property on all links.\n\nFor LaTeX output, The color used for internal links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor),\nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor ConTeXt output, sets the color for both external links and links within the document.\n\nFor Typst output, sets the color of internal hyperlinks using Typst color syntax.\n" + "description": "For HTML output, sets the CSS `color` property on all links.\n\nFor LaTeX output, The color used for internal links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor), \nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor ConTeXt output, sets the color for both external links and links within the document.\n" }, { "name": "monobackgroundcolor", @@ -229,7 +229,7 @@ }, { "name": "grid", - "description": "Properties of the grid system used to layout Quarto HTML and Typst pages." + "description": "Properties of the grid system used to layout Quarto HTML pages." }, { "name": "appendix-style", @@ -322,8 +322,8 @@ "description": "Specifies to apply a background color on code blocks. Provide a hex color to specify that the background color is\nenabled as well as the color of the background.\n" }, { - "name": "syntax-highlighting", - "description": "Specifies the coloring style to be used in highlighted source code.\n\nValid values:\n\n- `none`: Disables syntax highlighting for code blocks.\n- `idiomatic`: Uses the format's native syntax highlighter\n (e.g., Typst's built-in highlighting, LaTeX `listings` package,\n or reveal.js highlight.js plugin).\n- A style name (e.g., `pygments`, `tango`, `github`): Uses\n Pandoc's skylighting with the specified theme.\n- A path to a `.theme` file: Uses a custom KDE syntax\n highlighting theme.\n\nFor adaptive light/dark themes, specify an object with `light`\nand `dark` properties pointing to theme files.\n" + "name": "highlight-style", + "description": "Specifies the coloring style to be used in highlighted source code.\n\nInstead of a *STYLE* name, a JSON file with extension\n` .theme` may be supplied. This will be parsed as a KDE\nsyntax highlighting theme and (if valid) used as the\nhighlighting style.\n" }, { "name": "syntax-definitions", @@ -572,16 +572,6 @@ } ] }, - { - "name": "a11y", - "title": "Accessibility", - "options": [ - { - "name": "axe", - "description": "When defined, run axe-core accessibility tests on the document." - } - ] - }, { "name": "includes", "title": "Includes", diff --git a/docs/reference/formats/icml.json b/docs/reference/formats/icml.json index 3b691ea253..c12d254f16 100644 --- a/docs/reference/formats/icml.json +++ b/docs/reference/formats/icml.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/ipynb.json b/docs/reference/formats/ipynb.json index 3df560c4f5..bf84e4c9c5 100644 --- a/docs/reference/formats/ipynb.json +++ b/docs/reference/formats/ipynb.json @@ -75,6 +75,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/jats.json b/docs/reference/formats/jats.json index e94e5ec03f..69bc5fd50c 100644 --- a/docs/reference/formats/jats.json +++ b/docs/reference/formats/jats.json @@ -85,6 +85,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/man.json b/docs/reference/formats/man.json index a4a3635a09..8f3713e0e0 100644 --- a/docs/reference/formats/man.json +++ b/docs/reference/formats/man.json @@ -57,6 +57,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "formatting", "title": "Formatting", diff --git a/docs/reference/formats/markdown/commonmark.json b/docs/reference/formats/markdown/commonmark.json index 5067829cbd..73e871a068 100644 --- a/docs/reference/formats/markdown/commonmark.json +++ b/docs/reference/formats/markdown/commonmark.json @@ -79,6 +79,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/markdown/gfm.json b/docs/reference/formats/markdown/gfm.json index 3bb6e685c2..32bed8a6a9 100644 --- a/docs/reference/formats/markdown/gfm.json +++ b/docs/reference/formats/markdown/gfm.json @@ -87,6 +87,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/markdown/hugo.json b/docs/reference/formats/markdown/hugo.json index 3bb6e685c2..32bed8a6a9 100644 --- a/docs/reference/formats/markdown/hugo.json +++ b/docs/reference/formats/markdown/hugo.json @@ -87,6 +87,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/markdown/markua.json b/docs/reference/formats/markdown/markua.json index 5067829cbd..73e871a068 100644 --- a/docs/reference/formats/markdown/markua.json +++ b/docs/reference/formats/markdown/markua.json @@ -79,6 +79,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/ms.json b/docs/reference/formats/ms.json index 659b59a00a..4b3e475722 100644 --- a/docs/reference/formats/ms.json +++ b/docs/reference/formats/ms.json @@ -105,6 +105,10 @@ "name": "layout", "title": "Layout", "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + }, { "name": "indent", "description": "Whether to use document class settings for indentation. If the document \nclass settings are not used, the default LaTeX template removes indentation \nand adds space between paragraphs\n\nFor groff (`ms`) documents, the paragraph indent, for example, `2m`.\n" @@ -124,8 +128,8 @@ "description": "The style to use when displaying code annotations. Set this value\nto false to hide code annotations.\n" }, { - "name": "syntax-highlighting", - "description": "Specifies the coloring style to be used in highlighted source code.\n\nValid values:\n\n- `none`: Disables syntax highlighting for code blocks.\n- `idiomatic`: Uses the format's native syntax highlighter\n (e.g., Typst's built-in highlighting, LaTeX `listings` package,\n or reveal.js highlight.js plugin).\n- A style name (e.g., `pygments`, `tango`, `github`): Uses\n Pandoc's skylighting with the specified theme.\n- A path to a `.theme` file: Uses a custom KDE syntax\n highlighting theme.\n\nFor adaptive light/dark themes, specify an object with `light`\nand `dark` properties pointing to theme files.\n" + "name": "highlight-style", + "description": "Specifies the coloring style to be used in highlighted source code.\n\nInstead of a *STYLE* name, a JSON file with extension\n` .theme` may be supplied. This will be parsed as a KDE\nsyntax highlighting theme and (if valid) used as the\nhighlighting style.\n" }, { "name": "syntax-definitions", diff --git a/docs/reference/formats/muse.json b/docs/reference/formats/muse.json index 06169dd00f..6b09056c43 100644 --- a/docs/reference/formats/muse.json +++ b/docs/reference/formats/muse.json @@ -71,6 +71,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/odt.json b/docs/reference/formats/odt.json index 1101646bea..ea8629e071 100644 --- a/docs/reference/formats/odt.json +++ b/docs/reference/formats/odt.json @@ -90,6 +90,10 @@ { "name": "page-width", "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", + "description": "Properties of the grid system used to layout Quarto HTML pages." } ] }, diff --git a/docs/reference/formats/opml.json b/docs/reference/formats/opml.json index 3b691ea253..c12d254f16 100644 --- a/docs/reference/formats/opml.json +++ b/docs/reference/formats/opml.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/org.json b/docs/reference/formats/org.json index 3b691ea253..c12d254f16 100644 --- a/docs/reference/formats/org.json +++ b/docs/reference/formats/org.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/pdf.json b/docs/reference/formats/pdf.json index f4d5edba3f..cd6bba2312 100644 --- a/docs/reference/formats/pdf.json +++ b/docs/reference/formats/pdf.json @@ -149,7 +149,7 @@ }, { "name": "mathfont", - "description": "For LaTeX output, the math font family for use with `xelatex` or\n`lualatex`. Takes the name of any system font, using the\n[`fontspec`](https://ctan.org/pkg/fontspec) package.\n\nFor Typst output, sets the font used for mathematical content.\n" + "description": "The math font family for use with `xelatex` or \n`lualatex`. Takes the name of any system font, using the\n[`fontspec`](https://ctan.org/pkg/fontspec) package.\n" }, { "name": "CJKmainfont", @@ -181,7 +181,7 @@ }, { "name": "linestretch", - "description": "For HTML output sets the CSS `line-height` property on the html\nelement, which is preferred to be unitless.\n\nFor LaTeX output, adjusts line spacing using the\n[setspace](https://ctan.org/pkg/setspace) package, e.g. 1.25, 1.5.\n\nFor Typst output, adjusts the spacing between lines of text.\n" + "description": "For HTML output sets the CSS `line-height` property on the html \nelement, which is preferred to be unitless.\n\nFor LaTeX output, adjusts line spacing using the \n[setspace](https://ctan.org/pkg/setspace) package, e.g. 1.25, 1.5.\n" } ] }, @@ -191,15 +191,15 @@ "options": [ { "name": "linkcolor", - "description": "For HTML output, sets the CSS `color` property on all links.\n\nFor LaTeX output, The color used for internal links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor),\nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor ConTeXt output, sets the color for both external links and links within the document.\n\nFor Typst output, sets the color of internal hyperlinks using Typst color syntax.\n" + "description": "For HTML output, sets the CSS `color` property on all links.\n\nFor LaTeX output, The color used for internal links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor), \nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor ConTeXt output, sets the color for both external links and links within the document.\n" }, { "name": "filecolor", - "description": "For LaTeX output, the color used for external links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor),\nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor Typst output, sets the color of external file links using Typst color syntax.\n" + "description": "The color used for external links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor), \nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n" }, { "name": "citecolor", - "description": "For LaTeX output, the color used for citation links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor),\nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor Typst output, sets the color of citation links using Typst color syntax.\n" + "description": "The color used for citation links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor), \nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n" }, { "name": "urlcolor", @@ -247,6 +247,10 @@ "name": "papersize", "description": "The paper size for the document.\n" }, + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + }, { "name": "margin-left", "description": "For HTML output, sets the `margin-left` property on the Body element.\n\nFor LaTeX output, sets the left margin if `geometry` is not \nused (otherwise `geometry` overrides this value)\n\nFor ConTeXt output, sets the left margin if `layout` is not used, \notherwise `layout` overrides these.\n\nFor `wkhtmltopdf` sets the left page margin.\n" @@ -302,8 +306,8 @@ "description": "Specifies to apply a background color on code blocks. Provide a hex color to specify that the background color is\nenabled as well as the color of the background.\n" }, { - "name": "syntax-highlighting", - "description": "Specifies the coloring style to be used in highlighted source code.\n\nValid values:\n\n- `none`: Disables syntax highlighting for code blocks.\n- `idiomatic`: Uses the format's native syntax highlighter\n (e.g., Typst's built-in highlighting, LaTeX `listings` package,\n or reveal.js highlight.js plugin).\n- A style name (e.g., `pygments`, `tango`, `github`): Uses\n Pandoc's skylighting with the specified theme.\n- A path to a `.theme` file: Uses a custom KDE syntax\n highlighting theme.\n\nFor adaptive light/dark themes, specify an object with `light`\nand `dark` properties pointing to theme files.\n" + "name": "highlight-style", + "description": "Specifies the coloring style to be used in highlighted source code.\n\nInstead of a *STYLE* name, a JSON file with extension\n` .theme` may be supplied. This will be parsed as a KDE\nsyntax highlighting theme and (if valid) used as the\nhighlighting style.\n" }, { "name": "syntax-definitions", @@ -522,10 +526,6 @@ "name": "language", "description": "YAML file containing custom language translations" }, - { - "name": "shorthands", - "description": "Enable babel language-specific shorthands in LaTeX output. When `true`,\nbabel's language shortcuts are enabled (e.g., French `<<`/`>>` for guillemets,\nGerman `\"` shortcuts, proper spacing around French punctuation).\n\nDefault is `false` because language shorthands can interfere with code blocks\nand other content. Only enable if you need specific typographic features\nfor your language.\n" - }, { "name": "dir", "description": "The base script direction for the document (`rtl` or `ltr`).\n\nFor bidirectional documents, native pandoc `span`s and\n`div`s with the `dir` attribute can\nbe used to override the base direction in some output\nformats. This may not always be necessary if the final\nrenderer (e.g. the browser, when generating HTML) supports\nthe [Unicode Bidirectional Algorithm].\n\nWhen using LaTeX for bidirectional documents, only the\n`xelatex` engine is fully supported (use\n`--pdf-engine=xelatex`).\n" @@ -716,16 +716,6 @@ } ] }, - { - "name": "pdfa", - "title": "PDF/A", - "options": [ - { - "name": "pdf-standard", - "description": "Specifies PDF conformance standards and/or version for the output.\n\nAccepts a single value or array of values:\n\n**PDF versions** (both Typst and LaTeX):\n`1.4`, `1.5`, `1.6`, `1.7`, `2.0`\n\n**PDF/A standards** (both engines):\n`a-1b`, `a-2a`, `a-2b`, `a-2u`, `a-3a`, `a-3b`, `a-3u`, `a-4`, `a-4f`\n\n**PDF/A standards** (Typst only):\n`a-1a`, `a-4e`\n\n**PDF/UA standards**:\n`ua-1` (Typst), `ua-2` (LaTeX)\n\n**PDF/X standards** (LaTeX only):\n`x-4`, `x-4p`, `x-5g`, `x-5n`, `x-5pg`, `x-6`, `x-6n`, `x-6p`\n\nExample: `pdf-standard: [a-2b, ua-2]` for accessible archival PDF.\n" - } - ] - }, { "name": "text", "title": "Text Output", diff --git a/docs/reference/formats/presentations/beamer.json b/docs/reference/formats/presentations/beamer.json index 7b9645cf69..331d2df961 100644 --- a/docs/reference/formats/presentations/beamer.json +++ b/docs/reference/formats/presentations/beamer.json @@ -223,7 +223,7 @@ }, { "name": "mathfont", - "description": "For LaTeX output, the math font family for use with `xelatex` or\n`lualatex`. Takes the name of any system font, using the\n[`fontspec`](https://ctan.org/pkg/fontspec) package.\n\nFor Typst output, sets the font used for mathematical content.\n" + "description": "The math font family for use with `xelatex` or \n`lualatex`. Takes the name of any system font, using the\n[`fontspec`](https://ctan.org/pkg/fontspec) package.\n" }, { "name": "CJKmainfont", @@ -255,7 +255,7 @@ }, { "name": "linestretch", - "description": "For HTML output sets the CSS `line-height` property on the html\nelement, which is preferred to be unitless.\n\nFor LaTeX output, adjusts line spacing using the\n[setspace](https://ctan.org/pkg/setspace) package, e.g. 1.25, 1.5.\n\nFor Typst output, adjusts the spacing between lines of text.\n" + "description": "For HTML output sets the CSS `line-height` property on the html \nelement, which is preferred to be unitless.\n\nFor LaTeX output, adjusts line spacing using the \n[setspace](https://ctan.org/pkg/setspace) package, e.g. 1.25, 1.5.\n" } ] }, @@ -265,15 +265,15 @@ "options": [ { "name": "linkcolor", - "description": "For HTML output, sets the CSS `color` property on all links.\n\nFor LaTeX output, The color used for internal links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor),\nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor ConTeXt output, sets the color for both external links and links within the document.\n\nFor Typst output, sets the color of internal hyperlinks using Typst color syntax.\n" + "description": "For HTML output, sets the CSS `color` property on all links.\n\nFor LaTeX output, The color used for internal links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor), \nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor ConTeXt output, sets the color for both external links and links within the document.\n" }, { "name": "filecolor", - "description": "For LaTeX output, the color used for external links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor),\nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor Typst output, sets the color of external file links using Typst color syntax.\n" + "description": "The color used for external links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor), \nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n" }, { "name": "citecolor", - "description": "For LaTeX output, the color used for citation links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor),\nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor Typst output, sets the color of citation links using Typst color syntax.\n" + "description": "The color used for citation links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor), \nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n" }, { "name": "urlcolor", @@ -321,6 +321,10 @@ "name": "papersize", "description": "The paper size for the document.\n" }, + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + }, { "name": "margin-left", "description": "For HTML output, sets the `margin-left` property on the Body element.\n\nFor LaTeX output, sets the left margin if `geometry` is not \nused (otherwise `geometry` overrides this value)\n\nFor ConTeXt output, sets the left margin if `layout` is not used, \notherwise `layout` overrides these.\n\nFor `wkhtmltopdf` sets the left page margin.\n" @@ -376,8 +380,8 @@ "description": "Specifies to apply a background color on code blocks. Provide a hex color to specify that the background color is\nenabled as well as the color of the background.\n" }, { - "name": "syntax-highlighting", - "description": "Specifies the coloring style to be used in highlighted source code.\n\nValid values:\n\n- `none`: Disables syntax highlighting for code blocks.\n- `idiomatic`: Uses the format's native syntax highlighter\n (e.g., Typst's built-in highlighting, LaTeX `listings` package,\n or reveal.js highlight.js plugin).\n- A style name (e.g., `pygments`, `tango`, `github`): Uses\n Pandoc's skylighting with the specified theme.\n- A path to a `.theme` file: Uses a custom KDE syntax\n highlighting theme.\n\nFor adaptive light/dark themes, specify an object with `light`\nand `dark` properties pointing to theme files.\n" + "name": "highlight-style", + "description": "Specifies the coloring style to be used in highlighted source code.\n\nInstead of a *STYLE* name, a JSON file with extension\n` .theme` may be supplied. This will be parsed as a KDE\nsyntax highlighting theme and (if valid) used as the\nhighlighting style.\n" }, { "name": "syntax-definitions", @@ -592,10 +596,6 @@ "name": "language", "description": "YAML file containing custom language translations" }, - { - "name": "shorthands", - "description": "Enable babel language-specific shorthands in LaTeX output. When `true`,\nbabel's language shortcuts are enabled (e.g., French `<<`/`>>` for guillemets,\nGerman `\"` shortcuts, proper spacing around French punctuation).\n\nDefault is `false` because language shorthands can interfere with code blocks\nand other content. Only enable if you need specific typographic features\nfor your language.\n" - }, { "name": "dir", "description": "The base script direction for the document (`rtl` or `ltr`).\n\nFor bidirectional documents, native pandoc `span`s and\n`div`s with the `dir` attribute can\nbe used to override the base direction in some output\nformats. This may not always be necessary if the final\nrenderer (e.g. the browser, when generating HTML) supports\nthe [Unicode Bidirectional Algorithm].\n\nWhen using LaTeX for bidirectional documents, only the\n`xelatex` engine is fully supported (use\n`--pdf-engine=xelatex`).\n" @@ -786,16 +786,6 @@ } ] }, - { - "name": "pdfa", - "title": "PDF/A", - "options": [ - { - "name": "pdf-standard", - "description": "Specifies PDF conformance standards and/or version for the output.\n\nAccepts a single value or array of values:\n\n**PDF versions** (both Typst and LaTeX):\n`1.4`, `1.5`, `1.6`, `1.7`, `2.0`\n\n**PDF/A standards** (both engines):\n`a-1b`, `a-2a`, `a-2b`, `a-2u`, `a-3a`, `a-3b`, `a-3u`, `a-4`, `a-4f`\n\n**PDF/A standards** (Typst only):\n`a-1a`, `a-4e`\n\n**PDF/UA standards**:\n`ua-1` (Typst), `ua-2` (LaTeX)\n\n**PDF/X standards** (LaTeX only):\n`x-4`, `x-4p`, `x-5g`, `x-5n`, `x-5pg`, `x-6`, `x-6n`, `x-6p`\n\nExample: `pdf-standard: [a-2b, ua-2]` for accessible archival PDF.\n" - } - ] - }, { "name": "text", "title": "Text Output", diff --git a/docs/reference/formats/presentations/pptx.json b/docs/reference/formats/presentations/pptx.json index b31566c710..a65c88ae67 100644 --- a/docs/reference/formats/presentations/pptx.json +++ b/docs/reference/formats/presentations/pptx.json @@ -89,6 +89,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/presentations/revealjs.json b/docs/reference/formats/presentations/revealjs.json index 45e6d68a1e..96cee55a9a 100644 --- a/docs/reference/formats/presentations/revealjs.json +++ b/docs/reference/formats/presentations/revealjs.json @@ -433,6 +433,10 @@ "name": "height", "description": "The \"normal\" height of the presentation, aspect ratio will\nbe preserved when the presentation is scaled to fit different\nresolutions. Can be specified using percentage units.\n" }, + { + "name": "margin", + "description": "For `revealjs`, the factor of the display size that should remain empty around the content (e.g. 0.1).\n\nFor `typst`, a dictionary with the fields defined in the Typst documentation:\n`x`, `y`, `top`, `bottom`, `left`, `right` (margins are specified in `cm` units,\ne.g. `5cm`).\n" + }, { "name": "min-scale", "description": "Bounds for smallest possible scale to apply to content" @@ -479,6 +483,10 @@ "name": "brand-mode", "description": "The brand mode to use for rendering the document, `light` or `dark`.\n" }, + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + }, { "name": "max-width", "description": "Adds a css `max-width` to the body Element." @@ -498,10 +506,6 @@ { "name": "margin-bottom", "description": "For HTML output, sets the `margin-bottom` property on the Body element.\n\nFor LaTeX output, sets the bottom margin if `geometry` is not \nused (otherwise `geometry` overrides this value)\n\nFor ConTeXt output, sets the bottom margin if `layout` is not used, \notherwise `layout` overrides these.\n\nFor `wkhtmltopdf` sets the bottom page margin.\n" - }, - { - "name": "margin", - "description": "For `revealjs`, the factor of the display size that should remain empty around the content (e.g. 0.1).\n\nFor `typst`, a dictionary specifying page margins. Use `x` and `y` for symmetric\nhorizontal/vertical margins, or `top`, `bottom`, `left`, `right` for\nindividual sides. Values should include units (e.g. `1.5in`, `2cm`).\n" } ] }, @@ -538,8 +542,8 @@ "description": "The style to use when displaying code annotations. Set this value\nto false to hide code annotations.\n" }, { - "name": "syntax-highlighting", - "description": "Specifies the coloring style to be used in highlighted source code.\n\nValid values:\n\n- `none`: Disables syntax highlighting for code blocks.\n- `idiomatic`: Uses the format's native syntax highlighter\n (e.g., Typst's built-in highlighting, LaTeX `listings` package,\n or reveal.js highlight.js plugin).\n- A style name (e.g., `pygments`, `tango`, `github`): Uses\n Pandoc's skylighting with the specified theme.\n- A path to a `.theme` file: Uses a custom KDE syntax\n highlighting theme.\n\nFor adaptive light/dark themes, specify an object with `light`\nand `dark` properties pointing to theme files.\n" + "name": "highlight-style", + "description": "Specifies the coloring style to be used in highlighted source code.\n\nInstead of a *STYLE* name, a JSON file with extension\n` .theme` may be supplied. This will be parsed as a KDE\nsyntax highlighting theme and (if valid) used as the\nhighlighting style.\n" }, { "name": "syntax-definitions", @@ -746,16 +750,6 @@ } ] }, - { - "name": "a11y", - "title": "Accessibility", - "options": [ - { - "name": "axe", - "description": "When defined, run axe-core accessibility tests on the document." - } - ] - }, { "name": "includes", "title": "Includes", diff --git a/docs/reference/formats/rst.json b/docs/reference/formats/rst.json index daca4ffc05..642ff5092d 100644 --- a/docs/reference/formats/rst.json +++ b/docs/reference/formats/rst.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "formatting", "title": "Formatting", diff --git a/docs/reference/formats/rtf.json b/docs/reference/formats/rtf.json index 92dd7e3d4d..86beff492b 100644 --- a/docs/reference/formats/rtf.json +++ b/docs/reference/formats/rtf.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/tei.json b/docs/reference/formats/tei.json index 0eb0f5bc17..209f4b927c 100644 --- a/docs/reference/formats/tei.json +++ b/docs/reference/formats/tei.json @@ -71,6 +71,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/texinfo.json b/docs/reference/formats/texinfo.json index 3b691ea253..c12d254f16 100644 --- a/docs/reference/formats/texinfo.json +++ b/docs/reference/formats/texinfo.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/textile.json b/docs/reference/formats/textile.json index ba0217968c..939205203f 100644 --- a/docs/reference/formats/textile.json +++ b/docs/reference/formats/textile.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/typst.json b/docs/reference/formats/typst.json index 0141ba972a..69cf98d5af 100644 --- a/docs/reference/formats/typst.json +++ b/docs/reference/formats/typst.json @@ -23,34 +23,12 @@ "name": "abstract-title", "description": "Title used to label document abstract" }, - { - "name": "thanks", - "description": "The contents of an acknowledgments footnote after the document title." - }, { "name": "order", "description": "Order for document when included in a website automatic sidebar menu." } ] }, - { - "name": "typst", - "title": "Typst", - "options": [ - { - "name": "logo", - "description": "The logo image." - }, - { - "name": "margin-geometry", - "description": "Fine-grained control over marginalia package geometry. Most users should\nuse `margin` and `grid` options instead; these values are computed automatically.\n\nUser-specified values override the computed defaults.\n" - }, - { - "name": "theorem-appearance", - "description": "Controls how theorems, lemmas, definitions, etc. are rendered:\n\n- `simple`: Plain text with bold title and italic body (default)\n- `fancy`: Colored boxes using brand colors\n- `clouds`: Rounded colored background boxes\n- `rainbow`: Colored left border with colored title\n" - } - ] - }, { "name": "options", "title": "Format Options", @@ -80,14 +58,6 @@ { "name": "toc-depth", "description": "Specify the number of section levels to include in the table of contents.\nThe default is 3\n" - }, - { - "name": "lof", - "description": "Print a list of figures in the document." - }, - { - "name": "lot", - "description": "Print a list of tables in the document." } ] }, @@ -106,10 +76,16 @@ { "name": "shift-heading-level-by", "description": "Shift heading levels by a positive or negative integer.\nFor example, with `shift-heading-level-by: -1`, level 2\nheadings become level 1 headings, and level 3 headings\nbecome level 2 headings. Headings cannot have a level\nless than 1, so a heading that would be shifted below level 1\nbecomes a regular paragraph. Exception: with a shift of -N,\na level-N heading at the beginning of the document\nreplaces the metadata title.\n" - }, + } + ] + }, + { + "name": "reveal-layout", + "title": "Slide Layout", + "options": [ { - "name": "page-numbering", - "description": "Schema to use for numbering pages, e.g. `1` or `i`, or `false` to omit page numbering.\n\nSee [Typst Numbering](https://typst.app/docs/reference/model/numbering/) \nfor additional information.\n" + "name": "margin", + "description": "For `revealjs`, the factor of the display size that should remain empty around the content (e.g. 0.1).\n\nFor `typst`, a dictionary with the fields defined in the Typst documentation:\n`x`, `y`, `top`, `bottom`, `left`, `right` (margins are specified in `cm` units,\ne.g. `5cm`).\n" } ] }, @@ -121,43 +97,13 @@ "name": "mainfont", "description": "For HTML output, sets the CSS `font-family` on the HTML element.\n\nFor LaTeX output, the main font family for use with `xelatex` or \n`lualatex`. Takes the name of any system font, using the\n[`fontspec`](https://ctan.org/pkg/fontspec) package. \n\nFor ConTeXt output, the main font family. Use the name of any \nsystem font. See [ConTeXt Fonts](https://wiki.contextgarden.net/Fonts) for more\ninformation.\n" }, - { - "name": "codefont", - "description": "For Typst output, sets the font used for displaying code. Takes\nthe name of any font available to Typst (system fonts or fonts in\ndirectories specified by `font-paths`).\n" - }, { "name": "fontsize", "description": "For HTML output, sets the base CSS `font-size` property.\n\nFor LaTeX and ConTeXt output, sets the font size for the document body text.\n" }, - { - "name": "mathfont", - "description": "For LaTeX output, the math font family for use with `xelatex` or\n`lualatex`. Takes the name of any system font, using the\n[`fontspec`](https://ctan.org/pkg/fontspec) package.\n\nFor Typst output, sets the font used for mathematical content.\n" - }, { "name": "font-paths", "description": "Locally, Typst uses installed system fonts. In addition, some custom path \ncan be specified to add directories that should be scanned for fonts.\nSetting this configuration will take precedence over any path set in TYPST_FONT_PATHS environment variable.\n" - }, - { - "name": "linestretch", - "description": "For HTML output sets the CSS `line-height` property on the html\nelement, which is preferred to be unitless.\n\nFor LaTeX output, adjusts line spacing using the\n[setspace](https://ctan.org/pkg/setspace) package, e.g. 1.25, 1.5.\n\nFor Typst output, adjusts the spacing between lines of text.\n" - } - ] - }, - { - "name": "colors", - "title": "Colors", - "options": [ - { - "name": "linkcolor", - "description": "For HTML output, sets the CSS `color` property on all links.\n\nFor LaTeX output, The color used for internal links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor),\nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor ConTeXt output, sets the color for both external links and links within the document.\n\nFor Typst output, sets the color of internal hyperlinks using Typst color syntax.\n" - }, - { - "name": "filecolor", - "description": "For LaTeX output, the color used for external links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor),\nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor Typst output, sets the color of external file links using Typst color syntax.\n" - }, - { - "name": "citecolor", - "description": "For LaTeX output, the color used for citation links using color options\nallowed by [`xcolor`](https://ctan.org/pkg/xcolor),\nincluding the `dvipsnames`, `svgnames`, and\n`x11names` lists.\n\nFor Typst output, sets the color of citation links using Typst color syntax.\n" } ] }, @@ -165,18 +111,6 @@ "name": "layout", "title": "Layout", "options": [ - { - "name": "cap-location", - "description": "Where to place figure and table captions (`top`, `bottom`, or `margin`)" - }, - { - "name": "fig-cap-location", - "description": "Where to place figure captions (`top`, `bottom`, or `margin`)" - }, - { - "name": "tbl-cap-location", - "description": "Where to place table captions (`top`, `bottom`, or `margin`)" - }, { "name": "papersize", "description": "The paper size for the document.\n" @@ -187,11 +121,7 @@ }, { "name": "grid", - "description": "Properties of the grid system used to layout Quarto HTML and Typst pages." - }, - { - "name": "margin", - "description": "For `revealjs`, the factor of the display size that should remain empty around the content (e.g. 0.1).\n\nFor `typst`, a dictionary specifying page margins. Use `x` and `y` for symmetric\nhorizontal/vertical margins, or `top`, `bottom`, `left`, `right` for\nindividual sides. Values should include units (e.g. `1.5in`, `2cm`).\n" + "description": "Properties of the grid system used to layout Quarto HTML pages." } ] }, @@ -202,14 +132,6 @@ { "name": "code-annotations", "description": "The style to use when displaying code annotations. Set this value\nto false to hide code annotations.\n" - }, - { - "name": "syntax-highlighting", - "description": "Specifies the coloring style to be used in highlighted source code.\n\nValid values:\n\n- `none`: Disables syntax highlighting for code blocks.\n- `idiomatic`: Uses the format's native syntax highlighter\n (e.g., Typst's built-in highlighting, LaTeX `listings` package,\n or reveal.js highlight.js plugin).\n- A style name (e.g., `pygments`, `tango`, `github`): Uses\n Pandoc's skylighting with the specified theme.\n- A path to a `.theme` file: Uses a custom KDE syntax\n highlighting theme.\n\nFor adaptive light/dark themes, specify an object with `light`\nand `dark` properties pointing to theme files.\n" - }, - { - "name": "syntax-definitions", - "description": "KDE language syntax definition files (XML)" } ] }, @@ -256,10 +178,6 @@ "name": "figures", "title": "Figures", "options": [ - { - "name": "fig-cap-location", - "description": "Where to place figure captions (`top`, `bottom`, or `margin`)" - }, { "name": "fig-width", "description": "Default width for figures generated by Matplotlib or R graphics.\n\nNote that with the Jupyter engine, this option has no effect when\nprovided at the cell level; it can only be provided with\ndocument or project metadata.\n" @@ -286,10 +204,6 @@ "name": "tables", "title": "Tables", "options": [ - { - "name": "tbl-cap-location", - "description": "Where to place table captions (`top`, `bottom`, or `margin`)" - }, { "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" @@ -308,10 +222,6 @@ "name": "csl", "description": "Citation Style Language file to use for formatting references." }, - { - "name": "citation-location", - "description": "Where citation information should be displayed (`document` or `margin`)" - }, { "name": "citeproc", "description": "Turn on built-in citation processing. To use this feature, you will need\nto have a document containing citations and a source of bibliographic data: \neither an external bibliography file or a list of `references` in the \ndocument's YAML metadata. You can optionally also include a `csl` \ncitation style file.\n" @@ -326,16 +236,6 @@ } ] }, - { - "name": "footnotes", - "title": "Footnotes", - "options": [ - { - "name": "reference-location", - "description": "Specify location for footnotes. Also controls the location of references, if `reference-links` is set.\n\n- `block`: Place at end of current top-level block\n- `section`: Place at end of current section\n- `margin`: Place at the margin\n- `document`: Place at end of document\n" - } - ] - }, { "name": "crossref", "title": "Cross-References", @@ -486,16 +386,6 @@ } ] }, - { - "name": "pdfa", - "title": "PDF/A", - "options": [ - { - "name": "pdf-standard", - "description": "Specifies PDF conformance standards and/or version for the output.\n\nAccepts a single value or array of values:\n\n**PDF versions** (both Typst and LaTeX):\n`1.4`, `1.5`, `1.6`, `1.7`, `2.0`\n\n**PDF/A standards** (both engines):\n`a-1b`, `a-2a`, `a-2b`, `a-2u`, `a-3a`, `a-3b`, `a-3u`, `a-4`, `a-4f`\n\n**PDF/A standards** (Typst only):\n`a-1a`, `a-4e`\n\n**PDF/UA standards**:\n`ua-1` (Typst), `ua-2` (LaTeX)\n\n**PDF/X standards** (LaTeX only):\n`x-4`, `x-4p`, `x-5g`, `x-5n`, `x-5pg`, `x-6`, `x-6n`, `x-6p`\n\nExample: `pdf-standard: [a-2b, ua-2]` for accessible archival PDF.\n" - } - ] - }, { "name": "text", "title": "Text Output", diff --git a/docs/reference/formats/wiki/dokuwiki.json b/docs/reference/formats/wiki/dokuwiki.json index 3b691ea253..c12d254f16 100644 --- a/docs/reference/formats/wiki/dokuwiki.json +++ b/docs/reference/formats/wiki/dokuwiki.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/wiki/jira.json b/docs/reference/formats/wiki/jira.json index 3b691ea253..c12d254f16 100644 --- a/docs/reference/formats/wiki/jira.json +++ b/docs/reference/formats/wiki/jira.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/wiki/mediawiki.json b/docs/reference/formats/wiki/mediawiki.json index 3b691ea253..c12d254f16 100644 --- a/docs/reference/formats/wiki/mediawiki.json +++ b/docs/reference/formats/wiki/mediawiki.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/wiki/xwiki.json b/docs/reference/formats/wiki/xwiki.json index 3b691ea253..c12d254f16 100644 --- a/docs/reference/formats/wiki/xwiki.json +++ b/docs/reference/formats/wiki/xwiki.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/formats/wiki/zimwiki.json b/docs/reference/formats/wiki/zimwiki.json index 3b691ea253..c12d254f16 100644 --- a/docs/reference/formats/wiki/zimwiki.json +++ b/docs/reference/formats/wiki/zimwiki.json @@ -67,6 +67,16 @@ } ] }, + { + "name": "layout", + "title": "Layout", + "options": [ + { + "name": "grid", + "description": "Properties of the grid system used to layout Quarto HTML pages." + } + ] + }, { "name": "code", "title": "Code", diff --git a/docs/reference/projects/announcement.json b/docs/reference/projects/announcement.json index f668f53455..95419d10be 100644 --- a/docs/reference/projects/announcement.json +++ b/docs/reference/projects/announcement.json @@ -1,7 +1,7 @@ [ { "name": "content", - "description": "The content of the announcement. Supports markdown formatting." + "description": "The content of the announcement" }, { "name": "dismissable", diff --git a/docs/reference/projects/book.json b/docs/reference/projects/book.json index 07e3729846..036016603a 100644 --- a/docs/reference/projects/book.json +++ b/docs/reference/projects/book.json @@ -483,10 +483,6 @@ "name": "reader-mode", "description": "Displays a 'reader-mode' tool which allows users to hide the sidebar and table of contents when viewing a page.\n" }, - { - "name": "llms-txt", - "description": "Generate llms.txt and .llms.md files for LLM-friendly content consumption.\n" - }, { "name": "google-analytics", "description": "Enable Google Analytics for this website" diff --git a/docs/reference/projects/navbar.json b/docs/reference/projects/navbar.json index c4d528d9ba..06ef49e9d2 100644 --- a/docs/reference/projects/navbar.json +++ b/docs/reference/projects/navbar.json @@ -1,7 +1,7 @@ [ { "name": "title", - "description": "The navbar title. Uses the project title if none is specified. Supports markdown formatting." + "description": "The navbar title. Uses the project title if none is specified." }, { "name": "logo", diff --git a/docs/reference/projects/navitem.json b/docs/reference/projects/navitem.json index 14e521b381..265416711c 100644 --- a/docs/reference/projects/navitem.json +++ b/docs/reference/projects/navitem.json @@ -17,7 +17,7 @@ }, { "name": "text", - "description": "Text to display for item (defaults to the\ndocument title if not provided). Supports markdown formatting.\n" + "description": "Text to display for item (defaults to the\ndocument title if not provided)\n" }, { "name": "rel", diff --git a/docs/reference/projects/pagefooter.json b/docs/reference/projects/pagefooter.json index 4bb39a78c4..3637d9ada4 100644 --- a/docs/reference/projects/pagefooter.json +++ b/docs/reference/projects/pagefooter.json @@ -1,15 +1,15 @@ [ { "name": "left", - "description": "Footer left content. Supports markdown formatting." + "description": "Footer left content" }, { "name": "right", - "description": "Footer right content. Supports markdown formatting." + "description": "Footer right content" }, { "name": "center", - "description": "Footer center content. Supports markdown formatting." + "description": "Footer center content" }, { "name": "border", diff --git a/docs/reference/projects/sidebar.json b/docs/reference/projects/sidebar.json index eacdcec557..f9b4cafb83 100644 --- a/docs/reference/projects/sidebar.json +++ b/docs/reference/projects/sidebar.json @@ -5,7 +5,7 @@ }, { "name": "title", - "description": "The sidebar title. Uses the project title if none is specified. Supports markdown formatting." + "description": "The sidebar title. Uses the project title if none is specified." }, { "name": "logo", diff --git a/docs/reference/projects/website.json b/docs/reference/projects/website.json index 5ff8f2f634..83a272596a 100644 --- a/docs/reference/projects/website.json +++ b/docs/reference/projects/website.json @@ -51,10 +51,6 @@ "name": "reader-mode", "description": "Displays a 'reader-mode' tool which allows users to hide the sidebar and table of contents when viewing a page.\n" }, - { - "name": "llms-txt", - "description": "Generate llms.txt and .llms.md files for LLM-friendly content consumption.\n" - }, { "name": "google-analytics", "description": "Enable Google Analytics for this website"