Skip to content

Commit cce59ff

Browse files
authored
fix(examples): the engine deck stops calling a shipped backend planned (#510)
Its first page listed PPTX as "Planned" beside a version badge reading v2.1.0 — the release that shipped it, and the release whose own copy of this deck is published as a .pptx. Three more sentences dated from when PDF was the only output: the library described as generating "structured business PDF documents", the pipeline ending at "PDFBox writes the bytes", and page two headed "From one Java file to a designed PDF". PPTX is now the live @beta backend it is, ordered ahead of the semantic-only DOCX export, and the prose covers both formats. The layout baseline moves with it. The only structural change is the backend cards reordering — Backend_PPTX shifts one position, the node count is unchanged — plus the tagline growing from one line to two and the sections below shifting by that height.
1 parent 5fe9a62 commit cce59ff

5 files changed

Lines changed: 370 additions & 360 deletions

File tree

CHANGELOG.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -241,6 +241,14 @@ follow semantic versioning; release dates are ISO 8601.
241241

242242
### Documentation
243243

244+
- **The engine deck stopped calling a shipped backend planned.** Its first page listed
245+
PPTX as *Planned* beside a version badge reading v2.1.0 — the release that shipped it,
246+
and the release whose own copy of that deck is published as a `.pptx`. The page also
247+
described the library as generating "structured business PDF documents" and ended its
248+
pipeline at "PDFBox writes the bytes", and page two was headed "From one Java file to
249+
a designed PDF"; all three were written when PDF was the only output. PPTX is now the
250+
live `@Beta` backend it is, ordered ahead of the semantic-only DOCX export, and the
251+
prose covers both formats.
244252
- **The Maven Central banner became a deck.** It was one 16:9 slide: wordmark,
245253
coordinate, capability tags and a code → layout → document diagram. It now carries
246254
three more pages in the same amber-on-navy language — the authoring pipeline and what
143 Bytes
Binary file not shown.

examples/src/main/java/com/demcha/examples/flagships/EngineDeckData.java

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -113,8 +113,8 @@ record Backend(String icon, String title, String sub, boolean live) {
113113
static List<Backend> backends() {
114114
return List.of(
115115
new Backend("pdf-file", "PDFBox 3.0", "Production backend", true),
116-
new Backend("docx", "DOCX export", "Semantic export", false),
117-
new Backend("ppt-file", "PPTX", "Planned", false));
116+
new Backend("ppt-file", "PPTX", "Editable deck · Beta", true),
117+
new Backend("docx", "DOCX export", "Semantic export", false));
118118
}
119119

120120
// ── "How it works" content (page 2) ───────────────────────────────────────
@@ -128,7 +128,7 @@ static List<PipelineStep> pipeline() {
128128
new PipelineStep("1", "dsl", "AUTHOR", "Fluent DSL describes intent."),
129129
new PipelineStep("2", "layout", "MEASURE", "Two-pass geometry, every node."),
130130
new PipelineStep("3", "page-break", "PAGINATE", "Split the flow across pages."),
131-
new PipelineStep("4", "pdf-file", "RENDER", "PDFBox writes the bytes."));
131+
new PipelineStep("4", "pdf-file", "RENDER", "A backend writes the bytes."));
132132
}
133133

134134
/** A "why it's solid" proof card: bold title + a sentence. */

examples/src/main/java/com/demcha/examples/flagships/EngineDeckExample.java

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -260,7 +260,7 @@ static void compose(DocumentSession document) {
260260
// ═════════ PAGE 2 — how it works ═════════
261261
.addPageBreak(b -> b.name("ToHowItWorks"))
262262
.addSection("HowKicker", s -> kicker(s, "HOW IT WORKS",
263-
"From one Java file to a designed PDF"))
263+
"From one Java file to a designed document"))
264264
.addSection("HowBody", s -> s
265265
.padding(DocumentInsets.zero())
266266
.addParagraph(p -> p
@@ -273,7 +273,8 @@ static void compose(DocumentSession document) {
273273
.accent("paginates", VIOLET_DEEP)
274274
.plain(" the flow row-by-row, and ")
275275
.accent("renders", VIOLET_DEEP)
276-
.plain(" through an isolated PDFBox backend. No manual coordinates, no XML templates."))
276+
.plain(" the resolved layout through an isolated backend — PDFBox for PDF, "
277+
+ "Apache POI for the deck. No manual coordinates, no XML templates."))
277278
.lineSpacing(1.55)))
278279
.addRow("Pipeline", row -> {
279280
row.spacing(8).weights(1, 0.14, 1, 0.14, 1, 0.14, 1);
@@ -375,7 +376,8 @@ private static void banner(SectionBuilder s) {
375376
.add(brandLine())
376377
.addParagraph(p -> p
377378
.text("Open-source Java library for generating structured business "
378-
+ "PDF documents with a declarative DSL.")
379+
+ "documents with a declarative DSL — print-ready PDF and an "
380+
+ "editable PowerPoint deck from one composition.")
379381
.textStyle(tagline()).lineSpacing(1.3).margin(DocumentInsets.top(4)))
380382
.addShape(sh -> sh.size(749, 1.2).fillColor(RULE_DARK).margin(DocumentInsets.top(8)))
381383
.addRow("Flow", row -> {

0 commit comments

Comments
 (0)