[markbac]

Problem

A poster's page script widens its layout until the content fits the paper's proportions, up to 4000 px. Pictures as wide as their column grow with the page, so a poster with several large pictures fits at no width.

The script then kept 4000 px, gave the poster the paper's height and let the content overflow:

• Printed from Chrome, the rest went onto a second page.
• py-doc poster --pdf prints page 1 only, so the bottom of the poster, footer included, was silently cut off.

Change

src/py_doc/poster.py, the page script:

• When no width fits, it takes the width whose content is least tall for that width, so the poster prints as large as it can.
• The poster is as tall as its content, so nothing is cut off.
• On beforeprint, the poster is scaled to fit the page and centred, with margins at the sides. This covers Chrome's print dialogue and --pdf alike.
• It marks the poster data-squeezed and warns in the browser console.
• Posters that fit are unchanged: their print zoom and margin are what they were.

The posters guide and the writing guide say what happens and what to do about it. The new sentences keep within the Vale sentence limit.

Testing

• New browser test: a picture too tall to fit at any width. It checks that the poster holds all its content, prints on one page and is centred. It fails before the change and passes after.
• Full suite: 1331 passed, 43 skipped. ruff check and ruff format --check are clean.
• Real poster: an A1 landscape poster with seven screenshots, which lost its footer before, now prints whole on one page.
• --pdf itself was not run, because it needs the tool container. poster_pdf.js takes the same steps the test does: print media, beforeprint, then the PDF.

Not done

The warning shows only in the browser console. Reporting it in the terminal during --pdf would mean passing output back from the container.

---

Generated by Claude Code