spb/llm-api-toolkits

1# Beamer: finding slides that overflow23## What happens45A frame has a fixed height. When its content is taller, Beamer does not start a new slide: the6extra lines are set below the bottom edge and never appear. The build succeeds. The only trace is7a log line such as89```10Overfull \vbox (42.48938pt too high) detected at line 2211```1213where the line is that of `\end{frame}`.1415## How the tool maps it to a frame16171. The log is read in order, counting the pages shipped out; an overfull vbox reported after18   page *n* belongs to page *n + 1*.192. Beamer's `.nav` file records the first and last page of each frame (a frame with overlays20   spans several pages).213. Frames are listed from the source in order — `\begin{frame}{Title}` or `\frametitle{Title}` —22   with file and line.2324When the number of frames in the `.nav` equals the number found in the source, the mapping is25exact and the report says `exact (.nav)`. Otherwise (frames produced by a macro or a loop,26`\againframe`, frames inside conditionals) it falls back to the line number of the warning and27says the mapping is approximate.2829## Reading the report3031`beamer deck.tex` returns:3233- `overflowing_frames` — number, title, file, line, how many points too high, pages;34- `frames_with_overfull_hbox` — content too wide (a long formula, a wide table or image);35- `frames_without_title` — title pages and outline frames are not counted;36- `frames` — every frame with its page range and number of overlay slides.3738As a rule of thumb at 10–11 pt, a line of text is 12–14 pt high: an overflow of 42 pt is about39three lines lost.4041## Fixing42431. Cut. A slide that overflows usually says too much.442. Split into two frames.453. Reduce a figure: `height=0.6\textheight` instead of a width.464. `\begin{frame}[allowframebreaks]` for bibliographies and long lists (not with overlays).475. `\begin{frame}[shrink=5]` or a smaller font for one frame, as a last resort: the audience48   sees the difference.496. `[t]` alignment does not gain space; it only moves the content up.5051## What is not detected5253- Material placed with `textpos`, `tikz` `overlay` / `remember picture`, or `\vspace*{-…}`54  tricks: it is not part of the box Beamer measures.55- Content hidden behind the footline or a logo: the frame box fits, the template covers it.56- Images wider than the slide inside a `\makebox` or `\resizebox` that hides the excess.57- Text that fits but is unreadably small.5859For these, look at the pages: `text deck.tex --from N --to N` shows which text reached page N,60and nothing replaces opening the PDF.61