[markbac]

Summary

• examples/poster/landscape.md sets orientation: landscape in its own front matter. Before, that setting was only in py-doc.yml, so py-doc poster poster/landscape.md built a portrait A1 poster from a file written for three landscape columns. py-doc.yml keeps the company's look: theme, colours, header, footer and fonts. A new test builds the file on its own and checks it is landscape A1. With the line removed, the test fails.

• The posters chapter says which settings go where. The layout goes with the words, so orientation, columns, split, paper and width belong in the front matter. The company's look is shared, so it belongs under poster: in py-doc.yml.

• The posters chapter says how a poster is laid out, from the top down:

  1. the header;
  2. stats and abstract;
  3. bands of {.wide} sections and of columns, in section order;
  4. summary and references;
  5. the footer.

  It includes an example of full width, two columns, full width, two columns, full width.

• Fixes main's red CI. A 40-word sentence in the barcode docs from Poster barcode block: Code 128, Code 39, EAN-13, EAN-8, UPC-A and ITF-14 #172 fails the docs lint step on main, and it is split here.

Tests

• 1335 passed, 20 skipped.
• ruff check . passes, and so do py-doc lint docs --strict and the examples' py-doc lint docs poster --strict.
• The commissioning poster still builds through py-doc.yml as one landscape A1 page.

---

Generated by Claude Code