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:
1 parent
f56caced32
commit
dd92128464
33 files changed
+1158
-28
No files matched your search
@@ -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]),
|
||||
|
||||
@@ -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);
|
||||
|
||||
@@ -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,
|
||||
|
||||
@@ -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";
|
||||
|
||||
@@ -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)
|
||||
{
|
||||
|
||||
Reference in new issue
Block a user