arxiv-preflight

arXiv 投稿前チェック

パイプライン内の位置： Phase 3a（投稿準備）。Phase 2 の修正と PDF の再コンパイル後に実行します。arxiv-figures と arxiv-package に進むためのゲートです。 実行順序の全体については /manuscript-pipeline を参照してください。

目的

TeX/LaTeX プロジェクト（または PDF 投稿物）を arXiv のすべての投稿要件に照らして体系的に検証し、違反が見つかった場合はそれぞれに対する具体的な修正方法を添えた、構造化された合否レポートを作成します。

関連スキル：

• manuscript-review — 文章の品質、構成、主張を監査します
• manuscript-provenance — 計算の再現性を監査します
• arxiv-figures — arXiv 向けに図を最適化します
• arxiv-package — 投稿用 tarball をパッケージ化します

このスキルは arXiv の技術要件への適合のみを対象とし、文章の品質や科学的内容は対象外です。

ワークフロー

1. 取り込み

投稿ディレクトリを特定します。次を探します：

• メインの .tex ファイル
• すべてのインクルードファイル（図、.bbl、.bst、スタイルファイル、サブディレクトリ）
• 00README.XXX ファイル
• anc/ ディレクトリ
• コンパイル済み PDF（利用可能な場合）

Read references/guidelines.md

2. 検証パス

すべてのパスを実行します。各チェックの結果は次のとおりです：

• PASS — 要件を満たしています
• FAIL — 違反が見つかりました（正確なファイル、行、具体的な修正方法を記録）
• WARN — 注意事項です（ブロッカーではありませんが、問題が発生する可能性があります）
• N/A — 該当しません

---

パス 1 — ファイル構成

1. .tex ファイル内に絶対ファイルパスがない（\input、\includegraphics、\include、\bibliography）
2. ファイル名にスペースや特殊文字（&、\、:）が含まれていない
3. 除外すべき補助ファイルがない：.aux、.log、.toc、.lot、.lof、.dvi、.ps、.pdf（図の PDF を除く）
4. 必須ファイルが存在する：BibTeX/BibLaTeX を使う場合は .bbl、makeindex を使う場合は .ind、用語集／記号一覧を使う場合は .gls/.nls
5. .tex 関連の設定ファイルを除き、隠しファイル（. で始まるファイル）がない
6. ジャーナルのテンプレートや査読者宛ての書簡が含まれていない
7. サブディレクトリ構成：サブディレクトリ内のファイルを参照する \include{} 呼び出しがない（代わりに \input{} を使用）
8. \documentclass を含む .tex ファイルが複数ある場合、00README.XXX に toplevelfile が宣言されていることを確認する

パス 2 — TeX/LaTeX 準拠

1. プロセッサとの互換性：図の形式がプロセッサに適合している
   • DVI モード：.ps/.eps の図のみ
   • PDFLaTeX：.pdf/.png/.jpg の図のみ
   • 条件付きコンパイルなしで形式が混在していない
2. psfig パッケージを使用していない（graphicx を使用）
3. 日付フィールドで \today マクロを使用していない
4. JavaScript が埋め込まれていない
5. \pdfoutput の判定に \ifx\pdfoutput\undefined ではなく ifpdf パッケージを使用している
6. 回避策なしで shell-escape に依存するパッケージを使用していない（minted → frozencache=true）
7. 外部文書への参照に xr パッケージを使用していない
8. 二重行間の「査読者向け」モードの書式設定がない
9. キャプション内の \cite 呼び出しに \protect\cite を使用している
10. サブディレクトリ内のファイルに \include を使用していない
11. BibLaTeX の .bbl 形式のバージョンが対象の TeX Live と互換性がある（TL2025 では 3.3）
12. カスタムまたは標準外のスタイルファイルがすべて投稿物に含まれている
13. TeX Live ディストリビューションに含まれないパッケージを使用していない（一般的な非 TL パッケージを確認）

パス 3 — 図の検証

1. 参照されているすべての図が指定されたパスに存在する
2. 図の形式がプロセッサの要件に適合している
3. 絶対パスを参照する図がない
4. アニメーション、JavaScript、インタラクティブ要素が埋め込まれていない
5. PNG ファイル：画像が大きすぎないか確認する（34 メガピクセル超は警告）
6. ファイルサイズが妥当である（個々の図が 5MB 超、または図の合計が 25MB 超の場合はフラグを立てる）
7. \includegraphics 呼び出しに代替テキストがある（参考情報 — アクセシビリティのベストプラクティス）
8. \includegraphics が非推奨の代替手段ではなく graphicx パッケージを使用している

パス 4 — 書誌情報の検証

1. .bbl ファイル名が対応する .tex ファイル名と一致している

2. .bib を含める場合、.bbl も含まれている（arXiv は .bib を処理できますが、.bbl の方が安全です）

3. 参考文献中の arXiv 識別子が正しい形式（YYMM.NNNNN）を使用している

4. e-print 識別子に余分な書式指定がない

5. BibLaTeX の .bbl 形式のバージョンを確認する（.bbl 内の \RequirePackage のバージョンを調べる） パス 5 — メタデータの準拠状況（.tex のフロントマターを確認）

6. タイトル：すべて大文字にしない、生の Unicode を使用しない、意味が不明瞭なマクロは展開する

7. 著者：適切な氏名形式を使用し、敬称を付けず、et al. で省略しない

8. 要旨：先頭に「Abstract」というテキストを置かない、1920 文字以内に収める、行頭に空白を置かない

9. 要旨：意味が不明瞭な TeX マクロを展開し、書式設定コマンド（\em、\it）を使用しない

10. コメントのメタデータがある場合：ページ数と図の数を含める（参考情報）

パス 6 — PDF の検証（コンパイル済み PDF がある場合）

1. すべてのフォントが埋め込まれている（pdffonts または同等のツールで確認）
2. Type 3（ビットマップ）フォントがない
3. 機械可読である（スキャン画像またはビットマップではない）
4. 埋め込み JavaScript がない
5. テキスト抽出を妨げるセキュリティ制限がない
6. ファイルサイズが妥当である

パス 7 — 00README.XXX の検証（存在する場合）

1. ディレクティブの構文が有効である（各行は filename directive または単独のディレクティブ）
2. 参照先のファイルが存在する
3. DVI 関連のディレクティブで正しいファイル名を使用する（.tex 拡張子を付けない）
4. ディレクティブに矛盾がない

パス 8 — 付属ファイル（anc/ ディレクトリがある場合）

1. anc/ ディレクトリに .tex ファイルがない
2. 埋め込み JavaScript を含む PDF がない
3. .tex ソースから anc/ ディレクトリへの内部参照がない
4. 合計サイズが妥当である

パス 9 — よくあるエラーのスキャン

1. PS/EPS ファイルの先頭に %%BoundingBox がある（末尾ではない）
2. newtxmath と amssymb の間に \Bbbk の競合がない
3. 曖昧な二重下付き文字／上付き文字がない（a_x_y → a_{x}_y）
4. ソースファイルが連結されていない
5. Scientific Workplace の .rap ファイルがない
6. 標準スタイルファイル（epsf.sty、epsfig.sty）の改変版がない
7. 複雑なセクション名で hyperref を使う場合：bookmarks=false を指定するか、PDF 文字列を適切に処理する

---

3. レポートの生成

構造化されたレポートを作成します：

# arXiv Preflight Report

**Project:** [directory name]
**Date:** [date]
**Processor:** [detected processor]
**Verdict:** [READY / NEEDS FIXES / BLOCKED]

## Summary

| Category | Pass | Fail | Warn | N/A |
|----------|------|------|------|-----|
| File Organization | | | | |
| TeX Compliance | | | | |
| Figures | | | | |
| Bibliography | | | | |
| Metadata | | | | |
| PDF | | | | |
| 00README | | | | |
| Ancillary Files | | | | |
| Common Errors | | | | |

## Blocking Issues (FAIL)

[Each with file, line number, specific violation, exact fix]

## Warnings (WARN)

[Advisory items that may cause processing issues]

## All Checks

[Full pass/fail/warn/N/A status for every checkpoint]

4. 出力

レポートをプロジェクトディレクトリに arxiv-preflight-report.md として保存します。

判定結果とブロッキング問題の件数を提示します。READY の場合は、投稿を進められることを確認します。 NEEDS FIXES の場合は、必要な修正を優先度順に列挙します。

基本原則

• 二値判定による準拠確認。 arXiv の要件は提案ではありません。FAIL は投稿が却下されるか、処理が失敗することを意味します。WARN は問題が生じる可能性があることを意味します。
• 具体的な修正方法。 各 FAIL には、必要なコマンド、行、ファイルの変更を具体的に記載します。
• 誤検知をしない。 文書化された arXiv の要件に対する違反のみを指摘します。スタイル上の好みやベストプラクティスを FAIL として扱わないでください。
• プロセッサーを考慮する。 検出された TeX プロセッサーに合わせてすべてのチェックを行います。PDFLaTeX のルールは DVI モードの投稿には適用せず、その逆も同様です。