latex-scaffold

WILLOSCAR 的头像作者 WILLOSCAR

从现有的 Markdown 草稿和 `itations/ref.bib` 中搭建一个 LaTeX 项目(`latex/main.tex`、参考书目布线、结构)。**触发器**:latexscaffold、md→tex、LaTeX 重建项目、生成 main.tex。**使用时**:需要 LaTeX/PDF 交付(例如 arxiv-survey-latex pipeline),且草稿已生成/已进入构建阶段。**如果**:则跳过:还没有 `output/DRAFT.md`(或者你不需要 LaTeX 交付)。**Network**: none.**Guardrail**: 移除 markdown 残留(`##`, `**`, `[@...]`);参考书目指向 `itations/ref.bib`;不在此步骤改写内容。

📖 中文导读:从现有的 Markdown 草稿和 `itations/ref.bib` 中搭建一个 LaTeX 项目(`latex/main.tex`、参考书目布线、结构)。**触发器**:latexscaffold、md→tex、LaTeX 重建项目、生成 main.tex。**使用时**:需要 LaTeX/PDF 交付(例如 arxiv-survey-latex pipeline),且草稿已生成/已进入构建阶段。**如果**:则跳过:还没有 `output/DRAFT.md`(或者你不需要 LaTeX 交付)。**Network**: none.**Guardrail**: 移除 markdown 残留(`##`, `**`, `[@...]`);参考书目指向 `itations/ref.bib`;不在此步骤改写内容。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: latex-scaffold description: | Scaffold a LaTeX project (latex/main.tex, bibliography wiring, structure) from an existing Markdown draft and citations/ref.bib. Trigger: latex scaffold, md→tex, LaTeX 项目骨架, 生成 main.tex. Use when: 需要 LaTeX/PDF 交付(例如 arxiv-survey-latex pipeline),且 draft 已生成/已进入写作阶段。 Skip if: 还没有 output/DRAFT.md(或你不需要 LaTeX 交付)。 Network: none. Guardrail: 移除 markdown 残留(##, **, [@...]);bibliography 指向 citations/ref.bib;不在此步骤改写内容。

LaTeX Scaffold

Convert the approved Markdown draft into a minimal, buildable LaTeX project.

This is a deterministic conversion step; prose quality should already be addressed in output/DRAFT.md.

Inputs

  • output/DRAFT.md (or another approved draft)
  • citations/ref.bib

Outputs

  • latex/main.tex (and any required LaTeX support files)

Workflow

  1. Create latex/ directory if missing.
  2. Create latex/main.tex with sections matching the outline.
  3. Wire bibliography to citations/ref.bib.

Quality checklist

  • latex/main.tex exists and references citations/ref.bib.

Script

Quick Start

  • python .codex/skills/latex-scaffold/scripts/run.py --help
  • python .codex/skills/latex-scaffold/scripts/run.py --workspace <workspace_dir>

All Options

  • See --help (inputs/outputs are taken from the unit runner when used via pipeline)

Examples

  • Build latex/main.tex from output/DRAFT.md:
    • python .codex/skills/latex-scaffold/scripts/run.py --workspace <ws>

Notes

  • The generated latex/main.tex includes a table of contents (tocdepth=2) for readability.
  • Language default: the scaffold uses article (English-looking front matter). If the draft contains CJK characters, it switches to ctexart so the PDF renders correctly.
  • Conversion rules (high level):
    • Headings ##/###/#### → \section/\subsection/\subsubsection (strips leading numeric prefixes like 1.2).
    • ## Abstract → abstract environment.
    • [@Key] or [@Key1; @Key2] → \citep{Key} / \citep{Key1,Key2}.
    • Inline markdown **bold** / *italic* / `code` → \textbf{} / \emph{} / \texttt{}.

Troubleshooting

Issue: the generated latex/main.tex still contains Markdown markers

Fix:

  • Re-run latex-scaffold and ensure the input output/DRAFT.md is clean (no ##, no **, no [@...] syntax that isn""t handled).

Issue: citations are missing in LaTeX

Fix:

  • Ensure citations/ref.bib exists and the scaffold points bibliography to it; then compile with latex-compile-qa.