# プリフライトのチェック

文書を手放す前に、ソース、ビルドログ、PDF、参考文献、アクセシビリティの兆候、投稿のリスクを確認します。

コンパイルに成功したことが示すのは、PDF ができたことだけです。すべての引用が解決されたこと、読み上げ順が筋の通ったものであること、投稿用のアーカイブがきれいであること、ファイルが主張どおりのアクセシビリティ構造を備えていることまでは、保証されません。

プリフライトは、これらの疑問をローカルでの 1 回のレビューにまとめます。プロジェクトレールの**シールド**を開き、文書に合うチェックを選びます。問題を直しているときは 1 つのチェックを、投稿前にはすべてのチェックを実行します。

![Oleafly のプリフライトパネル。必要なチェックを選び、行ごとに 1 つずつ実行するか、下のボタンで有効なチェックをすべて実行する。](https://cdn.oleafly.com/images/screenshots/desktop/docs/preflight-checks-dark-window-v2.png#view=0,45,344,689)

![論文を提出する前に、ビルド、投稿、アクセシビリティのチェックをプリフライトで実行するところ。](https://cdn.oleafly.com/images/gifs/desktop/preflight.gif?v=2)

## 独立した 6 つのチェック

### コンパイルとレイアウト

直近のビルドログと PDF を読み、失敗したビルド、未解決の引用と参照、再コンパイルの警告、欠けたグリフ、はみ出したボックス、切れたテキスト、重複した PDF の宛先、ページサイズの混在を調べます。

### 投稿の準備状況

選んだ出版プロファイルをプロジェクトに適用します。変わりにくい要件を確認します。ドキュメントクラス、概要とキーワード、図の形式、埋め込みフォント、PDF の制限、キャプション、移植できる名前、ソースパッケージの余計なものが対象です。

### ATS の準備状況

採用管理システムとほぼ同じ方法で、履歴書からテキストを抽出します。連絡先の項目、想定されるセクション、読み上げ順を乱しかねないレイアウトを報告します。

### アクセシビリティ

ソースと PDF にある、次の兆候を確認します。タグ付け、代替テキスト、言語とタイトルのメタデータ、ビューアの設定、見出し、表、リンク、読み上げ順、選択できるテキスト、必要に応じたしおり、非常に小さな文字です。

### 参考文献とアセット

見つからないファイル、未解決の引用と相互参照、重複したラベルと DOI、情報の足りない参考文献の項目を見つけます。プロジェクト全体が揃っている場合は、引用されていない参考文献も見つけます。

### プライバシーとブラインド査読

資格情報、秘密鍵、機微なファイル、下書きのメモ、内部向けのコメント、謝辞、著者の項目、ブラインド査読を妨げかねない身元のメタデータを探します。

## Typst プロジェクト

Typst のソースには、専用のチェックがあります。`.typ` ファイルを直接読むため、Typst の構文に LaTeX の規則が働くことはありません。

- **参考文献とアセット**は、対応するラベルや参考文献の項目がない `@` の参照と引用、重複したラベル、プロジェクト内のどのファイルにも一致しない画像や `#include` のパス、プロジェクトにない `#bibliography` のファイル、出典を引用しているのに `#bibliography` を呼び出していない文書を見つけます。引用キーは `.bib` ファイルにも、Hayagriva の `.yml` ファイルにも置けます。
- **アクセシビリティ**は、画像自体にも、画像を含む図にも `alt` テキストがない画像、空の見出し、`#set document(title: ...)` またはテンプレートでタイトルを設定していない文書を指摘します。
- **投稿の準備状況**は、選んだプロファイルに合うテンプレートをプロジェクトが読み込んでいること、テンプレートに概要とキーワードが渡されていること、`#lorem` のテキスト、プレースホルダー、TODO のメモが残っていないことを確認します。キャプション、画像のサイズ、ファイル名も調べます。
- **プライバシーとブラインド査読**は、テンプレートに渡された著者名、メールアドレス、所属、謝辞、ローカルのファイルパスを見つけます。

指摘ごとにファイルと行が示され、詳細には `#image("chart.png", alt: "Bar chart of yearly sales")` のような Typst での修正方法が表示されます。

## 色だけでなく、確かさを読む

どの結果にも、Oleafly がそこに至った理由の説明が付きます。

- **確認済み**は、ソース、ログ、プロジェクト、PDF から、アプリが直接の証拠を観察したことを意味します。
- **要判断**は、文書化されたヒューリスティックが、人が確認すべきものを見つけたことを意味します。
- **手動**は、ファイルだけでは安全に判断できないチェックを示します。

入力が足りないことが、合格になることはありません。ソースだけの指摘は、最新の PDF ができるまで部分的なままです。

## 出版プロファイルを選ぶ

提出先にいちばん近いものを、一般的な出版、arXiv、IEEE、ACM、論文誌、学位論文のプロファイルから選びます。プロファイルが扱うのは、自動で確認できるほど変わりにくい要件です。Typst プロジェクトでは、プロファイルは対応する Typst テンプレートも求め、指摘には受け付けるテンプレートの名前が示されます。

そのうえで、投稿先の最新の指示を開いてください。ページ数の上限、余白、ファイルサイズの上限、匿名化の規則、命名規則は変わりやすく、汎用のプロファイルでは判断できません。

## 別の読み手に届く内容を見る

プリフライトパネルの**スクリーンリーダー**を選ぶと、PDF のテキストをページごとに抽出する**リーダーに見えているもの**が開きます。2 段組の論文が行をまたいで読まれていないか、アイコンフォントの電話番号が抜けていないか、キャプションが違う場所にないか、選択できるテキストがないページがないかを見つけるのに使います。

履歴書では、**解析ツールが抽出した内容**に、ATS のシミュレーションが取り出せた名前、メールアドレス、電話番号、リンク、標準のセクションが表示されます。

これらの表示は証拠であって、読み手が実際に使う投稿ポータル、スクリーンリーダー、解析ツールでのテストの代わりにはなりません。

## PDF/UA とアクセシビリティ: 正直な境界線

Oleafly が確認するのは、ファイルから読み取れる範囲の PDF/UA-1 です。指摘には、PDF/UA-1、異なる場合は PDF/UA-2、Matterhorn Protocol のチェックポイント、WCAG 2.2 の PDF 技術が引用されます。

レポートは、次のような機械で読み取れる兆候を扱います。

- 実際の内容を含むタグツリー
- 図と数式の代替テキスト
- 表の見出しセル
- 見出しの階層の進み方
- 文書の言語と XMP のタイトル
- タイトルを表示するビューアの設定
- リンクの説明と、疑わしいタグなしの内容
- 宣言した PDF/UA-1 への適合が、ファイルによって裏付けられているか

パネルには、機械で確認できる PDF/UA-1 の 106 件の規則のうち、何件を確認できたかが表示されます。読み取れなかった規則や、当てはまらなかった規則があるときも表示されます。確認していない規則が、合格として数えられることはありません。

:::caution[プリフライトは PDF/UA の適合を証明しません]
これは一部の規則を確認するチェックであり、適合の証明ではありません。代替テキストに意味があるか、読み上げ順が人にとって筋が通っているか、色のコントラストが十分か、読み手の支援技術で文書がうまく使えるかを、Oleafly は判断できません。正式な適合の結果が必要なときは、最終ファイルを veraPDF または PAC 2024 で検証し、人によるレビューを行ってください。
:::

## LaTeX からタグ付き PDF を準備する

LaTeX のタグ付けは、ドキュメントクラス、パッケージ、エンジン、TeX Live のバージョンに左右されます。プリフライトは、準備を提案する前に、実際に使われるメイン文書と、それが読み込むプリアンブルのファイルを確認します。

1. 現在の PDF に対して**アクセシビリティ**を実行し、指摘を読みます。
2. **アクセシブルな書き出し**を開きます。
3. クラスとパッケージの互換性レポートを確認します。互換性のないクラスがあると準備できません。一部だけ互換のパッケージや不明なパッケージは、警告として表示されます。
4. **アクセシブルな書き出しの準備**を選び、提案されたソースの変更をすべて確認します。
5. 生成された代替テキストのプレースホルダーを、それぞれ意味のある説明に置き換えます。求められたら、文書のタイトルも加えます。
6. TeX Live 2026 か、2025 年 11 月以降に更新した TeX Live の pdfLaTeX または LuaLaTeX でコンパイルします。アクセシブルな数式には LuaLaTeX が必要です。
7. もう一度アクセシビリティを実行し、リーダー表示を確認します。適合が重要なときは、最後に Oleafly の外で最終的な PDF を検証してください。

準備では、言語、PDF/UA-2 の意図、タグ付けを指定した `\DocumentMetadata` を追加または更新できます。表の最初の行を見出し行として宣言する、足りない図の代替テキストの目に見えるプレースホルダーを追加する、選んだエンジンが必要とするときは `unicode-math` を追加する、といったこともできます。変更は適用する前に表示されます。

`\DocumentMetadata` の行は、バージョンチェックの内側に入ります。同梱のエンジンのように 2025 年 11 月より古い LaTeX では、この行が飛ばされ、失敗する代わりにタグなしで文書がビルドされ、その PDF は PDF/UA への適合を主張しません。プリフライトはその場合、**この LaTeX は古すぎるため、タグ付けをスキップしました**と報告し、ビルドを実行した LaTeX の名前も示します。

同梱の Tectonic エンジンは、タグツリーを作れません。**タグ付きでコンパイルして確認**は、使えるシステムの TeX ディストリビューションか、Oleafly が管理する TinyTeX を使い、Tectonic のプロジェクトでも常に LuaLaTeX を実行します。タグ付きのコンパイルが、TinyTeX の `tagpdf-base.sty` のような見つからないファイルで止まった場合は、通常のコンパイルと同じようにそのインストールを提案し、そのあとでタグ付きのコンパイルをやり直します。準備したソースを、自分の最新のツールチェーンでコンパイルすることもできます。

:::note[互換性が妨げになることがあります]
プリフライトは、LaTeX Project が公開しているタグ付け対応状況のデータを使います。対応していないクラスは使えず、一部だけ対応しているクラスには注意が付き、データにないパッケージは安全と見なさず、不明として扱われます。`enumitem` は、タグ付きのワークフローでは読み込めないため、現在は使えません。
:::

TinyTeX、パッケージの状態、システムの TeX まわりのセキュリティ上の境界については、[LaTeX のエンジンとパッケージ](/docs/latex-engines/)を参照してください。

## Typst の PDF 規格

Typst プロジェクトには、準備するソースがありません。Typst が長期保存用やアクセシブルな PDF を自分で書き出すため、**アクセシビリティ**のチェックでは、**アクセシブルな書き出し**の代わりに **PDF 規格**が表示されます。

1. **アクセシビリティ**を実行し、足りない代替テキストと足りない文書のタイトルを直します。PDF/UA-1 には、どちらも必要です。
2. **PDF 規格**の下で、PDF/UA-1 や PDF/A-2b などの**規格**を選びます。
3. **PDF を書き出す**を選び、ファイルを保存します。
4. 適合が重要なときは、書き出した PDF を Oleafly の外で検証します。

Typst 0.14 以降はすべての PDF にタグを付けるため、タグ付きの別コンパイルはありません。古いバージョンで選べる規格は少なく、Typst 0.11 では 1 つもありません。どれに当てはまるかは、パネルに表示されます。新しいバージョンを使うには、コンパイルメニューの **Typst のバージョン（このプロジェクト）** を変更します。[Typst プロジェクト](/docs/typst/#what-each-version-can-do)を参照してください。

## 実用的な最終確認

1. 提出するつもりのソースを、そのままコンパイルします。
2. 関連するプリフライトのチェックをすべて実行します。
3. 確認済みの指摘を直し、要判断の指摘を調べます。
4. 手動の項目をすべて、投稿先の最新のガイドと照らして確認します。
5. 参考文献と付録を含め、最終の PDF を最初のページから最後まで読みます。
6. 書き出したファイルとソースのアーカイブを、保存した場所から開きます。
7. 締め切りの前に、投稿先が用意している検証ツールを使います。

プリフライトが減らせるのは、避けられる不意の問題です。採択、アクセシビリティ、科学的な正しさには、これからも著者、投稿先、そして文書を使う人たちが必要です。
