latex-scaffold

Original：🇺🇸 English

Translated

1 scripts

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`；不在此步骤改写内容。

1installs

Sourcewilloscar/research-units-pipeline-skills

Added on2026-02-14

NPX Install

npx skill4agent add willoscar/research-units-pipeline-skills latex-scaffold

SKILL.md Content

View Translation Comparison →

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

Create
```
latex/
```
directory if missing.
Create
```
latex/main.tex
```
with sections matching the outline.
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
```
  ).
- Headings starting with
```
Appendix
```
  /
```
附录
```
  trigger
```
\appendix
```
  once, then render as appendix sections.
- Bold caption lines like
```
**Table 1. ...**
```
  /
```
**Appendix Table A1. ...**
```
  immediately before a Markdown table become a LaTeX
```
table
```
  float with
```
\caption{...}
```
  and a stable
```
\label{tab:...}
```
  .
- ```
## 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