paper-spine-latex

PaperSpine LaTeX

LaTeX の組み立て、テンプレートへの統合、図の配置、引用、ラベル、およびコンパイルの安全性チェックには、このスキルを使用してください。書き換えやビルドの出力で必要な場合を除き、原稿の論理は変更しないでください。

必須の入力

• 改訂済みの原稿またはビルド済みの原稿
• 使用するテンプレート（任意）
• 図、表、参考文献、ソースファイル
• 素材からビルドする場合は、paper_rewriting_output/figure_asset_map.md

必須の出力

• 更新済みの LaTeX プロジェクト。素材からビルドする場合は、 paper_rewriting_output/final_paper/main.tex を使用してください
• TeX エンジンが利用可能な場合は、コンパイル済みの PDF。素材からビルドする場合は、 paper_rewriting_output/final_paper/paper.pdf を使用してください
• paper_rewriting_output/latex_report.md
• 最終成果物を作成する場合は、paper_rewriting_output/final_artifact_manifest.md
• paper_rewriting_output/final_paper/paper.docx と paper_rewriting_output/word_report.md（任意）

ルール

• プロジェクトのパスには、スペースや ASCII 以外の文字が含まれる場合があります（例：exp_lab_en - 副本）。pandoc／copy コマンドに渡すすべてのパスを引用符で囲み、引用符で囲まないシェルのグロブは避けてください。このようなディレクトリでは、エラーが表示されないまま正常に動作しないことがあります。Windows では、ファイル操作に PowerShell を使用することを推奨します。
• コンテンツの作業は LaTeX の構成作業と分けてください。
• 検証済みの変更理由がない限り、引用キーとラベルは維持してください。
• 承認済みの画像を figures/ にコピーし、安定したラベルを使用してください。
• 利用可能な場合は、scripts/latex_guard.py を実行してください。
• 未解決のコンパイルまたはアセットの問題は latex_report.md に記録してください。
• ワークフローが build_from_materials の場合、Markdown を最終原稿として扱わないでください。
• 中国語で出力する場合は XeLaTeX と CJK 対応テンプレートを推奨します。英語で出力する場合は、対象のテンプレートに従うか、保守的な article テンプレートを使用してください。
• TeX エンジンが利用できない場合は .tex を保持し、コンパイルをスキップしたことを latex_report.md に記録してください。
• TeX エンジンが利用可能なのにコンパイルに失敗した場合は、.tex を保持し、最初の致命的なエラーを latex_report.md に記載してください。また、アーティファクトのチェックに合格したと主張しないでください。
• Word 出力を生成する場合は、final_paper/ ディレクトリから pandoc を使用してください。原稿で BibTeX 引用を使用している場合は、citeproc で解決し、\cite コマンドが生の LaTeX のまま残らず、書式設定された参考文献として出力されるようにしてください：

  cd final_paper
  pandoc main.tex -o paper.docx --from latex --to docx \
    --resource-path=. --extract-media=./media \
    --number-sections --citeproc --bibliography=references.bib
  

  • --citeproc --bibliography=references.bib は \cite{...} と参考文献リストを出力します。原稿に引用がない場合に限り、省略してください。
  • --number-sections を指定すると、LaTeX ソースと同じように見出しに番号が付きます。
  • --resource-path=. は \includegraphics{figures/...} のパスを解決します。
  • --extract-media=./media は画像を docx に埋め込みます。
  • ハウススタイル（フォント、見出しスタイル、余白）を適用するには、対象のテンプレートから作成した --reference-doc=reference.docx を追加してください。
  • \ref／\autoref の相互参照には pandoc-crossref フィルター（--filter pandoc-crossref）が必要です。指定しない場合、[?] と出力されることがあります。
  • これらのフラグを指定しないと、pandoc は画像や引用を黙って削除したり、空の docx を生成したりします。
  • .tex 内の相対パスが正しく解決されるよう、final_paper/ から実行してください。
  • エンコーディングを失わせる中間のプレーンテキスト変換手順は使用しないでください。
• scripts/word_guard.py final_paper/paper.docx --markdown --output paper_rewriting_output/word_report.md を実行し、Word ファイルを使用可能なものとして提示する前に、失敗項目を修正してください。word_guard が段落数 0 を報告した場合は、画像が対応形式（PNG／JPG）であること、および figures/ ディレクトリが存在することを確認してください。
• Word 出力の忠実性を保つため、次のような pandoc の一般的なエラーを防いでください。
  • まず \input／\include を展開し（例：latexpand main.tex > flat.tex）、その後、展開済みのファイルを変換してください。pandoc はサブファイルを確実に取り込めません。
  • カスタムの \newcommand／\def マクロは展開するか削除してください。pandoc が解決できないマクロは、その内容を黙って落とします。
  • 表はシンプルな形式（tabular／booktabs）にしてください。tabularx、multirow、入れ子の表は docx で位置がずれることが多いため、表を一つずつ開いて確認してください。
  • Citeproc は既定で著者・年方式を出力するため、数値形式の LaTeX スタイル（plain、unsrt、ieeetr）とは Word での表示が異なります。番号付きの [1] 引用を維持するには、--csl=ieee.csl や --csl=vancouver.csl など、数値形式の CSL を指定してください。
  • 中国語の場合は、CJK フォント（例：SimSun または Noto Serif CJK）を使用して --reference-doc=reference.docx を作成してください。指定しないと、文字が四角で表示されます。
  • 変換後、docx を開いて見出し、数式、図、表、参考文献がすべて正しく出力されていることを確認してください。

LaTeX の構造を編集する前に、references/latex-source-control.md を読んでください。