academic-beamer-slides-temp

name

academic-beamer-slides-temp

description

Create and refine academic paper-presentation slides in LaTeX Beamer with selectable generic templates, self-contained output folders, compile checks, and optional figure/table extraction from local paper projects. Use when the user wants seminar slides, lecture-style academic slides, paper presentations, or reusable Beamer decks from notes, a paper, `full.md`, `images/`, or extracted paper JSON, especially when they mention templates such as default, default-v2, or CambridgeUS.

Academic Beamer Slides Temp

Overview

Generate or revise academic Beamer slides as a repeatable workflow. Keep all artifacts in one folder, choose a template intentionally, improve Chinese academic phrasing when needed, reduce AI-writing traces, compile twice, and inspect the log before delivery.

Load these references when needed:

• Workflow and template choice: references/workflow.md
• Layout review standards: references/layout-checklist.md
• Figure/table insertion from local paper assets: references/figure-mining.md

Workflow Decision Tree

1. Determine whether the task is a new deck, a revision of an existing deck, or a style migration.
2. Choose a template:
   • default-v2
   • default
   • cambridgeus
3. Create a self-contained output folder before drafting.
4. Draft or revise slide text.
5. Mine figures/tables only when they support a specific claim.
6. Compile twice.
7. Parse the .log and fix layout or LaTeX issues before delivery.

Step 1: Initialize A Self-Contained Project Folder

Run:

python scripts/init_beamer_project.py --template <default-v2|default|cambridgeus> --output-dir <folder> --main-name <name>

This creates a folder that contains:

• the chosen main.tex
• any required style files
• build_beamer.bat
• all intermediate files and the final .pdf in the same directory

Do not scatter .aux, .log, .nav, .out, .snm, or .toc into the project root.

Step 2: Draft The Slide Content

Use a paper-presentation structure unless the user asks for another format:

1. Title
2. Outline
3. Motivation / question
4. Literature / gap
5. Model or empirical design
6. Main results
7. Mechanism / interpretation
8. Robustness / extension
9. Conclusion
10. Backup slides if needed

For Chinese slide prose:

• Prefer direct seminar language over report-summary language.
• Keep one stable translation for each technical term.
• Write slide sentences, not note-style paragraphs.

If the session also exposes relevant skills:

• Use academic-lecture-notes when the deck needs stronger Chinese academic exposition, theorem/proof structure, or graduate-level terminology.
• Use humanizer after the content draft when the wording sounds like AI-generated summary prose.

Step 3: Add Figures And Tables Only When They Earn Their Space

If the project folder contains paper assets, use them deliberately.

Preferred source order:

1. full.md
2. content_list_v2.json or similar extracted JSON
3. images/

Useful script:

python scripts/find_paper_figures.py --project-dir <paper-folder>

Rules:

• Add a figure only when it supports a claim on that slide.
• Prefer one figure per slide, or two tightly related figures on one slide.
• Put parameter tables on their own slide when they are dense.
• Shorten captions to "what to notice", not the full paper caption.

Step 4: Compile

Preferred:

build_beamer.bat

or:

build_beamer.bat <main-file>.tex

The batch file runs XeLaTeX twice and keeps outputs local to the folder.

Step 5: Inspect The Log And Fix Layout

Run:

python scripts/check_beamer_log.py <file>.log

Interpretation:

• exit code 2: compile errors, must fix
• exit code 1: layout warnings remain, inspect and usually fix
• exit code 0: no tracked compile/layout issues found

Treat these as real problems unless obviously tiny and harmless:

• Undefined control sequence
• Package ... Error
• Overfull \hbox
• Overfull \vbox

Use the checklist in references/layout-checklist.md.

Step 6: Typical Revision Moves

When a dense frame breaks:

• split one slide into two before shrinking all fonts
• move derivation detail to backup slides
• shorten captions and block titles
• replace a paragraph with one sentence plus one figure
• reduce font size locally, not globally

Assets

Template assets live in:

• assets/templates/default/
• assets/templates/default-v2/
• assets/templates/cambridgeus/

Shared build script lives in:

• assets/common/build_beamer.bat