Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

_quarto.yml: unknown or misplaced keys under project:/website: are silently ignored (Quarto 1 fails validation)

Đang mở
  • Có gì không ổn?
#880 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
48/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
rust, yaml
Lĩnh vực
build-system, developer-experience

Hướng nghiên cứu

Start by tracing q2 render project configuration loading and the existing Q-1-18 diagnostic for unknown properties, then inspect the schemas for project, website, and other closed top-level blocks. Add validation that reports unknown or misplaced keys with their location; a useful result is diagnostics for the shown tocc and llms-text examples, with the existing format.html.llms-txt case still handled according to its open schema.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

bug

Summary

_quarto.yml is not checked for unknown or misplaced keys. A typo under website: or project:, or a key nested under the wrong parent, renders silently with the option having no effect. Quarto 1 fails validation with the property name and location. q2 has the diagnostic for this (Q-1-18 Unknown Property, "closed" schemas) and its doc even lists "a property that belongs to a different block" as a typical cause, but it does not fire for the project config.

How this was found: llms-txt: true placed under format: html: instead of website: produced nothing, no warning, and it took a trip to the docs to see why. (Quarto 1 is silent for that specific placement too, since format.html is open for pandoc metadata; the cases below are the ones where it does speak up.)

Repro

A scaffold (q2 create project website site --no-prompt) with one of these configs:

Unknown and misspelled keys under website:

project:
  type: website
website:
  title: "site"
  tocc: true
  llms-text: true
format:
  html:
    theme: cosmo

Unknown key under project:

project:
  type: website
  tocc: true
website:
  title: "site"
format:
  html:
    theme: cosmo

Known key under the wrong parent

project:
  type: website
website:
  title: "site"
format:
  html:
    theme: cosmo
    llms-txt: true

q2 render site
quarto render site
Config Quarto 1 (99.9.9 dev) q2 0.35.0-nightly.20261021
website.tocc, website.llms-text ERROR: … validation failed. (line 5, columns 3--7) property name tocc is invalid … (line 6) property name llms-text is invalid, with the location website:tocc renders, no output
project.tocc ERROR: … property name tocc is invalid … location project:tocc renders, no output
format.html.llms-txt renders, no output renders, no output

Expected

At least what Quarto 1 does: Q-1-18 for unknown properties under the closed blocks (project, website, and the other top-level blocks that have schemas), as an error or at least a warning. A nice extra that Quarto 1 does not have: when the unknown key is a known key of a sibling block (llms-txt is website.llms-txt), say so in the hint.

Environment

q2 0.35.0-nightly.20261021 (macOS arm64); repo at ad283a2cb. Quarto 1 at 99.9.9 (dev build from quarto-cli).

Ngôn ngữ chính
Rust
Star
278
Fork
19
Merge trung bình
20 giờ 23 phút
Pull request đã merge (30 ngày)
164

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của quarto-dev/q2

Tất cả issue của quarto-dev/q2

Issue tương tự

Thêm issue về Rust

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.