dull-bird/do.arxiv-translator

arXiv LaTeX Translator & Compiler (Modern Solution)

This skill handles the end-to-end workflow of converting an arXiv paper's LaTeX source into a translated PDF on Windows, macOS, and Linux using modern xeCJK and fontspec.

Workflow

0. Pre-flight Dependency Check

Before starting, verify that all required system tools are installed.

• Windows (PowerShell): Get-Command curl, tar, xelatex, bibtex -ErrorAction SilentlyContinue
• macOS / Linux (Bash): for cmd in curl tar xelatex bibtex; do command -v $cmd >/dev/null 2>&1 || echo "Missing: $cmd"; done

1. Identify & Download

• Extract the ID (e.g., 2508.11825v2) from the URL or find it via search.
• Create a target directory and download/extract the source and the paper pdf (for final check) using native tools (curl, tar).
  • Abstract: https://arxiv.org/abs/xxxx.xxxxx
  • Source: https://arxiv.org/src/xxxx.xxxxx
  • PDF: https://arxiv.org/pdf/xxxx.xxxxx.pdf

2. Analyze & Modularize (For Large Papers)

• Read the original .pdf file to build a mental map.
• Modularization Strategy (Crucial for Reliability):
  • If the main .tex file is large (>500 lines), DO NOT use the replace tool for content translation. It is prone to whitespace/encoding mismatches.
  • Instead, write and run a Python script to split the monolithic .tex file into sub-files by \section (e.g., sections/01_intro.tex, sections/02_related.tex).
  • Update the main .tex file to use \input{sections/xxx.tex}.
  • For small files, you may still use replace or directly overwrite the file with write_file.
• Terminology Glossary: Create a local mental glossary of 5-10 core technical terms to ensure consistency.

3. Atomic Translation (Write-File Overwrite)

• Work on Chunks: Translate one sub-file (or one section) at a time.
• Overwrite Mode: Use the write_file tool to write the fully translated content into the sub-files. This avoids the "string not found" errors common with the replace tool.
• Content Preservation: Rigorously preserve LaTeX commands, math environments, citations, and references.
• Modern Chinese Support (xeCJK):
  • Inject \usepackage{xeCJK} and \setCJKmainfont{Microsoft YaHei} (or platform equivalent) into the main preamble.

4. Compile & Auto-Fix

• Use xelatex -interaction=nonstopmode.
• Standard compilation loop: xelatex -> bibtex -> xelatex x2.
• Missing Package Installation (First Priority): If compilation fails with a File 'xxx.sty' not found or LaTeX Error: File 'xxx.cls' not found error, ALWAYS attempt to install the missing package first before modifying any source file:
  1. Run tlmgr search --file xxx.sty to identify the TeX Live package name.
  2. Run tlmgr install <package-name> (may require sudo on macOS/Linux).
  3. If tlmgr is not available or fails, try mktexlsr to refresh the package database.
  4. On macOS with MacTeX, you can also use sudo tlmgr update --self && sudo tlmgr install <package-name>.
  5. Only after exhausting all installation options should you consider workarounds in source code.
• Other Error Auto-Fixing: For non-package errors (e.g., undefined commands, syntax errors), read the .log file, identify the error line, and fix the corresponding sub-file using write_file or replace.

5. Integrity Verification & Archive

• Completeness Check: Verify all sub-files in sections/ are translated.
• Visual Check: Compare the translated PDF with the original.
• Standardized Archiving: Move the final compiled PDF to the Obsidian vault at 60_Notes/papers/<Paper_Title>/<Paper_Title>_<LANG>.pdf (e.g., 60_Notes/papers/Attention Is All You Need/Attention Is All You Need_CN.pdf), aligning with note-summary's structure.
• Clean up intermediate files in the working directory.

Guidelines

• Prefer write_file over replace for Translation: Overwriting a small, dedicated section file is 100% reliable compared to searching for a literal string in a 20,000-line file.
• Font Selection:
  • Windows: Microsoft YaHei or SimSun.
  • macOS: PingFang SC.
  • Linux: Noto Sans CJK SC.
• Preserve Template: Use xeCJK to minimize style interference.
• Heredocs: Use single-quoted heredocs in shells to handle backslashes correctly.

Rules

• Read deeporbit.json from the workspace root to determine the interaction language. Use this language for all your responses and generated note contents (e.g. zh-CN). The Obsidian folder paths themselves will ALWAYS remain in English.
• Missing Package — Install First, Never Remove: If xelatex (or pdflatex) reports a missing .sty or .cls file, you MUST attempt to install the package using tlmgr before considering any source-code modification. The goal is to preserve the original paper's formatting as faithfully as possible. Only if installation is truly impossible (e.g., proprietary journal class not on CTAN) may you apply minimal source-level workarounds, and you must document the reason.
  • Install workflow:

    # 1. Find the package name
    tlmgr search --file <missing-file.sty>
    # 2. Install it
    sudo tlmgr install <package-name>
    # 3. Refresh the filename database
    sudo mktexlsr
    

  • Common shorthand packages to try first: texlive-latex-extra, texlive-science, texlive-publishers.
• Missing Bibliography Style Fallback: If bibtex fails with 'I couldn't open style file xxx.bst', first try tlmgr install <bibtex-style-package>. Only if the .bst file is a custom one bundled with the paper (not on CTAN) should you fallback to \bibliographystyle{plainnat} or \bibliographystyle{unsrt}.
• Anti-Destruction Principle: When fixing compilation errors or missing translations, NEVER extract files directly from the original tarball to overwrite existing .tex files, as this will destroy previously completed translations. Always inspect differences first.
• Large File Handling Strategy: For translating .tex files, favor replacing the entire file content using write_file over piece-meal updates with replace to prevent partial translations.
• Integrity Verification: Before declaring the task complete, explicitly check the translated document sections to ensure no section or subsection was accidentally reverted or skipped.