AOQML für Anfänger: Unterschied zwischen den Versionen

Aus AntamarWiki
Wechseln zu: Navigation, Suche
Zeile 1: Zeile 1:
 
'''WICHTIG:''' Momentan ist diese Seite noch nicht fertig! Bitte erst dann als Vorlage nutzen, wenn sie freigegeben ist.  
 
'''WICHTIG:''' Momentan ist diese Seite noch nicht fertig! Bitte erst dann als Vorlage nutzen, wenn sie freigegeben ist.  
  
==1. Der Editor==  
+
==1. Den Editor benutzen==  
 +
 
 
Der [[AOQML-Editor]] erleichter gerade für Anfänger das Programmieren erheblich, da er einen geeigneten Rahmen bietet und zumindest einen Teil der üblichen Fehler im Vorfeld erkennen kann. Ladet ihn einfach herunter (http://aoqml.isonweb.de/) und speichert ihn in einem Ordner für eure eigenen Questen.  
 
Der [[AOQML-Editor]] erleichter gerade für Anfänger das Programmieren erheblich, da er einen geeigneten Rahmen bietet und zumindest einen Teil der üblichen Fehler im Vorfeld erkennen kann. Ladet ihn einfach herunter (http://aoqml.isonweb.de/) und speichert ihn in einem Ordner für eure eigenen Questen.  
  
[[Bild:Aoqml 01.jpg|thump]]
+
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 01.JPG|thumb]]
 +
|}
  
 
Ein Doppelklick öffnet ihn.  
 
Ein Doppelklick öffnet ihn.  
  
Bild 2
+
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 02.JPG|thumb]]
 +
|}
  
 
Das Feld "Quest" öffnet 3 Möglichkeiten: Man kann eine neue '''Quest anlegen''', eine schon im Ordner vorhandene '''Quest laden''' oder durch '''Beenden''' den Editor schließen.  
 
Das Feld "Quest" öffnet 3 Möglichkeiten: Man kann eine neue '''Quest anlegen''', eine schon im Ordner vorhandene '''Quest laden''' oder durch '''Beenden''' den Editor schließen.  
  
Bild 3
+
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 03.JPG|thumb]]
 +
|}
  
 
Wir müssen natürlich erst einmal eine erste Quest anlegen.  
 
Wir müssen natürlich erst einmal eine erste Quest anlegen.  
  
Bild 4
+
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 04.JPG|thumb]]
 +
|}
  
 
Gespeichert wird sie im entsprechenden Ordner, in dem auch der Editor ist. Natürlich benötigt sie einen Namen. Er sollte einfach und eindeutig sein und einen Hinweis auf den Inhalt bieten. Wir nennen die erste Quest fantasievoll '''testquest 01'''.  
 
Gespeichert wird sie im entsprechenden Ordner, in dem auch der Editor ist. Natürlich benötigt sie einen Namen. Er sollte einfach und eindeutig sein und einen Hinweis auf den Inhalt bieten. Wir nennen die erste Quest fantasievoll '''testquest 01'''.  
  
Bild 5
+
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 05.JPG|thumb]]
 +
|}
  
 
Die Queste wird jetzt als eigener Unterordner für die einzelnen Dateien in dem Questordner angelegt. Außerdem erscheint im Editor jetzt die grafische Übersicht über die einzelnen Dateien. Da wir noch keine Datei geschrieben haben ist auch noch keine zu sehen  - außer der Datei '''start''', die immer vorhanden sein muss und daher automatisch erstellt wird. Da sie noch leer ist, wird sie rot dargestellt.  
 
Die Queste wird jetzt als eigener Unterordner für die einzelnen Dateien in dem Questordner angelegt. Außerdem erscheint im Editor jetzt die grafische Übersicht über die einzelnen Dateien. Da wir noch keine Datei geschrieben haben ist auch noch keine zu sehen  - außer der Datei '''start''', die immer vorhanden sein muss und daher automatisch erstellt wird. Da sie noch leer ist, wird sie rot dargestellt.  
  
Bild 6
+
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 06.JPG|thumb]]
 +
|}
  
Ein Doppelklick öffnet die Datei start.  
+
Ein Doppelklick öffnet die Datei '''start'''.  
  
Bild 7
+
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 07.JPG|thumb]]
 +
|}
  
 
Wenn man auf einem Netbook mit "kompaktem" Monitor arbeitet, so wie ich, kann es vom Platz her etwas eng werden... In dem Fall sollte man als erstes einige Leerzeilen unter </szene> setzen. Große Monitore sind deutlich von Vorteil. Man kann das Fenster verschieben und in der Größe verändern.  
 
Wenn man auf einem Netbook mit "kompaktem" Monitor arbeitet, so wie ich, kann es vom Platz her etwas eng werden... In dem Fall sollte man als erstes einige Leerzeilen unter </szene> setzen. Große Monitore sind deutlich von Vorteil. Man kann das Fenster verschieben und in der Größe verändern.  
  
Bild 8
+
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 08.JPG|thumb]]
 +
|}
 +
 
 +
===2. Die erste Szene schreiben==
 +
 
 +
Nachdem die Szene "start" geöffnet ist, beginnen wir mit einer einfachen Queste.
 +
 
 +
Die Zeile  '''<quest status="running"/>'''  am Anfang steht nur in der Szene start, in den anderen ist sie nicht nötig. Die Zeile  '''</scene>'''  steht am Ende der Dateien (=Szenen), um diese zu schließen. Der restliche Code wird zwischen diese beiden Zeilen geschrieben.
 +
 
 +
Wir beginnen die Queste mit einem kleinen Einführungstext. Dazu schreiben wir zwischen die beiden Zeilen < p>. Der Editor erweitert dies sofort zu < p>< /p>. '''Hinweis:''' Das Leerzeichen zwischen < und p dient nur dazu, das Wiki zu überlisten - das würde sonst die Befehle interpretieren... Gilt auch im folgenden.
 +
 
 +
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 09.JPG|thumb]]
 +
|}
 +
 
 +
< p> öffnet die Textausgabe, < /p> schließt sie wieder. Den Text kann man direkt dazwischen schreiben. Er wird dann in der Quest als normaler Text ausgegeben. Wörtliche Rede von Charakteren wird zwischen < q></ q> geschrieben und dann automatisch kursiv und mit Anführungszeichen ausgegeben. Wir nehmen folgenden Text:
 +
 
 +
''Gerade als du beim Wirt etwas zu Essen bestellen willst, fällt dein Blick auf einen Zettel an der Wand der Kneipe. Anders als die anderen Aushänge und Notizen, die schon von Kerzenruß und Staub vergilbt sind, scheint er ziemlich neu zu sein.''
 +
 
 +
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 10.JPG|thumb]]
 +
|}
 +
 
 +
Wenn wir das so lassen, würde die Queste nur den Text anzeigen und keine weiteren Funktionen bieten. Der SC würde festhängen. Aber natürlich lassen wir sie nicht so! Stattdessen geben wir dem Spieler zwei Optionen vor, wie er weiter verfahren kann.
 +
 
 +
Dafür tippen wir erst einmal hinter dem < /p> '''Enter''', um eine Zeile nach unten zu kommen, und geben dann < ul> ein, was sich wie gewohnt zu < ul>< /ul> verändert. Dieses < ul> sorgt dafür, das die geplanten Links in der Queste schön untereinander gezeigt werden, nicht hintereinander.
 +
 
 +
Um Platz zu haben setzen wir den Cursor zwischen die beiden Befehle und drücken drei mal '''Enter''', dann die Taste '''<--'''. Jetzt haben wir zwischen den '''ul''' zwei freie Zeilen. Der Editor rückt automatisch alles ein, was wir dazwischen eingeben. Das vereinfacht die Übersicht erheblich, wenn wir größere Szenen schreiben.
 +
 
 +
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 11.JPG|thumb]]
 +
|}
 +
 
 +
In die beiden leeren Zeilen geben wir  '''< li>'''  ein. Das sorgt dafür, das die Optionslinks mit einem Aufzählungspunkt beginnen, was hübscher aussieht.
 +
 
 +
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 12.JPG|thumb]]
 +
|}
 +
 
 +
Wenn der '''|''' zwischen den Befehlen sitzt (so: '''< li>|< /li>''' ) klicken wir links auf die Taste '''<choice.../>'''. Dadurch wird automatisch der Befehl <choice target="">...</choice> eingefügt. Dieser Befehl erzeugt in der Queste dann den eigentlichen Link. Er muss zwischen beiden li eingefügt werden!
 +
 
 +
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 13.JPG|thumb]]
 +
|}
  
Die Zeile  <quest status="running"/>  am Anfang steht nur in der Szene start, in den anderen ist sie nicht nötig. Die Zeile  </scene>  steht am Ende der meisten Dateien (=Szenen), um diese zu schließen.  
+
So leer würde der Link aber nur '''...''' anzeigen - und, wenn man ihn anklickt, ins leere führen! Also müssen wir beide Befehle füllen. Zunächst einmal mit den Texten, die als anklickbarer Link angezeigt werden. Wir nehmen die beiden Texte "''Desinteressiert wendest du dich deinem Essen zu.''" und "''Das siehst du dir aus der Nähe an.''". Sie ersetzen die ... .  
  
 +
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 14.JPG|thumb]]
 +
|}
  
 +
Jetzt würde die Queste zwar die Texte als Links anzeigen, die würden aber immer noch ins leere führen. Also muss noch jeweils eine Zieldatei angegeben werden, und zwar zwischen die "". Da es noch keine Dateien außer start gibt, können wir uns die Namen frei aussuchen. Wir nehmen für die obere Option '''abbruch''' und für die untere '''zettel'''. '''Hinweis:''' Bitte klein schreiben, ä, ö, ü und ß vermeiden und _ statt Leerzeichen benutzen, sonst kann es Probleme geben!
  
 +
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 15.JPG|thumb]]
 +
|}
  
==2. start.xml==
+
Damit wäre die Datai "start" soweit fertig. Also klicken wir oben auf '''speichern'''. Dann schließen wir die Datei mit dem kleinen grauen x oben rechts (das große rote schließt den ganzen Editor). Jetzt sollte etwa folgendes zu sehen sein:
  
 +
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 16.JPG|thumb]]
 +
|}
  
 +
Das Fenster kann man vergrößern, den Zoom benutzen und die Dateien hin und her ziehen, bis sie gut liegen. Es sollte übersichtlich sein, etwa so:
  
==3.==
+
{| border="0" style="border-collapse:collapse; background-color:transparent;" cellpadding="0"
 +
| [[Bild:Aoqml 17.JPG|thumb]]
 +
|}

Version vom 8. Mai 2010, 17:55 Uhr

WICHTIG: Momentan ist diese Seite noch nicht fertig! Bitte erst dann als Vorlage nutzen, wenn sie freigegeben ist.

1. Den Editor benutzen

Der AOQML-Editor erleichter gerade für Anfänger das Programmieren erheblich, da er einen geeigneten Rahmen bietet und zumindest einen Teil der üblichen Fehler im Vorfeld erkennen kann. Ladet ihn einfach herunter (http://aoqml.isonweb.de/) und speichert ihn in einem Ordner für eure eigenen Questen.

Aoqml 01.JPG

Ein Doppelklick öffnet ihn.

Aoqml 02.JPG

Das Feld "Quest" öffnet 3 Möglichkeiten: Man kann eine neue Quest anlegen, eine schon im Ordner vorhandene Quest laden oder durch Beenden den Editor schließen.

Aoqml 03.JPG

Wir müssen natürlich erst einmal eine erste Quest anlegen.

Aoqml 04.JPG

Gespeichert wird sie im entsprechenden Ordner, in dem auch der Editor ist. Natürlich benötigt sie einen Namen. Er sollte einfach und eindeutig sein und einen Hinweis auf den Inhalt bieten. Wir nennen die erste Quest fantasievoll testquest 01.

Aoqml 05.JPG

Die Queste wird jetzt als eigener Unterordner für die einzelnen Dateien in dem Questordner angelegt. Außerdem erscheint im Editor jetzt die grafische Übersicht über die einzelnen Dateien. Da wir noch keine Datei geschrieben haben ist auch noch keine zu sehen - außer der Datei start, die immer vorhanden sein muss und daher automatisch erstellt wird. Da sie noch leer ist, wird sie rot dargestellt.

Aoqml 06.JPG

Ein Doppelklick öffnet die Datei start.

Aoqml 07.JPG

Wenn man auf einem Netbook mit "kompaktem" Monitor arbeitet, so wie ich, kann es vom Platz her etwas eng werden... In dem Fall sollte man als erstes einige Leerzeilen unter </szene> setzen. Große Monitore sind deutlich von Vorteil. Man kann das Fenster verschieben und in der Größe verändern.

Aoqml 08.JPG

=2. Die erste Szene schreiben

Nachdem die Szene "start" geöffnet ist, beginnen wir mit einer einfachen Queste.

Die Zeile <quest status="running"/> am Anfang steht nur in der Szene start, in den anderen ist sie nicht nötig. Die Zeile </scene> steht am Ende der Dateien (=Szenen), um diese zu schließen. Der restliche Code wird zwischen diese beiden Zeilen geschrieben.

Wir beginnen die Queste mit einem kleinen Einführungstext. Dazu schreiben wir zwischen die beiden Zeilen < p>. Der Editor erweitert dies sofort zu < p>< /p>. Hinweis: Das Leerzeichen zwischen < und p dient nur dazu, das Wiki zu überlisten - das würde sonst die Befehle interpretieren... Gilt auch im folgenden.

Aoqml 09.JPG

< p> öffnet die Textausgabe, < /p> schließt sie wieder. Den Text kann man direkt dazwischen schreiben. Er wird dann in der Quest als normaler Text ausgegeben. Wörtliche Rede von Charakteren wird zwischen < q></ q> geschrieben und dann automatisch kursiv und mit Anführungszeichen ausgegeben. Wir nehmen folgenden Text:

Gerade als du beim Wirt etwas zu Essen bestellen willst, fällt dein Blick auf einen Zettel an der Wand der Kneipe. Anders als die anderen Aushänge und Notizen, die schon von Kerzenruß und Staub vergilbt sind, scheint er ziemlich neu zu sein.

Aoqml 10.JPG

Wenn wir das so lassen, würde die Queste nur den Text anzeigen und keine weiteren Funktionen bieten. Der SC würde festhängen. Aber natürlich lassen wir sie nicht so! Stattdessen geben wir dem Spieler zwei Optionen vor, wie er weiter verfahren kann.

Dafür tippen wir erst einmal hinter dem < /p> Enter, um eine Zeile nach unten zu kommen, und geben dann < ul> ein, was sich wie gewohnt zu < ul>< /ul> verändert. Dieses < ul> sorgt dafür, das die geplanten Links in der Queste schön untereinander gezeigt werden, nicht hintereinander.

Um Platz zu haben setzen wir den Cursor zwischen die beiden Befehle und drücken drei mal Enter, dann die Taste <--. Jetzt haben wir zwischen den ul zwei freie Zeilen. Der Editor rückt automatisch alles ein, was wir dazwischen eingeben. Das vereinfacht die Übersicht erheblich, wenn wir größere Szenen schreiben.

Aoqml 11.JPG

In die beiden leeren Zeilen geben wir < li> ein. Das sorgt dafür, das die Optionslinks mit einem Aufzählungspunkt beginnen, was hübscher aussieht.

Aoqml 12.JPG

Wenn der | zwischen den Befehlen sitzt (so: < li>|< /li> ) klicken wir links auf die Taste <choice.../>. Dadurch wird automatisch der Befehl <choice target="">...</choice> eingefügt. Dieser Befehl erzeugt in der Queste dann den eigentlichen Link. Er muss zwischen beiden li eingefügt werden!

Aoqml 13.JPG

So leer würde der Link aber nur ... anzeigen - und, wenn man ihn anklickt, ins leere führen! Also müssen wir beide Befehle füllen. Zunächst einmal mit den Texten, die als anklickbarer Link angezeigt werden. Wir nehmen die beiden Texte "Desinteressiert wendest du dich deinem Essen zu." und "Das siehst du dir aus der Nähe an.". Sie ersetzen die ... .

Aoqml 14.JPG

Jetzt würde die Queste zwar die Texte als Links anzeigen, die würden aber immer noch ins leere führen. Also muss noch jeweils eine Zieldatei angegeben werden, und zwar zwischen die "". Da es noch keine Dateien außer start gibt, können wir uns die Namen frei aussuchen. Wir nehmen für die obere Option abbruch und für die untere zettel. Hinweis: Bitte klein schreiben, ä, ö, ü und ß vermeiden und _ statt Leerzeichen benutzen, sonst kann es Probleme geben!

Aoqml 15.JPG

Damit wäre die Datai "start" soweit fertig. Also klicken wir oben auf speichern. Dann schließen wir die Datei mit dem kleinen grauen x oben rechts (das große rote schließt den ganzen Editor). Jetzt sollte etwa folgendes zu sehen sein:

Aoqml 16.JPG

Das Fenster kann man vergrößern, den Zoom benutzen und die Dateien hin und her ziehen, bis sie gut liegen. Es sollte übersichtlich sein, etwa so:

Aoqml 17.JPG