- baseportal Dokumentation

Titel:

Ausgabeseiten sind ganz gewöhnliche Web-Seiten, in denen Sie jedoch bestimmte neue HTML-Befehle, sog. Tags verwenden können. baseportal bearbeitet die Seiten vor der eigentlichen Ausgabe und ersetzt diese speziellen Tags, z.B. durch den aktuellen Inhalt einer Datenbank, durch eine andere Seite oder auch das Ergebnis einer Berechnung.Da solche Seiten also als Vorlagen für die eigentliche Ausgabe dienen, werden Sie auch "Schablonen" genannt, auf Englisch: Templates.

Beispiel:

&nbsp; <code>
 <pre><html></head><title>Highscore</title></head>
<body bgcolor=ffffff>

<h2>Highscore-Liste</h2>

<center>
<table width=90% border=1>
<tr><td>Name</td><td>Punkt</td>

<loop sort=- range=0,10>
<tr>
<td>$Name</td>
<td>$Punkt</td>
</tr>
</loop>

</table>
</center>

</body></html></code> </pre> 
 Alle schwarzen Tags sind ganz normale HTML-Befehle.

Rot = Neue, baseportal-spezifische Tags (Befehle)

Wie im Standard HTML auch, fangen baseportal-Tags mit dem Kleiner-Zeichen <c><</c> an und hören mit dem Grösser-Zeichen <c>></c> auf. Manche Tags stehen alleine, wie <c><include...></c>, manche umschliessen einen Bereich, den sie beeinflussen. Das Ende des Bereichs wird dann mit einem zugehörigen abschliessenden Tag markiert, das genauso heisst, wie das Start-Tag, allerdings mit einem vorangestellten Schrägstrich <c>/</c> beginnt, wie z.B. <c><loop>&nbsp;...&nbsp;</loop></c>. Gross/Kleinschreibung ist egal, üblich ist allerdings durchwegs alles klein zu schreiben.

Blau = Parameter, die die Ausführung der Befehle beeinflussen

Manche Tags benötigen zusätzliche Angaben, auch Parameter genannt, um ihre Arbeit verrichten zu können, wie z.B. <c><include src=...></c>, das den Namen einer Datei braucht, den es an dieser Stelle einfügen soll. Bei anderen Tags sind Parameter nicht unbedingt nötig, sie ermöglichen jedoch die leicht unterschiedliche Ausführung der Befehle, wie z.B. mit einer anderen Sortierung oder mit einer anderen Hintergrundfarbe. Tag und Parameter werden durch Leerzeichen voneinander getrennt, ebenso wie mehrere Parameter untereinander. Achtung: Anführungszeichen werden als Bestandteil des Wertes interpretiert, sie umschliessen nicht, wie in HTML möglich, einen Wert. Also einfach keine Anführungszeichen verwenden...

Grün = Werte (Variablen), die durch aktuelle Daten ersetzt werden

Variablen sind einfach Platzhalter, an deren Stelle der eigentliche Wert eingefügt wird. Sie beginnen (wie in der Programmiersprache Perl) immer mit dem "Dollar"-Zeichen <c>$</c>. Es gibt bei baseportal eine Reihe spezieller Variablen, die z.B. die Anzahl der gelesenen Einträge oder den Namen der auszugebenden Datenbank enthalten. Oft bezeichnen sie aber Felder einer Datenbank und enthalten dann für jeden Datensatz den jeweiligen Wert.</td> </tr> <tr> <td> <ul>Ein paar Tipps zum allgemeinen Verständnis: <li>Loop heisst "Schleife" und bedeutet, dass in obigem Beispiel alles, was innerhalb von &lt;loop&gt; und &lt;/loop&gt; steht, entweder so oft hintereinader ausgegeben wird, wieviel tatsächlich Datensätze in der Datenbank sind bzw. hier bis maximal 10 Datensätze, auch wenn mehr Datensätze in der Datenbank vorhanden sind.
 Die Ausdrücke <a href="http://baseportal.de/baseportal/doku/baseportal.pl?htx=/doku/wiki&kennung=66#1">sort=-</a> und <a href="http://baseportal.de/baseportal/doku/baseportal.pl?htx=/doku/wiki&kennung=66#1">range=0,10</a> werden an den etsprechenden Stellen erklärt. </li> <li>Im Template werden zur Formatierung der Ausgaben ganz normale HTML-Tags angewandt, ganz egal, ob da noch zusätzlich baseportal - interne Tags stehen.
 Schließlich werden hier ja Ausgaben für Web-Browser generiert, so dass ein paar HTML-Kenntnisse beim Einsatz von baseportal durchaus von Vorteil sind. </li> </ul> </td> </tr> </table>

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

Ohne Änderungen zurück zur Seite

Neue Seite erstellen