manuscript-typography

原稿のタイポグラフィ監査

パイプライン上の位置： フェーズ 2b（仕上げ監査）。manuscript-provenance と並行して実行します。依存関係：フェーズ 1 の修正後に内容が確定していること。 実行順序の全体については /manuscript-pipeline を参照してください。

目的

LaTeX 原稿を監査し、可読性と専門的な見た目に直接影響する、広く認められた学術的なタイポグラフィの慣例を確認します。これらは特定の投稿先に固有の書式規則ではなく、何十年にもわたる学術出版で確立された、経験豊富な読者や査読者が気づく投稿先を問わない規範です。

内容がしっかりしていても、タイポグラフィが拙い論文は経験不足を印象づけます。査読者は、ひとつの文を読む前に、視覚的な体裁から印象を形成します。

他のスキルとの関係

懸念事項	manuscript-review	manuscript-typography（本スキル）	arxiv-preflight
表の内容	データ品質、有効数字（§12）	デザイン：booktabs、配置、見出し、キャプションの位置	書式への準拠
図の内容	色覚への配慮、軸ラベル、チャートジャンク（§12）	デザイン：フォントの適合、背景、サブフィギュアのスタイル	書式／サイズへの準拠
レンダリング結果	可読性、フロートの近接性、改ページ（§23）	レイアウト：孤立行、段組みのバランス、間隔、フロート指定子	該当なし
数式表記	表記の一貫性、演算子の書式（§15）	間隔、区切り記号のサイズ、ディスプレイ数式とインライン数式の選択	該当なし
相互参照	引用の適切さ（§11）	参照スタイルの一貫性、改行不可スペース	該当なし
タイポグラフィ	該当なし	ダッシュ、引用符、単位、マイクロタイポグラフィ	該当なし
仕上げ	該当なし	TODO、プレースホルダー、メタデータ、ブックマーク	該当なし

ルール： このスキルはデザインとタイポグラフィを監査します。manuscript-review は内容とコミュニケーションを監査します。arxiv-preflight は投稿要件への準拠を監査します。 重複はありません。それぞれが同じ文書から異なる情報を確認します。

ワークフロー

1. 取り込み

すべての .tex ファイル（メインファイルと \input／\include の対象）を読み込みます。以下を特定します。

• ドキュメントクラスと読み込まれているパッケージ
• 2 段組みか 1 段組みか
• 投稿先（クラス／テンプレートから特定できる場合）

コンパイル済み PDF がある場合は、レンダリング結果の確認に使用します。

2. 監査項目

各項目を次のように判定します。

• FAIL — 慣例に違反しています（文書ファイル、行番号、LaTeX コードを含む具体的な修正方法）
• WARN — 判断が分かれるものの、検討する価値があります
• PASS — 慣例に従っています
• N/A — 該当しません

---

パス 1 — 表のデザイン

1.1 表の構造

• booktabs パッケージを使用します：\toprule、\midrule、\bottomrule
• \hline は使用しません（booktabs の同等のコマンドに置き換えます）
• 縦罫線（列指定の |）は使用しません。表の縦罫線は、組版に不慣れな印象を与えます
• 二重の横罫線は使用しません
• 例外：ドキュメントクラスで特定の表スタイルが必須の場合は、注記しますが指摘対象にはしません

% BAD
\begin{tabular}{|l|c|r|}
\hline
Method & Accuracy & F1 \\
\hline\hline
Ours & 0.94 & 0.91 \\
\hline
\end{tabular}

% GOOD
\begin{tabular}{lcr}
\toprule
Method & Accuracy & F1 \\
\midrule
Ours & 0.94 & 0.91 \\
\bottomrule
\end{tabular}

1.2 列の配置

• 数値列：右揃え、または小数点揃え（siunitx の S 列）
• テキスト列：左揃え
• 中央揃え：1 文字、または非常に短いラベルに限ります
• ヘッダーの配置：列の配置に合わせるか、中央揃えにします

1.3 ヘッダーの書式

• ヘッダーは本文と視覚的に区別します（通常は太字：\textbf{}）
• すべて大文字のヘッダーは使用しません（太字またはスモールキャピタルを使用します）
• ヘッダー内の単位は括弧または角括弧で囲みます。Latency (ms) のように記載し、Latency ms とはしません

1.4 最良結果の示し方

• 最良結果を強調する場合は、すべての表で同じ方法を使用します（太字、下線、またはマーカー）
• 最初の表のキャプションまたは脚注で、そのルールを定義します
• 表によって太字と下線を使い分けてはいけません

1.5 表の注記

• 脚注や注記はキャプションではなく、表の下に配置します
• \tablenotes（threeparttable）を使用するか、一貫したマーカーを使った手動の脚注を使用します

1.6 キャプションの配置

• 表のキャプションは表の上に配置します（共通の慣例）
• \begin{tabular} の前に \caption{} を置きます
• 表の下には配置しません。下に置くのは図の場合です

1.7 キャプションの書式

• キャプションのラベル（「Table 1:」／「Table 1.」）は太字またはスモールキャピタルにして、説明文と視覚的に区別します
• キャプションの説明文は本文より小さくします。標準は \small（1 段階小さいサイズ）で、\footnotesize も使用できます
• caption パッケージを使って、一貫して制御します：

\usepackage[font=small, labelfont=bf]{caption}
% label ("Table 1:") = bold, description = \small
% applies uniformly to all figures AND tables

• キャプションを本文と同じサイズにしてはいけません。本文と視覚的に競合し、文書が適切に組版されていない印象になります
• キャプションを \footnotesize より小さくしてはいけません。読みにくくなります
• すべてのキャプションで一貫させます（表と図で同じサイズ／太さのルールを使用します）

1.8 キャプションのスタイル

• 接頭辞は「Table 1:」または「Table 1.」のいずれかに統一し、混在させません（caption パッケージの labelsep で制御します）
• 最初の文で表の内容を説明します
• キャプションだけで内容を理解できるようにします

1.9 余白

• 論理的な行グループには空行ではなく、\addlinespace（booktabs）を使用します
• 表の中で \\[6pt] を使った手動の余白調整はしません
• 列間に十分な余白を確保します。詰まりすぎている場合は @{\hspace{...}} または \setlength{\tabcolsep} を使用します

1.10 複数ページにわたる表

• 1 ページを超える表には、longtable または supertabular を使用します
• 続きのページにもヘッダーを繰り返し表示します
• 表を 1 ページに収めるために文字サイズを小さくしません（\small より小さいサイズは読みにくくなります）

---

パス 2 — 図のデザイン

2.1 キャプションの配置

• 図のキャプションは図の下に配置します（一般的な慣例）
• \includegraphics の後に \caption{}
• 上には配置しません。上に配置するのは表です

2.2 キャプションの書式

• 表のキャプションと同じサイズ／ウェイトのルールにします。caption パッケージは全体に均一に適用されます
• キャプションラベル（"Figure 1:"）は太字またはスモールキャピタルにします（表のラベルのスタイルに合わせます）
• キャプションの説明文は \small または \footnotesize にします（表のキャプションのサイズに合わせます）
• caption パッケージを使用しない場合は、図と表のキャプションが同じ書式になっているか手動で確認します

2.3 キャプションのスタイル

• 一貫した接頭辞を使用します。"Figure 1:"、"Figure 1."、"Fig. 1:" のいずれかを選び、すべての図で統一します
• 表のキャプションのスタイルに合わせます（表が "Table 1:" を使う場合、図は "Figure 1:" を使います）
• キャプションだけで内容が分かるようにします

2.4 サブ図のラベル付け

• スタイルを統一します：(a)、(b)、(c) を使用し、(i)、(ii)、(iii) や a)、b)、c) と混在させません
• subcaption または subfigure パッケージを使用します。手動で文字を付けないでください
• 本文でサブ図ラベルを一貫して参照します。"Figure 1(a)" を使用し、"Figure 1a" や "Figure 1 (a)" と混在させません

2.5 フォントの一貫性

• 図内のテキスト（軸ラベル、注釈、凡例）には、本文に調和するフォントを使用します
• 本文と同じセリフ体（Computer Modern、Times）か、読みやすいサンセリフ体（Helvetica、CMSans）にするのが標準です
• Matplotlib／R／MATLAB のデフォルトフォントは LaTeX の本文と視覚的に異なるため、違いが明らかな場合は指摘します
• 拡大縮小後の図のフォントサイズは、レンダリング時に読みやすい大きさにします（manuscript-review §23 と照合してください）
• 図内テキストはキャプションと同程度のサイズにします。本文より大きくしたり、脚注より小さくしたりしないでください

2.6 背景

• 背景は白または透明にします。灰色のプロット背景（matplotlib のデフォルト axes.facecolor）は使用しません
• 目的がない限り、色付きの枠線や境界線は使用しません

2.7 アスペクト比

• プロットを引き伸ばしたり、圧縮したりしません
• 標準的なアスペクト比は 4:3、16:9、黄金比、または正方形です
• 複数パネルの図では、すべてのパネルで同じアスペクト比を使用します

2.8 枠の一貫性

• すべての図で枠の扱いを統一します（すべて枠あり、またはすべて枠なし）
• 図の内容の周囲に設けるパディング／余白を統一します

---

パス 3 — LaTeX のタイポグラフィ

3.1 ダッシュ

• ハイフン（-）：複合語（well-known、state-of-the-art）
• エンダッシュ（--）：数値範囲（10--20、5--12 ページ、2020--2023）。よくある誤りは、範囲にハイフンを使うことです（"10-20" → "10--20"）。
• エムダッシュ（---）：挿入句や強調のための区切りに使います。エムダッシュは学術文書で CMOS 18、APA 7、MLA 9 に認められています。この文字自体を禁止するのではなく、次の点を指摘してください：
  • スペースの不統一： CMOS／APA／MLA ではスペースなしのエムダッシュ（text---text）を使い、新聞記事の AP スタイルではスペースあり（text --- text）を使います。どちらかを選び、一貫して適用してください。混在している場合は FAIL です。
  • 多用： 1 段落あたり約 1 個、または 1 ページあたり約 3 個を超えると、会話調になり始めます。まとまって使われている場合は WARN として指摘し、コンマ／コロン／括弧を使った書き換えを提案します。
  • 範囲への誤用： エンダッシュを使うべき箇所にエムダッシュを使用している場合（pages 5---12 は pages 5--12 とすべきです）は FAIL です。
  • AI 生成の兆候を判定するヒューリスティック（参考のみ、MEDIUM）： 他の AI 生成のパターンと組み合わさったエムダッシュの多用は、未編集の LLM 出力を示す場合があります。この判定は manuscript-review Pass 7b に委ね、エムダッシュだけを AI 生成の兆候として指摘しないでください。

3.2 引用符

• 開き：`（バッククォート）
• 閉じ：''（まっすぐなシングルクォート）
• "straight quotes" は使用しません。TeX で正しく表示されません
• 入れ子： outer'' の中に `inner' `` を入れます

3.3 省略記号

• \ldots または \dots を使用し、ピリオド 3 つ（...）は使用しません
• \ldots を使用すると、間隔が適切な省略記号になります

3.4 改行不可スペース

• \ref の前：Figure~\ref{fig:x}、Table~\ref{tab:x}、Section~\ref{sec:x}
• \cite の前：previous work~\cite{smith2020}
• 数値と単位の間：10~ms または 10\,ms
• ラベルとその参照先が改行で分離されるのを防ぎます 3.5 数値と単位の間隔、および細いスペース
• 数値と単位の間には細いスペースを入れます：10\,ms、5\,GB、100\,K（一貫性を保つために siunitx を使用します）
• 括弧付きの引用の中にはスペースを入れません：\cite{x}。\cite{ x } ではありません
• ソース内に連続したスペースを入れません（問題はありませんが、見た目が整いません）

3.6 セマンティックなマークアップ

• {\it text} や \textit{text} ではなく \emph{text} を使用します。\emph は正しく入れ子にできます
• 太字には {\bf } ではなく \textbf{} を使用します
• 旧式（\bf、\it、\sf）ではなく、新式のフォントコマンド（\textbf、\textit、\textsf）を使用します
• 数式モード内のローマン体テキストには、手動でフォントを切り替えるのではなく \textrm{} を使用します

3.7 マイクロタイポグラフィ

• \usepackage{microtype} — 文字の突き出しとフォントの拡張を有効にします
• 手間をかけずに、改行と余白の配置が大幅に改善されます
• 読み込まれていない場合は、追加を推奨します

3.8 特殊文字

• テキスト内では & ではなく \& を使用します
• テキスト内では % ではなく \% を使用します
• テキスト内では # ではなく \# を使用します
• テキスト内では _ ではなく \_ を使用します
• 度記号：$^\circ$ または \textdegree を使用します。Unicode の ° は使用しません
• 乗算記号：$\times$ を使用します。x は使用しません

3.9 合字

• ff、fi、fl、ffi、ffl は適切な合字として表示される必要があります（CM／Latin Modern フォントではデフォルトです）
• 理由なく \DisableLigatures または microtype の ligatures=false がグローバルに設定されている場合は指摘します
• フォントによっては合字が正しく表示されません。テキストの「find」が「f ind」のように表示される場合は、フォント設定に問題があります
• 一部の複合語では、合字が形態素の境界をまたがないようにします（例：「shelfful」）。軽微な問題のため、WARN のみです

3.10 イタリック体の使用 — 3 つの異なる目的

• 強調： 文中の語句を強調するには \emph{important} を使用します
• 外国語： まだ定着していない英語以外の用語には \textit{in vivo}、\textit{a priori} を使用します
• 定義する用語： 導入する専門用語の初出箇所には \textit{A convolutional layer is...} を使用します
• 通常の文章で強調に太字、すべて大文字、または色付きテキストを使用する場合は FAIL です
• 一貫性を保ちます。3 ページ目で「in vitro」をイタリック体にする場合は、ほかの箇所でもイタリック体にします（定着した語として扱う場合は、どこでもイタリック体にしません）

3.11 強調に色を使わない

• 通常の文章で強調のために色付きテキスト（重要事項に赤、用語に青など）を使用する場合は FAIL です
• 色は図、表、ハイパーリンクに使用し、本文には使用しません
• 例外：相互参照と URL に対する hyperref のリンク色

3.12 文の間隔

• LaTeX のデフォルトでは、ピリオドの後（文末）に余分なスペースが入ります。これは従来の TeX の動作です
• \frenchspacing はこの動作を無効にし、スペースを均一にします。どちらも使用できますが、意図して選んでください
• \frenchspacing を使わずに、ピリオドを含む略語（例：「et al.」、「Fig.」、「vs.」）を使用する場合は、ピリオドの後に \ または ~ を加えて、LaTeX が文末と誤認しないようにします：et al.\ 。大文字の後に本当の文末のピリオドが続く場合は、その前に \@. を使用します
• よくある問題：「...by Dr. Smith」では、LaTeX が「Dr.」を文末とみなし、その後に余分なスペースを入れます。修正方法：Dr.\ Smith

3.13 ディスプレイ数式とインライン数式

• 分数（\frac）、総和（\sum）、積（\prod）、積分、または行列を含む式は、インラインではなくディスプレイ数式にします。インライン表示では式が圧縮され、行間が乱れるためです
• 短い式（単一の変数、簡単な下付き文字、$x = 5$ のような短い等式）はインラインのままにします
• 目安：式によって行の高さが変わる場合は、ディスプレイ数式にします
• 文の一部となるディスプレイ数式にも、適切な句読点が必要です
• $$ ... $$（LaTeX ではなくプレーンな TeX であり、間隔も正しくありません）ではなく、\[ ... \] または equation 環境を使用します 3.14 URL の扱い
• URL は \url{} または \href{} に記述してください。裸のテキストや \texttt{} は使用しないでください
• \url{} を使うと、適切な文字（/、.、- など）の位置で改行できます
• \texttt{https://...} は行をまたいで改行されないため、行がはみ出します
• url または hyperref パッケージを読み込んでください（hyperref には url の機能が含まれます）
• hyperref が読み込まれている場合は、\hypersetup で breaklinks=true が設定されていることを確認してください
• 参考文献のエントリーにある長い URL には、追加の改行位置が必要です。\UrlBreaks を確認してください：

\makeatletter
\g@addto@macro{\UrlBreaks}{\UrlOrds}
\makeatother

• これがないと、長いパスセグメントを含む URL（ブログ記事やドキュメントでよく見られます）は、\url{} で囲んでも参考文献の余白からはみ出します

---

第 4 部 — 単位と数値

4.1 数値と単位の間のスペース

• 数値と単位の間にスペースを入れてください。「10 ms」であり、「10ms」ではありません
• 推奨：siunitx パッケージの \SI{10}{\milli\second} または \qty{10}{ms}
• ドキュメント全体で統一してください
• 例外：パーセントや度は数値に続けて記述できます（慣例は異なるため、どちらかに統一してください）

4.2 単位の表記

• 単位はイタリック体ではなく、立体（ローマン体）で表記してください。「10 ms」であり、「10 ms」ではありません
• 数式モードでは、$t = 10\,\mathrm{ms}$ とし、イタリック体になる $t = 10\,ms$ は使用しないでください
• 複合単位は m/s または m\,s$^{-1}$ とし、表記を統一してください

4.3 数値の表記

• 小数点の記号を統一してください（英語ではピリオド）
• 大きな数値では、桁区切り記号（カンマ、細いスペース、またはなし）を統一してください
• 範囲にはハイフン（10-20）ではなく、エヌダッシュ（10--20）を使ってください
• 文中の負の数には、ハイフン（-5）ではなく、適切なマイナス記号（$-5$）を使ってください

4.4 有効数字

• 同じ指標は、すべての表と本文で小数点以下の桁数を統一してください
• manuscript-review §12（内容の一貫性）と照合してください
• 精度は測定精度を超えないようにしてください

4.5 パーセンテージ

• 「14.3%」または「14.3 %」のどちらかに統一してください
• パーセンテージを比較する際は、「パーセントポイント」と「パーセント」の違いに注意してください

4.6 インラインの分数

• 通常の本文では、$\frac{1}{2}$ ではなく、\nicefrac{1}{2} または（xfrac の）\sfrac{1}{2} を使ってください
• インラインの $\frac{}{}$ は高さのある要素を作り、行間を乱します
• ディスプレイ数式や数式では、ディスプレイ形式の分数（\frac）が適切です
• 代替案：カジュアルな文脈では「1/2」も使用できます。ドキュメント全体で表記を統一してください

---

パス 5 — 相互参照と引用

5.1 参照の略記の一貫性

• どれか1つを選び、全体で統一します。
  • 完全形：「Figure」、「Table」、「Section」、「Equation」
  • 略記：「Fig.」、「Tab.」、「Sec.」、「Eq.」
  • 同じカテゴリ内で混在している場合は不合格です
• 一般的な慣例：括弧内では略記、本文では完全形を使います （「Fig. 1 に示すように」と「Figure 1 は……を示します」）

5.2 改行されないスペース

• Figure~\ref{fig:x} — 行末に「Figure」、次の行の先頭に「3」と分かれて表示されるのを防ぎます
• Eq.~\eqref{eq:x} — 同様です
• これは LaTeX の組版で最もよくある間違いです

5.3 数式の参照

• 一貫性を保ちます：括弧付きの (\ref{eq:x}) または \eqref{eq:x} を使い、混在させません
• 一貫性を保ちます：「Equation (1)」、「Eq. (1)」、「(1)」のいずれかを選びます

5.4 引用スタイル

• 文書全体で括弧のスタイルを統一します（著者・年方式または数値方式。\bibliographystyle で決まります）
• 手動で引用を整形しません（[1] のように直接記述しないでください）。必ず \cite を使います
• 1組の括弧内に複数の引用を記述する場合は、\cite{a,b,c} を使い、\cite{a}\cite{b}\cite{c} のようにしません
• 引用文献を本文に組み込む方法を統一します：「Smith et al. \cite{smith}」または「\citet{smith}」のどちらかを使い、両方のスタイルを混在させません

5.5 ラテン語の略語と一般的な略記

• 「e.g.」と「i.e.」の後には必ずカンマを付けます（CMOS）。文書全体で統一します。
• 「et al.」は「al」の後にピリオドを付けます（「alia」の略語です）。一般化した表現なのでイタリック体にはしません。
• 「vs.」は末尾にピリオドを付けます。正式な本文では「Versus」、括弧内や表では「vs.」を使います。
• 「cf.」は末尾にピリオドを付けます。「比較」を意味し、「参照」ではありません。
• 「etc.」は末尾にピリオドを付けます。正式な学術文書では避け、明示的に列挙することを推奨します。
• \frenchspacing を使わない場合は、文中の略語のピリオドの後に \ を加え、余分なスペースが入らないようにします（3.12 を参照）

5.6 hyperref の一貫性

• hyperref を使う場合は、リンクの色を統一します（すべて青、すべて黒、またはすべて枠付き）
• 色付きと色なしの相互参照を混在させません
• リンク先が正しく解決されるようにします（出力に「??」が残らないこと）

---

パス 6 — ページレイアウトと間隔

6.1 フロート指定子

• [H] より [htbp] を優先します — [H] は配置を強制し、大きな余白を生じる不適切な改ページを招くことがよくあります
• 上部または下部への配置には [t] または [tb] も使用できます
• [h] だけの指定は不安定です（LaTeX はしばしば無視します）
• 特別な理由がない限り、[h!] や [H] は使いません

6.2 ウィドウとオーファンの制御

• 段落の1行だけがページ上部（ウィドウ）またはページ下部（オーファン）に取り残されないようにします
• プリアンブルに \widowpenalty=10000 と \clubpenalty=10000 を指定します
• または、必要に応じて \needspace コマンドを使います

6.3 段組みのバランス（2段組みのレイアウト）

• 最終ページでは段の高さを揃えます（\usepackage{balance} または \usepackage{flushend} を使います）
• 最終ページの段のバランスが崩れている（左段が埋まり、右段が空いている）と、未完成に見えます

6.4 手動の間隔調整

• 過剰な \vspace{}、\hspace{}、\\[Xpt]、\bigskip、\smallskip を検出します
• これらは、構造的に解決すべきレイアウトの問題に対する一時しのぎです
• 特定のフロートやタイトルの状況で最小限に使うのは許容されます

6.5 改ページ

• 正当な理由がない限り、セクションの途中で \newpage や \clearpage を使いません
• 参考文献の前に \clearpage を使うのは許容されます

6.6 段落の間隔と字下げ

• 標準的な LaTeX：段落の字下げを行い、追加の間隔は設けません（デフォルト）
• 代替方式：字下げをせず、垂直方向の間隔を設けます（\usepackage{parskip}）
• 両方を併用する（字下げと追加の間隔を両方使う）場合は不合格です。どちらか一方を選びます

6.7 段落の字下げ幅

• 標準：1em から 1.5em（LaTeX のデフォルトの \parindent は約 1.5em）
• 大きすぎる場合（>2em）：スペースを無駄にし、誇張された印象になります
• 小さすぎる場合（<0.5em）：字下げが見えず、目的を果たせません
• 理由なく \parindent を不自然な値に手動設定しないでください 6.8 見出し直後の最初の段落
• セクション／サブセクション見出し直後の最初の段落はインデントしないでください（LaTeX のデフォルトの動作です）。
• 最初の段落に \indent または \hspace{\parindent} を追加している場合：FAIL
• パッケージまたは手動設定で最初の段落をインデントしている場合（\usepackage{indentfirst}）：WARN — 英語の学術組版では標準的ではありません。フランスや一部のヨーロッパの慣習では標準的です — 意図的であれば問題ありません。

6.9 行間／行送り

• 標準：文書クラスで設定された行高による単一行間（デフォルトの \baselinestretch = 1.0）
• \linespread{1.6} または \usepackage[doublespacing]{setspace} による二重行間 = 投稿用には FAIL — これは査読用／ドラフト用の設定であり、最終入稿用ではありません。
• 文書クラスが article で、二重行間が有効になっている場合は、フラグを立ててください — ドラフト用の設定を戻し忘れている可能性があります。
• \linespread{1.05} から \linespread{1.1} は、フォントによっては微調整として許容されます。

6.10 行の長さ／1行あたりの文字数

• 最適な長さ：1行あたり45--75文字（Bringhurst）。理想は66文字です。
• 標準的な段幅（約3.3インチ／84mm）の2段組レイアウトでは、自然にこの範囲になります。
• 余白の狭い1段組レイアウトでは、1行あたり90文字を超えることがあり、可読性が低下します。
• 修正方法：余白を広げる、2段組に切り替える、または \usepackage{geometry} を使用して適切なテキスト幅を設定します。
• 文書クラスが余白を設定している場合（ほとんどの学会用クラスが該当します）、上書きしないでください。

6.11 フロートの遅延による蓄積

• コンパイルしたPDFを読みます。前のサブセクションのフロート（表、図）が後のサブセクションの途中に配置され、段落の流れを妨げていないか確認します。
• 症状：文が始まり、その後1ページ以上にわたってフロートが続き、再び文が続きます。読者は文脈を見失います。
• よくある原因：内容が密集したセクションに [t] フロートが多数あることです。LaTeX は配置できないフロートを後回しにするため、次に配置可能な箇所まで蓄積します。
• 診断：各サブセクションの境界で、保留中のフロート数を数えます。サブセクションNのフロートがサブセクションN+2以降の開始後に現れる場合は、FAIL のフラグを立ててください。
• 修正方法：\usepackage{placeins} を追加し、文章の流れが整った状態で始めるべきサブセクションの前に \FloatBarrier を挿入します（特に、フロートの多いデータ中心のセクションに続く方法論／統計／考察のセクション）。
• 代替方法：\usepackage[section]{placeins} を使うと、フロートが \section の境界を越えないよう自動的に制御できます。\subsection 単位で制御するには、手動で \FloatBarrier を指定する必要があります。
• すべてのフロートを [H] に変更して修正しないでください — これにより、さらにレイアウトが悪化します（大きな余白が生じます）。適切な箇所に \FloatBarrier を挿入するのが正しい解決策です。
• カテゴリー：AUTO-FIX（影響を受けるサブセクションの前に \usepackage{placeins} と \FloatBarrier を追加）

6.12 ハイフンで終わる行の連続

• 行末がハイフンで終わる行が2--3行を超えて連続する場合は、視覚的な欠陥です（組版でいう「豚の毛」または「はしご」）。
• 修正方法：\hyphenpenalty=50（デフォルト）を設定し、値を大きくしてハイフン分割の頻度を下げるか、該当箇所の文章を言い換えます。
• \usepackage[none]{hyphenat} はハイフン分割を完全に無効にします — 学術文書では通常望ましくありません。
• 個別の問題語には \hyphenation{spe-ci-fic-word} を使います。

---

パス7 — コードとアルゴリズム

7.1 インラインコード

• インラインコード／識別子には \texttt{} または \verb|| を使います。
• 一貫性を保ちます：すべてのインラインコードで同じ書式を使います。
• 書式が統一されていない例：タイプライター体の場合も、斜体の場合も、書式なしの場合もある。

7.2 コードリスト

• 手動の \texttt ブロックではなく、listings または minted パッケージを使います。
• シンタックスハイライトのスタイルを統一します。
• 本文でコードの行を参照する場合は、行番号を付けます。
• フォントサイズは \small または \footnotesize を使います — 本文サイズ（大きすぎる）や \scriptsize（小さすぎる）は使いません。

7.3 アルゴリズムの擬似コード

• algorithm2e、algorithmic、または algorithmicx パッケージを使います。
• インデントを統一します。
• 参照する場合は行番号を付けます。
• 入力／出力を明確に示します。
• キャプションは上に配置します（表の慣例に従います — アルゴリズムは手続き型の表です）。

---

パス 8 — タイポグラフィの階層

文書のフォントサイズとウェイトによって、明確な視覚的階層を形成する必要があります。 読者はサイズやウェイトの違いを無意識に利用して、文書の構造を把握します。 要素のサイズが同じだと階層が崩れ、ページが平坦な印象になります。

8.1 サイズ階層の参考

標準的な学術文書の LaTeX サイズ階層（本文との相対値）：

要素	本文との相対サイズ	ウェイト	スタイル
章／部のタイトル	+4--6pt	太字	ローマン
セクション見出し	+2--3pt	太字	ローマン
サブセクション見出し	+1--2pt	太字	ローマン
サブサブセクション見出し	本文と同じ	太字または斜体	ローマン
本文	基準（10pt、11pt、または12pt）	標準	ローマン
キャプションラベル（「Figure 1:」）	本文より1段階小さい（\small）	太字	ローマン
キャプションの説明	本文より1段階小さい（\small）	標準	ローマン
表の本文	本文と同じ、または \small	標準	ローマン
図内のテキスト	キャプションと同程度	標準	サンセリフまたは本文と同じフォント
脚注	本文より2段階小さい（\footnotesize）	標準	ローマン
コードリスト	本文より1～2段階小さい	標準	等幅
ヘッダー／フッター	本文より1～2段階小さい	標準	ローマンまたは斜体

ほとんどの文書クラスでは、この階層が自動的に設定されます。このスキルでは、 著者が誤って上書きしていないかを確認します。

8.2 キャプションは本文より小さいサイズにする

• キャプションが本文と同じサイズ（例：本文もキャプションも12pt）＝不合格
• キャプションは1段階小さくする必要があります：\small（本文が12ptなら10.95pt、11ptなら9.5pt、10ptなら9pt）
• \footnotesize も許容されます（やや小さめです）
• これを適用するには caption パッケージを使うのが適切です：

% Standard professional setup
\usepackage[font=small, labelfont=bf]{caption}

% Alternative: slightly smaller
\usepackage[font=footnotesize, labelfont=bf]{caption}

% With label separator control
\usepackage[font=small, labelfont=bf, labelsep=period]{caption}
% produces "Figure 1. Description" with bold "Figure 1."

8.3 キャプションラベルは説明文と視覚的に区別する

• ラベル（「Table 1:」／「Figure 1.」）は太字にします。これが一般的な慣例です
• 代替案：スモールキャピタル（labelfont=sc）または太字のスモールキャピタル
• ラベルと説明文のウェイトが同じ＝不合格。読者が図表番号をすばやく見つけられません
• ラベルは参照の目印で、説明文は本文です。役割が異なるため、見た目も区別する必要があります。

8.4 見出しは階層が深くなるにつれてウェイトとサイズを小さくする

• サイズと視覚的なウェイトの両方で、\section > \subsection > \subsubsection とします
• 文書クラスがこの設定を提供している場合（ほとんどのクラスが提供しています）、手動のフォントコマンドで上書きしないでください
• \section{} の代わりに手動で {\Large\textbf{...}} を使う＝不合格。番号、ブックマーク、目次が壊れます

8.5 脚注のサイズ

• 脚注は本文より小さくする必要があります（LaTeX の標準設定は \footnotesize）
• 脚注が本文と同じサイズ＝不合格
• 脚注の参照記号：上付き数字（デフォルト）。一貫したスタイルにします

8.6 表の本文のサイズ

• 表の本文は本文と同じサイズ、または1段階小さく（\small）します
• 表をページに収めるために \footnotesize 以下にしてはいけません。代わりに表を再設計します（列を減らす、見出しを短縮する、2つの表に分ける）
• 例外：列数が多く、スペースが実際に制限される付録の表では、\small を下限とします

8.7 ヘッダー／フッターのテキスト

• ランニングヘッダー／フッターは本文より小さいサイズにします（ほとんどの文書クラスの標準設定）
• 手動で設定したヘッダーが本文と同じサイズ＝内容と競合する視覚的ノイズになります

8.8 本文での手動フォントサイズの上書きを避ける

• 本文中（見出し以外）の {\large ...} または {\Large ...} を検出します
• ページ制限に収めるためにセクション全体を囲む {\small ...} を検出します
• これらは階層を上書きし、視覚的な一貫性を損ないます
• 例外：特定のフロート／環境内での \small は許容されます

---

パス 9 — 仕上げの確認

9.1 プレースホルダーの検出

• .tex ファイルに「TODO」「FIXME」「XXX」「PLACEHOLDER」「TBD」が含まれていない
• 「Lorem ipsum」や埋め草のテキストがない
• 意図的なバージョン管理ではなく、明らかに下書きの名残であるコメントアウトされた段落がない

9.2 PDF メタデータ（PDF がある場合）

• PDF のプロパティにタイトルが設定されている（「main.tex」や空欄ではない）
• PDF のプロパティに著者が設定されている
• \hypersetup{pdftitle={...}, pdfauthor={...}} が設定されている

9.3 PDF のしおり

• hyperref がしおりを有効にして読み込まれている（デフォルト）
• PDF リーダーのサイドバーからセクション構成をたどれる
• しおりのテキストがセクションのタイトルと一致している

9.4 パッケージ読み込みの一貫性

• 同じパッケージに対する \usepackage の重複がない
• パッケージオプションの競合がない
• 慣例に沿った順序でパッケージが読み込まれている（hyperref は最後、または最後近く）

9.5 行のはみ出し／詰め不足の警告（必須 — 省略しないでください）

• .log ファイル（メインの tex と同名。例：main.log や yuj.log）を読む
• Overfull \\hbox を検索する — 各項目はテキストが余白を越えていることを示します
• 各項目について、行番号と badness の値を報告する
• よくある原因：参考文献の長い URL、改行できないインライン数式、幅の広い \resizebox の表、長い \texttt{} 文字列
• 原因に応じて修正する：
  • URL：breaklinks=true と \UrlBreaks{\UrlOrds} を設定する（3.14 を参照）
  • インライン数式：\allowbreak で改行するか、別行立てにする
  • 表：\resizebox の拡大縮小を確認し、\small の使用や再設計を検討する
  • \texttt{}：URL には \url{} を使用し、パスには \allowbreak を追加する
• badness が 5000 を超える Underfull \\hbox も確認する — これらは目に見えて間延びした行になります

9.6 未解決の参照

• 未解決の \ref または \cite による、出力結果内の ?? がない
• 参考文献項目の欠落による [?] がない
• .log で「Reference ... undefined」と「Citation ... undefined」を確認する

---

3. レポートの生成

# Typography Audit Report

**Manuscript:** [main tex file]
**Document class:** [detected class]
**Layout:** [single/two-column]
**Date:** [date]
**Verdict:** [Professional | Needs Polish | Significant Issues]

## Summary

| Category | Pass | Fail | Warn |
|----------|------|------|------|
| Table Design | | | |
| Figure Design | | | |
| LaTeX Typography | | | |
| Units & Numbers | | | |
| Cross-References | | | |
| Page Layout | | | |
| Code & Algorithms | | | |
| Typographic Hierarchy | | | |
| Professional Polish | | | |

## Fixes (ordered by impact)

### High Impact (visual professionalism)

[Issues that experienced readers/reviewers will notice immediately]

### Medium Impact (readability)

[Issues that affect reading experience but may not be consciously noticed]

### Low Impact (polish)

[Micro-issues that matter for camera-ready / final versions]

## Quick Fixes

[One-line fixes: add microtype, add booktabs, fix non-breaking spaces —
 items that take <1 minute each and improve the document noticeably]

4. 出力

レポートをプロジェクトディレクトリに [manuscript-name]-typography-report.md として保存します。

以下を提示します：

• 判定
• 重大度が高／中／低の問題の件数
• すぐにできる修正の上位 5 件（最小の作業で最大の効果があるもの）
• 各修正に対する具体的な LaTeX コード

LaTeX の簡単な修正方法

複数の問題を解決できる、プリアンブルへの一般的な 1 行追加：

% Micro-typography: better line breaks, margin alignment
\usepackage{microtype}

% Professional tables: \toprule, \midrule, \bottomrule
\usepackage{booktabs}

% Proper SI units: \SI{10}{\milli\second}
\usepackage{siunitx}

% Subfigures with consistent labeling
\usepackage[labelformat=parens]{subcaption}

% Widow/orphan prevention
\widowpenalty=10000
\clubpenalty=10000

% Two-column balance on last page
\usepackage{balance}  % add \balance before \bibliography

% Caption formatting: bold label, small text
\usepackage[font=small, labelfont=bf]{caption}

% Inline fractions: \nicefrac{1}{2}
\usepackage{nicefrac}

% PDF metadata
\hypersetup{
  pdftitle={Your Paper Title},
  pdfauthor={Author Names},
}

基本原則

• 好みではなく慣例に従います。 この監査の各チェック項目は、さまざまな学術分野で適切に組版された論文の大多数が実践している規範を反映しています。 慣例に実際にばらつきがある場合（例：パーセント記号の前後の空白）は、両方の選択肢を示して WARN として指摘し、一貫性を保つよう求めます。

• ドキュメントクラスを考慮します。 ドキュメントクラスによってデフォルトの慣例が上書きされることがあります（例：IEEEtran 独自の表スタイル）。クラスによってスタイルが指定されている場合は、それに従い、競合する慣例を押しつけないでください。

• 症状ではなく原因を修正します。 間隔を調整するための \vspace{-3mm} は、症状に対する応急処置です。余白の乱れを引き起こしたフロート指定子やパッケージ設定を修正することが、本当の解決策です。

• 手軽な改善から始めます。 レポートでは、効果と作業量の比率に基づいて修正の優先順位を付けます。\usepackage{microtype} の追加は 5 秒で済み、すべてのページの品質を向上させます。 これは、すべての表を再設計する提案よりも先に行います。

• 特定のスタイルを押しつけません。 このスキルは「好みのスタイル」を強制するものではありません。 文書内の一貫性と、広く合意されている慣例への準拠を求めます。著者が意図的かつ一貫して選択したスタイルは尊重してください。