lint — 設定の実在キー検証
_quarto.yml と front matter を公式仕様の実在キーで検証する
概要
quarto-dsh lint は、_quarto.yml と各 .qmd の front matter を、公式仕様に基づく実在キー辞書で検証します。実在しないキー・値・出力形式を検出します。
使い方
quarto-dsh lint [dir]dir を省略するとカレントディレクトリを検査します。
検出できる問題
実在しない project.type
project:
type: blog # ← 実在しない[error] _quarto.yml:project.type — 値 'blog' は実在しません。有効な値: default, website, book, manuscript未知のトップレベルキー
website:
bogus-key: true # ← 未知のキー未知の出力形式 / キー
format:
markdown-extra: {} # ← 未知の出力形式
html:
nope-option: true # ← 未知のキー
Note実在するキーだけを収録
辞書は quarto-pe のリファレンスを基に凍結しています（src/knowledge/yaml-keys.json）。project.type は default / website / book / manuscript のみで、article / blog は収録していません。
検証できる場所
- トップレベル: project / website / book / format / execute / vars / filters / …
- format: html / pdf / docx / pptx / revealjs
- execute: echo / eval / include / warning / message / error / cache / freeze / fig-*
- 共通メタデータ: title / author / date / lang / toc / number-sections / …
出力が「OK」の場合
問題がなければ次のように表示されます。
OK: 問題はありません。エージェントからの利用
quarto-dsh chat のエージェントも quarto-lint ツールを呼び出し、設定の正確性を確認してから修正を提案します。