Leo<HTML>

Macro Tags

Tags - Referenz
Tag Syntax
Include Tag
Macro Tags
    Beschreibung
    Hard Macros
    Soft Macros
Menu Tags
Locale Tags
Char Tag
File Tags
Image Tag
Delete Tag
Init System
Der Interpreter
Eigene Tags
Index
Es gibts 2 verschiedene Typen von Makros. Soft und Hard Makros. Beide Arten sind einfache Text substitutionen. Der Unterschied is das Aufrufschema. Soft Makros werden explizit aufgerufen. Hard Macros sind mächtiger, aber auch gefährlicher.

Hard Macro Tag Definition:

<macro (Typ: simple_tag)
name="foobar" (info: Name des Macros)
text="bla bla bla bla" (info: Der zu substituierende Text)
hard (info: Makro ist ein Hard-Makro)
>

Der name des Makros ist der Text der durch den Text, der durch die text Option definiert ist ersetzt werden soll. Um ein Hard-Makro zu definieren, muß die hard Option gesetzt sein.

Beispiel:
  
<macro name="foobar" text="The Foo Bar" hard> 
 



Nun wird, sobald der Text "foobar" gefunden wird dieser durch "The Foo Bar" ersetzt.

Beispiel:

// Vor der Substitution
Es war einmal ein Mann, der hatte einen foobar.

// Nach der Substitution
Es war einmal ein Mann, der hatte einen The Foo Bar.



Aber sei vorsichtig. Wenn du versuchst "foobar" durch "The foobar Foo" zu ersetzen, wird Leo<HTML> in einer endlosen Schleife hängen bleiben. Später werde ich noch Techniken erklären, die so etwas zulassen.

Soft Macro Definition:

<macro (Typ: simple_tag)
name="foobar" (info: Name des Macros)
text="bla bla bla bla" (info: Der zu substituierende Text)
soft (optional) (info: Makro ist ein Hard-Makro)
>



Die Dekleration eines Soft-Makros unterscheidet sich kaum von der eines Hard-Makros. Mit soft wird ein Macro als Soft-Makro definiert. Diese Option kann auch weggelassen werden. Ist bei einer Makro Definition weder das soft, noch das hard Flag gesetzt ist das Makro ein Soft-Makro.

Soft Macro Call Definition:

<macro (Typ: simple_tag)
macro_name (info: Name des Makros)
PARAMETER_X (optional) (info: Pseudo Parameter)
>

Beispiel:
  
<macro name="foobar" text="The Foo Bar"> 



Das Makro wird aber nun so aufgerufen:

Beispiel:

// Vor der Substitution
Es war einmal ein Mann, der hatte einen <macro foobar>

// Nach der Substitution
Es war einmal ein Mann, der hatte einen The Foo Bar.



Es ist wirklich einfach. Aber so ein Makro ist nun einmal nicht sehr flexibel. Um die Sache doch ein wenig flexibler werden zu lassen gibt es die PARAMETER_X Option:

Beispiel:


// Definition
<macro name="foobar" text="The PARAMETER_1 Foo PARAMETER_2">

// Aufruf
Es war einmal ein Mann, der hatte einen <macro foobar PARAMETER_1="real" PARAMETER_2="Bar">.

// Ergebnis
Es war einmal ein Mann, der hatte einen The real Foo Bar .




Makros sind ein relativ primitives Werkzeug, und sind recht unflexibel. Aber auch sie haben ihre Daseinsberechtigung. Wer allerdings mehr Flexibilität will muß früher oder später auf Eigene Tags zurückgreifen.


Diese Seite wurde von King Leo kreiert. Seitengenerator Leo<HTML> Version 0.99.0 .