LaTeXを書いてPDFをプレビュー

重要な編集セッションの後、ルート ファイル、エンジン、パッケージ セット、またはフォルダー構造を変更する前に、プロジェクトを ZIP としてエクスポートします。アーカイブには、プロジェクトを他の場所で継続するために必要なソース ファイルと追加のアセットが含まれている必要があります。ダウンロードされた PDF はコンパイルされた結果のみであり、編集可能なソースを置き換えることはできません。 ZIP を開き、プロジェクトのコピーとして使用する前に、章、参考文献ファイル、画像、カスタム クラス、スタイル ファイルが存在することを確認します。

可能な限り、既存のプロジェクトですでに指定されているエンジンを使用してください。 pdfLaTeX は、多くの確立されたドキュメントやパッケージにとって実用的な選択肢です。ソースで広範な Unicode テキスト、システム フォント、または OpenType フォント機能が必要な場合は、XeLaTeX が推奨されることがよくあります。エンジンを変更すると、フォント メトリック、改行、パッケージの動作、出力のページネーションに影響を与える可能性があります。選択が不確かな場合は、プロジェクトのドキュメントを確認し、代表的なページ、方程式、参考文献、および非ラテン語テキストをクリーンにまとめたものを比較してください。

後のメッセージは以前の同じエラーの結果であることが多いため、最初の有用な診断から始めてください。よくある原因としては、不明なコマンド、一致しない中括弧、ファイルの欠落、不正なパス、選択したエンジンで使用できないパッケージ、ドキュメント環境を含まないルート ドキュメントなどが挙げられます。原因を 1 つずつ修正し、再度コンパイルします。生成されたファイルにエラーが指摘されている場合は、影響を受ける目次、引用、ラベル、または補助エントリを作成したソース コマンドを調べてください。

相互参照と参考文献目録では、LaTeX が最初に補助情報を書き込み、その後のパスでそれを読み取るため、複数のコンパイルが成功する必要がある場合があります。すべてのラベルが一意であること、各参考文献が正確なラベル名を使用していること、引用キーが参考文献エントリと一致していること、および参考文献ファイルが予期されるワークフローに含まれていることを確認します。参照を判断する前にコンパイル エラーを修正してください。疑問符が残っている場合は、最も古い引用または補助ファイルの診断を検査し、選択したエンジンと参考文献コマンドがプロジェクトと一致することを確認します。

コンパイルが成功したということは、ドキュメントが正しいということではなく、PDF が生成されたことを意味します。タイトル ページ、ページ順序、見出し、表、図、方程式、脚注、リンク、引用、参考文献、ヘッダー、フッター、余白、改ページを確認します。過剰な行、クリップされたグラフィックス、欠落しているグリフ、未解決の疑問符、予期しない空白ページ、および変更されたフォント置換を探します。重要な文書の場合は、通常のズームと印刷縮尺で代表的なページを比較し、リンクとコピーされたテキストが期待どおりに動作することを確認します。

目的のルート .tex ファイルを特定し、章、画像、参考文献、クラス、スタイル ファイルの相対パスの一貫性を維持します。シェル コマンド、外部プログラム、異常なシステム フォント、使用できないパッケージ、または別の TeX ディストリビューションに依存するプロジェクトは、コンパイル前に変更が必要になる場合があります。ファイル名は、大文字と小文字がすべてのソース参照と正確に一致する場合に最も安全です。インポート後、最初に小さな既知のセクションをコンパイルし、診断を確認してから、パッケージ固有の違いや欠落している資産がないかドキュメント全体を検査します。