Klausur-Deckblätter als Sammel-PDF aus Vorlagen vom Typ exam-cover

Neuer Dialog "Deckblätter…" bei Klausuren, Punktetabelle als Drawing mit
festen Spaltenbreiten, FLOWDRAWBOX-Attribut fit=content, Stapel-Rendering
mit Seitenzahl je Datensatz, Kursbezeichnung und konfigurierbares Kürzel.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
adminandClaude Opus 5.5 committed 2026-10-07 10:39:09 +02:00
1 parent f56caced32
commit dd92128464
33 files changed
+1158 -28

No files matched your search

+42 -7
View File
@@ -7,13 +7,26 @@ using QuestPDF.Infrastructure;
namespace LehrerApp.Templating;
public sealed class QuestTemplateRenderer : ITemplateRenderer, ITemplatePreviewRenderer
public sealed class QuestTemplateRenderer : ITemplateRenderer, ITemplatePreviewRenderer, ITemplateBatchRenderer
{
static QuestTemplateRenderer() => QuestPDF.Settings.License = LicenseType.Community;
public byte[] RenderToPdf(LoadedTemplate template, ITemplateDataProvider data) =>
BuildDocument(template, ValidateData(template, data)).GeneratePdf();
public BatchRenderResult RenderBatchToPdf(LoadedTemplate template, IReadOnlyList<ITemplateDataProvider> data)
{
if (data.Count == 0) throw new ArgumentException("Mindestens ein Datensatz ist erforderlich.", nameof(data));
var documents = data.Select(x => BuildDocument(template, ValidateData(template, x))).ToList();
// Seitenzahl je Datensatz getrennt ermitteln: das zusammengeführte Dokument verrät nicht
// mehr, welcher Datensatz unerwartet auf eine Folgeseite übergelaufen ist.
var pageCounts = documents.Select(x => PdfPageCounter.Count(x.GeneratePdf())).ToList();
var pdf = documents.Count == 1
? documents[0].GeneratePdf()
: Document.Merge(documents).UseOriginalPageNumbers().GeneratePdf();
return new(pdf, pageCounts);
}
public byte[] RenderFirstPageToPng(LoadedTemplate template, ITemplateDataProvider data, int dpi = 120)
{
return RenderPagesToPng(template, data, dpi).First();
@@ -126,7 +139,8 @@ public sealed class QuestTemplateRenderer : ITemplateRenderer, ITemplatePreviewR
values, template.Manifest, box.Attributes);
else if (element is FlowDrawBoxElement drawing
&& values.GetValueOrDefault(drawing.Placeholder) is { } drawingValue)
DrawingElementRenderer.RenderFlow(content, drawingValue, drawing.Width, drawing.Height, unit);
DrawingElementRenderer.RenderFlow(content, drawingValue, drawing.Width, drawing.Height, unit,
FitsContent(drawing));
});
}
@@ -242,6 +256,11 @@ public sealed class QuestTemplateRenderer : ITemplateRenderer, ITemplatePreviewR
}
}
// fit=content (Opt-in): die FLOWDRAWBOX belegt nur die Höhe ihres tatsächlichen Inhalts statt
// immer die volle deklarierte Höhe - nachfolgende Flow-Elemente rücken direkt an.
private static bool FitsContent(FlowDrawBoxElement drawing) =>
drawing.Attributes.TryGetValue("fit", out var fit) && fit.Equals("content", StringComparison.OrdinalIgnoreCase);
private static void RenderFlowElement(IContainer container, TemplateElement element, LoadedTemplate template,
IReadOnlyDictionary<string, PlaceholderValue> values)
{
@@ -267,7 +286,7 @@ public sealed class QuestTemplateRenderer : ITemplateRenderer, ITemplatePreviewR
break;
case FlowDrawBoxElement drawing when values.GetValueOrDefault(drawing.Placeholder) is { } drawingValue:
DrawingElementRenderer.RenderFlow(container, drawingValue,
drawing.Width, drawing.Height, template.Layout.Unit);
drawing.Width, drawing.Height, template.Layout.Unit, FitsContent(drawing));
break;
case ImageElement image:
var imageContainer = container;
@@ -520,7 +539,8 @@ internal static class DrawingElementRenderer
container.Svg(BuildSvg(drawing, width, height, 0, unit));
}
public static void RenderFlow(IContainer container, PlaceholderValue value, float width, float pageHeight, string unit)
public static void RenderFlow(IContainer container, PlaceholderValue value, float width, float pageHeight, string unit,
bool fitContent = false)
{
var pages = value switch
{
@@ -529,6 +549,11 @@ internal static class DrawingElementRenderer
.Select(commands => new DrawingValue(commands, pageHeight)).ToList(),
_ => throw new InvalidDataException("FLOWDRAWBOX erwartet einen Drawing-Platzhalter."),
};
// Nur ein direkter DrawingValue kennt seine Inhaltshöhe; ein per Callback aufgezeichneter
// Inhalt füllt weiterhin jede Box vollständig.
var lastHeight = fitContent && value is DrawingValue fitted
? Math.Clamp(fitted.ContentHeight - (pages.Count - 1) * pageHeight, 0, pageHeight)
: pageHeight;
container.Column(column =>
{
// Kein manueller PageBreak() zwischen den Ausschnitten: RenderFlow sitzt in einer
@@ -538,12 +563,14 @@ internal static class DrawingElementRenderer
// z.B. begann der zweite Monat der Fehlzeitenliste auf Seite 3, obwohl auf Seite 2
// noch reichlich Platz war. QuestPDF schiebt einen Ausschnitt, der nicht mehr passt,
// ohnehin automatisch auf die nächste Seite.
foreach (var page in pages)
for (var index = 0; index < pages.Count; index++)
{
var height = index == pages.Count - 1 ? lastHeight : pageHeight;
if (height <= 0) continue;
// Koordinaten sind nach Slice()/RecordPages() bereits seitenlokal (bei 0 beginnend) -
// kein zusätzlicher viewBox-Y-Offset nötig oder sinnvoll (siehe Slice()).
column.Item().Height(UnitConverter.Points(pageHeight, unit)).Svg(
BuildSvg(page, width, pageHeight, 0, unit));
column.Item().Height(UnitConverter.Points(height, unit)).Svg(
BuildSvg(pages[index], width, height, 0, unit));
}
});
}
@@ -745,6 +772,14 @@ internal static class DrawingElementRenderer
}
}
/// <summary>Zählt die Seiten eines von QuestPDF erzeugten PDFs anhand der unkomprimierten
/// Seitenobjekte ("/Type /Page", nicht "/Type /Pages").</summary>
internal static class PdfPageCounter
{
public static int Count(byte[] pdf) => System.Text.RegularExpressions.Regex
.Matches(Encoding.Latin1.GetString(pdf), @"/Type\s*/Page(?![A-Za-z])").Count;
}
internal static class ChartElementRenderer
{
public static void Render(IContainer container, ChartValue value, string chartType,