You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Quarto 1.6 supports unified branding across formats, updates to RevealJS, a new shortcode to reorder content, a landscape page block, and more. There are also a couple of breaking changes that will affect a small number of users.
5
5
categories:
6
6
- Quarto 1.6
7
7
- Releases
8
8
author: Charlotte Wickham
9
-
date: "xx/xx/2024"
9
+
date: "11/15/2024"
10
10
draft: true
11
-
#image:
12
-
#image-alt:
11
+
image: "images/thumbnail.png"
12
+
image-alt: "Quarto 1.6 with a palette."
13
13
---
14
14
15
-
Quarto 1.6 has been officially released! You can get the current release from the [download page](/docs/download/index.qmd)
15
+
Quarto 1.6 has been officially released! You can get the current release from the [download page](/docs/download/index.qmd).
16
16
17
-
## Crossrefs
17
+
We are particularly excited about:
18
18
19
-
It should now be easier to get Quarto to recognize subfloats (subtables, subfigures, etc) when they're emitted by code cells.
20
-
If the `subcap` attribute of a code cell has as many entries as the number of outputs from your code cell, Quarto knows to accept those as subfloats.
21
-
See [#10328](https://github.com/quarto-dev/quarto-cli/issues/10328) for details.
19
+
- Support for **brand.yml**---a single file that defines your organization's branding and style preferences across formats.
22
20
23
-
Minimal example:
21
+
- RevealJS updates, including the new navigation features: scroll mode and jump to slide.
22
+
23
+
- The `contents` shortcode for reordering your content.
24
+
25
+
-`landscape` blocks for placing content on a landscape page.
26
+
27
+
- Improvements in how you can specify subpanels of cross-references from code blocks.
28
+
29
+
You can read about these new features and a couple of breaking changes in the sections below. You can find all the changes in this version in the [Release Notes](/docs/download/changelog/1.6/).
30
+
31
+
## Cross-format theming with **brand.yml**
32
+
33
+
[**brand.yml**](https://posit-dev.github.io/brand-yml/) is a Posit project outside Quarto that defines brand information using a simple YAML file. Quarto is a flagship adopter of **brand.yml** and supports brand-themed output for `html`, `dashboard`, `typst` and `revealjs` formats.
34
+
35
+
TODO: Include brand example from Guide here.
36
+
37
+
Get started by reading the Quarto [Guide to Brand](/docs/authoring/brand.qmd).
38
+
39
+
## RevealJS update
40
+
41
+
Quarto v1.6 updates RevealJS to v5.1.0. With the update comes two notable features:
24
42
43
+
[**Jump to Slide**](/docs/presentations/revealjs/presenting.qmd#jump-to-slide): Quickly navigate to a slide. Press {{< kbd G >}} to activate, type a slide number or ID, and hit Enter/Return.
44
+
45
+
[**Scroll Mode**](/docs/presentations/revealjs/presenting.qmd#scroll-view): Scroll rather than click to advance slides. Press {{< kbd R >}}, add `?view=scroll` to your URL, or use the Navigation menu to activate. Automatically activated on small screens.
46
+
47
+
## Contents shortcode
48
+
49
+
The `contents` shortcode lets you compose content in one location in your document and then display it in another. For example, you might use a code cell to generate a plot:
50
+
51
+
````markdown
52
+
```{{python}}
53
+
#| echo: false
54
+
#| label: a-cell
55
+
import matplotlib.pyplot as plt
56
+
plt.plot([1,2,3])
57
+
```
25
58
````
26
-
```{{r}}
59
+
60
+
Then use the `contents` shortcode to display that plot in a callout by referencing its label, `a-cell`:
61
+
62
+
```{.markdown shortcodes="false"}
63
+
::: callout-note
64
+
## Note the following plot
65
+
66
+
{{< contents a-cell >}}
67
+
68
+
:::
69
+
```
70
+
71
+
Find all the details on our guide page on the [contents shortcode](/docs/authoring/contents.qmd).
72
+
73
+
## Landscape mode
74
+
75
+
In `pdf`, `docx,` and `typst` formats, you can now put content on a landscape page by placing it inside a [`landscape` block](/docs/authoring/article-layout.html#landscape-mode):
76
+
77
+
```markdown
78
+
::: {.landscape}
79
+
80
+
This will appear in landscape.
81
+
82
+
:::
83
+
```
84
+
85
+
## Cross-reference improvements
86
+
87
+
It should now be easier to get Quarto to recognize subfloats (subtables, subfigures, etc) when they're emitted by code cells. If the `subcap` attribute of a code cell has as many entries as the number of outputs from your code cell, Quarto knows to accept those as subfloats. See [#10328](https://github.com/quarto-dev/quarto-cli/issues/10328){.external} for details.
88
+
89
+
Minimal example:
90
+
91
+
```{{{r}}}
27
92
#| label: tbl-example
28
93
#| tbl-cap: I want these images to be interpreted as Tables.
29
94
#| tbl-subcap:
@@ -32,12 +97,25 @@ Minimal example:
32
97
plot(1:10)
33
98
plot(11:20)
34
99
```
35
-
````
36
100
37
-
101
+
{.border fig-alt="Screenshot of a document showing two plots with an overall caption labelled 'Table 1', and each plot with a caption starting '(a)' and '(b)' respectively."}
102
+
103
+
## Breaking Changes
104
+
105
+
We try very hard to keep Quarto backward compatible. However, in this release, there are a couple of breaking changes due to upstream dependencies. You may be affected if:
38
106
39
-
## Acknowledgements
107
+
-**You have TypeScript files (`*.ts`) that you use with `quarto run` that import Deno standard libraries.**
40
108
41
-
We'd like to say a huge thank you to everyone who contributed to this release by opening issues and pull requests:
109
+
The import syntax has changed. Please see [Deno Scripts](/docs/projects/scripts.html#deno-scripts) for the necessary changes.
110
+
111
+
-**You override the LaTeX `graphics.tex` partial, or you have a completely custom LaTeX template that doesn't use the `graphics.tex` partial.**
112
+
113
+
A Pandoc change means some images are now wrapped in `\pandocbounded`. Consequently, your `graphics.tex` partial, or your template, needs to define `\pandocbounded`. You can look at our [source code for `graphics.tex`](https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/formats/pdf/pandoc/graphics.tex){.external} to see the necessary changes and read more about the upstream change in [Pandoc commit 26b25a4](https://github.com/jgm/pandoc/commit/26b25a4428815b04c255e33e95ee86ca7b6ee30e){.external}.
114
+
115
+
## Acknowledgments
116
+
117
+
We want to say a huge thank you to everyone who contributed to this release by opening issues and pull requests:
42
118
43
119
{{< include _contribs.md >}}
120
+
121
+
The palette emoji in the [listing and social card image](images/thumbnail.png) for this post comes from [OpenMoji](https://openmoji.org/){.external}– the open-source emoji and icon project. License: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/#){.external}
0 commit comments