visual-audit

スライドデッキのビジュアル監査

スライドデッキのレイアウトを徹底的に監査します。

手順

1. $ARGUMENTS で指定されたスライドファイルを読みます

2. Quarto（.qmd）ファイルの場合：

   • quarto render Quarto/$ARGUMENTS でレンダリングします
   • レンダリング結果を測定します："${SLIDE_QA_PYTHON:-python3}" scripts/slide-qa.py Quarto/<deck>.html。ヘッドレス Chrome でデッキを読み込み、すべてのフラグメントを表示して、各端からはみ出したピクセル数、該当する要素、スクロール要素内で隠れているコンテンツを含む quality_reports/audits/slide-qa/<deck>/report.md を出力します。また、スライドごとのスクリーンショットと、画像の読み込みに失敗した箇所や、パスが存在しないか大文字・小文字が正しくないローカルファイル（GitHub Pages で問題が発生します）も出力します。OVERFLOW の検出結果はこのレポートを参照し、読み込みに失敗したアセットや大文字・小文字が正しくないアセットも指摘事項です。それ以外の確認には、指摘のあったスライドと情報量の多いスライドのスクリーンショットを読みます。
   • 終了コードが 2 の場合（通常は Playwright が見つからない場合です。スクリプトに一度だけ実行する仮想環境のインストール手順と、設定する SLIDE_QA_PYTHON の行が表示されます）、その旨を伝えます。レンダリングされた情報量の多いスライドの HTML と、ユーザーが提供したスクリーンショットを確認する方法に切り替え、ユーザーが目視確認すべきスライドを明記します

3. Beamer（.tex）ファイルの場合：

   • コンパイルします（/compile-latex を参照）。ログで overfull hbox の警告を確認し、図や情報量の多いコンテンツを含む PDF ページを読みます

4. すべてのスライドを監査します：

   はみ出し： スライドの境界を越えるコンテンツ フォントの一貫性： インラインのフォントサイズ指定、一貫性のないサイズ ボックス過多： 1 枚のスライドに色付きボックスが 3 つ以上（INV-7 では 2 つまで許容）、不適切なボックスの種類 余白： 負のマージンの不足、fig-align の不足 レイアウト： トランジションの不足、導入文の不足、意味に沿った色使い

5. 重要度と推奨事項を含む、スライドごとに整理したレポートを作成します

6. 余白を優先する原則に従います：

   1. 負のマージンで縦方向の余白を減らします
   2. リストをまとめます
   3. 独立した数式を本文内に移します
   4. 画像／SVG のサイズを小さくします
   5. 最終手段としてフォントサイズを小さくします（0.85em 未満にはしません）