ljg-present

ljg-present：プレゼンテーション鋳造器

観客がひと目でこのページの主役を見つけられ、話し手が続きを展開するための十分なヒントを得られるようにします。Unixらしさは、正確な関係性、自然な言葉、明確な優先順位、そして意図的に残された余白から生まれます。

ワークフローの振り分け

作業	入口
プレゼンテーションの生成、並べ替え、改善	Workflows/Generate.md

注意点

• share、talk などの用途ラベルは色を決めません。ビジュアルテーマが指定されていない場合は hacker-dark を使用します。
• 2行で1つの判断を表すこともあります。role は語りの機能によって決まり、行数は文字サイズとページ分割にのみ関わります。
• タイトル、本文、ヒント文の3点セットは必須ではありません。主文だけですでに意味が伝わる場合は、それ単独で成立させます。
• Unicode の接続線には等幅グリッドを使用し、中国語のノードは個別に組みます。中国語を1文字ずつ固定幅の文字枠に詰め込まないでください。
• 静的チェックに合格しても、画面として成立するとは限りません。ビルドツールは固定テンプレートを使用します。ブラウザープローブで実際に描画されたページを確認し、スクリーンショットでは視覚的な優先順位を別途確認します。

2種類のコンテンツ契約

モード	使用する場面	忠実性の対象
faithful 忠実なレイアウト	既存の投影用アウトラインがある場合。改稿の許可がない場合	元の文言、順序、表、コード、元画像
editorial プレゼンテーション構成	ユーザーが講演内容の要約、表示内容の再構成、または図の描き直しをすでに依頼している場合	主張、根拠、条件、数値、関係性。画面上のテキストは許可された範囲で改稿できます

現在の依頼ですでに要約または描き直しが許可されている場合は、そのまま実行し、改めて確認しません。プレゼンテーション構成では editingBasis を記録し、画面上のコンテンツから sourceIds をたどって完全な出典に戻れるようにします。講演内容の全体は notes に入れ、N キーで表示します。「プレゼンテーションにする」という依頼だけでは、作者のコンテンツを削除・改稿する許可にはなりません。

デザインと実装

• まず DesignSystem.md を読み、関連するレイアウトの実例を CompositionReference.md で確認します。
• データ契約は RenderingSpec.md、関係図、ネイティブチャート、ソースコードの境界は ChartSpec.md を参照してください。
• Tools/BuildDeck.ts を使ってデータを SloganTemplate.html に組み込みます。成果物の末尾に CSS を追加したり、別の描画分岐を書いたりしません。
• 元資料にある章の転換と間を保ちます。コンテンツノード数、ページ数、図の数は品質目標ではありません。
• 中心的な主張、重要な制限、データは投影距離を考慮して読みやすさを保ちます。補助情報は後景に回すか講演内容に入れます。余白を作るために中心的な情報を縮小してはいけません。

テーマ

明示的な選択 > 明確な theme_* ビジュアルラベル > hacker-dark。一般的な話題や用途ラベルはテーマ選択に関与しません。

意図またはパラメーター	theme
デフォルト、Unix、terminal、ダーク	hacker-dark
ライトな Hacker、--hacker、互換用の --cyber	hacker
-b / --theme=black	black
-r / --theme=red	red
-y / --theme=yellow	yellow

納品物

1つの ~/Downloads/{title}.html。フォントは埋め込み、チャートはインライン、オフライン対応で、アニメーションはありません。→ ↓ Space Enter j PageDown で次へ進みます。← ↑ k PageUp で戻ります。Home/End で最初または最後のページへ移動します。F で全画面表示、N で講演内容を表示します。図や講演内容をスクロールしてもページ送りは発生しません。

静的検証では現在のテンプレートとソースデータを確認します。Interceptor でブラウザーを分離して Tools/ProbeDeck.js を読み込み、全体のサムネイルと代表ページを確認します。分離ブラウザーが利用できない場合は成果物を保持し、視覚的な再検証が未完了であることを正直に報告します。検収済みのように見せるため、メインブラウザーで代用してはいけません。

例

• 「元のアウトラインどおりにプレゼンテーションを作成し、文言は変えないでください」→ faithful。意味に沿ってレイアウトを選び、必要に応じて元の境界に沿ってページを追加します。
• 「話の要点を展示にまとめて、現場で詳しく話せるようにしてください」→ editorial。主張、対比、関係性を抽出し、講演内容の全体を notes に入れます。
• 「古い ASCII 図を Unicode に置き換えてください」→ 描き直しの許可を記録し、ノード、接続、方向に基づいて新しい図を確認します。実際のコードは1文字ずつそのまま保持します。