Felder

Umbrüche und Kommentare

Erfahren Sie, wie Sie in Ihren Vorlagen gezielt Seiten-, Spalten- und andere Umbrüche steuern können

In Output.Rocks Vorlagen können Sie verschiedene Arten von Umbrüchen einfügen, darunter Seitenumbrüche, Spaltenumbrüche und Abschnittsumbrüche. Diese Umbrüche werden beim Rendern in Ihre Dokumente übernommen, es sei denn, sie befinden sich in bedingten Abschnitten, die nicht angezeigt werden.

Umbruch-Felder

Um Vorlagen noch flexibler zu gestalten, bietet Output.Rocks spezielle Felder, die Umbrüche erzeugen, ohne dass Sie tatsächlich einen physischen Umbruch in der Vorlage einfügen müssen:

Seitenumbrüche

Die einfachste Möglichkeit, einen Umbruch zu erzeugen, ist die Verwendung von <<pageBreak>>. Dieses Feld fügt einen Umbruch an der aktuellen Position im Dokument ein.

Vor dem Umbruch
<<pageBreak>>
Nach dem Umbruch

Spaltenumbrüche

Ein Spaltenumbruch sorgt dafür, dass der Text nach dem Umbruch sofort in der nächsten Spalte weiterläuft, unabhängig davon, wie viel Platz in der aktuellen Spalte noch vorhanden ist.

Voraussetzung: Ihr Dokument wurde mit einem Spaltenlayout erstellt (z.B. zwei Spalten).

Dieser Umbruch bezieht sich nicht auf Tabellen-Spalten.

Vorlage (.docx mehrspaltig):

<<artikel.einleitung>>

<<columnBreak>>

<<artikel.haupttext>>

Spaltenumbruch-Verhalten:

  • Text springt sofort zur nächsten Spalte, unabhängig vom verfügbaren Platz
  • Restlicher Platz in der aktuellen Spalte bleibt leer
  • Funktioniert nur in Vorlagen mit mehrspaltigem Layout
  • Ideal für strukturierte Artikel oder Newsletter

Bedingte Umbrüche in Wiederholungen

Besonders nützlich sind bedingte Umbrüche innerhalb von wiederholenden Abschnitten:

<<pageBreakNotLast>>

Fügt einen Seitenumbruch ein, aber nicht beim letzten Element einer Wiederholung. Dies ist ideal, um Elemente auf separate Seiten zu verteilen, ohne dass nach dem letzten Element ein leerer Seitenumbruch entsteht.

Kommentare in Templates

Tornado unterstützt Kommentare in Templates, die beim Rendern komplett entfernt werden. Kommentare sind nützlich für Notizen und temporäres Deaktivieren von Template-Bereichen.

<<## Dies ist ein Kommentar und wird nicht angezeigt ##>>

Verwendung: Permanente Notizen für Template-Autoren

Wichtiges Verhalten: Wenn ein Kommentar allein auf einer Zeile steht, wird die gesamte Zeile entfernt.

❌ Problem:

<<## Kommentar ##>><<fieldName>>

Das fieldName wird mit entfernt!

✅ Lösung:

<<## Kommentar ##>>
<<fieldName>>

Oder:

<<fieldName>><<## Kommentar ##>>

STRG/CMD + Eingabe Umbrüche:
Wenn Sie in Ihrem Textverarbeitungsprogramm einen Zeilenumbruch mit STRG + Eingabe (Windows) oder CMD + Eingabe (Mac) erstellen, wird dieser als "weicher Umbruch" behandelt (Zeilenumbruch statt neuer Absatz).


Im Vorlagen-Rendering wirkt ein solcher Umbruch rein stilistisch und nicht funktional - die umgebrochene Zeile wird mit auskommentiert!

❌ Problem mit weichen Umbrüchen:

<<## Kommentar ##>>  ← STRG/CMD + Eingabe Umbruch hier
<<fieldName>> 
<<anderesField>>

Die Zeile mit fieldName wird mit entfernt!

✅ Lösung:

<<## Kommentar ##>>
<<fieldName>>
<<anderesField>>

Verwenden Sie normale Zeilenumbrüche zum nächsten Absatz (Eingabe-Taste) statt weicher Umbrüche.

Praktische Anwendungsbeispiele

Personenliste mit Seitenumbrüchen

Vorlage (.docx):

<<rs_mitarbeiter>>

Name: <<name>>
Position: <<position>>
Abteilung: <<abteilung>>
E-Mail: <<email>>
Telefon: <<telefon>>

<<pageBreakNotLast>>
<<es_>>

Mehrspaltiges Layout mit Spaltenumbrüchen

Vorlage (.docx mehrspaltig):

<<rs_nachrichten>>
<<titel>>

<<kurzbeschreibung>>

<<columnBreakNotLast>>
<<es_>>

  • Umbruch-Felder müssen in einer eigenen Zeile stehen, um korrekt zu funktionieren
  • pageBreakNotLast und columnBreakNotLast können nur innerhalb von wiederholenden Abschnitten verwendet werden
  • Bei mehrseitigen Dokumenten kann die strategische Platzierung von Umbrüchen die Lesbarkeit erheblich verbessern

Für komplexere Layouts können Sie auch reguläre Seitenumbrüche oder Spaltenumbrüche in Ihrem Textverarbeitungsprogramm einfügen. Diese werden beim Rendern beibehalten, sofern sie nicht durch bedingte Abschnitte ausgeschlossen werden.

Verbindung mit anderen Vorlagen-Funktionen

Seitenumbrüche können besonders effektiv sein, wenn sie mit anderen Vorlagen-Funktionen kombiniert werden:

Mit bedingten Abschnitten

<<cs_{dokument.sonderformat=='mehrseitig'}>>
<<pageBreak>>
<<es_>>

In berechneten Schritten

<<rs_produkte>>
Produkt: <<name>>
Preis: <<preis>>

<<cs_{$itemnum % 5 == 0}>><<pageBreakNotLast>><<es_>>
<<es_>>

Dieses Beispiel fügt nach jedem fünften Produkt einen Seitenumbruch ein, außer wenn es sich um das letzte Produkt handelt.

Achten Sie darauf, dass Ihre Dokumente nicht zu viele aufeinanderfolgende Umbrüche enthalten, da dies zu unerwünschten leeren Seiten führen kann. Testen Sie Ihre Vorlagen immer im Vorlageneditor.