release notes - Escape shortcodes in changelog files when importing them as render target in quarto-web

(cherry picked from commit f92d3ca)

Author: cderv

docs/download/changelog/1.3/_changelog.md

@@ -27,7 +27,7 @@
 
 ## Jupyter Notebooks
 
-- Add support for embedding cell outputs in quarto documents using `{{< embed >}}`. You can address cells by Id, Tag, or label, such as `{{< embed mynotebook.ipynb#fig-output >}}` which would embed the output of a cell with the label `fig-output`). You can also provide a list of ids like `{{< embed mynotebook.ipynb#fig-output,tbl-out >}}`.
+- Add support for embedding cell outputs in quarto documents using `{{{< embed >}}}`. You can address cells by Id, Tag, or label, such as `{{{< embed mynotebook.ipynb#fig-output >}}}` which would embed the output of a cell with the label `fig-output`). You can also provide a list of ids like `{{{< embed mynotebook.ipynb#fig-output,tbl-out >}}}`.
 - Only attempt to postprocess `text/plain` output if it's nonempty ([#3896](https://github.com/quarto-dev/quarto-cli/issues/3896)).
 - Fix output of bokeh plots so the right number of cells is generated ([#2107](https://github.com/quarto-dev/quarto-cli/issues/2107)).
 - Fix output of code cells that contain triple backticks (or more) ([#3179](https://github.com/quarto-dev/quarto-cli/issues/3179)).

docs/download/changelog/1.5/_changelog.md

@@ -260,7 +260,7 @@
 - ([#9727](https://github.com/quarto-dev/quarto-cli/issues/9727)): `lightbox`: do not overwrite `window.onload` events.
 - ([#9792](https://github.com/quarto-dev/quarto-cli/issues/9798)): Fix a 1.5 regression where `freeze` would be accidentally triggered in single-file renders.
 - ([#10003](https://github.com/quarto-dev/quarto-cli/issues/10003)): fix Giscus light/dark theme YAML example in schema where `theme` is missing.
-- Add support for `{{< lipsum >}}` shortcode, which is useful for emitting placeholder text. Provide a specific number of paragraphs (`{{< lipsum 3 >}}`).
+- Add support for `{{{< lipsum >}}}` shortcode, which is useful for emitting placeholder text. Provide a specific number of paragraphs (`{{{< lipsum 3 >}}}`).
 - Resolve data URIs in Pandoc's mediabag when rendering documents.
 - Increase v8's max heap size by default, to avoid out-of-memory errors when rendering large documents (also cf. https://github.com/denoland/deno/issues/18935).
 - When running `quarto check` from a development build (from a git repository), show the git commit hash in addition to the version string.

tools/release-notes.R

@@ -49,11 +49,17 @@ cat("Prerelease:", new_release_major, "->", new_prerelease_major, "\n")
 changelog_url <- paste0("https://github.com/quarto-dev/quarto-cli/releases/download/v", 
   old_release, "/changelog.md")
 changelog_dir <- dir_create(path(downloads, "changelog", major_version))
+changelog_file <- path(changelog_dir, "_changelog", ext = "md")
 
-download_status <- download.file(changelog_url, path(changelog_dir, 
-  "_changelog", ext = "md"))
+download_status <- download.file(changelog_url, changelog_file)
 stopifnot(!download_status)
 
+# escape shortcodes on changelog files as we don't want them processed on website
+# changelog.md is not supposed to have shortcodes that are meant to be resolved as they 
+# are not .qmd files, but regular markdown files.
+# # Pattern that matches {{< >}} but NOT {{{< >}}} (already escaped): "(?<!\\{)(\\{\\{<[^>]*>\\}\\})(?!\\})"
+xfun::gsub_file(changelog_file, pattern = "(?<!\\{)(\\{\\{<[^>]*>\\}\\})(?!\\})", replacement = "{\\1}", perl = TRUE)
+
 glue("
 ---
 title: {major_version} Release Notes