文書デザイン
自己完結型HTML文書のためのデザインシステム。目標: 画面で正しく表示され、PDFに印刷してもクリーンで、ビルドステップ不要 — どこでも開ける単一ファイル。
references/cv-template.htmlをテンプレートとしてコピーして開始してください。以下のすべての設定が既に組み込まれています。
デザイントークン
すべての色とサーフェスを:rootのカスタムプロパティで定義し、ダークテーマの上書きを用意します。ルール内に16進数の色値を直接記述しないでください。これにより文書のテーマ変更と印刷が容易になります。
:root {
--doc-background: #ffffff;
--doc-background-mid: #eef0ee; /* ページの周囲 */
--doc-border-light: #e3e3e0;
--doc-text-primary: #1d1f22;
--doc-text-secondary: #5f6368;
--doc-accent: #1f6f5c; /* 1つのアクセントカラー、控えめに使用 */
--doc-accent-soft: #e7f1ee; /* チップ/薄い背景色 */
}
html[data-theme='dark'] {
--doc-accent: #4fbfa3;
--doc-accent-soft: #16332b;
}
ルール:
- アクセントカラーは1色のみ。セクション見出し、役職/会社名、箇条書きのマーカーのみに使用します。アクセントを多用すると装飾的に見えます。
- テキストカラーは2色。プライマリは本文、セカンダリはメタデータ(日付、場所、メモ)に使用。
- 塗りつぶしではなく、薄い色で表現。ベタのアクセントブロックではなく、チップには
--doc-accent-softを使用。
レイアウト
- ページ幅は最大820px、中央寄せ、上部マージン24px。これ以上広いと行の長さが読みやすさを損ねます。
- ページ内余白は38~42px。余白が視覚的な重みを持つため、外側の境界線は不要。
- ページ周囲は
--doc-background-midで、白いページがシートとして認識されるようにします。 - セクションは15pxの間隔で積み上げます。構造はボックスやパネルではなく、スペーシングと各セクション見出し下の細い線で表現します。
タイポグラフィ
- システムフォントスタックを使用し、Webフォントは不使用:
-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif。読み込み不要、オフラインでも失敗しません。 - 基本サイズは小さめ: 画面表示で12.8px、行間1.38。これはブログ記事ではなく文書です — 密度は機能です。
- サイズ感: 名前28px/700、セクション見出し11.5px/700大文字、文字間隔1.3px、役職タイトル13.5px/700、本文12~12.5px、メタデータ11px。
- セクション見出しは大文字でアクセントカラー、下部に細い線。これが唯一の見出しスタイルです。別の階層の視覚的階層を追加しないでください。
- ハイフネーションと両端揃え: テキストは左揃えのままにし、両端揃えはしないでください。
印刷ルール
PDFへの印刷が主な用途であるため、印刷用の設定は画面表示と同様に重要です。
@page { size: letter; margin: 0 }とし、余白をページコンテナのパディングに移動させて制御します。- 白背景を強制し、
print-color-adjust: exactを設定して、薄い色のチップが維持されるようにします。 - 約10pt、行間1.3に縮小。画面サイズは紙には大きすぎます。
- 各役職、サブ役職、ヘッダーに
break-inside: avoidを設定し、1つのジョブエントリーがページをまたがないようにします。 - インタラクティブな要素(ボタン、リンク風のコントロール)は印刷時に非表示にします。
アクセシビリティ
- コントラストを維持: 白背景にプライマリテキスト、見出しとマーカーのみアクセントカラー。長い本文テキストにはアクセントカラーを使用しないでください。
- 実際の見出し要素(
h1、h2)を適切な順序で使用。大文字はCSSでスタイリングし、HTML上で大文字で入力しない。 - リンクには説明的なテキストを与え、色だけで区別しない。
- 箇条書きには意味論的なリスト構造を維持 — スクリーンリーダーがリストの長さを通知し、長いCVで役立ちます。
アンチパターン
- マルチカラムレイアウト — 印刷で崩れたり、スクリーンリーダーが誤った順序で読み上げます。
- レイアウトのためのテーブル。
- テキストの代わりに画像やアイコンフォント — PDFのテキスト抽出やATS(採用管理システム)解析に耐えられません。
- ベタのアクセントカラーヘッダー、グラデーション、コンテンツへのドロップシャドウ、またはすべてのセクション間の装飾的な区切り線。
- ブラウザによって挿入されるヘッダー/フッター(日付、URL、ページ番号) — 印刷ダイアログで無効にしてください。