プリフライトのチェック
文書を手放す前に、ソース、ビルドログ、PDF、参考文献、アクセシビリティの兆候、投稿のリスクを確認します。
コンパイルに成功したことが示すのは、PDF ができたことだけです。すべての引用が解決されたこと、読み上げ順が筋の通ったものであること、投稿用のアーカイブがきれいであること、ファイルが主張どおりのアクセシビリティ構造を備えていることまでは、保証されません。
プリフライトは、これらの疑問をローカルでの 1 回のレビューにまとめます。プロジェクトレールのシールドを開き、文書に合うチェックを選びます。問題を直しているときは 1 つのチェックを、投稿前にはすべてのチェックを実行します。


独立した 6 つのチェック
「独立した 6 つのチェック」セクションコンパイルとレイアウト
「コンパイルとレイアウト」セクション直近のビルドログと PDF を読み、失敗したビルド、未解決の引用と参照、再コンパイルの警告、欠けたグリフ、はみ出したボックス、切れたテキスト、重複した PDF の宛先、ページサイズの混在を調べます。
投稿の準備状況
「投稿の準備状況」セクション選んだ出版プロファイルをプロジェクトに適用します。変わりにくい要件を確認します。ドキュメントクラス、概要とキーワード、図の形式、埋め込みフォント、PDF の制限、キャプション、移植できる名前、ソースパッケージの余計なものが対象です。
ATS の準備状況
「ATS の準備状況」セクション採用管理システムとほぼ同じ方法で、履歴書からテキストを抽出します。連絡先の項目、想定されるセクション、読み上げ順を乱しかねないレイアウトを報告します。
アクセシビリティ
「アクセシビリティ」セクションソースと PDF にある、次の兆候を確認します。タグ付け、代替テキスト、言語とタイトルのメタデータ、ビューアの設定、見出し、表、リンク、読み上げ順、選択できるテキスト、必要に応じたしおり、非常に小さな文字です。
参考文献とアセット
「参考文献とアセット」セクション見つからないファイル、未解決の引用と相互参照、重複したラベルと DOI、情報の足りない参考文献の項目を見つけます。プロジェクト全体が揃っている場合は、引用されていない参考文献も見つけます。
プライバシーとブラインド査読
「プライバシーとブラインド査読」セクション資格情報、秘密鍵、機微なファイル、下書きのメモ、内部向けのコメント、謝辞、著者の項目、ブラインド査読を妨げかねない身元のメタデータを探します。
Typst プロジェクト
「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 とアクセシビリティ: 正直な境界線
「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 件の規則のうち、何件を確認できたかが表示されます。読み取れなかった規則や、当てはまらなかった規則があるときも表示されます。確認していない規則が、合格として数えられることはありません。
LaTeX からタグ付き PDF を準備する
「LaTeX からタグ付き PDF を準備する」セクションLaTeX のタグ付けは、ドキュメントクラス、パッケージ、エンジン、TeX Live のバージョンに左右されます。プリフライトは、準備を提案する前に、実際に使われるメイン文書と、それが読み込むプリアンブルのファイルを確認します。
- 現在の PDF に対してアクセシビリティを実行し、指摘を読みます。
- アクセシブルな書き出しを開きます。
- クラスとパッケージの互換性レポートを確認します。互換性のないクラスがあると準備できません。一部だけ互換のパッケージや不明なパッケージは、警告として表示されます。
- アクセシブルな書き出しの準備を選び、提案されたソースの変更をすべて確認します。
- 生成された代替テキストのプレースホルダーを、それぞれ意味のある説明に置き換えます。求められたら、文書のタイトルも加えます。
- TeX Live 2026 か、2025 年 11 月以降に更新した TeX Live の pdfLaTeX または LuaLaTeX でコンパイルします。アクセシブルな数式には LuaLaTeX が必要です。
- もう一度アクセシビリティを実行し、リーダー表示を確認します。適合が重要なときは、最後に 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 のような見つからないファイルで止まった場合は、通常のコンパイルと同じようにそのインストールを提案し、そのあとでタグ付きのコンパイルをやり直します。準備したソースを、自分の最新のツールチェーンでコンパイルすることもできます。
TinyTeX、パッケージの状態、システムの TeX まわりのセキュリティ上の境界については、LaTeX のエンジンとパッケージを参照してください。
Typst の PDF 規格
「Typst の PDF 規格」セクションTypst プロジェクトには、準備するソースがありません。Typst が長期保存用やアクセシブルな PDF を自分で書き出すため、アクセシビリティのチェックでは、アクセシブルな書き出しの代わりに PDF 規格が表示されます。
- アクセシビリティを実行し、足りない代替テキストと足りない文書のタイトルを直します。PDF/UA-1 には、どちらも必要です。
- PDF 規格の下で、PDF/UA-1 や PDF/A-2b などの規格を選びます。
- PDF を書き出すを選び、ファイルを保存します。
- 適合が重要なときは、書き出した PDF を Oleafly の外で検証します。
Typst 0.14 以降はすべての PDF にタグを付けるため、タグ付きの別コンパイルはありません。古いバージョンで選べる規格は少なく、Typst 0.11 では 1 つもありません。どれに当てはまるかは、パネルに表示されます。新しいバージョンを使うには、コンパイルメニューの Typst のバージョン(このプロジェクト) を変更します。Typst プロジェクトを参照してください。
実用的な最終確認
「実用的な最終確認」セクション- 提出するつもりのソースを、そのままコンパイルします。
- 関連するプリフライトのチェックをすべて実行します。
- 確認済みの指摘を直し、要判断の指摘を調べます。
- 手動の項目をすべて、投稿先の最新のガイドと照らして確認します。
- 参考文献と付録を含め、最終の PDF を最初のページから最後まで読みます。
- 書き出したファイルとソースのアーカイブを、保存した場所から開きます。
- 締め切りの前に、投稿先が用意している検証ツールを使います。
プリフライトが減らせるのは、避けられる不意の問題です。採択、アクセシビリティ、科学的な正しさには、これからも著者、投稿先、そして文書を使う人たちが必要です。