From efacf917e41ba33e84f616f6db0a20d7d869755e Mon Sep 17 00:00:00 2001 From: Carlos Scheidegger Date: Thu, 17 Oct 2024 12:56:32 -0700 Subject: [PATCH 1/2] add docs for the fix described in https://github.com/quarto-dev/quarto-cli/pull/11098 --- docs/projects/scripts.qmd | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/projects/scripts.qmd b/docs/projects/scripts.qmd index d5cb0b3627..a4c442d9df 100644 --- a/docs/projects/scripts.qmd +++ b/docs/projects/scripts.qmd @@ -69,6 +69,13 @@ If a pre-render script modifies any of these values, an error will be returned a If you have a `pre-render` step that is expensive, you may want only run it when the entire project is being rendered. Here's how you would do this in the various supported script languages: +### Advanced: large input and output file lists + +In some execution environments, the maximum size of an environment might be limited. In this case, a pre- or post-render script invocation might fail when Quarto attempts to build the appropriate environment variables. + +In such scenarios, you can declare the environment variable `QUARTO_USE_FILE_FOR_PROJECT_INPUT_FILES` (respectively, `QUARTO_USE_FILE_FOR_PROJECT_OUTPUT_FILES`) to direct Quarto to use the +declared file as the destination of the file list that would have been written in `QUARTO_PROJECT_INPUT_FILES` (respectively, `QUARTO_PROJECT_OUTPUT_FILES`). + ::: panel-tabset ## TypeScript From 6a06663308d431def8d738ba00e4cec9c7effdd0 Mon Sep 17 00:00:00 2001 From: Carlos Scheidegger Date: Thu, 17 Oct 2024 13:04:55 -0700 Subject: [PATCH 2/2] put docs in the right place --- docs/projects/scripts.qmd | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/projects/scripts.qmd b/docs/projects/scripts.qmd index a4c442d9df..e1ac034d55 100644 --- a/docs/projects/scripts.qmd +++ b/docs/projects/scripts.qmd @@ -69,13 +69,6 @@ If a pre-render script modifies any of these values, an error will be returned a If you have a `pre-render` step that is expensive, you may want only run it when the entire project is being rendered. Here's how you would do this in the various supported script languages: -### Advanced: large input and output file lists - -In some execution environments, the maximum size of an environment might be limited. In this case, a pre- or post-render script invocation might fail when Quarto attempts to build the appropriate environment variables. - -In such scenarios, you can declare the environment variable `QUARTO_USE_FILE_FOR_PROJECT_INPUT_FILES` (respectively, `QUARTO_USE_FILE_FOR_PROJECT_OUTPUT_FILES`) to direct Quarto to use the -declared file as the destination of the file list that would have been written in `QUARTO_PROJECT_INPUT_FILES` (respectively, `QUARTO_PROJECT_OUTPUT_FILES`). - ::: panel-tabset ## TypeScript @@ -110,6 +103,13 @@ end ``` ::: +### Advanced: large input and output file lists + +In some execution environments, the maximum size of an environment might be limited. In this case, a pre- or post-render script invocation might fail when Quarto attempts to build the appropriate environment variables. + +In such scenarios, you can declare the environment variable `QUARTO_USE_FILE_FOR_PROJECT_INPUT_FILES` (respectively, `QUARTO_USE_FILE_FOR_PROJECT_OUTPUT_FILES`) to direct Quarto to use the +declared file as the destination of the file list that would have been written in `QUARTO_PROJECT_INPUT_FILES` (respectively, `QUARTO_PROJECT_OUTPUT_FILES`). + ## Deno Scripts {#deno-scripts} If you want to create project scripts with TypeScript, `quarto run` enables you to use the [Deno](https://deno.land/) TypeScript interpreter bundled with Quarto. This interpreter also includes much of Deno's [standard library](https://docs.deno.com/runtime/manual/basics/standard_library). For example, to use the Deno YAML parser you would do this: