Bearbeiten von „Blatt der Geschichten/Syntax“

{{ToDo|Gegenprüfen ob alles auch für Leute verständlich ist, die keine Programmierkenntnisse haben oder ähnliches}}
== Allgemein ==
Das [[Blatt der Geschichten]] erlaubt es, Texte nur bei definierten Bedinungen anzuzeigen sowie Bilder in die Feldbeschreibung einzubinden, wobei das Blatt hier als erweiternde Feldbeschreibung zu betrachten ist.

<small>'''Wichtig:''' Zu beachten ist, dass Zeilenumbrüche keinen Effekt haben; angezeigt werden nur mit <code>[br]</code> erzeugte Zeilenumbrüche!</small><!-- Das passt hierhin als Warnung; ist der Fehler, den ich bisher am häufigsten gesehen habe -->

==BBCode==
Die folgenden BBCodes können ähnlich den Profilcodes verwendet werden:
* <code>[b]Text[/b]</code> '''erzeugt einen fettgedruckten Text'''
* <code>[i]Text[/i]</code> ''erzeugt einen kursiven Text''
* <code>[u]Text[/u]</code> <u>erzeugt einen unterstrichenen Text</u>
* <code>[s]Text[/s]</code> <s>erzeugt einen durchgestrichenen Text</s>
* <code>[mitte]Text[/mitte]</code> <div style="text-align: center;">erzeugt einen mittig ausgerichteten Text</div>
* <code>[rechts]Text[/rechts]</code> <div style="text-align: right;">erzeugt einen rechts ausgerichteten Text</div>
* <code>[br]</code> erzeugt einen Zeilenumbruch

== Bilder ==
Es lassen sich Bilder aus bestimmten Teilen von Freewar selbst einbinden. Dies kann wie folgt erreicht werden:
* NPC-Bilder
: <code><nowiki>[[:Bild:NPC:dateiname.gif]]</nowiki></code>
* Item-Bilder
:<code><nowiki>[[:Bild:Item:dateiname.gif]]</nowiki></code>
* Feld-Bilder
: <code><nowiki>[[:Bild:Karte:Feldbildname.jpg]]</nowiki></code> 
* Unterkunfts-Bilder
:<code><nowiki>[[:Bild:Karte:Ordner/Feldbildname.jpg]]</nowiki></code> 
:: Den Ordner findet man, indem man ein UK-Kartenbild in einem neuen Tab öffnet: <nowiki>http://welt1.freewar.de/freewar/images/map/u/Ordner/Feldbildname.jpg</nowiki>
* Bilder von items.freewar.info 
:<code><nowiki>[[[[:Bild:Unique:Ordner/Uniquebild.gif]]]]</nowiki></code>
* Spezielle FW-Bilder
** <code><nowiki>[[:Bild:FW:Trenner]]</nowiki></code> http://welt1.freewar.de/freewar/images/item_divider.gif
** <code><nowiki>[[:Bild:FW:Auge]]</nowiki></code> http://rpsrv.freewar.de/freewar/images/icon_view.gif
** <code><nowiki>[[:Bild:FW:Gold]]</nowiki></code> http://rpsrv.freewar.de/freewar/images/icon_gold.gif
** <code><nowiki>[[:Bild:FW:Pfeilunten]]</nowiki></code> http://rpsrv.freewar.de/freewar/images/icon_drop.gif
** <code><nowiki>[[:Bild:FW:Pfeilrechts]]</nowiki></code> http://rpsrv.freewar.de/freewar/images/icon_transfer.gif
** <code><nowiki>[[:Bild:FW:Seite]]</nowiki></code> http://rpsrv.freewar.de/freewar/images/icon_scroll_neu.gif
** <code><nowiki>[[:Bild:FW:stern1]]</nowiki></code> http://rpsrv.freewar.de/freewar/images/sponsor.gif
** <code><nowiki>[[:Bild:FW:stern2]]</nowiki></code> http://rpsrv.freewar.de/freewar/images/sponsor2.gif
** <code><nowiki>[[:Bild:FW:stern3]]</nowiki></code> http://rpsrv.freewar.de/freewar/images/sponsor3.gif
** <code><nowiki>[[:Bild:FW:Links]]</nowiki></code> http://welt3.freewar.de/freewar/images/arrleft.gif
** <code><nowiki>[[:Bild:FW:Oben]]</nowiki></code> http://welt3.freewar.de/freewar/images/arrup.gif
** <code><nowiki>[[:Bild:FW:Rechts]]</nowiki></code> http://welt3.freewar.de/freewar/images/arrright.gif
** <code><nowiki>[[:Bild:FW:Unten]]</nowiki></code> http://welt3.freewar.de/freewar/images/arrdown.gif
* Verkleinerte Bilder (25x25)
** <code><nowiki>[[:Bild:Itemk:Itemname.gif]]</nowiki></code> 
** <code><nowiki>[[:Bild:NPCk:NPCname.gif]]</nowiki></code>
** <code><nowiki>[[:Bild:Kartek:Feldbildname.gif]]</nowiki></code> 
** <code><nowiki>[[:Bild:Kartek:Ordner/Feldbildname.gif]]</nowiki></code>
** <code><nowiki>[[:Bild:Uniquek:Ordner/Uniquebild.gif]]</nowiki></code>
** Verkleinerte Unique-Bilder (10x10)

Um das Bild des [[Feuergeist]]es einzubinden, ist also <code><nowiki>[[:Bild:NPC:feuergeist.gif]]</nowiki></code> im Bearbeitungsfenster einzufügen.

Diese Bilder lassen sich optional auch verlinken (siehe [[#Ziele|Ziele]]). Dazu wird einfach ein weiterer Parameter hinzugefügt:
* <code><nowiki>[[:Bild:NPC:dateiname.gif:Zielname]]</nowiki></code>

==Spoiler==
Spoilertexte sind Texte, die erst nach dem Klicken des Spoilertitels angezeigt werden.<br />
<code>[spoiler=Spoilertitel]Spoilertext[/spoiler]</code>

Spoilertitel dürfen '''keine''' Bilder enthalten! Man kann aber durch Ziele einen einfachen Spoilereffekt erzeugen, was die Verwendung von Bildern als Spoilerlink ermöglicht.


Es lassen sich auch [[#Ziele|Ziele]] definieren in dem man noch ein weiteres ''=Zielname'' anfügt:<br />
<code>[spoiler=Spoilertitel=''Zielname'']Spoilertext der erscheint oder verschwindet, je nachdem ob das Ziel gesetzt ist oder nicht[/spoiler]</code>

Das Klicken auf den Spoilerlink bewirkt, dass ein gesetztes Ziel entfernt wird bzw. ein nicht gesetztes gesetzt wird.

== Ziele ==
Ein Ziel ist ein boolescher Speicher, der mittels einer Zeichenkette (in den Beispielen hier ''Zielname'') identifizierbar ist. Das heißt entweder ist es gesetzt oder nicht.

=== Setzen / Entfernen eines Zieles ===
* Wechselt den Status eines Ziels: aus gesetzt wird nicht gesetzt und umgekehrt:
:<code><nowiki>[[</nowiki>Zielname]]</code> <small>Siehe auch [[#Spoiler|Spoiler]] für die Verknüpfung von Zielen mit Spoilern</small>
* Entfernt ein Ziel, insofern gesetzt:
:<code><nowiki>[[-</nowiki>Zielname]]</code>
* Setzt ein Ziel, wenn nicht gesetzt:
:<code><nowiki>[[+</nowiki>Zielname]]</code>
* Entfernt alle Ziele dieser Unterkunft:
:<code><nowiki>[[entfernen]]</nowiki></code>

=== Zugriff auf Ziele anderer Nutzer ===
Durch das Voranstellen der [[ID|User-ID]] vor dem Zielnamen, kann man in den Verknüpfungen prüfen, ob ''Zielname'' beim User mit der User-ID ''id'' gesetzt ist.
* Beispiel
:<code>[+ziel:id:Zielname]Nur lesbar, wenn das Ziel ''Zielname'' beim User mit der ID ''id'' gesetzt ist.[end+]</code>

Das Wort "Zielname" kann durch jede beliebige Zeichenfolge ersetzt werden, mit der dann später das Ziel nochmals aufgerufen werden kann - beispielsweise zu Weiterverwendung bei ''Und-'' oder ''Oder-Verknüpfungen''. Außerdem sollte der Name eines Zieles nie aus einer reinen Zahlenfolge bestehen, Doppelpunkte enthalten oder ''entfernen'' heißen, sonst könnte das Blatt eventuell nicht das machen, was man erwartet.

== Ganzzahl-Variablen ==
Es können Variablen angelegt werden, die aber nur Ganzzahlen speichern. Für Variablennamen gelten die gleichen Namenskonventionen wie bei Zielen.

=== Anzeige ===
Der Wert einer Variable wird mit <code><nowiki>[[##variablenname]]</nowiki></code> angezeigt.
=== Manipulation ===
* Veränderung mit den 5 (+,-,*,/,%) Grundrechenarten
:<code><nowiki>[[:Link:Linkbezeichnung:#variablenname+1]]</nowiki></code>
* Wert zuweisen
:<code><nowiki>[[:Link:Linkbezeichnung:#variablenname=1]]</nowiki></code>
: oder <code><nowiki>[[:Link:Linkbezeichnung:#variablenname=zeit]]</nowiki></code> für den aktuellen Zeitstempel
* Diese Operationen können auch ohne Links ausgeführt werden
:<code><nowiki>[[#variablenname=72]]</nowiki></code>

== Bedingungen ==
Es ist möglich, Texte nur unter bestimmten Bedingungen anzuzeigen. Hierbei ist die Verknüpfung mehrerer Bedingungen möglich.

=== Schlüsselwörter ===
* Geschlechter: 
** männlich, weiblich, neutral
* Rassen
** Serum, Arbeiter, Magier, Natla, Onlo, Taruner, Zauberer, Kämpfer
** Bündnis, Zusammenkunft
* Personen
** Clan, Freund, Verräter, Ich, User:''User-ID'', Clan:''Clan-ID''
* Beleuchtung
** Licht ''(der Text wird angezeigt, wenn das Licht-Bild des Feldes aktiv ist oder der Spieler eine Lichtquelle dabei hat.)''
** Dunkel
* Items
** Item:''Itemname''
* Auf Ignorierliste
** Ignoriert
** Igno

Alle Schlüsselwörter lassen sich mit einem ! [[Wikipedia:de:Negation#Die_Negation_in_der_zweiwertigen_Logik|negieren]].

=== Und-Verknüpfung ===
Es ist möglich, verschiedene Bedingungen mit einem '''Und'''-Operator (+) zu verbinden:
* Beispiel:
:<code><nowiki>[</nowiki><span style="color: #d00">+</span><nowiki>Onlo</nowiki><span style="color: #d00">+</span><nowiki>weiblich</nowiki><span style="color: #d00">+</span><nowiki>Item:Larafblüte]Alle weiblichen Onlos mit einer Larafblüte im Inventar können diesen Text lesen.[end</nowiki><span style="color: #d00">+</span><nowiki>]</nowiki></code>
{{Siehe auch|[[Wikipedia:de:Menge_(Mathematik)#Durchschnitt_.28Schnittmenge.2C_Schnitt.29|Schnittmenge in der deutschen Wikipedia]]}}

=== Oder-Verknüpfung ===
Es ist auch möglich, die verschiedenen Bedingungen mit einem '''Oder'''-Operator (/) zu verbinden:
* Beispiel:
:<code><nowiki>[</nowiki><span style="color: #d00">/</span><nowiki>User:1</nowiki><span style="color: #d00">/</span><nowiki>Onlo</nowiki><span style="color: #d00">/</span><nowiki>weiblich]Sotrax (UserID:1), alle weiblichen Wesen und alle Onlos können das lesen.[end</nowiki><span style="color: #d00">/</span><nowiki>]</nowiki></code>
{{Siehe auch|[[Wikipedia:de:Menge_(Mathematik)#Vereinigung_.28Vereinigungsmenge.29|Vereinigung in der deutschen Wikipedia]]}}

=== Verknüpfungen mit Zielen ===
*Als ''Und-Verknüpfung'':<br />
:<code>[+ziel:Zielname+ziel:Zielname2]Nur lesbar wenn ''Zielname'' '''und''' ''Zielname2'' gesetzt sind.[end+]</code>

*Als ''Oder-Verknüpfung'':<br />
:<code>[/ziel:Zielname/ziel:Zielname2]Nur lesbar wenn ''Zielname'' '''und / oder''' ''Zielname2'' gesetzt sind.[end/]</code>

=== Verknüpfungen mit Variablen ===
Variablen können mit Vergleichsoperatoren (< kleiner, > größer, <= kleiner gleich, >= größer gleich) Bedingungen erfüllen.
:<code>[+zahl:variablenname<10]kleiner als 10[end+]</code>

== Sonstiges ==
* <code><nowiki>[[:Profil:(User-id):Bezeichnung]]</nowiki></code> Um Profillinks des Servers einzubinden
* <code><nowiki>[[:CProfil:(Clan-id):Bezeichnung]]</nowiki></code> Um Clan-Profillinks des Servers einzubinden
* <code><nowiki>[[:name]]</nowiki></code> zeigt den Namen des Lesers an