Skip to content

book: Spanish edition + step-by-step Quick Start + dedication (release v26.06.111)#143

Merged
ancongui merged 1 commit into
mainfrom
book/es-edition-tutorial-v111
Jun 16, 2026
Merged

book: Spanish edition + step-by-step Quick Start + dedication (release v26.06.111)#143
ancongui merged 1 commit into
mainfrom
book/es-edition-tutorial-v111

Conversation

@ancongui

Copy link
Copy Markdown
Contributor

What

Makes PyFly by Example bilingual and more beginner-friendly, and ships it in the v26.06.111 release.

Book — English

  • New Quick Start tutorial "Build Lumen Step by Step": from an empty folder to a running, tested wallet feature (open → deposit → read balance over HTTP → test → react to a domain event), as a dedicated front part before Part I.
  • Every chapter deepened into a gentler, step-by-step tutorial — numbered Steps, "Run it" checkpoints with expected output, and plain-language glosses on first use of jargon — while preserving all prose, Spring-parity callouts, recaps, exercises, and verified listings.
  • Built with an extract → author → adversarial critic → fix workflow; the critic caught 10 HIGH + 8 MEDIUM issues (fabricated APIs, 2 markdown breaks) which were fixed and re-verified against src/pyfly. verify_code: 0 failing listings across 29 files; build green; book tests pass.

Book — Spanish (new)

  • Full Spanish edition under book/manuscript-es/ (manifest book.es.yaml), built to pyfly-by-example-es.{epub,pdf}. Translated with a shared terminology glossary (es-ES, informal ); code, ::: directives, {.recap}/{.exercises} classes, callout keywords, and image paths preserved byte-for-byte. Structural parity vs the English manuscript verified (0 mismatches); ES verify_code clean; ES build green.
  • The cover title stays "PyFly by Example" (per request); chapter/part titles and all prose are Spanish.

Dedication (EN + ES)

To Jacinto Arias and the Taidy team — "Because of you there is, at last, one way to do things. One. Single. Way. (We give it a week.)" / "Gracias a vosotros, ahora por fin sí se harán las cosas de una única forma. Una. Sola. Forma. (Le damos una semana.)"

Build system

  • book/build/build.py parameterized for multiple languages: --config, per-manifest manuscript_dir / output_basename / localized labels. EN unchanged in behavior.

Framework fix

  • pyfly new no longer scaffolds the removed pyfly.web.port key — the project template now emits pyfly.server.port under server: (Spring server.port parity). The legacy key was removed in v26.06.102 and left a dead key in scaffolded apps. No test pinned the template.

Release (v26.06.111)

  • Version bumped (__init__.py + pyproject.toml) + CHANGELOG entry.
  • release.yml now also attaches the four book artifacts (EN+ES EPUB/PDF) to the GitHub release.
  • .gitignore allowlists the ES artifacts under book/dist/.

Notes

The four EPUB/PDF artifacts are committed to book/dist/. Book version strings remain "v26.6.110" intentionally — that is the framework version the listings were verified against, and "new in v26.6.110" statements are historically accurate (111 adds only the book + the scaffold fix, no API change affecting listings).

After merge, tagging v26.06.111 triggers the release.

…e v26.06.111

PyFly by Example is now bilingual and more beginner-friendly, and ships in the
v26.06.111 release.

Book:
- New Quick Start tutorial 'Build Lumen Step by Step' (empty folder -> running,
  tested wallet feature) as a dedicated front part.
- Every chapter deepened into a gentler, step-by-step tutorial (numbered Steps,
  'Run it' checkpoints with expected output, jargon glosses), verified against
  PyFly v26.6.110 and the samples/lumen source; all code listings parse.
- Dedication added (EN + ES) to Jacinto Arias and the Taidy team.
- Full Spanish edition under book/manuscript-es (book.es.yaml), built to
  pyfly-by-example-es.{epub,pdf}; code/directives/classes/paths preserved
  byte-for-byte, structural parity verified vs the English manuscript.
- book/build/build.py parameterized for multiple languages (--config,
  per-manifest manuscript_dir / output_basename / localized labels).
- Both EN + ES EPUB/PDF committed to book/dist (.gitignore allowlists the ES
  artifacts) and attached to the GitHub release (release.yml).

Framework fix:
- pyfly new no longer scaffolds the removed pyfly.web.port key; the template
  now emits pyfly.server.port under server: (Spring server.port parity).

Release: bump to v26.06.111 (__init__ + pyproject) + CHANGELOG.
@ancongui ancongui merged commit ef200b3 into main Jun 16, 2026
6 checks passed
@ancongui ancongui deleted the book/es-edition-tutorial-v111 branch June 16, 2026 19:41
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