1.4 版本说明

此版本中的修复

• 更新 Pandoc 至 3.1.12.3，以移除 Pandoc 内置模板中对 polyfill.io 的依赖。

先前版本中的修复

• (#8969): 在 HTML 格式中使用 MathJax 时，将 polyfill.io 替换为 cdnjs.cloudflare.com。
• (#9927): 修复布局中显式尺寸图像的回归问题。
• (#10091): 修复 PDF 格式中无标题图像的 fig-align 属性的回归问题。
• (#8439): 确保处理缺少主题行的情况。
• (#8417): 解析 RawBlock 中的 HTML 时，在输出单元格中保持单一的 AST 元素。
• (#8490): 即使 qmd 单元格包含显式的 echo 声明，也能正确嵌入。
• (#8464): 修复短代码未递归展开的回归问题。
• (#8485): 修复短代码无法处理代码点高于 127 的 Unicode 字符的回归问题。
• (#8507): 修复 docx 中标注渲染的回归问题。
• (#8510): 修复 YAML 配置中使用 sidebar.align 而非 sidebar.alignment 的未记录行为的回归问题。
• (#8514): 修复 number-sections: false 文档中交叉引用渲染不正确的回归问题。
• (#8536): 修复 html 中列指定符的回归问题。
• (#8552): 修复从代码单元格读取标题时的错误行为。
• (#8555): 修复输出页面导航时生成的 HTML 格式错误（书籍和网站）。
• (#8566): 修复 Quarto 仪表板中使用 iTables 的问题。包括大型或宽表格的布局问题、粘性标题的出现，以及使用 iTables 1.7 渲染仪表板时可能发生的挂起问题。
• (#8567): 提高大型网站在长搜索词下的搜索性能。
• (#8586): 修复 LaTeX 表格中多个嵌入引用的渲染回归问题。
• (#8603): 修复多列布局和代码折叠的回归问题。
• (#8630): 修复带有下划线的 LaTeX 交叉引用标识符的回归问题。请注意，此语法在 Quarto 中并未正式支持，但此更改恢复了 1.3 版本中的行为。
• (#8652): 使 IDE 工具中的代码单元格检测在编辑器模式之间保持一致。
• (#8662): 不要错误地阻止在没有索引文件的情况下预览 docusaurus 网站。
• (#8697): 确保带有边距标题的灯箱图正确放置标题。
• (#8708): 解决手稿中 ipynbs 嵌入的复杂布局问题。
• (#8728): 修复 LaTeX 格式中空浮动对象导致的崩溃问题。
• (#8733): 修复 LaTeX 格式中 image-align=right 的回归问题。
• (#8741): 修复 MacOS 安装程序错误报告需要 Rosetta 的问题（实际上不需要）。
• (#8749): 修复使用 quarto publish connect 将 Quarto 项目发布到 Posit Connect 时创建捆绑包的问题。
• (#8785): 修复 LaTeX 格式中非居中、不可引用的子图的问题。
• (#8795): 修复仪表板工具栏中选择控件出现的问题。
• (#8798): 修复渲染 ipynb 笔记本时一级标题重复的问题。
• (#8818): 修复导航栏中 right 项目的对齐问题。
• (#8852): 不要从外部链接中去除 index.html。
• (#8854): 不允许边距脚注破坏 hover-citations。
• (#8858): 修复面包屑中渲染Markdown的问题
• (#8843): 修复在某些R代码单元格发出LaTeX依赖项以包含在LaTeX序言中时书籍的问题。
• (#8857): 修复在Windows上使用Plotly的Jupyter中format: dashboard的问题。
• (#8937): 修复路径中包含空格时的Unix quarto启动器问题。
• (#9076): 修复html格式中带有layout-ncol和column设置的代码单元格的渲染问题。
• (#9200): 修复在可交叉引用的表格元素外部使用tbl-colwidths的回归问题。
• (#9335): 修复代码块内转义的内联代码单元格的错误转义问题。
• (#9356): 不要处理About divs内图形的列类。
• (#9535): 修复从之前的1.4补丁版本中回归的fig-alt问题。
• (#9550): 当子标题错误地指定为fig-subcap: true但没有嵌入子标题时，不要崩溃。
• (#9593): 修复在段落中的跨度中使用column-margin时的回归问题。
• (#9602): 修复解析的HTML表格在pptx和typst等格式中未正确包含的回归问题。
• (#8258): Quarto现在再次支持R 4.1.3及更早版本。
• (#9704): 修复Revealjs中的PDF导出功能回归问题，现在它再次像1.3版本一样工作。
• (#9734): 修复未标记表格和tbl-cap-location信息的问题。

语言

• 添加塞尔维亚-拉丁语翻译（作者：@n_grubor）
• 添加斯洛伐克语翻译（作者：@tom67）
• 改进意大利语中“proof”的翻译（作者：@espinielli）
• 添加希腊语翻译（作者：@cultab）
• 添加挪威语翻译（作者：@lektorodd）
• 添加立陶宛语翻译（作者：@GegznaV）
• 添加繁体中文（台湾）翻译（作者：@bobby1030）
• 更新加泰罗尼亚语翻译（作者：@jmaspons）

依赖项

• 更新至Pandoc 3.1.11
• 更新至Typst 0.10.0

重大变更

• 在网站项目中，具有id属性的单个侧边栏将不再用作全局侧边栏。它将仅用于指定该id的页面或从侧边栏链接的页面。

HTML格式

• 添加对悬停时显示交叉引用内容的支持（使用crossrefs-hover: false禁用）。
• 添加对在HTML页面标题块中显示keywords的支持（当存在时）。
• (#3473): 添加对网站目录的body-right和body-left布局的支持。
• (#3895): 其他格式链接可以出现在左侧（确保它们遵循toc-location，无论是否可见目录）。
• (#4840): 添加对使用client-url指定自定义Hypothesis客户端URL的支持。
• (#4882): 添加对canonical-url的支持，当提供时，将包含一个rel=’canonical’的链接标签，该标签将使用显式提供的或自动生成的规范URL。
• (#5189): 确保即使page-layout为自定义时也显示附录。
• (#5196): 正确支持HTML输出的title-prefix。
• (#5210): 更新至Bootstrap 5.2.2。
• (#5393): 正确设置标题的颜色，不使用不透明度。
• (#5403): 修复kbd短代码的可访问性问题。
• (#5431): 正确应用标题元数据的列定位。
• (#5516): 确保出现在边距中的图像被正确标记为流体。
• (#5663): 正确地将列网格位置转发给带有边距元素的子网格。
• (#5700): 在Windows上悬停代码注释时不要显示滚动条。
• (#5708): 修复在查看带有特定查询参数的页面时出现的挂起问题
• (#5789): 在某些情况下修正无语言代码单元格的外观
• (#5794): 修复在scss主题中使用import时的缓存行为错误
• (#5798): 提高HTML提示框布局的一致性
• (#5856): 始终渲染HTML页面的标题块（之前仅在提供标题或副标题时渲染）
• (#5929): 拆分border-bottom属性以避免生成的CSS中出现无效的inherit条目
• (#5955): 修正当标题不存在时HTML提示框的外观
• (#5957): 修复当页边注释包含在标题或其他格式化文本中时的布局问题
• (#6004): 改善Quarto HTML文档中Cross Talk控件的外观
• (#6163): 将dot单元格的svg输出包裹在RawBlock html元素中
• (#6430): 修复当page-layout: full时横幅样式标题块作者的布局问题
• (#6627): 为复选框输入添加一些margin-right
• (#6693): 微调表格外观以提高一致性
• (#6714): 当存在其他（非标题/作者/副标题）元数据时显示HTML的标题块
• (#6833): 处理video短代码中部分指定的宽高比、宽度和高度属性
• (#6910): 正确地将code-summary作为全局HTML选项转发
• (#7024): 确保即使安装的Quarto文件不可写，HTML文档也能正确渲染
• (#7137): 在外部链接上设置目标时自动设置rel="noopener"
• (#7183): 用margin-aside类标记出现在页边的旁注
• (#7187): 在文档和项目级别的元数据中添加html-table-processing: none以禁用HTML表格处理。在围栏div中添加{html-table-processing="none"}以禁用该div中元素的HTML表格处理。在knitr或jupyter单元格中添加html-table-processing: none以禁用单元格输出内容的HTML表格处理
• (#7441): 悬停框中的链接（例如当悬停引用时选择加入的DOI链接）现在正确处理外部和新窗口链接（当link-external-icon: true和link-external-newwindow: true时）
• (#7542): 当作者中既有带附属机构的作者也有不带附属机构的作者时，标题块将正确显示作者的附属机构
• 确保代码注释按钮不是可选文本
• (#7364): 恢复对面板中layout-align属性的支持
• (#8032): 修复当页边注释包含在提示框内的列表项中时的布局问题
• (#7153): 修复当页边注释包含在块引用中时的布局问题

附录

• (#6783): 添加更多CC许可证，改进链接文本
• (#5685): 为附录部分提供一致的ID

RevealJS格式

• (#1943): 允许在演示文稿前文中设置code-block-height
• (#3671): 从目录中移除无标题的幻灯片
• (#5210): 更新至Bootstrap 5.2.2
• (#5546): 链接内的图像无法拉伸，因此自动拉伸功能现在忽略它们
• (#5783): 确保围栏代码块与行号一起工作
• (#6120): pdf-max-pages-per-slide 现在正确地为 RevealJS 设置了 pdfMaxPagesPerSlide 配置。
• (#6800): 当最后一页幻灯片被隐藏时，将自动添加的内容（如幻灯片页脚等）移动到 DOM 的顶层，以避免无意中删除它们。
• (#6827): 在更改外观时，正确布局 revealjs 幻灯片中的标注。
• (#6853, #5208): 当 attr 非空时，将标注包裹在 div 中。
• (#7042): 行高亮现在与代码注释正确配合。
• (#7104): 行高亮渐进显示现在在右侧正确显示代码注释锚点。
• (#7366): smaller: true 现在在嵌套幻灯片上正确应用。
• (#7394): 修复了在 output-location: fragment 时 revealjs 幻灯片中 mermaid 图表的问题。
• (#4988): 删除了编号代码行上的链接目标，因为 revealjs 不支持它们，导航仅通过幻灯片进行。
• (#4156): 在深色背景的幻灯片上，页脚和幻灯片编号文本现在根据 $dark-bg-text-color 适配了文本淡色。
• (#7134): 现在可以直接在图像上应用 .nostretch，以在 auto-stretch: true（默认）时选择退出 Revealjs 的图像拉伸。

PDF 格式

• (#4370): 将 AST 中深处的代码单元格提升到布局单元格外，以避免 Shaded 环境中的 \raisebox 问题。
• (#5078): 当 latex-auto-mk 为 false 时，确保在 PDF 渲染之前复制格式资源。
• (#5058): 为 PDF 格式添加了一个 before-title.tex 部分。该部分将出现在标题块之前的文档前言中，允许进一步自定义文档前言。默认情况下，此部分为空。
• (#5969): 在使用 backref 链接选项时，正确检测 biblatex 的重新运行需求。
• (#5690): 改进了 pdf-engine 的验证。
• (#6077): 确保证明环境在其内容周围紧密。
• (#6907): 修复了脚注标记行处理器未触发的问题。
• (#6990): 修复了 filename 代码单元格属性中的下划线未转义的问题。
• (#7175): 修复了使用多位数字作为注释编号时的代码注释问题。
• (#7267): 修复了 longtable 环境干扰 table 计数器的问题。
• (#7434): 在解析 PDF 中的图像时支持 resource-path。
• (#7534): 修复了在使用 reference-location: margin 时多段落脚注的问题。
• (#7568): 现在在 LaTeX 文档中，当同一行有其他注释时，代码注释也能正常工作。
• (#6716): 修复了在边距中放置引用时的 marginpar 错误。

Docusaurus 格式

• (#5152): 在 Docusaurus 输出中支持 code-line-numbers: true。
• (#6046): 修复了 Docusaurus 输出中的引用回归问题。
• (#6310): 通过默认渲染到 .mdx 来支持 Docusaurus 3.0。
• (#7201): 支持使用 code-line-numbers 进行行高亮，作为原始块属性或代码单元格选项。

Beamer 格式

• (#3650): 使用 classoption=notheorems 以避免与 Quarto 自己的定理环境冲突。
• (#5536): 通过修复浮动环境问题，正确支持 Beamer 输出的代码文件名功能。
• (#6041): 正确支持代码块外观选项（code-block-bg 和 code-block-border-left）。
• (#6226): 正确检测在使用 lualatex 时是否需要额外的编译以进行目录布局。
• (#6956): 为 format: beamer 添加 number-section 支持，以控制是否对章节进行编号。

Asciidoc 格式

• (#6589): 当 format: asciidoc 且标题缺失时不崩溃。
• (#7632): 在提示框内正确渲染引用。

Confluence 格式

• (#5151): 发布时提供关于附件延迟的信息性消息。
• (#7256): 提示框中不再产生不必要的换行。

网站列表

• (#3933): 当选择 minimal 时，不发出基础 Quarto CSS 或主题高亮 CSS。
• (#4800): 添加在列表中包含 xml-stylesheet 的支持。使用 feed: 下的 xml-stylesheet: example.xsl 提供 XSL 样式表的路径以样式化您的 RSS 源。
• (#5371): 正确计算列表中包含的描述的修剪长度。
• (#5463): 如果列表的 contents 不匹配任何项目，则报错。
• (#5742): 使用任何元素计算列表的描述，即使没有段落。
• (#5802): 如果列表表格显示没有日期的项目，则不显示日期值的 undefined 字符串。
• (#5805): 将继承的 word-break: break-word 样式（Bootstrap）更新为 word-break: keep-all，以防止列表中的单词断字。
• (#6029): 仅在没有其他图像可用时，才使用列表的 image-placeholder。
• (#6091): 自动发现图像时不使用远程/绝对路径图像。
• (#6268): 即使 theme: none 也启用列表。
• (#6407): 为列表项目添加 word-count 字段的支持。默认不显示。
• (#6408): 修复在 Windows 上使用 yaml 创建包含外部路径（例如 path: https://www.quarto.org）的列表时的错误。
• (#6447): 修复页面有多个列表（或在 yaml 中作为数组项传递的单个列表）时的图像占位符。
• (#6777): 在列表中包含自定义字段时，支持复杂字段如 citation.container-title。
• (#6903): 不显示元数据文件中提供的外部路径的 path 字段。
• (#6904): 在源中，移除不应包含 index.html 的 URL 中的 index.html。
• (#7088): 在默认列表模板中不发出多余的链接或空白。
• (#7184): 正确使用 Bootstrap 变量 pagination-active-color 为分页控件着色。
• (#7634): 使用显式宽度以确保默认列表布局不会超出其期望的边界。
• (#7345): 改进表格样式列表中类别的显示。
• (#7699): 当项目级渲染渲染 HTML 和其他格式（例如，同时包含 HTML 和 PDF 格式的书籍）时，正确忽略非 HTML 输出的列表。
• (#7290): 添加 feed:type 为 metadata 的支持，这将仅在生成 RSS 源时使用显式提供的描述元数据。此外，请注意，partial 源类型在有描述可用时，将优先使用显式描述而非第一段。
• 添加对使用 include 或 exclude 以 glob 语法从列表中程序化过滤内容的支持，以包含或排除列表中的特定项目。参见 https://github.com/quarto-dev/quarto-cli/commit/d415d9ca5b7cb59a8a4750dd3eeb60116b931bd6s
• (#8197): 自定义的 field-types 现在能正确地与网站列表的默认值合并。

网站

• 添加对 navbar > toggle-position 的支持，以控制响应式导航栏切换按钮是显示在右侧还是左侧。
• 添加在页面或 _metadata.yml 中设置 page-navigation: true|false 的支持。这允许网站的单个页面或部分控制是否显示 page-navigation。
• 添加对 bread-crumbs: true|false 的支持，以控制是否显示面包屑导航。当 bread-crumbs 为 true 时，支持在全宽（非移动设备）页面上显示面包屑导航。默认值为 true。
• 在 search 键内添加对 show-item-context 键的支持，以控制是否在搜索结果中显示页面父级。传递 tree、parent、root 或布尔值（如果传递 true，则默认为 tree）。
• (#3493): 修复了在使用 @ 符号的 href 时，网站关于页面抱怨缺少引文的问题。
• (#4668): 允许通过提供 repo-url，使用页面元数据（前言或 _metadata.yml 文件）覆盖页面的 repo-url。
• (#4739): 改进了在移动设备响应尺寸下的阅读模式处理。
• (#5204): 关于页面依赖于 TOC 位于右侧，因此强制其为 true。
• (#5212): 确保导航栏搜索按钮遵循 collapse-below 并保持正确对齐。
• (#5251): 允许单个页面指定 image: false，以防止 Twitter 和 Open Graph 元数据的图像发现。
• (#5283): 添加在文档中设置 repo-actions: false 的支持，以防止在特定页面上显示仓库操作。
• (#5389): 允许网站项目提供用于社交元数据标签的默认图像。
• (#5503): 修复了 href 文本的 Markdown 渲染问题，即将破折号转换为 en/em 破折号。
• (#5604): 将页脚内容作为块处理。
• (#5624): 添加对本地化 Cookie 同意的支持（使用文档的语言或通过在 cookie 同意键下明确指定语言）。
• (#5625): 优先使用网站指定的图像（如果已指定），而不是页面中出现的未装饰图像。
• (#5689): 不要将带有 id 的单个侧边栏用作全局侧边栏（id 明确表示该侧边栏将匹配指定该 id 的页面或侧边栏包含的页面）。
• (#5756): 为导航栏工具添加 rel="..." 解析。
• (#5763): 添加键盘快捷键以启动搜索（默认为 f 或 /）。使用 search > keyboard-shortcut 覆盖为您自己的键。
• (#5818): 确保网站（和书籍）的 repo-actions 在页脚中响应式显示，如果 TOC 不可见。
• (#5932): 修正 Open Graph 元数据键名 og:site_name。
• (#5964): 添加对 repo-link-target 和 repo-link-rel 的支持，以控制仓库操作链接的相应属性。
• (#6432): 不要用外部链接图标装饰导航工具（我们通常不会以这种方式装饰导航界面）。
• (#6703): 当文档中的 theme 键被忽略时，警告用户。
• (#6704): 当有重复的侧边栏 href 目标时，使用正确的标题。
• (#6708): 防止在网站和书籍的摘要或描述中重复脚注。
• (#6732): 允许为社交元数据指定全局替代文本。
• (#7447): 在 SCSS 主题中更改 $primary 颜色现在会正确更改导航栏背景颜色。
• (#7754): 如果没有其他标题可用，则使用网站标题作为页面的 html title。
• (#8083): 当存在侧边栏时，改进“关于”页面的布局
• (#8150): 正确支持侧边栏对齐。默认侧边栏文本对齐方式为左对齐。
• (#8166): 在使用项目路径时，正确识别“image”属性作为资源。

网站搜索

• (#4531): 章节交叉引用现在可以正确搜索
• (#7105): 通过提高默认限制并修复和移除Algolia在限制超过20时出现的警告，改进搜索结果。
• (#7150): 搜索快捷键不会拦截指向输入框的按键。
• (#7117): 确保在未滚动到页面顶部时（由于键盘显示而滚动），移动布局中的搜索功能正常工作（不会在滚动时关闭搜索）。
• (#7796): 允许使用语言键 search-text-placeholder 提供占位符文本

书籍

• (#5454): 修复在书籍项目中添加 asciidoc 等格式时预览出错的问题。
• (#5630): 正确生成书籍的分享URL
• (#6708): 防止网站和书籍中摘要或描述内的脚注重复。
• (#7206): 正确启用书籍的 issue-url
• (#8011): 改进对无章节章节的搜索支持。
• (#8145): 支持书籍工具（下载、分享、源代码）的本地化

发布

• (#5436): 添加对发布到Posit Cloud的支持。
• (#5220): 在发布默认Quarto项目中的单个文件时，正确尊重 output-dir
• (#4498): 当 quarto publish gh-pages 失败时，提供更好的错误信息，因为 origin 远程不存在 gh-pages 分支。

视频（和音频）

• (#5496, #5847, #5268): 正确显示网站项目中的本地音频和视频文件（正确识别 src 作为资源）

预览

• 显示渲染输出/进度，对于超过2秒的预览
• 从进度UI中取消正在执行的预览的能力
• 自动渲染缺失的格式（例如PDF、MS Word）
• 从 hugo.toml 正确检测Hugo项目类型（除了已经支持的 config.toml）
• 仅对明确选择加入的语言重用Jupyter内核
• (#4801): 在没有根索引文件的情况下预览默认项目类型的目录时，提供更具体的错误信息
• (#5882): 在PDF预览的查看器重定向中使用 Cache-Control 头配置禁用浏览器缓存，正确允许稍后在同一端口上进行HTML预览。

Jupyter

• 支持执行内联表达式（例如 `{python} x`）
• 改进对虚假matplotlib纯文本输出的检测/排除
• 在将Colab笔记本转换为qmd时，正确排除 id 字段。
• 更彻底地清除由matplotlib中间语句创建的文本工件。
• 添加 ipynb-shell-interactivity 选项（启用指定IPython InteractiveShell.ast_node_interactivity 选项）
• 仅在引擎语言为Julia时搜索Julia的conda安装
• 支持 plotly-connected 选项，以确定Plotly是嵌入还是从CDN加载
• 减少Plotly图表的默认边距（t=30,r=0,b=0,l=0）
• 当非包Python模块更改时，重启内核守护进程
• (#5051): 不要在尾部空格的强标签中发出，以免混淆Jupyter MD阅读器。
• (#6344): 在Python代码单元格元数据中出现YAML解析错误时，稍微改进错误信息。
• (#6367): 修复在从.qmd文件生成Jupyter笔记本时嵌套代码单元的错误。
• (#6393): 在搜索 Julia 特定的 Python 安装时，搜索 JULIA_HOME。
• (#7016): 在搜索未激活环境时，忽略我们没有权限的目录。
• (#7302): 在 Quarto 文档中嵌入多个笔记本的输出时，避免名称冲突
• (#7512): 当在 YAML 中使用 jupyter 键设置的内核未找到时，改进错误消息，列出已知的内核。
• (#7548): 由于与 display() 的交互，不要在 Julia 的 CairoMakie 中使用 fig_format="png"
• (#7607): 使 output: asis 的行为与 knitr 引擎相同，在必要时发出 div 包围。
• (#5363): 修复 Quarto 在读取笔记本时错误地将某些标题用作标题的问题。
• (#6411): 如果项目正在提供标题，则不执行笔记本标题修复。

Knitr

• (#4735): 现在更好地支持 knitr 块的特殊 verbatim 和 embed 语言引擎，包括带有特殊 quarto 单元选项，如 echo: fenced。
• (#5506): 修复当 knitr::asis_output(x) 与 length(x) != 1 一起使用时 if-statement 中的错误（作者: @rcannood）。
• (#6775): 避免重复用于在编织期间使 ojs_define() 可访问的特殊内部 tools:quarto R 环境。
• (#6792): 在 YAML 配置级别提供的 fig-asp 现在正确地设置 knitr 中的 fig.asp 块选项。
• (#7002): layout-valign 正确地转发到 HTML，以调整计算图形的垂直布局对齐。
• (#5994): ojs 或 mermaid 单元格的 include 或 echo 等选项现在在使用 knitr 引擎时正确处理。
• (#4869): sql 单元格输出现在有正确的 Quarto 处理，因此特定功能如 column: margin 可以工作。
• (#7600): output: asis 现在正确地不在类 knit_asis 的单元格输出周围发出 .cell-output-display div。
• (#7877): crop: false 块选项允许在检测到 pdfcrop 和 ghostscript 时选择退出（按块或全局）PDF 中的自动裁剪。这补充了 knitr 的方式 crop: null。
• (#7943): 内部 Quarto R 函数不应泄漏到用户的全局环境中。
• (#7029): 修复在 R 中读取配置时的一些编码问题。

OJS 引擎

• 将 observablehq 的运行时更新到版本 5.6.0。
• (#4927): 在 OJS 代码单元格中添加对 code-summary 选项的支持。
• (#5215): 在提供单文件预览时，将 CORS 请求报告为纯文本。
• (#6267): 修复在 file:// 中运行时的错误消息。
• (#7537): 代码注释与 OJS 单元格更好地配合。
• (#7747): 修复 FileAttachment 路径解析，使其与 revealjs 格式（以及更一般地说，具有非空哈希的 URL）一起工作。
• (#8071): 添加对 hugo-md 作为输出格式的支持。

Mermaid 图表

• 升级到 10.2.0-rc.2
• (#5426): 在 markdown 格式中不转义 mermaid 输出（作者: @rcannood）。

代码注释

• (#5339): 改进代码注释在可滚动幻灯片上的行为

• (#6016): 确保注释在 Safari 中位于正确的行上

• (#6385): 添加对围栏代码单元格中代码注释的支持

• (#7056): 仅在必要时使悬停注释的内容可滚动

• (#7435): 使用 # 作为未知语言的备用注释字符

• 添加对 OCaml 代码注释的支持 ## 作者与机构

• 增加了对指定作者角色的支持，在适用情况下，可选支持贡献程度和自动规范化CreDiT角色。

• 改进了对机构元数据的支持，包括ringgold、isni、ror。

• 增加了对资助的支持，包括支持简单字符串或包含来源、接收者和调查者的资助。来源和接收者可以是

  • 一个或多个简单字符串，ref指向作者或机构ID，或遵循机构模式的物体。

• (#5764): 增加了对机构包含组属性的支持，以表示机构内的团队或研究组。

• (#6068): 在默认的commonmark和gfm输出中正确显示作者姓名。

• (#6138): 增加了对学位的支持，以指定学术头衔或专业认证，显示在个人姓名之后（例如，“MD”，“PhD”）。

• (#6139): 对于不包含yaml前言的markdown输出，仍然执行作者规范化。当yaml_metadata_block启用时（或对于pandoc markdown），不要规范化作者前言，因为这会导致多余的作者键。

Lua过滤器

• 增加了对require()调用中相对路径的支持。
• 增加了对quarto.doc.add_resource和quarto.doc.add_supporting的支持。add_resource将资源文件添加到当前渲染中，将该文件复制到输出目录中的相同相对位置。add_supporting将支持文件添加到当前渲染中，将该文件移动到输出目录中的相同相对位置。
• (#5242): 在错误消息中添加行号。
• (#5461): 确保stripTrailingSpace的返回类型始终为pandoc.List。
• (#5466): 为用户过滤器提供全局环境_G。
• (#6211): 当找不到JSON过滤器（或可能拼写错误的来自扩展的Lua过滤器）时，改进错误消息。
• (#6215): 在Lua API中添加quarto.utils.string_to_inlines和quarto.utils.string_to_blocks，将字符串转换为内联列表或块列表，考虑quarto的AST结构。
• (#6289): 允许markdownToInlines接受空字符串。
• (#6935): 在quarto.format API中添加isGithubMarkdownOutput()。
• (#6935): 使用GitHub的语法渲染gfm的提示框。
• (#7067): 为用户Lua过滤器添加新的入口点。参见https://quarto.org/docs/prerelease/1.4/lua_changes.html。
• (#7083): 为Span和Div节点分离自定义节点处理器，启用条件内容跨度（作者: @knuesel）。

Debian安装程序

• (#3785): 推荐安装unzip，在安装扩展时使用。
• (#5167): 如果无法在路径中创建符号链接，不要失败安装。

可引用的文章

• (#6766): 在指定文档引用元数据时，将id添加为有效的CSL属性。

交叉引用

• (#2551): 支持没有标题的可交叉引用图表。
• (#6620): 引入FloatRefTarget AST节点，将交叉引用目标泛化为包括图表、表格和自定义浮动元素。
• (#7200): 在子引用标签中支持Unicode。

输入格式

• (#7905): 在处理HTML rawblocks以避免Pandoc将SVG元素转换为图像时，使用html+raw_html作为输入格式。

扩展

• 在安装扩展时，提供打开文档解释使用方法的选项。
• (#4889): 在尝试创建重复扩展时改进错误消息。
• (#6759): 正确支持格式扩展控制它们使用的过滤器顺序。
• (#7375): 更新扩展时，现在会删除新版本扩展中不存在的文件。
• (#7886): Better support installation of extensions and usage of templates from repos which have been renamed.
• (#7909): Properly resolve filter extensions even when a directory of the same name exists.

Other Fixes and Improvements

• Exit if project pre or post render script fails
• Support --output-dir for rendering individual files.
• Use InternalError in typescript code, and offer a more helpful error message when an internal error happens.
• (#1173): Allow specifying margin caption location on a per cell basis
• (#1237): Allow include shortcodes to be resolved from inside non-executable code cells and metadata blocks.
• (#1392): Add tools and LaTeX information to quarto check output.
• (#2214, reopened): don’t report a non-existing version of Google Chrome in macOS.
• (#3599, #5870): Fix hash issue causing unexpected render when freeze is activated on Windows but re-rendered on Linux (e.g. in Github Action).
• (#4614): Correctly remove empty mediabag directory in remote drives.
• (#4673): Quarto now report in check and error message if rmarkdown R package minimal requirement (>= 2.3) is not fullfilled, and it will ask to update the package.
• (#4820): Add support for setting the Giscus light/dark themes.
• (#5377): support from: formats correctly.
• (#5421): Correct quarto --help command to provide correct commands and descriptions
• (#5444): Introduce a build command make-installer-dir to better support third party packaging without dependencies. Fine tuning of code/patch provided in https://github.com/conda-forge/quarto-feedstock/pull/7.
• (#5748): Don’t cleanup shared lib_dir files when using embed-resources within a project
• (#5755): Allow document metadata to control conditional content.
• (#5785): Don’t process juptyer notebook markdown into metadata when embedding notebooks into documents.
• (#5902): Support paired shortcode syntax.
• (#6013): Don’t error if citation is passed as a boolean value in metadata via flags
• (#6042): Correctly support empty lines in YAML blocks.
• (#6142): Properly respect DENO_DIR when set
• (#6154): quarto check knitr does not fail anymore when user’s .Rprofile contains cat() calls.
• (#6178): When QUARTO_LOG_LEVEL=DEBUG, information about search for a R binary will be shown.
• (#6207): When QUARTO_R is set to a non-existing path, a warning is now thrown like with QUARTO_PYTHON. Quarto still fallback to search a working R version.
• (#6244): Code annotation now works for executable code cells using echo: fenced. Also it now supports HTML and Markdown code cells.
• (#6269): Fix issue with YAML validation where the annotated value was incorrectly built.
• (#6487): Fix serviceworkers check in htmlDependency to look at the correct key.
• (#6568): Trim file extension in data URI that might have been inadvertently added by Pandoc.
• (#6620): Rewrite Crossreferenceable figure support. See the prerelease documentation for more information.
• (#6697): Fix issue with outputing to stdout (quarto render <file> -o -) on Windows.
• (#6705): Fix issue with gfm output being removed when rendered with other formats.
• (#6746): 允许标准输出和标准错误独立完成，以避免死锁。
• (#6807): 改进生成的CSS文件中的源映射引用清理。
• (#6825): 当发生YAML解析错误时显示文件名。
• (#6836): 修复引用模式中docx格式下abstract键缺失的问题。
• (#7013): 当无法找到或运行R时，改进错误信息，并在详细模式中增加更多详细信息。
• (#7032): quarto现在可以正确运行，即使安装在路径中包含空格的文件夹中。
• (#7131): 修复JATS子文章模板中ISBN条目的拼写错误（作者: @jasonaris）。
• (#7252): 改进对某些与expl3.sty加载相关的LaTeX支持文件不匹配情况的处理。
• (#7502): 修正execute-debug帮助文本
• (#7674): 在安装后为TinyTeX配置字体路径，以便xetex能够正确找到自定义字体。
• (#7675): 在Windows上，当APPDATA不是TeX Live的合适位置时，quarto install tinytex会将TinyTeX安装到由环境变量ProgramData定义的目录中。
• (#8086): 在meta短代码中添加对数组元数据索引的支持。
• (#8245): 在Windows上，防止Quarto因尝试从注册表读取代码页时访问问题而导致的错误。