From 25096a5ef1a56b7687e9a5b2488dc4e09f8a5c8f Mon Sep 17 00:00:00 2001 From: Christophe Dervieux Date: Thu, 12 Jun 2025 10:34:58 +0200 Subject: [PATCH 1/3] switch to visual editor (cherry picked from commit e2f67a611a3bc07c027ce32df2d979eb2258fdaa) --- docs/advanced/environment-vars.qmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/advanced/environment-vars.qmd b/docs/advanced/environment-vars.qmd index babeba890f..2fc4a2a247 100644 --- a/docs/advanced/environment-vars.qmd +++ b/docs/advanced/environment-vars.qmd @@ -78,4 +78,4 @@ ENV["QUARTO_DOCUMENT_PATH"] | `QUARTO_FIG_WIDTH` and `QUARTO_FIG_HEIGHT` | Values for `fig-width` and `fig-height` as set in the document metadata | +--------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | `QUARTO_RUN_NO_NETWORK` | When `true`, Quarto project scripts written in TypeScript won't be allowed to use the network to download sources. In this setting, those scripts will not have access to the standard library. | -+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ ++--------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ \ No newline at end of file From e5bc20bfe3dea0abf1a99557f6573fb9fe6b382f Mon Sep 17 00:00:00 2001 From: Christophe Dervieux Date: Thu, 12 Jun 2025 11:06:31 +0200 Subject: [PATCH 2/3] Add mention of `--log-level` in troubleshooting section and also `--log` and `QUARTO_LOG` (cherry picked from commit 5afd0c50549675b3e4b1a21ac90da00c58b7b6b8) --- docs/troubleshooting/index.qmd | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/troubleshooting/index.qmd b/docs/troubleshooting/index.qmd index 38b1b763d9..cc8bd16323 100644 --- a/docs/troubleshooting/index.qmd +++ b/docs/troubleshooting/index.qmd @@ -105,6 +105,10 @@ export QUARTO_LOG_LEVEL=DEBUG ::: +`--log-level debug` can also be passed at command line e.g. `quarto render index.qmd --log-level debug` + +If you prefer to have the log be written to file, you can set `QUARTO_LOG` in your environment, or `--log` at command line. + ### Inspect log files {#log-files} Quarto creates log files that can help you diagnose problems. These are stored in different locations depending on your operating system: From 9bed2e25e00096d7c21fe287486ef177ad0f073f Mon Sep 17 00:00:00 2001 From: Christophe Dervieux Date: Thu, 12 Jun 2025 11:06:58 +0200 Subject: [PATCH 3/3] Add logging related environment variables to the advanced doc (cherry picked from commit e91708841fc4a2fc07dda8863f1674eb8b6e6c1b) --- docs/advanced/environment-vars.qmd | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/advanced/environment-vars.qmd b/docs/advanced/environment-vars.qmd index 2fc4a2a247..d6fa25def7 100644 --- a/docs/advanced/environment-vars.qmd +++ b/docs/advanced/environment-vars.qmd @@ -38,6 +38,14 @@ You can read about other ways to set environment variables in Quarto Projects in +---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | `QUARTO_CHROMIUM_HEADLESS_MODE` | Used for adaption of the `--headless` mode used with `QUARTO_CHROMIUM` binary. Set to `"none"` for `--headless` , or to `"old"` or `"new"` to pass as argument, e.g. `--headless=` . Quarto 1.6 sets `"old"` as default, which works from Chrome 112 to 131. Starting Quarto 1.7.13, `"none"` is the default as [Chrome 132 removed old headless mode](https://developer.chrome.com/blog/removing-headless-old-from-chrome). | +---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| `QUARTO_LOG` | Those variables controls the logging behavior: | +| | | +| `QUARTO_LOG_LEVEL` | - `QUARTO_LOG` is the same as using `--log` at command line. It is used to set the path to the log file | +| | | +| `QUARTO_LOG_FORMAT` | - `QUARTO_LOG_LEVEL` is the same as using `--log-level` at command line. It is used to set the max level that will be log. Possible values are `DEBUG`, `INFO`(default), `WARNING`, and `ERROR`. | +| | | +| | - `QUARTO_LOG_FORMAT` is the same as using `--log-format` at command line. It is used to set the format for the log. Possible values are `plain` (default) and `json-stream`. | ++---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ ## Variables Quarto sets