PEIQ Knowledge Base

Platzhalter

poweruser

Platzhalter ermöglichen es, eine Eigenschaft dynamisch im gewünschten Format auszugeben. Ein typischer Anwendungszweck ist es, den Erscheinungstag oder die Seitennummer einer Seite auf selbiger darzustellen.

Funktionalitäten von Platzhaltern

  • Aufrufen von Platzhaltern im Layouttext-Bereich

  • Erweitern von Platzhaltern um Formate

  • Formatieren von Platzhaltern

Inhaltsverzeichnis


Beispiele für Platzhalter

In PRINT NGEN ist eine Seite mit Platzhaltern für verschiedene Anwendungen zum Nachschlagen angelegt. Diese Seite ist “Platzhalter” benannt und ist über den Seitennamen auffindbar.

Einstellung für die Globale Suche (nach Seiten) für die Seite beispielhafter Platzhalter in PRINT NGEN

Wird nach diesem gesucht, wird die Seite, welche Beispiele für Platzhalter auflistet, ausgegeben.

Seite beispielhafter Platzhalter in PRINT NGEN

Die Seite ist thematisch sortiert und listet für verschiedene Anwendungsfälle den jeweiligen Platzhalter mit Beschreibung sowie der Ausgabe bei Aufruf auf:

Erstellung eines Seitenkopfes mit Platzhaltern

Vorbereitungen für das Einfügen eines Platzhalters

Nachfolgend wird die Layout-Werkzeugleiste (zu öffnen über Fenster > Werkzeugleisten > Layout oder über Toolbars > Layout) benötigt. Auf einer beliebigen Seite wird ein Layouttext aufgezogen.
Dies geschieht über die Auswahl des Icons Rechteck zeichnen sowie im Anschluss Layouttext-Bereich zeichnen. Im Bereich der Spalten auf der Seite kann nun mit gedrückter linker Maustaste ein rechteckiger Bereich aufgezogen werden.

In der Eigenschaftsliste können in der Gruppe “Typographie” die nötigen Voreinstellungen bezüglich Schriftart, Schriftstil, Schriftgröße und Vorschub vorgenommen werden.
Auch die Ermittlung des Attributnamens (der Namen einer Eigenschaft wie er in der Datenbank hinterlegt ist) muss bereits erfolgt sein. 

Der oben beschriebene Vorgang wird im folgenden Video gezeigt:

https://www.youtube.com/watch?v=M43ZPlGOXGw

 

Beispiel: Datums-Platzhalter
Als Beispiel für einen Datums-Platzhalter wird nachfolgend der Erscheinungstag herangezogen. Das Ziel ist es, den Erscheinungstag in einer Form mit Wochentag und Monatsnamen im Titelkopf einer Seite auszugeben.

Hierfür wird der Attributname der Eigenschaft “ErscheintAm” ermittelt.

 

Im folgenden Video wird gezeigt, wie ein Datums-Platzhalter eingefügt wird, der den Erscheinungstag der Seite ausgibt:

 

Im folgenden Video wird erklärt, wie Monats- und Wochentags-Namen geändert werden können:

Einfügen eines Platzhalters

Damit ein Platzhalter eingefügt werden kann, müssen die folgenden Bedingungen erfüllt sein:

  • Der aufgezogene Layouttext-Bereich ist ausgewählt (grüne Eckpunkte)

  • Die Eigenschaftsliste stellt die Gruppe “Typographie” dar

Anschließend wird der Menüpunkt “Platzhalter” über Text > Makro / Tag / Variable > Platzhalter aufgerufen.

Daraufhin ist ein Cursor im Layouttext-Bereich positioniert und die in der Eigenschaftsliste dargestellte Gruppe ist nun “Platzhalter”.

 

Der Aufbau eines Platzhalters lautet: $(Eigenschaft)

Der Platzhalter enthält stets die Eigenschaft, also den Attributnamen, in runden Klammern gesetzt und mit einem vorangestellten Dollar-Zeichen. Zu beachten ist, dass der Attributname case-sensitiv ist. In dieser Form wird der Attributname in die Wert-Spalte der Eigenschaft “PHFormat” eingetragen. Bestätigt wird die Eingabe durch ENTER.

Daraufhin wird die Eingabe im Layouttext-Bereich ausgewertet. Im Beispiel des Erscheinungstages wird dessen Datum dargestellt.

Erweitern eines Platzhalters um ein Format

Die Erweiterung eines Platzhalters um ein Format ist mit einer festgelegten Syntax möglich.

Ein Platzhalter kann wie folgt erweitert werden: $(Eigenschaft.Format)

Für die Bearbeitung des Platzhalters muss dieser markiert werden. In der Eigenschaftsliste wird die Gruppe “Platzhalter” dargestellt. In der Wertspalte der Eigenschaft “PHFormat” wird der Attributname um das Format in der beschriebenen Syntax ergänzt.
Nach Bestätigung der Eingabe mit ENTER wird diese im Layouttext-Bereich ausgewertet.

Beispiele

Der erweiterte Platzhalter

Der ausgewertete Platzhalter im Layouttext-Bereich

Der erweiterte Platzhalter

Der ausgewertete Platzhalter im Layouttext-Bereich

 

Hinterlegen einer Werteliste als Platzhalter

Es ist möglich, anstelle einer Eigenschaft auch eine Werteliste in einem Platzhalter zu hinterlegen. Dies ist beispielsweise nötig, wenn ein Ressort (z. B. Politik) im Seitenkopf ausgegeben werden soll, in den Eigenschaften jedoch als Abkürzung (z. B. pl) hinterlegt ist. Die Zuordnungen der Abkürzungen zum gewünschten Klarnamen kann in einer Werteliste erfolgen, welche beim Aufruf des Platzhalters hinterlegt wird.

Der Aufruf einer Werteliste im Platzhalter ist mit einer festgelegten Syntax möglich.

Beispiel

 

Am Beispiel ist der Aufruf im Platzhalter mit der zugehörigen Bibliothek und dem Element zu sehen. Der Name der aufgerufenen Bibliothek lautet “doku_Wertelisten”. Unter dieser - aktuell gültigen - Bibliothek ist das Element “RessLang” eingehängt. Bei diesem handelt es sich um eine Werteliste. Diese wird ebenfalls am Platzhalter als Elementname aufgerufen.

Formatieren eines Platzhalters

Das Spalten einer Zeile

Werden mehrere Platzhalter in einer Zeile verwendet, muss diese gespalten werden, um die Lesbarkeit zu erhalten.

Beispiel: Erscheinungstag und Seitennummer (Attributname des Beispiels: SeitNr)

Hierfür wird der Cursor zwischen den beiden Platzhaltern positioniert.

Im Anschluss daran wird der Menüpunkt “Zeile spalten <ZS>” über Text > Layout > Zeile spalten ausgewählt.

Daraufhin wird der Cursor hinter dem zweiten Platzhalter im Layouttext-Bereich positioniert und über ENTER ein Absatz eingefügt (alternativ ist auch “Zeile austreiben” möglich). Dadurch ist der zweite Platzhalter in der Zeile nun auf der rechten Seite positioniert.

 

 Im folgenden Beispiel wird eine Seitennummer eingefügt und auf der rechten Seite positioniert:

 

Platzhalter zentrieren

Im folgenden Video wird gezeigt, wie ein Ressort eingefügt, per Zentrierbefehl zentriert sowie anschließend formatiert werden kann. Mithilfe eines Zusatz-Vorschubs wird das Ressort zudem auf die gleiche Höhe gebracht wie die anderen Teile des Seitentitels.

Einrichtung fester Abstände

Es ist auch möglich, innerhalb der Zeile feste Abstände einzustellen.
Im Beispiel wird links des rechten Platzhalters (Seitennummer) der Zeitungstitel direkt eingetippt.

Der Cursor befindet sich an der Position, an welcher der feste Abstand, der Festwert, eingefügt werden soll. Im Anschluss daran wird der Menüpunkt “Festwert” über Text > Festwerte > Festwert ausgewählt.

Daraufhin wird in der Eigenschaftsliste die Gruppe “Festwert” ausgegeben. In der Werte-Spalte der Eigenschaft “Festwert” kann nun der gewünschte Abstand eingegeben und mit ENTER bestätigt werden.

 

Im folgenden Video wird gezeigt, wie ein fester Abstand zwischen einem Platzhalter und dem Zeitungstitel eingerichtet werden kann:

 

Textformatierung eines Platzhalters

Soll der Text des Platzhalters formatiert werden, beispielsweise in einer anderen Schriftfarbe oder Schriftgröße, so ist dies über ein Unimakro möglich.

Der gewünschte Platzhalter wird im Layouttext-Bereich markiert. Im Anschluss daran wird der Menüpunkt “Unimakro (mit Ende)” über Text > Makro / Tag / Variable>Unimakro (mit Ende) ausgewählt.

Daraufhin öffnet sich die Eigenschaftsliste mit der Gruppe “Typographie”. Die Werte der Eigenschaften können nun bearbeitet werden.

 

Im folgenden Video wird gezeigt, wie eine Seitennummer mithilfe eines Unimakros formatiert werden kann:

Verwandte Seiten

 

Nur für PEIQ-Mitarbeiter:

https://peiq.atlassian.net/wiki/spaces/CORE/pages/735740297