Quarto 1.4 – Quarto

Quarto 1.4 已正式发布！您可以从下载页面获取当前版本。

此版本带来了大量新功能。我们想重点介绍的一些主要功能包括：仪表盘、Typst、内联代码语法、交叉引用和手稿。

仪表盘

Quarto 仪表盘简化了交互式仪表盘的创建，让您可以轻松布局交互式组件、可视化、表格数据和注释。以下是一些示例（点击图片访问实时版本）：

有关这些仪表盘的源代码和更多示例，请参阅示例画廊。当您准备好构建自己的 Quarto 仪表盘时，请访问我们的仪表盘指南。

Typst

Typst 是一种新的开源基于标记的排版系统，旨在与 LaTeX 一样强大，但更易于学习和使用。Typst 以极快的渲染速度创建精美的 PDF 输出。

Quarto 1.4 包含了 Typst CLI，因此您只需使用 format: typst 即可开始通过 Typst 创建 PDF：

hello-typst.qmd

---
title: "Hello Typst!"
format: typst
---

我的第一个 Typst 文档

我们特别兴奋的是，使用 Typst 制作期刊文章、会议海报、新闻简报等的模板是多么容易。以下是一些您可以在 Quarto 中使用的示例，作为自定义格式：

显示符合 IEEE 标准的文章样式的页面截图。标题居中，下方是两列作者。 — IEEE

横向海报的截图。海报包括右上角的标志、左上角的标题，以及三列排列的内容。 — Poster

显示信件的页面截图。发件人地址位于页面顶部，收件人地址左对齐。信件正文包括加粗的主题行。 — Letter

显示部门新闻简报的页面截图。页面垂直分为白色左侧栏和红色右侧栏。图像跨越两栏，文本“获奖科学”垂直排列在其右侧。 — Dept News

通过我们的Typst 基础指南开始您的 Quarto Typst 之旅。

内联代码语法

Quarto 1.4 引入了一种统一的语法，用于内联包含计算值。内联代码的语法类似于代码块，只是您使用单个反引号（`）而不是三个反引号（```），并且可以在 Markdown 中间使用：

Jupyter

```{python}
radius = 5
```

圆的半径是 `{python} radius`

此语法适用于任何 Jupyter 内核——因此对于 Julia，您可以将内联表达式写为 `{julia} radius`）。

Knitr

```{r}
radius <- 5
```

圆的半径是 `{r} radius`

OJS

```{ojs}
radius = 5
```

圆的半径是 `{ojs} radius`

如果你习惯使用 `r `，不用担心，这种语法仍然完全支持。更多信息请阅读内联代码。

交叉引用

Quarto 1.4 对交叉引用进行了全面改进，使你能够实现以下功能：

使用新的交叉引用 Div 语法灵活定义浮动交叉引用（如图表、表格和代码列表）的内容。例如，?@tbl-table 是一个被视为表格的图像：

::: {layout-ncol=“2”}
```
::: {#tbl-table}

![](table.png)

一个被视为表格的图像

:::
```
::: {#tbl-table}

一个被视为表格的图像

:::

:::

并且请注意，如果你将鼠标悬停在文本中出现的引用上，例如悬停在这个指向 ?@tbl-table 的链接上，你会得到内容的浮动预览——这也是新增的功能。
定义自定义类型的浮动交叉引用，你可以用它来创建指向视频、图表或补充图表的交叉引用。
交叉引用可执行代码单元格、标注和注释与解答。

手稿

Quarto 手稿项目为撰写和发表学术文章提供了一个框架。你可以使用笔记本（.qmd 或 .ipynb）作为内容和计算的来源，然后将这些计算与手稿一起发布，让读者深入研究你的代码。

手稿项目的输出是一个包含文章的网站，文章以多种格式（如 LaTeX、MS Word）呈现，并附有项目中笔记本的渲染版本：

手稿网页内容区域的截图。内容显示包括文章标题、作者和摘要的标题块、正文文本以及带有标题的图像。 — 文章内容

手稿网页右侧菜单的截图。菜单包含以下标题：目录、其他格式、笔记本和其他链接。 — 导航

更多关于手稿的信息以及如何开始，请阅读我们的手稿指南。

其他亮点

其他亮点包括：

Python 的 Shiny——在 Quarto 文档中使用 Shiny for Python 的支持。
脚本渲染——渲染特殊格式的 .py、.jl 和 .r 脚本文件。
Quarto 项目的简易 Binder 配置——支持生成将 Quarto 项目部署到 Binder 所需的文件。
连接邮件生成——扩展了 html 输出格式，以便可以通过 Posit Connect 创建和选择性发送 HTML/文本邮件。
发布到 Posit Cloud——将 posit-cloud 添加为 quarto publish 的发布场所。
图像和图表的灯箱处理——支持放大图像和图表，以及将多个图像分组为画廊。

如果你构建 Quarto 扩展，你还应该注意一些面向开发者的变化：

Lua 变化——在过滤器中新增了对可交叉引用元素的支持，扩展了 FloatRefTarget 和 Callout 等 Quarto AST 节点的可扩展渲染器，在 require() 调用中使用相对路径，以及更精确地指定过滤器插入的位置。
AST 处理变化——改进了 v1.3 中添加的 HTML 表格处理，并为 LaTeX 原始块提供了包含 Quarto 兼容 Markdown 以进行处理的方式。

你可以在发布说明中找到 1.4 版本的所有其他变化。

致谢

我们要向所有通过提交问题和拉取请求为此次发布做出贡献的人表示衷心的感谢：

AaronGullickson, abichat, abigailhaddad, aborruso, abraver, acebulsk, aghaynes, ajay333a, ajsmit, ALanguillaume, AlbertRapp, aletroux, alex-vinogradov, alexCardazzi, allefeld, am-lh, andlekbra, andrefmello91, AndreiBiziuk, andrewheiss, anielsen001, apsteinmetz, AQLT, arnaudgallou, aronatkins, atsyplenkov, b-rodrigues, Balaika, baptiste, barryrowlingson, batpigandme, bcongelio, benabel, benjaminschlegel, bfordAIMS, blacksqr, boshek, BradyAJohnston, brtarran, bryanhanson, bweatherson, c-zippel, cadojo, camilogarciabotero, cbrnr, ccamara, cermak-consulting, chendaniely, ChrisJefferson, ChristopherBarrington, christopherkenny, chrisvoncsefalvay, chuxinyuan, cjber, coatless, coltongearhart, CorradoLanera, csgroen, dalejbarr, DamonCharlesRoberts, Damonsoul, daniel-smit-haw, danieltomasz, danmackinlay, daranzolin, darthlite, das-g, davidfoxcroft, davidpomerenke, ddotta, declann, dense-set, dfolio, dgkf, dkapitan, dlakelan, dloss, dmkaplan2000, DOSull, dpabon, dpprdan, DriesSchaumont, drscotthawley, dschief001, dweng0, e-miz, EconomiCurtis, edavidaja, edibotopic, eeenilsson, ehudkr, eitsupi, EllaKaye, emdelponte, emilBeBri, EmilHvitfeldt, emitanaka, epruesse, ercbk, EricJC24, ericvmai, erikerhardt, espinielli, Eugloh, fecet, Felixmil, FeralFlora, finkelshtein, fkohrt, fradav, fuhrmanator, fulem, gadenbuie, garrettgman, GegznaV, Gewerd-Strauss, gimmiereddy, gl-eb, grantmcdermott, gregmacfarlane, gregoireurvoy, gregswinehart, gshotwell, GuillaumeDehaene, gvelasq, gyansinha, hamelsmu, harrelfe, harrylojames, harrysw1729, HelenaLC, helmingstay, HenrikBengtsson, homerhanumat, icarusz, ig0101, ijlyttle, ijmitch, irmoodie, isabelizimm, IULibScholComm, ivelasq, jack-davison, Janidai, jarbet, jasonaris, jatalah, JauntyJJS, jb-leger, jcheng5, jdonland, jdutant, jeremy9959, jeroenjanssens, jfb-h, jfunction, JGobeil, jgomezdans, jgostick, jhchou, jhk0530, jhunter-aof, jimgar, jimjam-slam, jmbuhr, jmcvw, Joda66, joelostblom, joelvonrotz, johngoldin, jonassmedegaard, jpatteet, jrowen, jthomasmock, jtr13, juba, juliantao, jurjoroa, justanothergithubber, jzelner, KaiWaldrant, kbvernon, kcarnold, kdheepak, kdzhang, kejaed, kendonB, knuesel, Kodiologist, kompre, koushikkhan, krishaamer, ksreyes, kwangkim, kyleGrealis, lcnbr, leeroyaus, leonardblaschek, Lextuga007, lidavidm, lillemets, lnnrtwttkhn, luifrancgom, Lulliter, lyndondrake, m-clark, m-guggenmos, machow, maelle, magnusnosnes, MarieEtienne, marklhc, martinfleis, Martinomagnifico, masud90, matanhakim, Matoyatapika, matthew-brett, matthewfinkbeiner, maxdrohde, mfenner, mfisher87, MichaelPascale, mikabr, milanmlft, mine-cetinkaya-rundel, Minh-AnhHuynh, miwojc, mloubout, msarahan, msh855, mslynch, murattasdemir, mvanaman, nanxstats, netique, netw0rkf10w, nickriches, njbart, noahmf, nqt2022, nwisn, nwvhb, OlexiyPukhov, olivroy, ollyhensby, pastorn, pat-s, patgd, petrbouchal, petzi53, phongphuhanam, pieterprovoost, piotr-kaczmarski, pjastr, pommevilla, prosoitos, ptram, qiushiyan, ratnanil, ravicodelabs, rcannood, rchaput, regob, remlapmot, resmartiZH, rgaiacs, rmcd1024, rmflight, rnd195, robolyst, rogerbramon, ronblum, ropeladder, rowanc1, RoyiAvital, rsenft1, salim-b, samcarter, sceptri, sda030, sebacea, sebastian-c, sebastianrowan, sebffischer, seeM, Serenade600, Servinjesus1, shafayetShafee, sharon-wang, shirdekel, simonjackman, sje30, sjspielman, skaltman, smithbn, snhansen, Sparrow0hawk, sswam, stefanbringuier, stephan-koenig, steveguil, Sumidu, sun123zxy, tegorman13, tflexs, th0ger, the-solipsist, TheGoodCartman, TheisFerre, thomascwells, TLouf, tobydriscoll, tom67, tonyaseverson, topepo, tpoisot, TrainedMusician, TS-CUBED, ttalVlatt, Tutuchan, tylermorganwall, ulyngs, ute, vfacta, vitpetrik, VivaldoMendes, VladimirAlexiev, Walser52, warrickball, wch, weihuangwong, wilcar, willingc, wjdenny, wklimowicz, XiangyunHuang, xtimbeau, yoyo25, YuanchenZhu2020, yuxi-liu-wired, yyzeng, zenggyu, Zeno-of-Elea, zief0002, Zuline

本文的列表和社交卡片图像中的派对彩带表情符号来自 OpenMoji——开源表情符号和图标项目。许可证：CC BY-SA 4.0