From 1fc5e5f9f330f9b82638d1304aa1340b132f563e Mon Sep 17 00:00:00 2001 From: Christophe Dervieux Date: Tue, 29 Apr 2025 15:08:37 +0200 Subject: [PATCH 1/9] latex, partials - Add new LaTeX partials info in the doc --- docs/journals/templates.qmd | 99 ++++++++++++++++++++++++++----------- 1 file changed, 71 insertions(+), 28 deletions(-) diff --git a/docs/journals/templates.qmd b/docs/journals/templates.qmd index d28f33b662..cd7d2a1abc 100644 --- a/docs/journals/templates.qmd +++ b/docs/journals/templates.qmd @@ -64,7 +64,9 @@ format: When Quarto renders a document with a partial, it will use the built in template but replace a portion of the template with the provided partial. In the above case, the LaTeX title will be replaced with the implementation provided as the partial, while the rest of the built in template will be used. -Note that the name of the partial files is important. You choose which portion of the template to replace by providing a partial with that name. You can see the list of partials available in [HTML Partials] and [LaTeX Partials] below. +Note that the name of the partial files is important. You choose which portion of the template to replace by providing a partial with that name. Providing an empty file as a partial is a way to opt out some insertion without modifying the whole main template. + +You can see the list of partials available for each format below: [LaTeX Partials], [Typst Partials], [HTML Partials] and [Revealjs Partials]. ### Including Partials {#including-partials} @@ -88,66 +90,107 @@ This modular approach means that it is easier to implement templates that: ## LaTeX Partials -View the Quarto LaTeX template and partials [source code here](https://github.com/quarto-dev/quarto-cli/tree/main/src/resources/formats/pdf/pandoc). Note that latex.template is a copy of the complete Pandoc template that the Quarto template and partials is based upon. +View the Quarto LaTeX template and partials [source code here](https://github.com/quarto-dev/quarto-cli/tree/main/src/resources/formats/pdf/pandoc). + +Since Quarto 1.7 providing Pandoc 3.6.3, there are two sets of partials: Quarto's specific partials and Pandoc's partials. The source directory contains both: + +- partials with `.latex` extension are the one inherited from Pandoc, +- partials with `.tex` extension are the one provided by Quarto directly to offer more granular customization. + +Quarto's partials and main template are based upon original template and partials from Pandoc - a copy of the file is kept in our source as reference when it was modified to fit Quarto's organization. Those files are: `latex.template` for the main template used as `template.tex` containing all the partials, and `latex.common` for the original version of `common.latex` as the original partial from Pandoc is tweaked to support Quarto's more specific partials. template.tex -: The core LaTeX template which includes the basic document skeleton plus the following partials. This can't be replaced as a `partial`, instead use the `template` option to provide your own template. +: The core LaTeX template which includes the basic document skeleton plus the following partials. This can't be replaced as a `template-partial`, instead use the `template` option to provide your own template. + +passoptions.latex + +: Contains declaration using `\PassOptionsToPackage` command to modify options for packages that may be used later in the template. doc-class.tex : Contains the document class declaration and options. By default we provide the identical document class that Pandoc provides, implementing many features. If you override this (which will be common), you will need to either implement support for the document class options or be aware that those options (e.g. font-size, paper-size, classoption, etc...) will not be supported in your output. -before-title.tex +fonts.latex -: Appears in the document premable just before the title block. By default, this partial is empty. +: Contains declarations to load LaTeX packages useful for fonts -title.tex +font-settings.latex -: Provides configuration of document metadata for writing the title block. Note that in addition to these templates and partials, Quarto will also make normalized authors and affiliations data available to the template, making is easy to write custom title blocks against a standard schema. +: Contains declarations about fonts packages configuration, depending on packages used and LaTeX engine used. -before-body.tex +common.latex -: Implements the frontmatter, title page, and abstract. +: Contains mostly declarations related to Pandoc features for LaTeX (like `linestretch`, `indent`, `verbatim-in-note`, `listings`, ...). This template from Pandoc is modified by Quarto to use more specific partials by splitting content between `common.latex` and `pandoc.tex`. You can either replace on of this partial entirely or a more specific one from `pandoc.tex`. In general, `common.latex` and `pandoc.tex` partials must always be included within your custom template. -after-body.tex +pandoc.tex -: Provides a placeholder to attach content at the end of the body. +: This includes configuration for most pandoc feature like text highlighting, tables, graphics, tight lists, citations, and header includes. In general, this partial must always be included within your custom template. In some circumstances, you may know that certain capabilities will not be needed, so you this partial is further composed of the following partials, which could be used if sensible: -toc.tex -: Creates the table of contents, list of figures, and list of tables. +::: {style="margin-left: 2em;"} -before-bib.tex +tables.tex -: Placed after the content of the document, but before the bibliography. By default contains nothing. +: Provides configuration for the output of tables, table captioning, and footnotes within tables. -biblio.tex +graphics.tex -: Creates the bibliography. +: Provides image scaling and placement configuration. -pandoc.tex +citations.tex -: This includes configuration for text highlighting, tables, graphics, tight lists, citations, and header includes. In general, this partial must always be included within your custom template. In some circumstances, you may know that certain capabilities will not be needed, so you this partial is further composed of the following partials, which could be used if sensible: +: When using CSL references, provides configuration and commands for outputting the bibliography. -::: {style="margin-left: 2em;"} +babel-lang.tex + +: When `lang` option is used, provides configuration and command for babel support and other language related LaTeX configuration. tightlist.tex -: Provides the tight list command. +: Provides the tight list command. -tables.tex +biblio-config.tex -: Provides configuration for the output of tables, table captioning, and footnotes within tables. +: Provides natbib or biblatex configurations. Instead of providing an empty partial to opt-out those configurations (e.g. for a custom format where a specific documentclass handles it already), use `biblio-config: false` for your document configuration. -graphics.tex +::: -: Provides image scaling and placement configuration. +after-header-includes.latex -citations.tex +: Contains what needs to be inserted after user specific header includes, like bookmark configuration. -: When using CSL references, provides configuration and commands for outputting the bibliography. -::: +hypersetup.latex + +: Contains `\hypersetup` command configuration. + +before-title.tex + +: Appears in the document premable just before the title block. By default, this partial is empty. + +title.tex + +: Provides configuration of document metadata for writing the title block. Note that in addition to these templates and partials, Quarto will also make normalized authors and affiliations data available to the template, making is easy to write custom title blocks against a standard schema. + +before-body.tex + +: Implements the frontmatter, title page, and abstract. + +toc.tex + +: Creates the table of contents, list of figures, and list of tables. + +before-bib.tex + +: Placed after the content of the document, but before the bibliography. By default contains nothing. + +biblio.tex + +: Creates the bibliography using either natbib or biblatex if used. + +after-body.tex + +: Provides a placeholder to attach content at the end of the body, right before `\end{document}` See the [full source code](https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/formats/pdf/pandoc/template.tex) for the Quarto LaTeX template to see how these partials are invoked by default. From 8ee8fd17d90dea1143fd03826369835c99b2307a Mon Sep 17 00:00:00 2001 From: Christophe Dervieux Date: Tue, 29 Apr 2025 15:08:53 +0200 Subject: [PATCH 2/9] update freeze after re-render --- _freeze/site_libs/quarto-listing/quarto-listing.js | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_freeze/site_libs/quarto-listing/quarto-listing.js b/_freeze/site_libs/quarto-listing/quarto-listing.js index 54d0e1e7f2..e9a07b2ea3 100644 --- a/_freeze/site_libs/quarto-listing/quarto-listing.js +++ b/_freeze/site_libs/quarto-listing/quarto-listing.js @@ -2,7 +2,8 @@ const kProgressiveAttr = "data-src"; let categoriesLoaded = false; window.quartoListingCategory = (category) => { - category = atob(category); + // category is URI encoded in EJS template for UTF-8 support + category = decodeURIComponent(atob(category)); if (categoriesLoaded) { activateCategory(category); setCategoryHash(category); From e549870cf7db589a41474110a26141393d52c9bc Mon Sep 17 00:00:00 2001 From: Christophe Dervieux Date: Tue, 29 Apr 2025 15:24:08 +0200 Subject: [PATCH 3/9] beamer, partials - Add beamer info and use an include for definitions of partials --- docs/journals/_about-latex-beamer-partials.md | 99 +++++++++++++++++ docs/journals/templates.qmd | 102 +++--------------- 2 files changed, 111 insertions(+), 90 deletions(-) create mode 100644 docs/journals/_about-latex-beamer-partials.md diff --git a/docs/journals/_about-latex-beamer-partials.md b/docs/journals/_about-latex-beamer-partials.md new file mode 100644 index 0000000000..6a059891c1 --- /dev/null +++ b/docs/journals/_about-latex-beamer-partials.md @@ -0,0 +1,99 @@ +Since Quarto 1.7 providing Pandoc 3.6.3, there are two sets of partials: Quarto's specific partials and Pandoc's partials. The source directory contains both: + +- partials with `.latex` extension are the one inherited from Pandoc, +- partials with `.tex` extension are the one provided by Quarto directly to offer more granular customization. + +Quarto's partials and main template are based upon original template and partials from Pandoc - a copy of the file is kept in our source as reference when it was modified to fit Quarto's organization. Those files are: `latex.template` for the main template used as `template.tex` containing all the partials, and `latex.common` for the original version of `common.latex` as the original partial from Pandoc is tweaked to support Quarto's more specific partials. + +template.tex + +: The core LaTeX template which includes the basic document skeleton plus the following partials. This can't be replaced as a `template-partial`, instead use the `template` option to provide your own template. + +passoptions.latex + +: Contains declaration using `\PassOptionsToPackage` command to modify options for packages that may be used later in the template. + +doc-class.tex + +: Contains the document class declaration and options. By default we provide the identical document class that Pandoc provides, implementing many features. If you override this (which will be common), you will need to either implement support for the document class options or be aware that those options (e.g. font-size, paper-size, classoption, etc...) will not be supported in your output. + +fonts.latex + +: Contains declarations to load LaTeX packages useful for fonts + +font-settings.latex + +: Contains declarations about fonts packages configuration, depending on packages used and LaTeX engine used. + +common.latex + +: Contains mostly declarations related to Pandoc features for LaTeX (like `linestretch`, `indent`, `verbatim-in-note`, `listings`, ...). This template from Pandoc is modified by Quarto to use more specific partials by splitting content between `common.latex` and `pandoc.tex`. You can either replace on of this partial entirely or a more specific one from `pandoc.tex`. In general, `common.latex` and `pandoc.tex` partials must always be included within your custom template. + +pandoc.tex + +: This includes configuration for most pandoc feature like text highlighting, tables, graphics, tight lists, citations, and header includes. In general, this partial must always be included within your custom template. In some circumstances, you may know that certain capabilities will not be needed, so you this partial is further composed of the following partials, which could be used if sensible: + + +::: {style="margin-left: 2em;"} + +tables.tex + +: Provides configuration for the output of tables, table captioning, and footnotes within tables. + +graphics.tex + +: Provides image scaling and placement configuration. + +citations.tex + +: When using CSL references, provides configuration and commands for outputting the bibliography. + +babel-lang.tex + +: When `lang` option is used, provides configuration and command for babel support and other language related LaTeX configuration. + +tightlist.tex + +: Provides the tight list command. + +biblio-config.tex + +: Provides natbib or biblatex configurations. Instead of providing an empty partial to opt-out those configurations (e.g. for a custom format where a specific documentclass handles it already), use `biblio-config: false` for your document configuration. + +::: + +after-header-includes.latex + +: Contains what needs to be inserted after user specific header includes, like bookmark configuration. + +hypersetup.latex + +: Contains `\hypersetup` command configuration. + +before-title.tex + +: Appears in the document premable just before the title block. By default, this partial is empty. + +title.tex + +: Provides configuration of document metadata for writing the title block. Note that in addition to these templates and partials, Quarto will also make normalized authors and affiliations data available to the template, making is easy to write custom title blocks against a standard schema. + +before-body.tex + +: Implements the frontmatter, title page, and abstract. + +toc.tex + +: Creates the table of contents, list of figures, and list of tables. + +before-bib.tex + +: Placed after the content of the document, but before the bibliography. By default contains nothing. + +biblio.tex + +: Creates the bibliography using either natbib or biblatex if used. + +after-body.tex + +: Provides a placeholder to attach content at the end of the body, right before `\end{document}` \ No newline at end of file diff --git a/docs/journals/templates.qmd b/docs/journals/templates.qmd index cd7d2a1abc..c6a1399dd7 100644 --- a/docs/journals/templates.qmd +++ b/docs/journals/templates.qmd @@ -90,109 +90,31 @@ This modular approach means that it is easier to implement templates that: ## LaTeX Partials -View the Quarto LaTeX template and partials [source code here](https://github.com/quarto-dev/quarto-cli/tree/main/src/resources/formats/pdf/pandoc). - -Since Quarto 1.7 providing Pandoc 3.6.3, there are two sets of partials: Quarto's specific partials and Pandoc's partials. The source directory contains both: - -- partials with `.latex` extension are the one inherited from Pandoc, -- partials with `.tex` extension are the one provided by Quarto directly to offer more granular customization. - -Quarto's partials and main template are based upon original template and partials from Pandoc - a copy of the file is kept in our source as reference when it was modified to fit Quarto's organization. Those files are: `latex.template` for the main template used as `template.tex` containing all the partials, and `latex.common` for the original version of `common.latex` as the original partial from Pandoc is tweaked to support Quarto's more specific partials. - -template.tex - -: The core LaTeX template which includes the basic document skeleton plus the following partials. This can't be replaced as a `template-partial`, instead use the `template` option to provide your own template. - -passoptions.latex - -: Contains declaration using `\PassOptionsToPackage` command to modify options for packages that may be used later in the template. - -doc-class.tex - -: Contains the document class declaration and options. By default we provide the identical document class that Pandoc provides, implementing many features. If you override this (which will be common), you will need to either implement support for the document class options or be aware that those options (e.g. font-size, paper-size, classoption, etc...) will not be supported in your output. - -fonts.latex - -: Contains declarations to load LaTeX packages useful for fonts - -font-settings.latex - -: Contains declarations about fonts packages configuration, depending on packages used and LaTeX engine used. - -common.latex - -: Contains mostly declarations related to Pandoc features for LaTeX (like `linestretch`, `indent`, `verbatim-in-note`, `listings`, ...). This template from Pandoc is modified by Quarto to use more specific partials by splitting content between `common.latex` and `pandoc.tex`. You can either replace on of this partial entirely or a more specific one from `pandoc.tex`. In general, `common.latex` and `pandoc.tex` partials must always be included within your custom template. - -pandoc.tex - -: This includes configuration for most pandoc feature like text highlighting, tables, graphics, tight lists, citations, and header includes. In general, this partial must always be included within your custom template. In some circumstances, you may know that certain capabilities will not be needed, so you this partial is further composed of the following partials, which could be used if sensible: - - -::: {style="margin-left: 2em;"} - -tables.tex - -: Provides configuration for the output of tables, table captioning, and footnotes within tables. +::: {.callout-note} -graphics.tex - -: Provides image scaling and placement configuration. - -citations.tex - -: When using CSL references, provides configuration and commands for outputting the bibliography. - -babel-lang.tex - -: When `lang` option is used, provides configuration and command for babel support and other language related LaTeX configuration. - -tightlist.tex - -: Provides the tight list command. - -biblio-config.tex - -: Provides natbib or biblatex configurations. Instead of providing an empty partial to opt-out those configurations (e.g. for a custom format where a specific documentclass handles it already), use `biblio-config: false` for your document configuration. +For `format: beamer`, see [Beamer Partials] ::: -after-header-includes.latex - -: Contains what needs to be inserted after user specific header includes, like bookmark configuration. - -hypersetup.latex - -: Contains `\hypersetup` command configuration. - -before-title.tex - -: Appears in the document premable just before the title block. By default, this partial is empty. - -title.tex - -: Provides configuration of document metadata for writing the title block. Note that in addition to these templates and partials, Quarto will also make normalized authors and affiliations data available to the template, making is easy to write custom title blocks against a standard schema. - -before-body.tex - -: Implements the frontmatter, title page, and abstract. +View the Quarto LaTeX template and partials [source code here](https://github.com/quarto-dev/quarto-cli/tree/main/src/resources/formats/pdf/pandoc). -toc.tex +{{< include /docs/journals/_about-latex-beamer-partials.md >}} -: Creates the table of contents, list of figures, and list of tables. +See the [full source code](https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/formats/pdf/pandoc/template.tex) for the Quarto LaTeX template to see how these partials are invoked by default. -before-bib.tex +## Beamer Partials -: Placed after the content of the document, but before the bibliography. By default contains nothing. +::: {.callout-note} -biblio.tex +New from Quarto 1.7: `format: beamer` now uses its own template and partials. -: Creates the bibliography using either natbib or biblatex if used. +::: -after-body.tex +View the Quarto Beamer template and partials [source code here](https://github.com/quarto-dev/quarto-cli/tree/main/src/resources/formats/beamer/pandoc). -: Provides a placeholder to attach content at the end of the body, right before `\end{document}` +{{< include /docs/journals/_about-latex-beamer-partials.md >}} -See the [full source code](https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/formats/pdf/pandoc/template.tex) for the Quarto LaTeX template to see how these partials are invoked by default. +See the [full source code](https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/formats/beamer/pandoc/template.tex) for the Quarto Beamer template to see how these partials are invoked by default. ## Typst Partials From 4af7feae765826c760a07ddc65eaee535a3d2ade Mon Sep 17 00:00:00 2001 From: Christophe Dervieux Date: Fri, 2 May 2025 14:36:37 +0200 Subject: [PATCH 4/9] Take into account review suggestions --- docs/journals/_about-latex-beamer-partials.md | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/journals/_about-latex-beamer-partials.md b/docs/journals/_about-latex-beamer-partials.md index 6a059891c1..dfee93e07d 100644 --- a/docs/journals/_about-latex-beamer-partials.md +++ b/docs/journals/_about-latex-beamer-partials.md @@ -1,9 +1,9 @@ -Since Quarto 1.7 providing Pandoc 3.6.3, there are two sets of partials: Quarto's specific partials and Pandoc's partials. The source directory contains both: +Starting with Quarto 1.7, which provides Pandoc 3.6.3, there are two sets of partials: those specific to Quarto and those inherited from Pandoc. The source directory contains: -- partials with `.latex` extension are the one inherited from Pandoc, -- partials with `.tex` extension are the one provided by Quarto directly to offer more granular customization. +- partials with `.latex` extension that are inherited from Pandoc, +- partials with `.tex` extension that are provided by Quarto directly for more granular customization. -Quarto's partials and main template are based upon original template and partials from Pandoc - a copy of the file is kept in our source as reference when it was modified to fit Quarto's organization. Those files are: `latex.template` for the main template used as `template.tex` containing all the partials, and `latex.common` for the original version of `common.latex` as the original partial from Pandoc is tweaked to support Quarto's more specific partials. +A copy of some of Pandoc's original files are also kept in Quarto's source as a reference. These files are: `latex.template`, the main template used as `template.tex` containing all the partials; and `latex.common` the original version of `common.latex`, which is tweaked to support Quarto's more specific partials. template.tex @@ -11,11 +11,11 @@ template.tex passoptions.latex -: Contains declaration using `\PassOptionsToPackage` command to modify options for packages that may be used later in the template. +: Contains declarations using the `\PassOptionsToPackage` command to modify options for packages that may be used later in the template. doc-class.tex -: Contains the document class declaration and options. By default we provide the identical document class that Pandoc provides, implementing many features. If you override this (which will be common), you will need to either implement support for the document class options or be aware that those options (e.g. font-size, paper-size, classoption, etc...) will not be supported in your output. +: Contains the document class declaration and options. By default we provide an identical document class to Pandoc, which implements many features. If you override this (which will be common), you will need to either implement support for the document class options or be aware that those options (e.g. `font-size`, `paper-size`, `classoption`, etc...) will not be supported in your output. fonts.latex @@ -23,15 +23,15 @@ fonts.latex font-settings.latex -: Contains declarations about fonts packages configuration, depending on packages used and LaTeX engine used. +: Contains declarations to configure font packages, depending on which packages and LaTeX engine are used. common.latex -: Contains mostly declarations related to Pandoc features for LaTeX (like `linestretch`, `indent`, `verbatim-in-note`, `listings`, ...). This template from Pandoc is modified by Quarto to use more specific partials by splitting content between `common.latex` and `pandoc.tex`. You can either replace on of this partial entirely or a more specific one from `pandoc.tex`. In general, `common.latex` and `pandoc.tex` partials must always be included within your custom template. +: Contains mostly declarations related to Pandoc features for LaTeX (like `linestretch`, `indent`, `verbatim-in-note`, `listings`, ...). Quarto modifies this template from Pandoc to use more specific partials by splitting content between `common.latex` and `pandoc.tex`. You can either replace this partial entirely or a more specific one from `pandoc.tex`. In general, the `common.latex` and `pandoc.tex` partials must always be included within your custom template. pandoc.tex -: This includes configuration for most pandoc feature like text highlighting, tables, graphics, tight lists, citations, and header includes. In general, this partial must always be included within your custom template. In some circumstances, you may know that certain capabilities will not be needed, so you this partial is further composed of the following partials, which could be used if sensible: +: This includes configuration for most Pandoc features like text highlighting, tables, graphics, tight lists, citations, and header includes. In general, this partial must always be included within your custom template. In some circumstances, you may know that certain capabilities will not be needed, so this partial is further composed of the following partials, which could be used if sensible: ::: {style="margin-left: 2em;"} @@ -58,7 +58,7 @@ tightlist.tex biblio-config.tex -: Provides natbib or biblatex configurations. Instead of providing an empty partial to opt-out those configurations (e.g. for a custom format where a specific documentclass handles it already), use `biblio-config: false` for your document configuration. +: Provides natbib or biblatex configurations. To opt-out of these configurations (e.g. for a custom format where a specific documentclass handles it already), rather than provide an empty partial, use `biblio-config: false` for your document configuration. ::: @@ -68,7 +68,7 @@ after-header-includes.latex hypersetup.latex -: Contains `\hypersetup` command configuration. +: Contains the `\hypersetup` command configuration. before-title.tex From b6210cc32c4f8b278abd3540d2ac72a0f64e2b09 Mon Sep 17 00:00:00 2001 From: Christophe Dervieux Date: Fri, 2 May 2025 14:37:31 +0200 Subject: [PATCH 5/9] Move the mention of copied file to the bottom of the list --- docs/journals/_about-latex-beamer-partials.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/journals/_about-latex-beamer-partials.md b/docs/journals/_about-latex-beamer-partials.md index dfee93e07d..db2b947712 100644 --- a/docs/journals/_about-latex-beamer-partials.md +++ b/docs/journals/_about-latex-beamer-partials.md @@ -3,8 +3,6 @@ Starting with Quarto 1.7, which provides Pandoc 3.6.3, there are two sets of par - partials with `.latex` extension that are inherited from Pandoc, - partials with `.tex` extension that are provided by Quarto directly for more granular customization. -A copy of some of Pandoc's original files are also kept in Quarto's source as a reference. These files are: `latex.template`, the main template used as `template.tex` containing all the partials; and `latex.common` the original version of `common.latex`, which is tweaked to support Quarto's more specific partials. - template.tex : The core LaTeX template which includes the basic document skeleton plus the following partials. This can't be replaced as a `template-partial`, instead use the `template` option to provide your own template. @@ -96,4 +94,6 @@ biblio.tex after-body.tex -: Provides a placeholder to attach content at the end of the body, right before `\end{document}` \ No newline at end of file +: Provides a placeholder to attach content at the end of the body, right before `\end{document}` + +A copy of some of Pandoc's original files are also kept in Quarto's source as a reference. These files are: `latex.template`, the main template used as `template.tex` containing all the partials; and `latex.common` the original version of `common.latex`, which is tweaked to support Quarto's more specific partials. \ No newline at end of file From 82d749163355b0b2fc507b0cb96688f015059c0d Mon Sep 17 00:00:00 2001 From: Christophe Dervieux Date: Fri, 2 May 2025 14:52:23 +0200 Subject: [PATCH 6/9] great idea to indent nested partials even more --- docs/journals/_about-latex-beamer-partials.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/journals/_about-latex-beamer-partials.md b/docs/journals/_about-latex-beamer-partials.md index db2b947712..ecb9f0580d 100644 --- a/docs/journals/_about-latex-beamer-partials.md +++ b/docs/journals/_about-latex-beamer-partials.md @@ -27,12 +27,14 @@ common.latex : Contains mostly declarations related to Pandoc features for LaTeX (like `linestretch`, `indent`, `verbatim-in-note`, `listings`, ...). Quarto modifies this template from Pandoc to use more specific partials by splitting content between `common.latex` and `pandoc.tex`. You can either replace this partial entirely or a more specific one from `pandoc.tex`. In general, the `common.latex` and `pandoc.tex` partials must always be included within your custom template. +::: {style="margin-left: 2em;"} + pandoc.tex : This includes configuration for most Pandoc features like text highlighting, tables, graphics, tight lists, citations, and header includes. In general, this partial must always be included within your custom template. In some circumstances, you may know that certain capabilities will not be needed, so this partial is further composed of the following partials, which could be used if sensible: -::: {style="margin-left: 2em;"} +::: {style="margin-left: 4em;"} tables.tex @@ -60,6 +62,8 @@ biblio-config.tex ::: +::: + after-header-includes.latex : Contains what needs to be inserted after user specific header includes, like bookmark configuration. From 1afb275a90044fab8759cdc19e3f824263b3b105 Mon Sep 17 00:00:00 2001 From: Christophe Dervieux Date: Fri, 2 May 2025 16:42:38 +0200 Subject: [PATCH 7/9] More review suggestions for main page --- docs/journals/templates.qmd | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/journals/templates.qmd b/docs/journals/templates.qmd index c6a1399dd7..7b321d0016 100644 --- a/docs/journals/templates.qmd +++ b/docs/journals/templates.qmd @@ -64,9 +64,9 @@ format: When Quarto renders a document with a partial, it will use the built in template but replace a portion of the template with the provided partial. In the above case, the LaTeX title will be replaced with the implementation provided as the partial, while the rest of the built in template will be used. -Note that the name of the partial files is important. You choose which portion of the template to replace by providing a partial with that name. Providing an empty file as a partial is a way to opt out some insertion without modifying the whole main template. +The name of the partial file is important. You choose which portion of the template to replace by providing a partial with that name. Providing an empty file as a partial is a way to opt out of some features without modifying the whole main template. -You can see the list of partials available for each format below: [LaTeX Partials], [Typst Partials], [HTML Partials] and [Revealjs Partials]. +You can see the list of partials available for each format below: [LaTeX Partials](#latex-partials), [Beamer Partials](#beamer-partials), [Typst Partials](#typst-partials), [HTML Partials](#html-partials) and [Revealjs Partials](#revealjs-partials). ### Including Partials {#including-partials} @@ -88,11 +88,11 @@ This modular approach means that it is easier to implement templates that: - Provide only the minimal LaTeX or HTML rather than being required to provide all of it -## LaTeX Partials +## LaTeX Partials {#latex-partials} ::: {.callout-note} -For `format: beamer`, see [Beamer Partials] +For `format: beamer`, see [Beamer Partials](#beamer-partials) ::: @@ -102,7 +102,7 @@ View the Quarto LaTeX template and partials [source code here](https://github.co See the [full source code](https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/formats/pdf/pandoc/template.tex) for the Quarto LaTeX template to see how these partials are invoked by default. -## Beamer Partials +## Beamer Partials {#beamer-partials} ::: {.callout-note} @@ -116,7 +116,7 @@ View the Quarto Beamer template and partials [source code here](https://github.c See the [full source code](https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/formats/beamer/pandoc/template.tex) for the Quarto Beamer template to see how these partials are invoked by default. -## Typst Partials +## Typst Partials {#typst-partials} View the Quarto Typst template and partials [source code here](https://github.com/quarto-dev/quarto-cli/tree/main/src/resources/formats/typst/pandoc/quarto). @@ -144,7 +144,7 @@ biblio.typ : Creates the bibliography. -## HTML Partials +## HTML Partials {#html-partials} View the Quarto html template and partials [source code here](https://github.com/quarto-dev/quarto-cli/tree/main/src/resources/formats/html/pandoc). Note that `html.template` is a copy of the complete Pandoc template that the Quarto template and partials is based upon. @@ -166,7 +166,7 @@ toc.html : Provide the table of contents target for the document -## Revealjs Partials +## Revealjs Partials {#revealjs-partials} View the Quarto Revealjs template and partials [source code here](https://github.com/quarto-dev/quarto-cli/tree/main/src/resources/formats/revealjs/pandoc). Note that `revealjs.template` is a copy of the complete Pandoc template that the Quarto template and partials is based upon. From 600b83721ea8b932dfbd3e63fe3aa7f2a8aca488 Mon Sep 17 00:00:00 2001 From: Charlotte Wickham Date: Fri, 2 May 2025 10:54:52 -0700 Subject: [PATCH 8/9] Add summary to highlights and blog post --- .../index/execute-results/html.json | 4 ++-- docs/blog/posts/2025-04-28-1.7-release/index.qmd | 9 +++++++++ docs/journals/_about-latex-beamer-partials.md | 2 +- docs/prerelease/1.7/_highlights.qmd | 8 ++++++++ 4 files changed, 20 insertions(+), 3 deletions(-) diff --git a/_freeze/docs/blog/posts/2025-04-28-1.7-release/index/execute-results/html.json b/_freeze/docs/blog/posts/2025-04-28-1.7-release/index/execute-results/html.json index 074858f700..f6c2cf0228 100644 --- a/_freeze/docs/blog/posts/2025-04-28-1.7-release/index/execute-results/html.json +++ b/_freeze/docs/blog/posts/2025-04-28-1.7-release/index/execute-results/html.json @@ -1,8 +1,8 @@ { - "hash": "c9ce8b48ba5987142141e4871a843fda", + "hash": "6aca55a2acf2260b85bc3cee1ab1f297", "result": { "engine": "knitr", - "markdown": "---\ntitle: Quarto 1.7 \ndescription: |\n Quarto 1.7 brings big improvements to dark mode along with updates to Typst, Pandoc, a new `version` shortcode, and improvements to the `julia` engine.\ncategories:\n - Quarto 1.7\n - Releases\nauthor: Charlotte Wickham\ndate: \"2025-04-28\"\ndraft: false\nimage: thumbnail-1.7.jpeg\nimage-alt: \"Quarto 1.7: half the Quarto logo is light on dark, the other half dark on light\"\n---\n\nQuarto 1.7 is out! You can get the current release from the [download page](/docs/download/index.qmd).\n\nWe are especially enthusiastic about the improvements 1.7 brings to dark mode: you can now specify light and dark themes via brand, map computational outputs to themes, and have your website theme follow your viewer's preference.\nTo celebrate these changes, this site, [quarto.org](/), now has a light and dark mode.\nToggle the switch in the navigation bar (``{=html}) to see the difference.\n\nYou can read about these improvements and some other highlights below. You can find all the changes in this version in the [Release Notes](/docs/download/changelog/1.7/).\n\n## Dark Mode Improvements\n\n### Specify light and dark themes via **brand.yml**\n\nYou can now specify a light and dark brand.\nFor example, at a project-level you can provide two brand files:\n\n```{.yaml filename=\"_quarto.yml\"}\nbrand:\n light: light-brand.yml\n dark: dark-brand.yml\n```\n\nStandalone HTML pages, websites, and dashboards will gain a light switch toggle allowing viewers to switch between the light and dark themes. \n\n::: {layout-ncol=2}\n\n![`light` brand](light.png){fig-alt=\"Screenshot of a webpage with a light blue body and charcoal text. A switch toggle in the navbar is 'off'.\"}\n\n![`dark` brand](dark.png){fig-alt=\"Screenshot of a webpage with a dark charcoal body and light blue text. A switch toggle in the navbar is 'on'.\"}\n\n:::\n\n\nBy default Typst documents will use the light brand, but you can set the `brand-mode` option to use the dark brand instead:\n\n```{.yaml filename=\"document.qmd\"}\n---\nformat:\n typst:\n brand-mode: dark\n---\n```\n\nRead about other ways to set a light and dark brand in [Guide > Brand](/docs/authoring/brand.qmd#dark-brand).\n\n\n### Map computational outputs to themes\n\nA new code cell option, `renderings`, allows you to indicate which computational outputs should be displayed in light and dark mode. \nCreate light and dark versions of your outputs in a single code cell, \nand add the option `renderings` to specify the order of the outputs.\nFor example, this cell creates a `light` version of a plot, \nthen a `dark` version:\n\n\n::: {.cell renderings='[\"light\",\"dark\"]'}\n\n````{.cell-code}\n```{{r}}\n#| renderings: [light, dark]\nplot(1:10) # Shown in `light` mode\n\npar(bg = \"#000000\", fg = \"#FFFFFF\", col.axis = \"#FFFFFF\")\nplot(1:10) # Shown in `dark` mode\n```\n````\n\n::: {.cell-output-display}\n![](index_files/figure-html/unnamed-chunk-1-1.png){width=672}\n:::\n\n::: {.cell-output-display}\n![](index_files/figure-html/unnamed-chunk-1-2.png){width=672}\n:::\n:::\n\n\nBoth outputs are produced, but you'll only see the one corresponding to the current state of the light switch.\nToggle the switch in the navigation bar to see the image change to reflect the theme.\n\n### Respect user color scheme\n\nSet the new `html` format option `respect-user-color-scheme` to `true` if you would like your site to honor the viewer’s operating system or browser preference for light or dark mode:\n\n```{.yaml filename=\"_quarto.yml\"}\nformat:\n html:\n respect-user-color-scheme: true\n```\n\n## Other Highlights\n\n- Typst updated to 0.13.0\n- Pandoc updated to 3.6.3\n- New [`version` shortcode](/docs/authoring/version.qmd) to insert the version of Quarto used to build your document:\n \n ::: {layout-ncol=2 layout-valign=\"center\"}\n \n ```{.markdown shortcodes=\"false\"}\n Rendered with Quarto {{< version >}}\n ```\n ::: {.border .p-1}\n Rendered with Quarto {{< version >}}\n :::\n\n :::\n\n- Improvements to the `julia` engine: \n - [`juliaup` integration](/docs/computations/julia.qmd#juliaup-integration): Use specific versions of Julia in your notebooks.\n \n - [R and Python support](/docs/computations/julia.qmd#r-and-python-support): Include `{r}` and `{python}` executable code cells via the RCall and PythonCall packages.\n \n - [Caching](/docs/computations/julia.qmd#caching-julia): Save time rendering long-running notebooks by caching results.\n \n - [Revise.jl integration](/docs/computations/julia.qmd#revise.jl-integration): Automatically update function definitions in Julia sessions.\n\n\n## Acknowledgements\n\nWe'd like to say a huge thank you to everyone who contributed to this release by opening issues and pull requests:\n\n[AndreasThinks](https://github.com/AndreasThinks), \n[ArthurData](https://github.com/ArthurData), \n[BrendonChau](https://github.com/BrendonChau), \n[DanStuder](https://github.com/DanStuder), \n[DavidFirth](https://github.com/DavidFirth), \n[Eli-78-fas](https://github.com/Eli-78-fas), \n[EllaKaye](https://github.com/EllaKaye), \n[EmilHvitfeldt](https://github.com/EmilHvitfeldt), \n[EvoArt](https://github.com/EvoArt), \n[FMKerckhof](https://github.com/FMKerckhof), \n[FrankwaP](https://github.com/FrankwaP), \n[JanPalasek](https://github.com/JanPalasek), \n[Jocarnail](https://github.com/Jocarnail), \n[MHellmund](https://github.com/MHellmund), \n[MichaelHatherly](https://github.com/MichaelHatherly), \n[Noghpu](https://github.com/Noghpu), \n[PeneLoopy](https://github.com/PeneLoopy), \n[Rafnuss](https://github.com/Rafnuss), \n[SergeCroise](https://github.com/SergeCroise), \n[TonyFly3000](https://github.com/TonyFly3000), \n[actuaristai](https://github.com/actuaristai), \n[alex-r-bigelow](https://github.com/alex-r-bigelow), \n[andrewheiss](https://github.com/andrewheiss), \n[ant-durrant](https://github.com/ant-durrant), \n[antoine4ucsd](https://github.com/antoine4ucsd), \n[arnaudgallou](https://github.com/arnaudgallou), \n[aronatkins](https://github.com/aronatkins), \n[arthurgailes](https://github.com/arthurgailes), \n[bkowshik](https://github.com/bkowshik), \n[boshek](https://github.com/boshek), \n[cbrnr](https://github.com/cbrnr), \n[cl-roberts](https://github.com/cl-roberts), \n[cmadland](https://github.com/cmadland), \n[coatless](https://github.com/coatless), \n[deepayan](https://github.com/deepayan), \n[devmcp](https://github.com/devmcp), \n[dhimmel](https://github.com/dhimmel), \n[dkapitan](https://github.com/dkapitan), \n[dmenne](https://github.com/dmenne), \n[eamcvey](https://github.com/eamcvey), \n[edavidaja](https://github.com/edavidaja), \n[fredguth](https://github.com/fredguth), \n[fuhrmanator](https://github.com/fuhrmanator), \n[gadenbuie](https://github.com/gadenbuie), \n[github-actions[bot]](https://github.com/apps/github-actions), \n[glin](https://github.com/glin), \n[gwbrck](https://github.com/gwbrck), \n[hchulkim](https://github.com/hchulkim), \n[hguturu](https://github.com/hguturu), \n[hturner](https://github.com/hturner), \n[ihrke](https://github.com/ihrke), \n[jdutant](https://github.com/jdutant), \n[jenslaufer](https://github.com/jenslaufer), \n[jkrumbiegel](https://github.com/jkrumbiegel), \n[jmgirard](https://github.com/jmgirard), \n[joelostblom](https://github.com/joelostblom), \n[kandolfp](https://github.com/kandolfp), \n[kapsner](https://github.com/kapsner), \n[kazuyanagimoto](https://github.com/kazuyanagimoto), \n[kdheepak](https://github.com/kdheepak), \n[kingo55](https://github.com/kingo55), \n[knuesel](https://github.com/knuesel), \n[kubu4](https://github.com/kubu4), \n[kv9898](https://github.com/kv9898), \n[kylie-foster](https://github.com/kylie-foster), \n[loneguardian](https://github.com/loneguardian), \n[lwjohnst86](https://github.com/lwjohnst86), \n[ma2048](https://github.com/ma2048), \n[markjholmes](https://github.com/markjholmes), \n[maurosilber](https://github.com/maurosilber), \n[mipmip](https://github.com/mipmip), \n[mroavi](https://github.com/mroavi), \n[mroberts1](https://github.com/mroberts1), \n[msh855](https://github.com/msh855), \n[mvuorre](https://github.com/mvuorre), \n[nathanj3](https://github.com/nathanj3), \n[odysseu](https://github.com/odysseu), \n[parmsam](https://github.com/parmsam), \n[peter-gy](https://github.com/peter-gy), \n[pvelayudhan](https://github.com/pvelayudhan), \n[raffaem](https://github.com/raffaem), \n[robmcd](https://github.com/robmcd), \n[ryanzomorrodi](https://github.com/ryanzomorrodi), \n[stragu](https://github.com/stragu), \n[sun123zxy](https://github.com/sun123zxy), \n[t-kalinowski](https://github.com/t-kalinowski), \n[temospena](https://github.com/temospena), \n[tjni](https://github.com/tjni), \n[torven-schalk](https://github.com/torven-schalk), \n[turcotte](https://github.com/turcotte), \n[wenyaoliu](https://github.com/wenyaoliu), \n[yhkee0404](https://github.com/yhkee0404).\n\n", + "markdown": "---\ntitle: Quarto 1.7 \ndescription: |\n Quarto 1.7 brings big improvements to dark mode along with updates to Typst, Pandoc, a new `version` shortcode, and improvements to the `julia` engine.\ncategories:\n - Quarto 1.7\n - Releases\nauthor: Charlotte Wickham\ndate: \"2025-04-28\"\ndraft: false\nimage: thumbnail-1.7.jpeg\nimage-alt: \"Quarto 1.7: half the Quarto logo is light on dark, the other half dark on light\"\n---\n\nQuarto 1.7 is out! You can get the current release from the [download page](/docs/download/index.qmd).\n\nWe are especially enthusiastic about the improvements 1.7 brings to dark mode: you can now specify light and dark themes via brand, map computational outputs to themes, and have your website theme follow your viewer's preference.\nTo celebrate these changes, this site, [quarto.org](/), now has a light and dark mode.\nToggle the switch in the navigation bar (``{=html}) to see the difference.\n\nYou can read about these improvements and some other highlights below. You can find all the changes in this version in the [Release Notes](/docs/download/changelog/1.7/).\n\n## Dark Mode Improvements\n\n### Specify light and dark themes via **brand.yml**\n\nYou can now specify a light and dark brand.\nFor example, at a project-level you can provide two brand files:\n\n```{.yaml filename=\"_quarto.yml\"}\nbrand:\n light: light-brand.yml\n dark: dark-brand.yml\n```\n\nStandalone HTML pages, websites, and dashboards will gain a light switch toggle allowing viewers to switch between the light and dark themes. \n\n::: {layout-ncol=2}\n\n![`light` brand](light.png){fig-alt=\"Screenshot of a webpage with a light blue body and charcoal text. A switch toggle in the navbar is 'off'.\"}\n\n![`dark` brand](dark.png){fig-alt=\"Screenshot of a webpage with a dark charcoal body and light blue text. A switch toggle in the navbar is 'on'.\"}\n\n:::\n\n\nBy default Typst documents will use the light brand, but you can set the `brand-mode` option to use the dark brand instead:\n\n```{.yaml filename=\"document.qmd\"}\n---\nformat:\n typst:\n brand-mode: dark\n---\n```\n\nRead about other ways to set a light and dark brand in [Guide > Brand](/docs/authoring/brand.qmd#dark-brand).\n\n\n### Map computational outputs to themes\n\nA new code cell option, `renderings`, allows you to indicate which computational outputs should be displayed in light and dark mode. \nCreate light and dark versions of your outputs in a single code cell, \nand add the option `renderings` to specify the order of the outputs.\nFor example, this cell creates a `light` version of a plot, \nthen a `dark` version:\n\n\n::: {.cell renderings='[\"light\",\"dark\"]'}\n\n````{.cell-code}\n```{{r}}\n#| renderings: [light, dark]\nplot(1:10) # Shown in `light` mode\n\npar(bg = \"#000000\", fg = \"#FFFFFF\", col.axis = \"#FFFFFF\")\nplot(1:10) # Shown in `dark` mode\n```\n````\n\n::: {.cell-output-display}\n![](index_files/figure-html/unnamed-chunk-1-1.png){width=672}\n:::\n\n::: {.cell-output-display}\n![](index_files/figure-html/unnamed-chunk-1-2.png){width=672}\n:::\n:::\n\n\nBoth outputs are produced, but you'll only see the one corresponding to the current state of the light switch.\nToggle the switch in the navigation bar to see the image change to reflect the theme.\n\n### Respect user color scheme\n\nSet the new `html` format option `respect-user-color-scheme` to `true` if you would like your site to honor the viewer’s operating system or browser preference for light or dark mode:\n\n```{.yaml filename=\"_quarto.yml\"}\nformat:\n html:\n respect-user-color-scheme: true\n```\n\n## Other Highlights\n\n- Typst updated to 0.13.0\n- Pandoc updated to 3.6.3\n- New [`version` shortcode](/docs/authoring/version.qmd) to insert the version of Quarto used to build your document:\n \n ::: {layout-ncol=2 layout-valign=\"center\"}\n \n ```{.markdown shortcodes=\"false\"}\n Rendered with Quarto {{< version >}}\n ```\n ::: {.border .p-1}\n Rendered with Quarto {{< version >}}\n :::\n\n :::\n\n- Updated LaTeX and Beamer template partials:\n\n - [LaTeX partials](/docs/journals/templates.html#latex-partials)\n - [Beamer partials](/docs/journals/templates.html#beamer-partials)\n\n These changes reflect the updates made in Pandoc 3.5 to separate the LaTeX and Beamer document templates and introduce some additional partials for both. \n If you have custom formats that provide custom templates or partials, you may need to update them to work with the new partials. \n\n- Improvements to the `julia` engine: \n - [`juliaup` integration](/docs/computations/julia.qmd#juliaup-integration): Use specific versions of Julia in your notebooks.\n \n - [R and Python support](/docs/computations/julia.qmd#r-and-python-support): Include `{r}` and `{python}` executable code cells via the RCall and PythonCall packages.\n \n - [Caching](/docs/computations/julia.qmd#caching-julia): Save time rendering long-running notebooks by caching results.\n \n - [Revise.jl integration](/docs/computations/julia.qmd#revise.jl-integration): Automatically update function definitions in Julia sessions.\n\n\n\n## Acknowledgements\n\nWe'd like to say a huge thank you to everyone who contributed to this release by opening issues and pull requests:\n\n[AndreasThinks](https://github.com/AndreasThinks), \n[ArthurData](https://github.com/ArthurData), \n[BrendonChau](https://github.com/BrendonChau), \n[DanStuder](https://github.com/DanStuder), \n[DavidFirth](https://github.com/DavidFirth), \n[Eli-78-fas](https://github.com/Eli-78-fas), \n[EllaKaye](https://github.com/EllaKaye), \n[EmilHvitfeldt](https://github.com/EmilHvitfeldt), \n[EvoArt](https://github.com/EvoArt), \n[FMKerckhof](https://github.com/FMKerckhof), \n[FrankwaP](https://github.com/FrankwaP), \n[JanPalasek](https://github.com/JanPalasek), \n[Jocarnail](https://github.com/Jocarnail), \n[MHellmund](https://github.com/MHellmund), \n[MichaelHatherly](https://github.com/MichaelHatherly), \n[Noghpu](https://github.com/Noghpu), \n[PeneLoopy](https://github.com/PeneLoopy), \n[Rafnuss](https://github.com/Rafnuss), \n[SergeCroise](https://github.com/SergeCroise), \n[TonyFly3000](https://github.com/TonyFly3000), \n[actuaristai](https://github.com/actuaristai), \n[alex-r-bigelow](https://github.com/alex-r-bigelow), \n[andrewheiss](https://github.com/andrewheiss), \n[ant-durrant](https://github.com/ant-durrant), \n[antoine4ucsd](https://github.com/antoine4ucsd), \n[arnaudgallou](https://github.com/arnaudgallou), \n[aronatkins](https://github.com/aronatkins), \n[arthurgailes](https://github.com/arthurgailes), \n[bkowshik](https://github.com/bkowshik), \n[boshek](https://github.com/boshek), \n[cbrnr](https://github.com/cbrnr), \n[cl-roberts](https://github.com/cl-roberts), \n[cmadland](https://github.com/cmadland), \n[coatless](https://github.com/coatless), \n[deepayan](https://github.com/deepayan), \n[devmcp](https://github.com/devmcp), \n[dhimmel](https://github.com/dhimmel), \n[dkapitan](https://github.com/dkapitan), \n[dmenne](https://github.com/dmenne), \n[eamcvey](https://github.com/eamcvey), \n[edavidaja](https://github.com/edavidaja), \n[fredguth](https://github.com/fredguth), \n[fuhrmanator](https://github.com/fuhrmanator), \n[gadenbuie](https://github.com/gadenbuie), \n[github-actions[bot]](https://github.com/apps/github-actions), \n[glin](https://github.com/glin), \n[gwbrck](https://github.com/gwbrck), \n[hchulkim](https://github.com/hchulkim), \n[hguturu](https://github.com/hguturu), \n[hturner](https://github.com/hturner), \n[ihrke](https://github.com/ihrke), \n[jdutant](https://github.com/jdutant), \n[jenslaufer](https://github.com/jenslaufer), \n[jkrumbiegel](https://github.com/jkrumbiegel), \n[jmgirard](https://github.com/jmgirard), \n[joelostblom](https://github.com/joelostblom), \n[kandolfp](https://github.com/kandolfp), \n[kapsner](https://github.com/kapsner), \n[kazuyanagimoto](https://github.com/kazuyanagimoto), \n[kdheepak](https://github.com/kdheepak), \n[kingo55](https://github.com/kingo55), \n[knuesel](https://github.com/knuesel), \n[kubu4](https://github.com/kubu4), \n[kv9898](https://github.com/kv9898), \n[kylie-foster](https://github.com/kylie-foster), \n[loneguardian](https://github.com/loneguardian), \n[lwjohnst86](https://github.com/lwjohnst86), \n[ma2048](https://github.com/ma2048), \n[markjholmes](https://github.com/markjholmes), \n[maurosilber](https://github.com/maurosilber), \n[mipmip](https://github.com/mipmip), \n[mroavi](https://github.com/mroavi), \n[mroberts1](https://github.com/mroberts1), \n[msh855](https://github.com/msh855), \n[mvuorre](https://github.com/mvuorre), \n[nathanj3](https://github.com/nathanj3), \n[odysseu](https://github.com/odysseu), \n[parmsam](https://github.com/parmsam), \n[peter-gy](https://github.com/peter-gy), \n[pvelayudhan](https://github.com/pvelayudhan), \n[raffaem](https://github.com/raffaem), \n[robmcd](https://github.com/robmcd), \n[ryanzomorrodi](https://github.com/ryanzomorrodi), \n[stragu](https://github.com/stragu), \n[sun123zxy](https://github.com/sun123zxy), \n[t-kalinowski](https://github.com/t-kalinowski), \n[temospena](https://github.com/temospena), \n[tjni](https://github.com/tjni), \n[torven-schalk](https://github.com/torven-schalk), \n[turcotte](https://github.com/turcotte), \n[wenyaoliu](https://github.com/wenyaoliu), \n[yhkee0404](https://github.com/yhkee0404).\n\n", "supporting": [ "index_files" ], diff --git a/docs/blog/posts/2025-04-28-1.7-release/index.qmd b/docs/blog/posts/2025-04-28-1.7-release/index.qmd index 47d9167569..b75446570a 100644 --- a/docs/blog/posts/2025-04-28-1.7-release/index.qmd +++ b/docs/blog/posts/2025-04-28-1.7-release/index.qmd @@ -104,6 +104,14 @@ format: ::: +- Updated LaTeX and Beamer template partials: + + - [LaTeX partials](/docs/journals/templates.html#latex-partials) + - [Beamer partials](/docs/journals/templates.html#beamer-partials) + + These changes reflect the updates made in Pandoc 3.5 to separate the LaTeX and Beamer document templates and introduce some additional partials for both. + If you have custom formats that provide custom templates or partials, you may need to update them to work with the new partials. + - Improvements to the `julia` engine: - [`juliaup` integration](/docs/computations/julia.qmd#juliaup-integration): Use specific versions of Julia in your notebooks. @@ -114,6 +122,7 @@ format: - [Revise.jl integration](/docs/computations/julia.qmd#revise.jl-integration): Automatically update function definitions in Julia sessions. + ## Acknowledgements We'd like to say a huge thank you to everyone who contributed to this release by opening issues and pull requests: diff --git a/docs/journals/_about-latex-beamer-partials.md b/docs/journals/_about-latex-beamer-partials.md index ecb9f0580d..ec05e0dc20 100644 --- a/docs/journals/_about-latex-beamer-partials.md +++ b/docs/journals/_about-latex-beamer-partials.md @@ -100,4 +100,4 @@ after-body.tex : Provides a placeholder to attach content at the end of the body, right before `\end{document}` -A copy of some of Pandoc's original files are also kept in Quarto's source as a reference. These files are: `latex.template`, the main template used as `template.tex` containing all the partials; and `latex.common` the original version of `common.latex`, which is tweaked to support Quarto's more specific partials. \ No newline at end of file +A copy of some of Pandoc's original files are also kept in Quarto's source as a reference. These files are: `latex.template`/`beamer.template`, the main template used as `template.tex` containing all the partials; and `latex.common` the original version of `common.latex`, which is tweaked to support Quarto's more specific partials. \ No newline at end of file diff --git a/docs/prerelease/1.7/_highlights.qmd b/docs/prerelease/1.7/_highlights.qmd index 8973b6dcc9..96d31785d3 100644 --- a/docs/prerelease/1.7/_highlights.qmd +++ b/docs/prerelease/1.7/_highlights.qmd @@ -24,5 +24,13 @@ Quarto 1.7 includes the following new features: - [Caching](/docs/computations/julia.qmd#caching-julia): Save time rendering long-running notebooks by caching results. - [Revise.jl integration](/docs/computations/julia.qmd#revise.jl-integration): Automatically update function definitions in Julia sessions. +- Updated LaTeX and Beamer template partials: + + - [LaTeX partials](/docs/journals/templates.html#latex-partials) + - [Beamer partials](/docs/journals/templates.html#beamer-partials) + + These changes reflect the updates made in Pandoc 3.5 to separate the LaTeX and Beamer document templates and introduce some additional partials for both. + If you have custom formats that provide custom templates or partials, you may need to update them to work with the new partials. + - Typst updated to 0.13.0 - Pandoc updated to 3.6.3 From 4f00b826999662d21c863041f02f237136aaca24 Mon Sep 17 00:00:00 2001 From: Charlotte Wickham Date: Fri, 2 May 2025 12:27:41 -0700 Subject: [PATCH 9/9] Pull paragraph out of include to allow different file names --- docs/journals/_about-latex-beamer-partials.md | 2 -- docs/journals/templates.qmd | 4 ++++ 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/journals/_about-latex-beamer-partials.md b/docs/journals/_about-latex-beamer-partials.md index ec05e0dc20..23d57737a4 100644 --- a/docs/journals/_about-latex-beamer-partials.md +++ b/docs/journals/_about-latex-beamer-partials.md @@ -99,5 +99,3 @@ biblio.tex after-body.tex : Provides a placeholder to attach content at the end of the body, right before `\end{document}` - -A copy of some of Pandoc's original files are also kept in Quarto's source as a reference. These files are: `latex.template`/`beamer.template`, the main template used as `template.tex` containing all the partials; and `latex.common` the original version of `common.latex`, which is tweaked to support Quarto's more specific partials. \ No newline at end of file diff --git a/docs/journals/templates.qmd b/docs/journals/templates.qmd index 7b321d0016..79474349bb 100644 --- a/docs/journals/templates.qmd +++ b/docs/journals/templates.qmd @@ -100,6 +100,8 @@ View the Quarto LaTeX template and partials [source code here](https://github.co {{< include /docs/journals/_about-latex-beamer-partials.md >}} +A copy of some of Pandoc's original files are also kept in Quarto's source as a reference. These files are: `latex.template`, the main template used as `template.tex` containing all the partials; and `latex.common` the original version of `common.latex`, which is tweaked to support Quarto's more specific partials. + See the [full source code](https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/formats/pdf/pandoc/template.tex) for the Quarto LaTeX template to see how these partials are invoked by default. ## Beamer Partials {#beamer-partials} @@ -114,6 +116,8 @@ View the Quarto Beamer template and partials [source code here](https://github.c {{< include /docs/journals/_about-latex-beamer-partials.md >}} +A copy of some of Pandoc's original files are also kept in Quarto's source as a reference. These files are: `beamer.template`, the main template used as `template.tex` containing all the partials; and `latex.common` the original version of `common.latex`, which is tweaked to support Quarto's more specific partials. + See the [full source code](https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/formats/beamer/pandoc/template.tex) for the Quarto Beamer template to see how these partials are invoked by default. ## Typst Partials {#typst-partials}