📌 この記事の位置づけ
本記事は、以下のシリーズの続編です。
- 39：VS Code 上で LaTeX 環境を先に固めた
- 40：IEEE Control Systems 論文を完走するための LaTeX 最小構成
- 41：その構成で、実際に完成 PDF まで到達した
この記事では、その最終段階として、
「この LaTeX 構成を、CI（GitHub Actions）でも最後まで通す」
という PoC を記録します。
🎯 この記事でやること
本記事で扱うのは、論文の内容ではありません。
- 制御理論
- 実験結果
- 研究の新規性
これらは一切扱いません。
目的は一貫して次の一点です。
IEEE Control Systems 論文を、CI 上でも LaTeX で破綻させず完走できるか
🤔 なぜ GitHub Actions までやるのか
ローカルで PDF が通っても、次の段階で止まることが多いです。
- 環境差分で落ちる
- BibTeX が CI で失敗する
- ログが見えず原因不明になる
つまり、
「人間の環境では通るが、再現できない」
状態になります。
そこで今回は、
- ローカル
- GitHub Actions（Ubuntu）
の 両方で同じ LaTeX 構成が通る ことを、PoC として確認しました。
🧱 採用した方針
この CI では、以下を重視しています。
- IEEEtran + XeLaTeX 前提
- 失敗時でも 必ずログを回収
- 成功時は PDF を artifact として保存
「CI が落ちたら何も分からない」状態を避ける設計です。
🧩 GitHub Actions workflow 全体
以下が、今回使用した workflow です。
name: Build LaTeX PDF (Humanoid TCST)
on:
push:
paths:
- 'papers/2025_humanoid_tcst/**'
- '.github/workflows/latex_humanoid_tcst.yml'
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Compile LaTeX document
id: compile
uses: xu-cheng/latex-action@v2
with:
root_file: main.tex
working_directory: papers/2025_humanoid_tcst
latexmk_use_xelatex: true
continue_on_error: false
# --- 失敗時でもログを出力 ---
- name: Show LaTeX logs (tail)
if: always()
run: |
echo "==== list ===="
ls -la papers/2025_humanoid_tcst || true
echo "==== main.log (last 200 lines) ===="
tail -n 200 papers/2025_humanoid_tcst/main.log || true
echo "==== latexmk.log (last 200 lines) ===="
tail -n 200 papers/2025_humanoid_tcst/latexmk.log || true
- name: Upload PDF artifact
if: success()
uses: actions/upload-artifact@v4
with:
name: humanoid_tcst_pdf
path: papers/2025_humanoid_tcst/main.pdf
- name: Upload logs artifact
if: always()
uses: actions/upload-artifact@v4
with:
name: latex_logs
path: |
papers/2025_humanoid_tcst/*.log
papers/2025_humanoid_tcst/*.aux
papers/2025_humanoid_tcst/*.blg
🔍 この workflow のポイント
① XeLaTeX 前提を明示
latexmk_use_xelatex: true
- IEEEtran
- newtx 系フォント
を使う前提を、CI 側でも固定しています。
② 失敗してもログを必ず出す
if: always()
を使い、
- main.log
- latexmk.log
を 必ず取得します。
CI で LaTeX が落ちた場合、
ログがないと原因特定がほぼ不可能です。
③ 成功時は PDF を artifact 化
uses: actions/upload-artifact@v4
により、
- 完成 PDF
- ビルドログ
を 成果物として保存できます。
これは、
「この構成で CI でも完走した」
という証拠になります。
🧠 CI まで通して分かったこと
- IEEEtran 構成は CI でも問題なく通る
- Appendix / Biography を含めても破綻しない
- LaTeX は 構造が正しければ自動化できる
ということが、実証できました。
🧾 本シリーズのまとめ（39–42）
- 39：環境と作業枠を先に固めた
- 40：完走できる LaTeX 最小構成を定義した
- 41：実際に完成 PDF まで到達した
- 42：CI（GitHub Actions）でも同じ構成を完走させた
論文の中身は、
この土台の上で初めて安心して磨けます。
🏁 おわりに
論文執筆が止まる原因は、
理論や実験ではなく 「再現できない構造」 であることが多いです。
LaTeX 構成を固め、
CI まで通しておくことで、
- 環境差分
- 再現性
- 属人性
をまとめて排除できます。
本記事が、
IEEE Control Systems 論文を書こうとしている方の
参考になれば幸いです。
※ 本記事は LaTeX / CI 構成 PoC の記録であり、
研究成果の主張や評価を目的とするものではありません。