Quarto 1.2.280升级后_quarto.yml配置项失效求助

核心原因 #

Quarto 1.2 对 Book 模块的配置结构做了重大调整，原本直接放在 book 节点下的 orcid、date-modified、logo 等字段被迁移到了顶层或其他子节点，旧配置会触发项目验证错误。

逐个配置项的修复/替代方案 #

1. Logo 保留方案（优先级最高） #

原 book: logo: path/to/logo.png 配置已失效，需将 Logo 配置移至顶层的 website 节点（Quarto Book 基于 Website 框架实现）：

website:
  logo: path/to/your-logo.png
  # 可选：自定义导航栏中的 Logo 显示
  navbar:
    logo:
      image: path/to/your-logo.png
      alt: "书籍Logo"

如果需要在书籍首页单独展示 Logo，也可以直接在首页的 .qmd 文件顶部用 Markdown 图片语法插入，配合样式调整：

![书籍Logo](path/to/your-logo.png){style="display:block;margin:0 auto;max-width:200px;"}

2. ORCID 字段处理 #

原 book: orcid: your-orcid-id 配置需移至顶层的 author 节点下：

author:
  - name: "你的名字"
    orcid: "xxxx-xxxx-xxxx-xxxx"

若要在页面显示 ORCID 信息，可在首页或作者信息区块手动添加（图标可本地存放后引用）：

![ORCID图标](path/to/orcid-icon.png) 你的名字 (ORCID: xxxx-xxxx-xxxx-xxxx)

3. Date-modified 替代方案 #

Quarto 1.2 不再支持全局 date-modified 配置，可通过两种方式实现：

• 单页面级：在每个页面的 .qmd 文件顶部 YAML 中添加 date-modified: YYYY-MM-DD，页面渲染时会自动展示修改时间
• 全局页脚：通过 website: footer 配置统一添加网站级修改时间：

website:
  footer:
    left: "最后修改：2024-05-20"

也可以用 Quarto 内置变量 last-modified 自动获取文件最新修改时间（需确保页面元数据启用）：

website:
  footer:
    left: "最后修改：{{< page last-modified >}}"

配置验证方法 #

修改配置后，运行以下命令快速检查配置合法性：

quarto check config

终端会明确提示错误位置，按提示调整即可。

内容的提问来源于stack exchange，提问作者feder80