Textelemente verwenden

Textelemente sind Websiteordner-Elemente, die ein benutzerdefiniertes Stück Text darstellen und die in einer Seite eines Websiteordners definiert und in einer anderen Seite verwendet werden können. Auf diese Weise können Sie z.B. den Seitentitel in jeder Inhaltsseite definieren, der dann in der Layoutseite verwendet wird, um den Seitentitel oben auf der Seite anzuzeigen.

Textelemente haben einen Namen und einen Wert. Sie definieren ein Textelement wie folgt:

[element set name="Name des Textelements"]Wert Textelement[/element]

Die Definition kann irgendwo im Quelltext einer Seite erfolgen. Wenn das Textelement einmal definiert ist, können Sie es verwenden, indem Sie

[element get name="Name des Textelements"]

in den Quelltext einer Seite einfügen. In der Webansicht dieser Seite wird das Textelement ausgewertet und durch seinen Wert ersetzt.

Textelemente, die in der Layoutseite definiert werden, können in jeder Inhaltsseite des Websiteordners verwendet werden, z.B. als Kürzel für eine oft benutzte Textpassage, die möglicherweise noch aufwendig formatiert ist. Textelemente, die in einer Inhaltsseite definiert sind, können nur in dieser selben Inhaltsseite und der Layoutseite verwendet werden. Wenn Sie Textelemente mit demselben Namen sowohl in einer Inhaltsseite als auch in der Layoutseite definieren, dann hat die Definition in der Inhaltsseite Vorrang vor der Definition in der Layoutseite. So können Sie also Standard-Textelemente in der Layoutseite definieren, die Sie in den Inhaltsseiten überschreiben können oder auch nicht. Sehen Sie sich die Quelltexte der Demonstrationsseiten für Start- und Layoutseite an, um mehr über die Verwendung von Textelementen zu erfahren.

Es gibt auch einige vordefinierte Textelemente, die Sie benutzen können:

title: der BSCW-Name des aktuellen Objekts;

description: die Beschreibung des aktuellen Objekts aus BSCW;

author: der Name des Erzeugers des aktuellen Objekts;

meta:bscw:keywords, meta:bscw:category: Die Tags und die Kategorie, die dem aktuellen Objekt zugewiesen wurden; auch andere Metadaten sind auf diesem Wege verfügbar, indem die internen Bezeichner der Metadatenattribute an meta: angehängt werden. Die Bezeichner, die in einem Metadatenprofil verwendet werden, erhalten Sie, indem

      Sie Aktion  Spezifikation  im Aktionsmenü des Metadatenprofils aufrufen (vgl. auch 3.9.1 Metadatenprofile).

So fügt etwa

[element get name="title"]

den Namen der aktuellen Seite ein und

[element get name="meta:bscw:description"]

die Beschreibung der aktuellen Seite. Darüber hinaus können Sie mit

[element get name="foldermeta:bscw:description"]

die Beschreibung des Ordners, in dem die Seite liegt, einfügen und mit

[element get name="topmostfoldermeta:bscw:description"]

die Beschreibung des ranghöchsten Websiteordners, in dem die Seite liegt.

Ferner ist es möglich, auf Metadaten an einer nicht näher bestimmten Stelle im Zugriffspfad der dargestellten Seite zurückzugreifen. So fügt

[element get name="searchmeta:bscw:description"]

das Metadatum bscw:description, also die Beschreibung, aus dem untersten Objekt entlang des Zugriffspfades, dem nach Konfiguration das Metadatum bscw:description zugewiesen werden könnte. Ist also dort keine Beschreibung hinterlegt, erhält man eine leere Ausgabe.