academic-beamer-deck

ワークフロー

1. 提供された資料をすべて確認し、内容を把握します。
2. 編集前にスライド計画を作成します（構成、テンポ、統合）。
3. ライブプレゼンテーション向けにストーリーを再構成します。
4. ビジュアルシステムを適用します（テーマ、色、階層）。
5. コンテンツの密度と明瞭さを最適化します。
6. コンテナベースの配置を使用してレイアウトを実装します（スペーシングの応急処置は使いません）。
7. すべてのスライド形式で、コンパイルとビジュアルの仕上がりを確認します。

---

ストーリー構成

標準的な構成：

1. タイトル
2. 導入（興味を引くオープニング）
3. 研究課題
4. ロードマップ
5. 背景
6. データ
7. 識別
8. 結果
9. メカニズム
10. 統合（図／要約）
11. 政策への示唆
12. 重要なポイント
13. 付録

必要に応じて調整しますが、ライブの聴衆にとっての流れを優先します。

---

デザインシステム

テーマ

• カスタムのミニマルな Beamer テーマを使用します
• デフォルトのテーマ（例：CambridgeUS）は避けます
• 次を使用します：
  • aspectratio=169
  • ナビゲーション記号なし
  • カスタムのフレームタイトルとフットライン

---

標準のカラースキーム

ユーザーから指定がない限り、次を使用します：

• プライマリ：SlateTeal (#1B4D5C) -> タイトル、見出し

• アクセント：WarmAmber (#D4A84B) -> ハイライト、重要な数値

• 本文テキスト：DeepCharcoal (#2C3E50)

• セカンダリアクセント：SoftCoral (#C0534D) -> 負の結果／有意性

• ミュート：CoolGray (#8899A6) -> 注記、注釈

• 明るい塗りつぶし：PaleSage (#EDF2F0) -> tcolorbox の塗りつぶし、ブロック本文

• 背景：

  • デフォルト：白 (#FFFFFF)
  • オプション：WarmWhite (#FAFAF8)（すべての図の背景が白以外の場合に限る）

色のルール

• アクセントカラーは控えめに使います
• スライドごとの主要色は最大2～3色にします
• 十分なコントラストを確保します
• スライド全体で一貫性を保ちます

---

タイポグラフィと構成

• 明確な階層を設けます：

  • タイトルを強調
  • 本文は最小限に
  • ハイライトは選択的に使用

• 次を優先します：

  • 重要なアイデアにはボックスを使用
  • 構造化されたレイアウト（列、グリッド）

• 次を避けます：

  • 密度の高い段落
  • ごちゃつき

---

コンテンツのルール

• スライドごとに主旨は1つにします
• テキストよりビジュアルを優先します
• 重複するスライドは統合します
• 補足的な内容は付録に移します
• オーバーレイ（\pause）は控えめに使います

---

図のルール（TikZ／ビジュアル）

次の順に最適化します：

1. 明瞭さ
2. バランス
3. 収まり
4. コンパクトさ

ルール：

• スライドの中央に構成を配置します
• 横方向のつながりがはみ出す場合は、最後のノードを中央揃えの下段に折り返します
  • 1段に収めるためにテキストやノード幅を縮小してはいけません
  • 折り返した段の中央揃えには座標の中点を使います： \coordinate (mid) at ($(first.south)!0.5!(last.south)$); \usetikzlibrary{calc} が必要です
• 不要な矢印は避けます（特に、視覚的に離れた結果ノードへの矢印）
• 注釈ラベルは、対応する親ノードのすぐ下にまとめます
• 注釈テキストにはミュートカラー（CoolGray）を使います
• 結果／アウトカムノードには、明確に区別できるスタイルを使います（例：アクセントカラーの塗りつぶし＋アクセントカラーの枠線）
• インラインのスタイル指定ではなく、再利用可能なノードスタイル（box、resultbox、evidence）を定義します
• 常に positioning ライブラリを使い、手動座標ではなく right=of、below=of を使用します

---

レイアウトのルール（重要）

基本原則

要素をスライドの端にぴったり配置してはいけません。 一貫したセーフゾーンを定義し、構造的に適用します。

---

セーフゾーン

単一のインセット値（例：1.5cm）を定義し、次に一貫して適用します：

• ページ番号（フットラインの rightskip を使用）
• ボタン（末尾に \hspace を追加）
• 右揃えのコンテンツすべて

この値は一度だけ定義して再利用します。値を変更する場合は、適用箇所すべてで変更する必要があります。

---

フレームタイトル

frametitle テンプレートでは、明示的な垂直方向のスペースを使用します：

\setbeamertemplate{frametitle}{%
  \vskip18pt%
  \nointerlineskip%
  {\usebeamerfont{frametitle}\usebeamercolor[fg]{frametitle}\insertframetitle\par}%
  \vskip2pt%
  {\color{AccentColor}\rule{\textwidth}{1.2pt}}%
  \vskip4pt%
}

重要なポイント：

• 先頭の \vskip でスライド端からの余白を調整します
• 16～18pt から始め、ユーザーのフィードバックに応じて調整します
• Beamer のデフォルトの frametitle スペースに頼ってはいけません

---

フットライン／ページ番号

明示的な rightskip を指定した beamercolorbox を必ず使用してください。

\setbeamertemplate{footline}{%
  \begin{beamercolorbox}[wd=\paperwidth, ht=18pt, right, rightskip=1.5cm]{footline}%
    \insertframenumber\,/\,\inserttotalframenumber\vskip4pt%
  \end{beamercolorbox}%
}

これが重要な理由：

• 内容の後ろにある末尾の \hspace は、beamercolorbox の境界で切り取られます
• つまり、\hfill{content}\hspace{Xcm} では、右端から確実に内側へ配置できません
• 確実な方法は、格納先の beamercolorbox に rightskip を設定することだけです
• これは実際に遭遇したレイアウトのバグの中で最も多いものでした

次の方法は使用しないでください：

% BROKEN: hspace gets clipped at box edge
\setbeamertemplate{footline}{%
  \hfill \insertframenumber \hspace{1.5cm}\vskip8pt%
}

---

ボタンとナビゲーション

\hfill を使ったボタンは右端まで押し出され、ページ番号と重なります。

修正方法：各ボタングループの後に、フットラインの rightskip と同じ幅の \hspace を追加します。

\hfill \hyperlink{label}{\beamerbutton{Back}}\hspace{1.5cm}

ボタンがあるすべてのスライドに適用してください。次のスライドも含みます。

• 付録へのリンクがあるメインスライド（SDID、ATT など）
• 戻るボタンがある付録スライド
• 1 行に複数のボタンがあるスライド（最後のボタンの後にのみ \hspace を追加）

複数のボタンが別々の \hfill 行にある場合、末尾に \hspace が必要なのは最後の行だけです。

\hfill \hyperlink{a}{\beamerbutton{Back (A)}}
\hfill \hyperlink{b}{\beamerbutton{Back (B)}}\hspace{1.5cm}

---

構造に関するルール

間隔を変更しても期待どおりに動作しない場合： -> 問題は数値ではなく、構造にあります -> テキストではなく、コンテナ（フットライン／テンプレート）を修正してください -> まず beamercolorbox またはテンプレートの定義を確認してください

---

図の組み込み

• 背景が白い図が1つでもある場合は、スライドの背景も白にしてください
• WarmWhite（#FAFAF8）を使用するのは、すべての図の背景が透明またはスライドの背景と一致している場合に限ります
• すべての \includegraphics 呼び出しで keepaspectratio を使用してください
• 4:3 用に作成された図は 16:9 では正しく伸縮しないため、幅のみを指定してください
• 背景に対して「枠で囲まれた」ように見える図は避けてください

ルール： テーマの厳密さより、視覚的な調和を優先します

---

付録

• タイトルスライドに合わせたスタイルのシンプルな区切りスライドを挿入してください
• appendixnumberbeamer パッケージを使って、スライド番号をリセットしてください
• メインデッキのすべてのハイパーリンクラベルを保持してください
• すべての戻るボタンが、メインデッキの正しいラベルにリンクしていることを確認してください
• 付録スライドは機能性を保ちつつ、プレゼンテーション向けの装飾を抑えてください：
  • 段階的な表示は使用しない
  • 表はより高密度にしても構いません
  • 装飾要素を減らしてください

---

実装ルール

• 間隔の調整による回避策より、構造的な修正を優先してください
• まずコンテナ（beamercolorbox、テンプレート）を確認してください
• 試行錯誤による間隔調整を繰り返さないでください
• \graphicspath{{figures/}} を使用し、すべての画像を figures/ サブディレクトリに保存してください
• コンパイル済みの出力ファイル（.pdf、.aux、.log、.nav、.out、.snm、.synctex.gz、.toc）はコミットしないでください

---

検証

コンパイル

• pdfLaTeX でコンパイルできる必要があります（明示的な要件がない限り XeLaTeX は使用しないでください）
• エラーがゼロであること（表の overfull hbox に関する警告は許容されます）
• 相互参照とハイパーリンクを解決するため、最低 2 回コンパイルしてください

---

視覚的な品質確認

次の点を確認してください。

• フレームタイトルの上部に余白がある（スライドの端に接していない）
• ページ番号が右端から内側に配置されている（隙間が見える）
• どのスライドでも、ボタンとページ番号が重なっていない
• 図が中央に配置され、フレーム内に収まっている
• 図が背景になじんでいる（白い枠が見えない）
• 密度の高い表が読みやすい（特に付録スライドを確認）
• タイトルスライドの要素が詰め込まれていない

---

ストレステスト

次のスライドで確認してください。

• 戻るボタンがある付録スライド（ボタンとページ番号の重なり）
• 密度の高い表（overfull vbox の警告、読みやすさ）
• 複数の図があるスライド（サブフィギュアの配置）
• TikZ の図（はみ出し、中央揃え）
• ナビゲーション要素が多いスライド（ボタンが多数ある堅牢性チェックリスト）
• タイトルスライドと付録の区切り（シンプルなフレームでは間隔が異なる）

---

避けるべき失敗

• スライドに要素を詰め込みすぎる
• 箇条書きを多用しすぎる
• オーバーレイを使いすぎる
• 要素が端で切れる（特にページ番号）
• 図がはみ出す（横長の連結図が 16:9 に収まらない）
• 図と背景の色が一致しない
• 脆弱な間隔調整の回避策（ボックス境界での \hspace）
• ボタンとページ番号が重なる
• メインデッキと付録間のハイパーリンクが切れる

---

成功基準

成功したスライド資料は、次の条件を満たします。

• pdfLaTeX で問題なくコンパイルできる
• 発表時間内に収まる
• 元の資料より発表しやすい
• すっきりとしたプロフェッショナルな見た目である
• 学術的な厳密さを保っている
• （ボタン付きの付録を含む）すべてのスライドで、間隔が確実に適切である
• スライドの端にぴったり接している要素がない

---

ヒューリスティック

迷ったときは、次のようにします。

• シンプルにする
• 配置をそろえる
• 余白を設ける
• テキストではなくコンテナを修正する
• アーカイブではなく、聴衆に向けたライブ発表を最適化する