arxiv-paper-zh

name

arxiv-paper-zh

description

Download arXiv LaTeX sources and PDFs into title-based paper folders, keep English source and Chinese source trees separate, maintain a concise glossary while manually translating the full paper into Chinese paragraph by paragraph without machine-translation APIs, scan for likely untranslated prose, and compile paper-zh.pdf locally with tectonic. Optionally create a bilingual reading PDF when requested. Use when asked to fetch, organize, translate, inspect, fix, or rebuild Chinese arXiv paper PDFs from source.

arxiv-paper-zh

Purpose

Use this skill to build a source-preserving Chinese paper workspace from arXiv:

<papers-root>/<SimpleTitle>/
  source/
  source-zh/
  translation/
    glossary.md
  paper.pdf
  paper-zh.pdf
  source-bilingual/        # optional, only when requested
  paper-bilingual.pdf      # optional, only when requested

The core requirement is layout preservation. Read the paper first, translate the Chinese copy manually paragraph by paragraph, preserve LaTeX structure, and compile locally with tectonic so the Chinese PDF keeps the original paper layout as much as possible.

Prefer running this workflow on Linux. Linux is the recommended environment for arXiv source builds, CJK font fixes, and tectonic compilation.

Workflow

1. Download and Scaffold

Run the downloader from this skill directory:

python {SKILL_DIR}/scripts/fetch_arxiv_papers.py \
  --dest /abs/path/to/papers-root \
  https://arxiv.org/abs/2509.23402 \
  2603.17117

The script downloads the original PDF, extracts the source package, verifies that .tex files exist, creates source/, and initializes source-zh/ by copying the original source.

If a paper folder already exists, stop and inspect it. Use --skip-existing only when the user explicitly wants existing folders left untouched.

2. Read Before Translating

Before editing source-zh/:

• Identify the main TeX file and included section files.
• Read the full paper once, including appendix material unless the user explicitly asks for body-only translation.
• Create translation/glossary.md with a small terminology table for method names, datasets, metrics, and repeated technical concepts.
• Keep model names, dataset names, benchmark names, metric names, symbols, code identifiers, and citation keys in their standard form.

Do not translate section by section blindly. The translation should reflect the paper's claims, terminology, and argument structure across the whole document.

Keep translation/glossary.md concise and human-readable. Update it during translation whenever an important term choice is made or revised. Do not add other terminology artifacts unless the user explicitly asks for them.

Use a simple table:

| English | 中文 | Notes |
|---|---|---|
| feed-forward | 前馈式 | fixed convention |
| reconstruction | 重建 | vision/3D context |

3. Translate in source-zh/

Edit only the source-zh/ tree. Never rewrite source/ while producing the Chinese version.

Translate manually:

• Translate prose paragraph by paragraph into natural technical Chinese.
• Translate title, abstract, section headings, appendix headings, captions, table headers, list items, footnotes, and visible figure labels when they are part of the paper text.
• Preserve LaTeX commands, custom macros, labels, citations, references, equations, tables, figures, bibliography files, file paths, URLs, and code tokens.
• Keep proper nouns and standard technical tokens in English when that is the normal convention.
• Do not use machine-translation APIs, batch translation services, or downloaded existing translations unless the user explicitly overrides this rule.
• Follow translation/glossary.md for repeated terms, and update the glossary immediately when introducing a new repeated translation choice.

If Chinese support is missing from the LaTeX preamble, add the smallest compatible CJK setup to the main file in source-zh/. For build issues, read references/troubleshooting.md.

4. Optional Bilingual Reading Version

Only create a bilingual version when the user asks for it. Keep it separate from the layout-preserving Chinese output:

<papers-root>/<SimpleTitle>/
  source-bilingual/
  paper-bilingual.pdf

The bilingual PDF is for side-by-side or alternating paragraph reading. It may grow much longer than the original and does not need to preserve the original paper layout as strictly as paper-zh.pdf. Do not let bilingual formatting changes affect source/ or source-zh/.

5. Inspect for Missed English Prose

After a substantial translation pass, scan the translated tree:

python {SKILL_DIR}/scripts/inspect_tex.py scan --scope full /abs/path/to/paper-dir

Use --scope body only if the user explicitly asked not to translate appendices.

The scanner is heuristic. Fix real missed English prose. It is acceptable for the remaining hits to be proper nouns, model names, datasets, metric names, acronyms, equations, code, URLs, bibliography entries, or other text that should remain English.

6. Compile With Tectonic

Before building, check whether tectonic is available:

tectonic --version

If it is missing, do not stop at an instruction for the user. On Linux/macOS, self-install it to ~/.local/bin/tectonic with the official installer:

mkdir -p ~/.local/bin
tmpdir="$(mktemp -d)"
curl --proto '=https' --tlsv1.2 -fsSL https://drop-sh.fullyjustified.net \
  -o "$tmpdir/install-tectonic.sh"
(cd "$tmpdir" && sh install-tectonic.sh)
install -m 755 "$tmpdir/tectonic" ~/.local/bin/tectonic
export PATH="$HOME/.local/bin:$PATH"
tectonic --version

Build the Chinese PDF:

python {SKILL_DIR}/scripts/build_translated_paper.py /abs/path/to/paper-dir

If the main file was detected incorrectly:

python {SKILL_DIR}/scripts/build_translated_paper.py \
  --main-tex path/relative/to/source-zh/main.tex \
  /abs/path/to/paper-dir

The script runs tectonic, copies the resulting PDF to <paper-dir>/paper-zh.pdf, and reports the build log location if compilation fails. If tectonic is missing, it attempts the same self-install automatically unless --no-install-tectonic is passed.

7. Verify

Before finishing:

• Confirm paper.pdf exists.
• Confirm source/ remains unchanged unless the user explicitly requested otherwise.
• Confirm source-zh/ contains the translated TeX.
• Confirm translation/glossary.md exists and reflects the final terminology choices.
• Confirm paper-zh.pdf exists and is non-empty.
• If requested, confirm source-bilingual/ and paper-bilingual.pdf exist and are non-empty.
• Mention any unresolved build warnings only when they matter for the user's next action.

Translation Conventions

• Prefer concise, publication-style Chinese over literal word-for-word rendering.
• Translate "novel view" as 新视角 unless the paper uses a different meaning.
• Translate "feed-forward" as 前馈式.
• Translate "reconstruction" as 重建 in vision/3D contexts.
• Preserve citation keys and cross-reference labels exactly.
• Shorten figure overlay labels when necessary, but keep their meaning.

Bundled Resources

• scripts/fetch_arxiv_papers.py: download arXiv sources/PDFs and create the source/ plus source-zh/ workspace.
• scripts/inspect_tex.py: scan translated TeX for likely missed English prose.
• scripts/build_translated_paper.py: compile source-zh/ with tectonic and sync paper-zh.pdf.
• references/troubleshooting.md: common source and build problems.