latex-paper-conversion

LaTeX 論文の変換

概要

このスキルは、LaTeX で執筆された学術論文を、ある出版社のテンプレートから別のテンプレートへ変換する、手間がかかり繰り返し発生する作業を自動化します。ジャーナル（Springer、MDPI、IEEE など）ごとに、文書の構成要件、ドキュメントクラス、余白の設定、参考文献のスタイルは大きく異なります。このスキルでは、構造化された複数段階のワークフローを実行し、内容を抽出して新しいテンプレートに対応付け、よくあるコンパイルエラーを解決することで、こうした変換を効率化します。

このスキルを使用する場面

• 既存の LaTeX 論文を新しいジャーナルの書式に変換するようユーザーから依頼された場合に使用します。
• ユーザーから既存の .tex ファイルと新しいテンプレートのディレクトリが提供された場合に使用します。
• フォーマット A（例：IPOL／Neural Processing）からフォーマット B（例：MDPI）への変換についてユーザーが言及した場合に使用します。

動作の仕組み

ステップ 1：前提条件と評価

元の LaTeX ファイルを特定し、ユーザーに変換先テンプレートのディレクトリを尋ねます。基本的なレイアウトの対応関係（1 段組か 2 段組か、参考文献のスタイルなど）を把握します。

ステップ 2：抽出・挿入スクリプトの生成

元の LaTeX ファイルを解析する Python スクリプト（例：convert_format.py）を作成します。レビュー済みの境界認識型抽出を使用してください。正規表現だけでは、任意のネストを含む TeX を安全に解析できません。コメント、マクロ、インクルードファイル、ラベル、引用、著者のメタデータを保持し、抽出した本文を元のファイルと照合します。新しいテンプレートの preamble、抽出した body、backmatter を結合します。出力ディレクトリ内の新しいファイルに書き込みます。

ステップ 3：体系的な修正

最終ファイルを書き込む前、または後続の処理で、抽出した本文に一般的な修正を行います。

• 数式環境のケースを変換します（例：\begin{theorem} を \begin{Theorem} にします）。
• 強制的なフロート配置を、テンプレートがサポートするオプションに調整します（例：[!t] または [h!]）。float パッケージが明示的に読み込まれていない限り、[H] の指定は避けてください。
• \includegraphics のパスが、新しい .tex ファイルの場所からの相対パスになっていることを確認します。
• 表はそれぞれ、適切に \columnwidth または \textwidth に合わせます。tabularx には、そのパッケージ、列指定、および対応する終了環境が必要です。開始コマンドだけを置き換えないでください。

ステップ 4：コンパイルとデバッグ

テンプレートで必要なエンジンと参考文献バックエンド（BibTeX または Biber）を使用し、参照を解決するために必要な回数だけ再実行します。レビュー済みのソースは、シェルエスケープを無効にした隔離された出力ディレクトリでコンパイルしてください。信頼できない TeX やビルドスクリプトは、ファイルを読み取ったりコマンドを実行したりする可能性があります。.log ファイルを grep または rg で確認し、パッケージの競合、未定義コマンド、コンパイルの停止を体系的に修正します。

例

例 1：IPOL から MDPI への変換

USER: "I need to convert my paper 'SAHQR_Paper.tex' to the MDPI format located in the 'MDPI_template_ACS' folder."
AGENT: *Triggers latex-paper-conversion skill*
1. Analyzes source `.tex` and target `template.tex`.
2. Creates Python script to extract Introduction through Conclusion.
3. Injects content into MDPI template.
4. Updates image paths and selects supported float options; uses `[H]` only if required and supported.
5. Compiles via pdflatex and bibtex to confirm zero errors.

ベストプラクティス

• ✅ 必ず Python の抽出スクリプトを作成してください。何千行もの LaTeX を手作業でコピー＆ペーストしないでください。
• ✅ 利用可能な場合は、テンプレートで必要なコンパイラーを実行し、ログと出力の見た目を確認してください。利用できない場合は、コンパイルを検証できなかったことを報告してください。
• ✅ 元の構成と変換先の構成が大きく異なる場合（例：概要とキーワードの統合）は、構成の対応関係をユーザーに明示的に尋ねてください。
• ❌ 新しいテンプレートにすべての数式パッケージが自動的に含まれていると決めつけないでください（例：不足している場合は \usepackage{amsmath} を追加します）。

よくある落とし穴

• 問題： 1 段組から 2 段組への移行で、表のボックスが幅を超える。 解決策： \begin{tabular} を検出し、自動的に \resizebox{\columnwidth}{!}{...} で囲むか、書式の変更を提案します。
• 問題： コンパイル中に未定義の制御綴エラーが発生する。 解決策： Paper.log を検索し、不足している \usepackage{} を変換後のテンプレートに追加します。

追加リソース

• Overleaf LaTeX ドキュメント

制限事項

• このスキルは、タスクが上記のスコープに明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全境界、成功基準が欠けている場合は、作業を中断して確認を求めてください。