book: Spanish edition + step-by-step Quick Start + dedication (release v26.06.111)#143
Merged
Merged
Conversation
…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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Makes PyFly by Example bilingual and more beginner-friendly, and ships it in the v26.06.111 release.
Book — English
src/pyfly.verify_code: 0 failing listings across 29 files; build green; book tests pass.Book — Spanish (new)
book/manuscript-es/(manifestbook.es.yaml), built topyfly-by-example-es.{epub,pdf}. Translated with a shared terminology glossary (es-ES, informal tú); code,:::directives,{.recap}/{.exercises}classes, callout keywords, and image paths preserved byte-for-byte. Structural parity vs the English manuscript verified (0 mismatches); ESverify_codeclean; ES build green.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.pyparameterized for multiple languages:--config, per-manifestmanuscript_dir/output_basename/ localized labels. EN unchanged in behavior.Framework fix
pyfly newno longer scaffolds the removedpyfly.web.portkey — the project template now emitspyfly.server.portunderserver:(Springserver.portparity). 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)
__init__.py+pyproject.toml) + CHANGELOG entry.release.ymlnow also attaches the four book artifacts (EN+ES EPUB/PDF) to the GitHub release..gitignoreallowlists the ES artifacts underbook/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.