<include file="top.lhhtml">
<lconf pos="/define" pagename="define">
<section link="/define/concept" local="concept">
<locale>
<locale language="en">
If you wanna create your own tags you have to define it before.
This can be done by the <code>define</code> tag.
<br>
The code between the <code>define</code> tag is JavaScript code and will be
interpreted. But this code has some limitations in the contrast
to the <link path="/interpreter/script">. Please study the
<link path="/interpreter/script"> and experimentice with the
interpreter before defining your own tags.
<p>
Examples for using own tags can be found at the Examples Collection
and the Tutorial. (<docu>)
</p>
</locale>
<locale language="de">
Wenn du dein eigenes Tag kreieren willst, dann must du es vorher
definieren. Dies geschieht mit dem <code>define</code> Tag.
<br>
Der Code zwischen dem <code>define</code> Tag ist JavaScript und
wird interpretiert. Aber dieser Code unterliegt einigen Einschränkungen,
im Gegensatz zu dem <link path="/interpreter/script">. Bitte studiere
zuerst das <link path="/interpreter/script"> und experimentiere mit dem
Interpreter bevor du deine eigenen Tags definierst.
<p>
Beispiele für die Verwendung eigener Tags wirst du in den Beispielen und
im Tutorial finden. (<docu>)
</p>
</locale>
</locale>
</section>
<!-- ************************ -->
<section link="/define/define" local="define">
<definition title="Define Tag Definition:">
<include file="define.def">
</definition>
<!-- **************** -->
<faq title="Name Option">
<locale>
<locale language="en">
This is the name of the tag. For the <code>define</code> tag it would be "define". For
a tag written <code><foobar></code> it would be "foobar".
For a close tag like <code></foobar></code> it would be "/foobar".
(But in normal cases you have not to use define a closing tag.)
</locale>
<locale language="de">
Dies ist der Name des Tags. Für das <code>define</code> Tag würde dieser
"define" lauten. Für dieses Tag: <code><foobar></code> lautet er
"foobar". Für ein abschließendes Tag wie: <code></foobar></code>
lautet er "/foobar". (Aber normalerweise muß ein abschließendes
Tag nicht extra definiert werden.)
</locale>
</locale>
</faq>
<!-- ************************ -->
<faq title="Type Option">
<locale>
<locale language="en">
There are two possible tag types. The "simple_tag" for a
single tag like <code><foobar></code>, and "open_close_tag"
for a pair of tags.
</locale>
<locale language="de">
Es gibt zwie Arten von Tags. Das "simple_tag" für einzelne Tags
wie <code><foobar></code> und "open_close_tag"'s für
Tag Paare.
</locale>
</locale>
<example mode="fixed">
<char latin1>
<foobar>
jblasdv asgasdö avslkdnva vaksdnv
adsvasd ölasdb asbölas dvölnsb asöln
</foobar>
</char>
</example>
<br><br>
<locale>
<locale language="de">
Bei einem "open_close_tag" wird der Text der sich zwischen den Tags
befindet als erster Parameter, als File Typ, an die JavaScript Funktion übergeben.
</locale>
<locale language="en">
At a "open_close_tag" the text between the tags will be given to the
JavaScript function as first parameter and it's type will be the File type.
</locale>
</locale>
</faq>
<!-- ******************** -->
<faq title="Init Option">
<locale>
<locale language="de">
Hier kann angegeben werden in welchen Init Scan
nach diesem hier definiertem Tag gesucht wird und dieses
ausgeführt wird.<br>
Der default Wert beträgt "user", das bedeuted, das alle
vom Anwender definierten Tags in dem User Scan ausgeführt werden,
es sei denn hier steht eine andere Information.
<br>
Es ist nicht möglich hier einen eingebauten Scan wie "include" zu
verwenden.
</locale>
<locale language="en">
At this position you can define which init scan should be used
to execute this defined tag.<br>
The default value is "user". This means that in normal cases
all user defined tags will be processed at the user scan.<br>
It is not possible to use a builtin scan like "include" here.
</locale>
</locale>
</faq>
<!-- ************************** -->
<faq title="Function Option">
<locale>
<locale language="en">
The name of the JavaScript function that should be called.
If this Option is not set, the <b>name</b> of the tag will be used.
</locale>
<locale language="de">
Der Name der JavaScript Funktion, die aufgerufen werden soll.
Wenn diese Option nicht gesetzt ist, dann wird der Wert der <b>name</b>
Option verwendet.
</locale>
</locale>
</faq>
<!-- ************************ -->
<faq title="Interpreter Option">
<lang en text="The name of the interpreter that should be used.">
<lang de text="Der Name des Interpreters, der verwendet werden soll.">
</faq>
<!-- *********************** -->
<faq title="Level Option">
<lang en text="The level of the define tag.">
<lang de text="Das Level des define tags.">
</faq>
<!-- ********************** -->
<faq title="Nested Option">
<locale>
<locale language="en">
Turns the nested Tag support on.
If the <b>type</b> of the tag is not an "open_close_tag" this option has no effect.
</locale>
<locale language="de">
Stellt ein ob verschachtelte Tags zugelassen werden sollen.
Wenn der <b>type</b> des Tags kein "open_close_tag" ist, dann
hat diese Option keine Auswirkungen.
</locale>
</locale>
</faq>
<!-- ******************** -->
<faq title="Get_real_tag Option">
<lang de text="Wenn dieses Flag gesetzt ist wird das gefundene Tag als Typ Tag an die JavaScript Funktion übergeben.">
<lang en text="If this flag is set the found tag will be given as the tag type to the JavaScript function.">
</faq>
<!-- ******************** -->
<faq title-en="PAR_X and DPAR_X Option" title-de="PAR_X und DPAR_X Option">
<locale>
<locale language="de">
Wenn <b>get_real_tag</b> nicht gesetzt ist wird das parsen der Parameter
an vom Kompiler übernommen. Diesem muß aber mitgeteilt werden, welche
Parameter benötigt werden.
<p>
<code>PAR_1=name</code> bedeuted, dass als erster Parameter der Wert der Option "name"
übergeben werden soll.<br>
<code>PAR_2=email</code> bedeuted, dass ale zweiter Parameter der Wert der Option "email"
übergeben werden soll.<br>
<code>PAR_1_STRING=name</code> bedeuted, dass als erste Parameter der Wert der Option "name"
übergeben werden soll und dieser als String interpretiert werden soll.<br>
<code>PAR_1_TYPE=name</code> bedeuted, dass als erste Parameter der Wert der Option "name"
übergeben werden soll und dieser als interner Typ interpretiert werden soll.<br>
<code>DPAR_1="ich"</code> bedeuted, dass falls der erste Parameter, also die "name"
Option nicht gesetzt ist, stattdessen dieser default Wert verwendet werden soll.
</p>
</locale>
<locale language="en">
If the <b>get_real_tag</b> is not set the option parsing will be done by the compiler.
but the compiler has to know which Options are required.
<p>
<code>PAR_1=name</code> means, that the Option "name" should be given to the function
as the first parameter.<br>
<code>PAR_2=email</code> means, that the Option "eamil" should be given to the function
as the second parameter.<br>
<code>PAR_1_STRING=name</code> means, that the Option "name" should be given to the function
as the first parameter and it should be interpreted as string.<br>
<code>PAR_1_TYPE=name</code> means, that the Option "name" should be given to the function
as the first parameter and it should be interpreted as an internal type.<br>
<code>DPAR_1="me"</code> means, that if the option of the first parameter, the "name" option
is not set, this default value should be used.
</p>
</locale>
</locale>
</faq>
</section>
|
