paper-latex-ppt

name

paper-latex-ppt

description

Create a concise Chinese LaTeX Beamer presentation PDF from an academic paper source folder or arXiv link. Use when the user provides a paper LaTeX/Overleaf folder, an arXiv URL/id, asks for a PPT/slides/deck in LaTeX format, says arxiv链接、arXiv源码、论文文件夹、论文PPT、LaTeX PPT、中文Beamer、用LaTeX做汇报PPT、编译PDF, wants Chinese presentation content with original title/authors preserved, requires important figures and tables from the paper to be included and explained, or asks to compile the generated Beamer .tex into PDF using a supplied or bundled template with Noto Serif CJK SC.

Paper LaTeX PPT

Goal

Turn a paper LaTeX folder or arXiv link into a clean Chinese ctexbeamer slide deck and compile it to PDF. Preserve the paper title and authors in their original language. Write all explanatory slide text in Chinese. Include important figures and tables from the paper source, with nearby explanatory text; give a figure/table its own slide when needed.

Quick Workflow

1. Identify the input and output location. Input may be a local paper LaTeX folder, an Overleaf-exported folder, an arXiv URL, or a bare arXiv id.
2. If the input is arXiv, run scripts/download_arxiv_source.py <arxiv_url_or_id> <source_dir> to download and unpack the official arXiv e-print source. If arXiv has no TeX source, report that clearly and ask for the paper folder or PDF plus assets.
3. If the user supplies their own template, use it; otherwise use assets/beamer_template.tex.
4. Run scripts/prepare_paper_ppt.py <paper_dir> <output_dir> to create a work directory, copy the paper folder, inspect the likely main .tex, list figure/table candidates, and place a starter slides.tex.
5. Read the generated paper_inventory.md and the paper source. Inspect figure/table files directly when captions are insufficient.
6. Replace the starter slide placeholders in slides.tex with a complete Chinese presentation.
7. Before compiling, ensure the local LaTeX environment has the required Chinese Beamer packages. If packages are missing, run scripts/ensure_latex_env.py --install-user to install relocatable TeX Live packages into the user tree, and use system package installation only when sudo/noninteractive apt is available.
8. Compile with XeLaTeX, preferably latexmk -xelatex -interaction=nonstopmode slides.tex. If XeLaTeX is unavailable but LuaLaTeX is available, compile with lualatex after installing luatexja; this is an acceptable local fallback for producing the PDF.
9. Verify that the PDF exists, important figures/tables render, pages are not overcrowded, and no incremental overlay syntax is present.

arXiv Inputs

Use the arXiv source endpoint, not the PDF endpoint, whenever possible. The helper accepts forms such as:

scripts/download_arxiv_source.py https://arxiv.org/abs/2401.01234 /tmp/paper-source
scripts/download_arxiv_source.py https://arxiv.org/pdf/2401.01234 /tmp/paper-source
scripts/download_arxiv_source.py 2401.01234 /tmp/paper-source

Then continue with:

scripts/prepare_paper_ppt.py /tmp/paper-source <output_dir>

If the arXiv source is a single gzipped TeX file, the script writes it as main.tex. If the source archive contains nested folders, inspect paper_inventory.md and the likely main .tex before drafting slides.

Slide Requirements

• Use ctexbeamer, 16:9, top-aligned frames, and Noto Serif CJK SC for Chinese fonts.
• Keep the interface simple: white background, blue section rule, restrained text, no decorative gradients.
• Do not use incremental reveal commands such as \pause, \onslide, \only, \visible, or overlay specs like <1->. Every page must be full new content.
• Keep each page focused. Prefer 12-18 slides for ordinary papers, adding pages only for complex methods, important figures, or dense tables.
• Use this default structure unless the paper calls for a better one:
  • Cover
  • 汇报提纲
  • 研究背景
  • 研究问题
  • 核心思路 / 方法设计
  • 关键图表解读
  • 实验设置
  • 实验结果
  • 消融 / 分析 / 案例
  • 小结
  • 方案已有问题与个人思考
• Put at most 3-5 bullets on text-heavy slides.
• For figure slides, use a two-column layout by default: left figure, right Chinese interpretation. Use a full-width figure plus lower text when the figure is wide.
• For tables, simplify when possible. If the original table is too dense, either import the original table on one page and explain takeaways on the side, or recreate only the key rows/columns in Beamer.

Paper Reading Heuristics

When drafting content, extract and verify:

• Metadata: title, authors, venue/year if available.
• Motivation: what practical or scientific gap the paper targets.
• Problem setting: task, threat model, assumptions, inputs/outputs, metrics.
• Contributions: usually from abstract/introduction.
• Method: pipeline, model architecture, algorithms, training/inference, privacy/security mechanism.
• Experiments: datasets, baselines, metrics, main tables, ablations, sensitivity analyses, case studies.
• Limitations: stated limitations plus your own technical critique.

Prioritize figures/tables with captions containing: overview, framework, architecture, pipeline, algorithm, main results, comparison, ablation, analysis, case study, visualization, or user study. Always inspect the actual figure/table before deciding it is unimportant.

LaTeX Asset Paths

The output work directory created by the script contains:

<output_dir>/
  slides.tex
  paper_inventory.md
  paper/                 # copied paper source folder

In slides.tex, reference original paper assets through paths under paper/, for example:

\includegraphics[width=\linewidth]{paper/figures/overview.pdf}

If a paper uses custom macros for tables, prefer copying the needed macro definitions into slides.tex only when they are necessary. Keep the slide file self-contained enough to compile inside Overleaf after uploading the whole output directory.

Template

Use assets/beamer_template.tex as the default slide skeleton. It already contains the user's requested visual style, footline, \PageTitle{...} macro, Noto Serif CJK SC, and helper environments for figure/text layouts.

When adapting a user-supplied template:

• Preserve their visual macros, page margins, footer text, and date style unless they ask otherwise.
• Add only the missing packages needed for figures/tables, such as graphicx, booktabs, tabularx, adjustbox, multicol, or fontspec.
• Keep the document compilable with XeLaTeX.

Compilation

Prefer XeLaTeX because Chinese text and Noto Serif CJK SC are required.

cd <output_dir>
latexmk -xelatex -interaction=nonstopmode -halt-on-error slides.tex

Fallback:

xelatex -interaction=nonstopmode -halt-on-error slides.tex
xelatex -interaction=nonstopmode -halt-on-error slides.tex

If the machine lacks ctexbeamer.cls, xelatex, latexmk, pgfcore.sty, adjustbox.sty, or luatexja.sty, install the missing environment before changing the slide template:

scripts/ensure_latex_env.py --install-user

The helper first reports missing commands/packages. With --install-user, it initializes tlmgr user mode, pins the repository to the historic TeX Live release matching the installed system tlmgr, and installs relocatable packages such as ctex, zhnumber, fandol, pgf, xcolor, luatexja, adjustbox, collectbox, and varwidth. It also removes user-mode l3kernel, l3packages, and l3backend if they conflict with the system LaTeX format. Some engines such as xetex, luatex, and latex-bin are not relocatable and cannot be installed in user mode; in that case use apt/system packages when permitted, or compile with the already available engine.

When system package installation is permitted, the useful Debian/Ubuntu packages are:

sudo apt-get update
sudo apt-get install -y texlive-lang-chinese texlive-xetex texlive-luatex latexmk

If sudo requires a password or apt is locked by permissions, do not stop. Use the user-mode helper above and compile with LuaLaTeX if xelatex remains unavailable:

lualatex -interaction=nonstopmode -halt-on-error slides.tex
lualatex -interaction=nonstopmode -halt-on-error slides.tex

If the system lacks Noto Serif CJK SC, either install it or compile on Overleaf with the Noto CJK font available. Do not silently switch to a different Chinese font unless the user approves.

Final Checks

Before reporting completion:

• Confirm slides.pdf exists.
• Open or inspect compilation logs for missing image/font errors.
• Check that the important paper figures and tables are included or explicitly explained why any are omitted.
• Search the generated .tex for overlay commands and remove them.
• Keep the final answer short and include the output .tex and .pdf paths.