Skip to content

book: redesign all diagrams + 2 new figures (release v26.06.112)#144

Merged
ancongui merged 1 commit into
mainfrom
book/figures-redesign-v112
Jun 16, 2026
Merged

book: redesign all diagrams + 2 new figures (release v26.06.112)#144
ancongui merged 1 commit into
mainfrom
book/figures-redesign-v112

Conversation

@ancongui

Copy link
Copy Markdown
Contributor

What

Overhauls the artwork in PyFly by Example (English + Spanish). Every content figure was rebuilt in one polished, consistent design language and rendered + visually inspected before committing.

Fixes real defects in the old diagrams

  • Broken "tofu" glyphs — the old SVGs used font-dependent characters (Unicode arrows , circled numbers ①②③, check marks ) that rendered as boxes. All such symbols are now drawn as vector shapes; every figure's text is ASCII/Latin-1 only (verified by a glyph audit: zero chars above U+00FF across all 23 figures).
  • Clipped / overflowing content (e.g. the event-sourcing figure had text cut off and tofu) — canvases resized with generous padding; nothing clips.
  • Low contrast / bland, inconsistent styling — replaced with a unified system.

New design language

White cards · brand-green gradient node headers · numbered step flows (on-theme with the step-by-step book) · monospace code tokens · slate for read/return paths, amber for cache/accents, warn-orange for failure/compensation · vector iconography (arrows, checkmark shields, clock, envelope, globe, retry loops).

Two new figures ("more where it helps")

  • 05-pagination (Ch. 5) — Page / Pageable / Sort: the request and the returned slice + counts.
  • 06-vo-entity (Ch. 6) — Value Object vs Entity (the aggregate figure was renumbered 6.1 → 6.2). Added to both languages.

Build & verify

  • 23 figures, all glyph-safe; verify_code clean for both manuscripts (0 failing listings × 29 files each).
  • Both editions rebuilt (EPUB + PDF) in the real weasyprint/EPUB pipeline and committed to book/dist/; book tests pass (5/5).
  • Version → v26.06.112; CHANGELOG updated. release.yml attaches all four books to the GitHub release.

Notes

Docs/artwork only — no framework code change. The figures are shared by both editions (ES chapters reference the same art/figures/ paths), so a single redesign upgrades both books.

Redesign every content figure of PyFly by Example (EN + ES) in one polished,
consistent design language: white cards, brand-green gradient headers, numbered
step flows, monospace code tokens, slate/amber/warn accents, and vector
iconography (arrows, checkmarks, badges, clock/envelope/globe/shield).

Fixes real defects in the previous artwork:
- broken 'tofu' glyphs from font-dependent characters (Unicode arrows, circled
  numbers, check marks) - now drawn as vector shapes; all figure text is
  ASCII/Latin-1 only.
- clipped / overflowing content (e.g. event-sourcing) - canvases resized with
  generous padding.
Every figure was rendered and visually inspected; a glyph audit confirms zero
characters above U+00FF across all 23 figures.

Adds two new figures where they help most:
- 05-pagination (Chapter 5): Page / Pageable / Sort.
- 06-vo-entity (Chapter 6): Value Object vs Entity (aggregate figure renumbered).

Both editions rebuilt (EPUB + PDF) and committed; release.yml attaches all four
books. Version -> v26.06.112; CHANGELOG updated.
@ancongui ancongui merged commit 872b5af into main Jun 16, 2026
6 checks passed
@ancongui ancongui deleted the book/figures-redesign-v112 branch June 16, 2026 20:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant