- baseportal Dokumentation

Titel:

<h2>Tag-Datenbanken</h2>

Wie definiert man nun eigene Tags? Unter anderem mit einer Datenbank. Diese ist eine ganz normale baseportal-Datenbank und enthält die <i>Namen</i> und das <i>Verhalten</i> neuer Tags. Es können mehrere verschiedene Datenbanken mit gleichnamigen Tags angelegt werden - und somit für verschiedene Zwecke unterschiedliche Ausgaben erzeugen.

Um eine Tag-Datenbank in Ihrem Bereich anzulegen, erstellen Sie einfach eine neue Datenbank und klicken Sie dann auf "Tag-Datenbank (XML)" bei den Vorlagen.

Hier ein Beispiel einer Tag-Datenbank:

<tab>
Name|Code
code|<c>s/</&lt;/g; s/>/&gt;/g; $title="Code" if $title eq "";
"<b>$title</b><div style=\"background:#f0f0f0;padding:8px\"><pre>$_</pre></div>"</c>
c|<c>s/</&lt;/g; s/>/&gt;/g;
"<span color=green>$_</span>"</c>
tab|<c>$sepcols||="|"; $seprows||="\n"; chomp;
s#$seprows?(.*?)$seprows#$x=$1; $x=~ s!$sepcols!</th><th bgcolor=e0e0e0>!g; "<tr><th bgcolor=e0e0e0>$x</th></tr><tr><td>"#e;
s#$sepcols#</td><td>#g;
s#$seprows#</td></tr><tr><td>#gs;
s#<tr><td>#<tr><td bgcolor=f0f0f0>#g;
s#<td></td>#<td>&nbsp;</td>#g;
"<ul><table border=1 cellspacing=0 cellpadding=4>$_</table></ul>";</c>
_datum|datum
</tab>

Hier werden die Tags <c>code</c>, <c>c</c>, <c>tab</c> und <c>datum</c> definiert, die für eine Dokumentation nützlich sein könnten.

Die Bedeutung der einzelnen Felder:

<tab>
Feld|Beschreibung
Name|Der Name des Tags, u.U. mit vorangestellten Spezialzeichen
Code|Code der beim Auftreten eines Tags ausgeführt wird
</tab>

Normalerweise wird der Code erst beim schliessenden Tag ausgeführt, wie z.B. beim <c><loop>..</loop></c>. Möchte man alleinstehende Tags wie z.B. <c><do action=all></c> definieren, so muss man einen Unterstrich <c>_</c> vor den Namen schreiben. Im obigen Beispiel kann man nun einfach

schreiben; ohne abschliessendes <c></datum</c> Tag. Möglich ist auch zwei Einträge zu definieren, die dann beim Anfangs- und beim Ende-Tag ausgeführt werden.

<h2>Reguläre Ausdrücke</h2>

"Reguläre Ausdrücke" (auf Englisch <i>Regular Expressions</i>, kurz <i>Regex</i>) dienen der Textanalyse und -bearbeitung und sind sehr mächtig, wenn auch auf den ersten Blick vielleicht etwas kompliziert. Mit einem regulären Ausdruck als Namen kann nach beliebigen Texten gesucht werden. Der gesamte gefundene Text steht in <c>$_</c> zur Verfügung. Werden innerhalb des regulären Ausdrucks Klammern benutzt, so stehen die Werte wie in Perl üblich in <c>$1</c>, <c>$2</c> etc. bereit.

Ein einfaches Beispiel - man möchte ein bestimmtes Wort (z.B. "Achtung") im Text hervorheben:

<tab>
Name|Code
<c>(Achtung)</c>|<c>'<span style="color:red">Achtung</span>'</c>
</tab>

Wo immer "Achtung" auf der Seite auftaucht, würde es jetzt Rot markiert werden. Um mehrere Wörter zu bestimmen, schreibt man z.B.:

Hier würden die baseportal-Befehle "get", "put", "mod" und "del" in einem Template automatisch blau markiert werden. Das macht z.B. in einer baseportal-Dokumentation Sinn. Die <c>|</c> trennen verschiedene Textalternativen.

Um genau zu sein würden auch Teile mitten in Wörtern entdeckt werden, z.B. "forGET". Um nun wirklich nur Wörter zu erkennen, müsste man schreiben:

<c>\b</c> hat eine besondere Bedeutung: Es passt auf "Wortgrenzen".

Eine sinnvolle Erweiterungen dieses Beispiels ist übrigens die automatische Verlinkung zu einer Glossar-Datenbank, in der die Begriffe im Detail erklärt werden. Der Code müsste dann so aussehen:

<h2>Entities definieren</h2>

Mit Hilfe der regulären Ausdrücke können auch die im XML-Standard definierten sog. <i>Entities</i> erzeugt werden. Sie kennen diese wahrscheinlich schon aus HTML, das sind die "Sonderzeichen", die von & und ; umschlossen sind, also z.B. &lt; oder &copy; oder die Umlaute &auml;, &uuml; etc. Hier 2 Beispiele:

<tab>
Name|Code
<c>&myname;</c>|<c>"Max Meier"</c>
<c>&jetzt;</c>|<c>datum "jetzt", "Stunde:Minute"</c>
</tab>

Der Text...

<code>
Mein Name ist &myname; und es ist jetzt genau &jetzt; Uhr.
</code>

...führt damit zu folgender Ausgabe

<code>
Mein Name ist Max Meier und es ist jetzt genau 03:59 Uhr.
</code>

<h2>Code bei allen Tags ausführen</h2>

Beim Namen gibt es den speziellen Wert <c>*</c>:

<tab>
Wert|Beschreibung
<c>*</c>|Wird bei jedem Anfangs-Tag ausgeführt
<c>/*</c>|Wird bei jedem Ende-Tag ausgeführt
</tab>

So lässt sich z.B. ein Strukturbaum der XML-Seite erstellen:

<tab>
Name|Beginn|Ende
<c>*</c>|<c>$struktur.="&nbsp;" x (@_parents*2).$_tag</c>|
</tab>

<h2>Variablen</h2>

Wird ein Tag-Code ausgeführt stehen verschiedene Variablen zur Verfügung:

<tab>
Name|Beschreibung
<c>$_</c>|Enthält im "Ende"-Code den Inhalt des eingeschlossenen Bereichs
<c>%_</c>|Die Parameter des Tags aufgeschlüsselt nach Name=Wert
<c>$_tag</c>|Name des Tags (Nur bei Name=* sinnvoll)
<c>@_parents</c>|Die umschliessenden Tags
<c>$_query</c>|Die Parameter des Tags als kompletter Text
<c>$_begintag</c>|Wenn gesetzt, befindet sich der Code beim Anfangstag
<c>$_empty</c>|Wenn gesetzt, wurde das Tag als markiert (<c><tag /></c>)
</tab>

Name: Passwort: Stichworte: Version: 1 2 3 Angebot:

Ohne Änderungen zurück zur Seite

Neue Seite erstellen