This commit is contained in:
@@ -1,5 +1,43 @@
|
||||
# LehrerApp Templating
|
||||
|
||||
## Konstante Platzhalter und Hervorhebung
|
||||
|
||||
Ein Platzhalter kann seinen Wert vollständig im Vorlagenpaket tragen. `IsConstant=true` bewirkt,
|
||||
dass `ConstantValue` beim Rendern immer verwendet wird; ein gleichnamiger Wert aus dem externen
|
||||
`ITemplateDataProvider` wird bewusst ignoriert. Damit eignen sich Konstanten besonders für lange
|
||||
Textbausteine in `TEXTBOX`, rechtliche Hinweise oder wiederkehrende Fußtexte.
|
||||
|
||||
```csharp
|
||||
new PlaceholderDefinition(
|
||||
"Datenschutzhinweis",
|
||||
PlaceholderType.Multiline,
|
||||
IsConstant: true,
|
||||
ConstantValue: "Dieser längere Text wird im Paket gespeichert.",
|
||||
Bold: true,
|
||||
Italic: false,
|
||||
Underline: false);
|
||||
```
|
||||
|
||||
Konstante Werte werden für `Text`, `Multiline`, `Date` und `Number` unterstützt. Die Eigenschaften
|
||||
`Bold`, `Italic` und `Underline` wirken, wenn der Platzhalter direkt von einem `TEXT`- oder
|
||||
`TEXTBOX`-Element referenziert wird. In der Layout-DSL kann Unterstreichung außerdem direkt mit
|
||||
`underline=true` gesetzt werden.
|
||||
|
||||
Konstante Text- und Multiline-Werte unterstützen zusätzlich abschnittsweise Hervorhebung und
|
||||
eingebettete externe Platzhalter:
|
||||
|
||||
```text
|
||||
Sehr geehrte Familie [b]${Student.LastName}[/b],
|
||||
|
||||
bitte geben Sie die [u]unterschriebene Erklärung[/u] bis [i]Freitag[/i] zurück.
|
||||
```
|
||||
|
||||
Unterstützt werden `[b]…[/b]`, `[i]…[/i]` und `[u]…[/u]`, auch verschachtelt. Die Klammerform
|
||||
`${Name}` ist in Fließtext vorzuziehen; `${Datum|dd.MM.yyyy}` erlaubt zusätzlich ein Format.
|
||||
Eingebettete Platzhalter müssen im Manifest als externe Platzhalter deklariert sein. Ihre gelieferten
|
||||
Werte werden immer als reiner Text behandelt und können deshalb kein Markup einschleusen. Mit
|
||||
`\[`, `\$` und `\\` lassen sich die Steuerzeichen wörtlich ausgeben.
|
||||
|
||||
## Freie Paketmetadaten
|
||||
|
||||
Jedes neu gespeicherte `.lavorlage`-Paket enthält eine lesbare `metadata.txt`. Pro Zeile steht ein
|
||||
|
||||
Reference in New Issue
Block a user