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

+3
View File
@@ -159,6 +159,9 @@ public sealed class LayoutParser
var nestedFlowDrawing = currentFlowName is not null;
Require(tokens, nestedFlowDrawing ? 2 : 6);
var flowDrawingAttributes = Attributes(tokens, nestedFlowDrawing ? 2 : 6);
if (flowDrawingAttributes.TryGetValue("fit", out var fit)
&& !fit.Equals("content", StringComparison.OrdinalIgnoreCase))
throw new FormatException("FLOWDRAWBOX fit muss content sein.");
parsedElement = new FlowDrawBoxElement(lineNumber,
nestedFlowDrawing ? 0 : Number(tokens[1]), nestedFlowDrawing ? 0 : Number(tokens[2]),
nestedFlowDrawing ? RequiredPositiveNumber(flowDrawingAttributes, "w") : Number(tokens[3]),
+9
View File
@@ -186,6 +186,15 @@ public interface ITemplateRenderer
byte[] RenderToPdf(LoadedTemplate template, ITemplateDataProvider data);
}
/// <summary>Ergebnis einer Stapelerzeugung: ein Sammel-PDF und die Seitenzahl je Datensatz.</summary>
public sealed record BatchRenderResult(byte[] Pdf, IReadOnlyList<int> PageCounts);
public interface ITemplateBatchRenderer
{
/// <summary>Rendert dieselbe Vorlage je Datensatz und fügt alles zu einem PDF zusammen.</summary>
BatchRenderResult RenderBatchToPdf(LoadedTemplate template, IReadOnlyList<ITemplateDataProvider> data);
}
public interface ITemplatePreviewRenderer
{
byte[] RenderFirstPageToPng(LoadedTemplate template, ITemplateDataProvider data, int dpi = 120);
+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,
+44
View File
@@ -51,6 +51,21 @@ gleich hohe Seitenfenster und setzt ihn auf Folgeseiten fort. Wie bei `FLOWBOX`
höchstens ein fließendes Element enthalten; bei einem eigenen Folgeseitenlayout müssen Typ,
Position und Größe übereinstimmen.
Standardmäßig belegt jeder Ausschnitt einer `FLOWDRAWBOX` die volle deklarierte Höhe, auch wenn
der Inhalt kürzer ist. Mit dem Opt-in-Attribut `fit=content` belegt der letzte Ausschnitt nur die
tatsächliche Inhaltshöhe (`ContentHeight`), sodass nachfolgende Elemente eines `content-flow`
direkt anschließen und bei wachsendem Inhalt nach unten wandern:
```text
#pragma content-flow body
FLOWDRAWBOX $Exam.PointsTable w=165 h=150 fit=content
TEXT "Gesamtpunkte: $Result.Points von $Exam.MaxPoints Punkte" gap=14
#pragma end-content-flow
```
`fit=content` wirkt nur bei einem direkt gelieferten `DrawingValue`; ein per Callback
aufgezeichneter Inhalt (`PagedDrawingValue`) füllt weiterhin jede Box vollständig.
Ein Vorlagenpaket kann keinen Callback und keinen Typ aus einer fremden Assembly einschleusen.
Farben, Zahlen, Bildformate, Bildgröße und Gesamtzahl der portablen Befehle werden validiert.
Damit bleibt die paketfähige Schnittstelle deterministisch. Ein `PagedDrawingValue` ist dagegen
@@ -195,6 +210,35 @@ eindeutig und Werte bleiben einzeilig. Der Loader stellt sie der Anwendung direk
weiterhin mit einer leeren Metadatensammlung geladen. Die empfohlenen Standardschlüssel stehen
zusätzlich als `TemplateMetadataKeys.Language` und `TemplateMetadataKeys.ReportType` bereit.
## Klausur-Deckblätter (`report-type=exam-cover`)
Eine Vorlage mit dem Metadatum `report-type=exam-cover` (`TemplateReportTypes.ExamCover`) erscheint
in der Hauptapp ausschließlich im Dialog „Deckblätter…" einer Klausur und nicht mehr in der Auswahl
für Elternbriefe und Arbeitsblätter. Importiert wird sie wie jede andere `.lavorlage` in den
Einstellungen. Je ausgewähltem Schüler entsteht eine Seite in einem Sammel-PDF
(`ITemplateBatchRenderer.RenderBatchToPdf`). Zusätzlich zu den Elternbrief-Platzhaltern
(`Student.Name`, `Student.FirstName`, `Student.LastName`, `Group.Name`, `SchoolYear`, `Datum`)
stehen bereit:
| Platzhalter | Typ | Inhalt |
| --- | --- | --- |
| `Exam.Title`, `Exam.Number`, `Exam.Kind`, `Exam.Niveau` | Text | Titel, Nummer, Art, Niveau der Arbeit |
| `Exam.Date` | Date | Datum der Arbeit |
| `Exam.ApprovalDate`, `Exam.AnnouncedDate`, `Exam.ReturnDate` | Text | Genehmigung, Ankündigung, Rückgabe (`TT.MM.JJJJ`, leer wenn nicht gesetzt) |
| `Exam.Course` | Text | `E-Kurs` / `G-Kurs` (Niveau der Arbeit, sonst des Schülers in der Lerngruppe); leer im Klassenverband |
| `Teacher.Abbreviation` | Text | Kürzel der Lehrkraft aus den Einstellungen, im Deckblatt-Dialog je Druck änderbar |
| `Exam.Variant` | Text | geschriebene Fassung (A/B), leer ohne Fassungen |
| `Exam.MaxPoints` | Text | erreichbare Punktzahl der geschriebenen Fassung, ohne Bonusaufgaben |
| `Result.Points`, `Result.Grade` | Text | erreichte Punkte und Note; als Blanko eine Linie aus Unterstrichen |
| `Result.Percent` | Text | erreichter Anteil, als Blanko leer |
| `Subject.Name`, `Group.GradeLevel` | Text | Fach und Jahrgangsstufe der Lerngruppe |
| `Exam.PointsTable` | Drawing | Punktetabelle (Aufgabe / Max. Punktzahl / Punktzahl) |
Die Punktetabelle hat feste Spaltenbreiten (38 mm Beschriftung, 20,5 mm je Aufgabe). Passen nicht
alle Aufgaben in die Breite der Box, folgt darunter ein weiterer Block; verkleinert wird nichts.
Sie gehört deshalb als `FLOWDRAWBOX … fit=content` in einen `content-flow`. Bonusaufgaben stehen
ohne Nummer und mit `+` vor der Punktzahl in der Tabelle.
## Bildskalierung
`IMG` unterstützt neben dem festen Begrenzungsrahmen eine optionale prozentuale Skalierung:
@@ -6,6 +6,14 @@ public static class TemplateMetadataKeys
public const string ReportType = "report-type";
}
/// <summary>Bekannte Werte für <see cref="TemplateMetadataKeys.ReportType"/>. Pakete ohne Angabe
/// (oder mit einem anderen Wert) gelten wie bisher als Brief-/Arbeitsblattvorlage.</summary>
public static class TemplateReportTypes
{
public const string Letter = "letter";
public const string ExamCover = "exam-cover";
}
public static class TemplateMetadataText
{
public const string FileName = "metadata.txt";
+10 -3
View File
@@ -63,7 +63,10 @@ public static class TemplatePackage
}
public sealed record InstalledTemplate(string Id, string Name, string Description, string PackagePath,
DateTime ImportedAtUtc);
DateTime ImportedAtUtc, string ReportType = "")
{
public bool IsExamCover => ReportType.Equals(TemplateReportTypes.ExamCover, StringComparison.OrdinalIgnoreCase);
}
public sealed class TemplateStore
{
@@ -86,7 +89,7 @@ public sealed class TemplateStore
{
var loaded = _loader.LoadFromPackage(path);
result.Add(new(loaded.Manifest.Id, loaded.Manifest.Name, loaded.Manifest.Description, path,
File.GetLastWriteTimeUtc(path)));
File.GetLastWriteTimeUtc(path), ReportTypeOf(loaded)));
}
catch (Exception ex) when (ex is InvalidDataException or TemplateValidationException) { }
}
@@ -102,9 +105,13 @@ public sealed class TemplateStore
var temporary = destination + ".tmp";
File.Copy(sourcePath, temporary, overwrite: true);
File.Move(temporary, destination, overwrite: true);
return new(loaded.Manifest.Id, loaded.Manifest.Name, loaded.Manifest.Description, destination, DateTime.UtcNow);
return new(loaded.Manifest.Id, loaded.Manifest.Name, loaded.Manifest.Description, destination, DateTime.UtcNow,
ReportTypeOf(loaded));
}
private static string ReportTypeOf(LoadedTemplate loaded) =>
loaded.Manifest.Metadata.GetValueOrDefault(TemplateMetadataKeys.ReportType, "");
public LoadedTemplate Load(InstalledTemplate template) => _loader.LoadFromPackage(template.PackagePath);
public void Delete(string id)
{