Hilfe:WikiKarte

Funktionsweise

Das Kartenprogramm basiert auf Objekten mit Parametern. Wenn keine zusätzlichen Werte angegeben werden, skaliert die Karte automatisch. Die 2D-Positionen auf der Karte errechnen sich in Schritt östlich und südlich von Wagenhalt und können unter diesem Link per Klick in die Karte ausgemessen werden. Alternativ kann in jeder angezeigten Karte per Klick ausgemessen werden, mehr dazu weiter unten. Beides geht momentan nur im Internet Explorer.

Orte

Um also eine einfache Karte mit der Lage der Orte Wagenhalt und Alt-Gareth zu zeichnen, dient folgender Aufruf:

 {{#karte:
  Dorf:Wagenhalt;0;0;0;0
  Reichsstadt:Alt-Gareth;0;0;12250;27650
 }}

Das Ergebnis sieht dann so aus:

{{#karte:
 Dorf:Wagenhalt;0;0;0;0
 Reichsstadt:Alt-Gareth;0;0;12250;27650
}}

Hier haben wir gleich den ersten Objekttyp kennengelernt: Ein Punktförmiges Objekt mit Beschreibung. Die Größe von Punkt und Beschriftung hängt dabei vom Namen ab. Momentan gibt es die Typen Reichsstadt, Stadt, Markt, Dorf und Burg jeweils gefolgt von einem Doppelpunkt und einer mit Semikolon getrennten Parameterliste, die hier die Reihenfolge Bezeichnung;LOD-Anzeige;LOD-Text;X-Position;Y-Position; haben muss.

Wir wissen also aus den oben angegebenen Werten, das Alt-Gareth etwa 12 Meilen östlich und 28 Meilen südlich von Wagenhalt liegt, Luftlinie sind das (nach Pythagoras) etwa 30 Meilen Entfernung, aber das nur am Rande, um zu verdeutlichen, wie sich diese Daten später auswerten ließen. Die beiden LOD-Werte ("Level of Detail") erkläre ich weiter unten und wir belassen sie vorerst beide auf 0.

Flüsse und Straßen

Kommen wir nun zu den länglichen Objekten, also Flüssen und Straßen. Auch hier wird die Größe ihrer Darstellung durch das richtige Schlüsselwort angegeben: Reichsstrasse, Strasse, Weg oder Pfad und Strom, Fluss oder Bach. Fügen wir also im obigen Beispiel die Reichsstraße bis zur Weggabelung ein, indem wir beginnend von Gareth durch mehrere Klicks den Verlauf der Reichsstraße approximieren, dadurch kommen wir an die Koordinatenliste.

 Reichsstrasse:Marschroute;0;0;12250;27650;14700;19250;17500;12950;18550;5600;17850;-3850;15050;-14350;15050;-20300

Wichtig ist, dass wir die Straße vor den Orten einfügen, denn die Reihenfolge der Objekte gibt auch deren Zeichenreihenfolge an. Ansonsten würde die Straße über den Punkt bei "Alt-Gareth" malen. Hier das Ergebnis:

{{#karte:
 Reichsstrasse:Marschroute;0;0;12250;27650;14700;19250;17500;12950;18550;5600;17850;-3850;15050;-14350;15050;-20300
 Dorf:Wagenhalt;0;0;0;0
 Reichsstadt:Alt-Gareth;0;0;12250;27650
}}

Die Parameter bei einer Strecke sind Bezeichnung;LOD-Anzeige;LOD-Text gefolgt von den X/Y-Paaren.

Wälder, Berge, Seen

Der letzte Objekttyp ist ein geschlossener Streckenzug, der momentan für fünf Schlüsselwörter implementiert ist See, Wald, Huegel, Berg und Gebirge, hier der Wald östlich von Wagenhalt (auch hier wurde einfach im Kreis einmal auf alle Eckpunkte des Waldes geklickt):

 Wald:;0;0;11900;6650;9800;5250;9800;3500;10850;1750;11900;1050;11900;-350;12250;-1400;14000;-2100;14000;-4200;15750;-1400;14000;350;15050;2800;13300;6300

Die Parameter sind hier gleich, allerdings werd der letzte Punkt mit dem ersten wieder verbunden und die Fläche ausgefüllt. Bemerkenswert ist hier, das die Bezeichnung leer ist (also ein auf den Doppelpunkt folgendes Semikolon), dadurch wird der Wald gar nicht bezeichnet. Das Ergebnis sieht so aus:

{{#karte:
 Wald:;0;0;11900;6650;9800;5250;9800;3500;10850;1750;11900;1050;11900;-350;12250;-1400;14000;-2100;14000;-4200;15750;-1400;14000;350;15050;2800;13300;6300
 Reichsstrasse:Marschroute;0;0;12250;27650;14700;19250;17500;12950;18550;5600;17850;-3850;15050;-14350;15050;-20300
 Dorf:Wagenhalt;0;0;0;0
 Reichsstadt:Alt-Gareth;0;0;12250;27650
}}

Universalobjekt "Flaeche"

Ein Universalobjekt ist die Flaeche. Mit ihr kann man besondere Objekte markieren oder z.B. auch politische Machtbereiche in einer Region darstellen.

Die Parameter sind etwas anders als bei den normalen Flächen wie Wald, Huegel, Gebirge.

Flaeche:Dämonenbrache;4;7;30;60;30;0;-1001;33029;-486;32513;373;32084;1317;32342;2004;32685;2434;32513;3292;32084;4237;31311;5611;31140;6899;31311;8530;31397;9303;31998;9475;33372;9045;34574;8530;35175;8187;35948;7843;36721;7500;38009;7586;39211;7843;40070;7500;41443;7328;42474;7070;43161;6469;43676;5697;44363;5181;45136;4838;46080;4580;47111;4580;48141;3808;48914;2691;49343;1489;49686;1489;48742;1232;48313;888;48484;888;49085;201;49429;-572;49429;-1087;48914;-658;47969;115;47626;1146;47368;1747;46681;2004;45823;1575;45823;1232;46338;459;46767;-142;47025;-915;47196;-1945;47540;-2375;47196;-2031;46681;-1259;46338;-743;45994;-1001;45307;-1516;45393;-2203;46080;-3062;46509;-4006;46853;-4350;46424;-4178;45565;-3663;44620;-2804;43762;-2375;43590;-1516;43762;-1001;43848;-142;43332;29;42646;373;41615;-400;41186;-1087;42044;-2203;42302;-2804;42903;-3491;43247;-3749;42731;-3920;42474;-4264;42731;-5123;42989;-4951;42044;-4521;40928;-3835;39984;-3062;39297;-2375;38782;-2718;38181;-3577;38438;-4607;38867;-4779;38009;-4436;37064;-3920;36291;-2976;35690;-2289;36120;-2117;36978;-1945;37751;-1602;37837;-915;37494;-314;36893;373;36034;802;34918;1232;34317;1918;33286;1489;33200;630;33544;-228;34059;-1001;33114

Der erste Parameter ist wieder die Bezeichnung, der zweite das Anzeigelevel, der dritte das Beschriftungslevel. Die 4 nun folgenden Parameter bedeuten folgendes: rot, grün, blau, alpha. rot, grün und blau stehen für Farbwerte. Eine Farbe am Computer setzt sich meist aus diesen drei Farben zusammen. die Werte dürfen dabei zwischen 0 und 255 liegen. 0;0;0 würde schwarz bedeuten, 255;255;255 reines weiß, 255;0;0 ein sehr kräftiges rot und so weiter. 30;60;30 ist ein sehr dunkles grau-grün. alpha steht für den Transparenzlevel der Farbe. alpha darf zwischen 0 und 127 groß sein. 0 würde "nicht durchsichtig" bedeuten, während 127 komplett unsichtbar wäre. Die Wälder und Hügel haben bei uns den Transparenzwert 64, sie sind also zur hälfte durchlässig.

Unser Beispiel sieht damit nun so aus: {{#karte: Flaeche:Dämonenbrache;4;7;30;60;30;0;-1001;33029;-486;32513;373;32084;1317;32342;2004;32685;2434;32513;3292;32084;4237;31311;5611;31140;6899;31311;8530;31397;9303;31998;9475;33372;9045;34574;8530;35175;8187;35948;7843;36721;7500;38009;7586;39211;7843;40070;7500;41443;7328;42474;7070;43161;6469;43676;5697;44363;5181;45136;4838;46080;4580;47111;4580;48141;3808;48914;2691;49343;1489;49686;1489;48742;1232;48313;888;48484;888;49085;201;49429;-572;49429;-1087;48914;-658;47969;115;47626;1146;47368;1747;46681;2004;45823;1575;45823;1232;46338;459;46767;-142;47025;-915;47196;-1945;47540;-2375;47196;-2031;46681;-1259;46338;-743;45994;-1001;45307;-1516;45393;-2203;46080;-3062;46509;-4006;46853;-4350;46424;-4178;45565;-3663;44620;-2804;43762;-2375;43590;-1516;43762;-1001;43848;-142;43332;29;42646;373;41615;-400;41186;-1087;42044;-2203;42302;-2804;42903;-3491;43247;-3749;42731;-3920;42474;-4264;42731;-5123;42989;-4951;42044;-4521;40928;-3835;39984;-3062;39297;-2375;38782;-2718;38181;-3577;38438;-4607;38867;-4779;38009;-4436;37064;-3920;36291;-2976;35690;-2289;36120;-2117;36978;-1945;37751;-1602;37837;-915;37494;-314;36893;373;36034;802;34918;1232;34317;1918;33286;1489;33200;630;33544;-228;34059;-1001;33114 Wald:;0;0;11900;6650;9800;5250;9800;3500;10850;1750;11900;1050;11900;-350;12250;-1400;14000;-2100;14000;-4200;15750;-1400;14000;350;15050;2800;13300;6300

 Reichsstrasse:Marschroute;0;0;12250;27650;14700;19250;17500;12950;18550;5600;17850;-3850;15050;-14350;15050;-20300
 Dorf:Wagenhalt;0;0;0;0
 Reichsstadt:Alt-Gareth;0;0;12250;27650
}}

Kommentare

Ein letztes, wichtiges Objekt sollte nicht unerwähnt bleiben: Die Kommentarzeile. Mit K: eingeleitet können in ihr beliebige Kommentare versteckt werden. Die Zeile wird einfach vom Programm ignoriert und erhöht, sinnvoll angewendet, die Lesbarkeit des Karten-Codes:

K:Hier ein beliebiger Kommentar, abgeschlossen mit Return.

Parameter

Es gibt einige allgemeine Parameter, mit denen man die Ausgabe steuern kann. Zur Überprüfung soll hier der Parameter P_Relief:1 vorgestellt werden. Damit wird die eigentliche Reliefkarte eingeblendet und man kann sehen, ob man sich vermessen hat. Der Parameter P_Messen:1 ermöglicht das Messen direkt in der Karte. Dann sieht es zusammen so aus:

{{#karte:
 P_Relief:1
 P_Messen:1
 Wald:;0;0;11900;6650;9800;5250;9800;3500;10850;1750;11900;1050;11900;-350;12250;-1400;14000;-2100;14000;-4200;15750;-1400;14000;350;15050;2800;13300;6300
 Reichsstrasse:Marschroute;0;0;12250;27650;14700;19250;17500;12950;18550;5600;17850;-3850;15050;-14350;15050;-20300
 Dorf:Wagenhalt;0;0;0;0
 Reichsstadt:Alt-Gareth;0;0;12250;27650
}}

Dadurch ist es fast so komfortabel, wie in einem Malprogramm: Ihr zieht z.B. eine Straße mit mehreren Mausklicks nach, kopiert Euch die Koordinaten unten und fügt in Eure Karte z.B. Strasse: und eventuell den Namen ein und fügt dann die Koordinaten dahinter ein. Probiert es aus, es ist kinderleicht. Wie sonst auch in der Wiki ist es wichtig, dass viele Hände die Daten sammeln (also in der Karte ausmessen). Einige wenige "Wiki-Gärtner" reichen aber dann aus, um die Daten in die richtige Form zu bringen. Wie immer gilt: Keine Scheu, man kann nichts kaputt machen!

Die anderen Parameter in Tabellenform erklärt:

P_Relief:	1 bedeutet Reliefkarte einblenden, 0 bedeutet Reliefkarte ausblenden (Standard)
P_Messen:	1 bedeutet, dass das Messen in der Karte aktiviert ist, 0 deaktiviert es (Standard)
P_GroesseX:	Breite der Karte in Pixel (Standard 600)
P_GroesseY:	Höhe der Karte in Pixel (Standard 600)
P_Stadtfaktor:	Größe von Städten als Divisor zur Kartengröße, ein höherer werde bedeutet kleinere Anzeige
P_Flussfaktor:	Größe von Flüssen als Divisor zur Kartengröße, ein höherer werde bedeutet kleinere Anzeige
P_Wegfaktor:	Größe von Wegen als Divisor zur Kartengröße, ein höherer werde bedeutet kleinere Anzeige
P_Seefaktor:	Größe von Seen als Divisor zur Kartengröße, ein höherer werde bedeutet kleinere Anzeige
P_Waldfaktor:	Größe von Wäldern als Divisor zur Kartengröße, ein höherer werde bedeutet kleinere Anzeige
P_Rand:	Randgröße in Pixeln, sowohl beim Auto-Scaling als auch bei angegebenen Min-Max-Werten wird dieser berücksichtigt (Standard 50)
P_MinX:	Minimale mindestens noch sichtbare Kartenposition X, schaltet hierfür das Autoscaling in dieser Richtung aus
P_MinY:	Minimale mindestens noch sichtbare Kartenposition Y, schaltet hierfür das Autoscaling in dieser Richtung aus
P_MaxX:	Maximale mindestens noch sichtbare Kartenposition X, schaltet hierfür das Autoscaling in dieser Richtung aus
P_MaxY:	Maximale mindestens noch sichtbare Kartenposition Y, schaltet hierfür das Autoscaling in dieser Richtung aus
P_LOD:	Detailstufe, regelt die Anzeige von Objekten je nach dort eingestellter Detailstufe, s.u.

Automatisierung

Mit der DynamicPageList-Extension ist es uns auch möglich, die Kartenausgabe zu automatisieren. Dazu wurden zu einigen Vorlagen (z.B. Vorlage:Dorfbeschreibung) weitere Vorlagen (z.B. Vorlage:Dorfbeschreibung.map) erstellt, so dass diese automatisch ausgegeben werden können.

Städte werden z.B. automatisch in die meisten Karten eingefügt, in dem man sie geschickt selektiert, hier z.B. die Reichsstädte in Schlund oder Hartsteen mit Beschreibung:

 {{#dpl:category=Reichsstädte|category=Schlund{{!}}Hartsteen|includepage={Dorfbeschreibung}.map|mode=userformat|secseparators=\n}}

Würde man dies alleine ausführen, gäbe es dieses (im Wiki-Format hässliches) Ergebnis, das danach von der Kartenprozedur interpretiert wird: {{#dpl:category=Reichsstädte|category=Schlund|Hartsteen|includepage={Dorfbeschreibung}.map|mode=userformat|secseparators=\n}}

In unsere Karte eingefügt gibt das dieses Ergebnis:

{{#karte:
 {{#dpl:category=Reichsstädte|category=Schlund|Hartsteen|includepage={Dorfbeschreibung}.map|mode=userformat|secseparators=\n}}
 Wald:;0;0;11900;6650;9800;5250;9800;3500;10850;1750;11900;1050;11900;-350;12250;-1400;14000;-2100;14000;-4200;15750;-1400;14000;350;15050;2800;13300;6300
 Reichsstrasse:Marschroute;0;0;12250;27650;14700;19250;17500;12950;18550;5600;17850;-3850;15050;-14350;15050;-20300
 Dorf:Wagenhalt;0;0;0;0
 Reichsstadt:Alt-Gareth;0;0;12250;27650
}}

Dazu werden die "versteckten" Felder Typ, PositionX, PositionY und Kurzname ausgewertet. Analog werden bei Flüssen die Felder Typ, Koordinaten, Anzahl und Kurzname ausgewertet.

Es empfiehlt sich, alle sonstigen Landschaften in einem sinnvollen Artikel zu sammeln, so wie ich es z. B. mit den Straßen in Weg und Steg im Schlund getan habe. Dazu nutzt man die beiden Wiki-Schlüsselwörter includeonly und noinclude, damit bei der Anzeige des Artikels nur Text, aber bei der Einbindung nur WikiKarte-Code ausgegeben wird. Sinnvoll ist es obendrein, neben den Artikeln

• Weg und Steg in X
• Wald und Forst in X
• Hügel und Berge in X
• Landschaften in X
• Besondere Orte in X

für jede Grafschaft X bei größeren Mengen oben genannter Landschaften in einer Baronie, diese einzeln zu beschreiben und in die oben genannten Sammelcontainer geschickt einzubinden.

Wo fange ich an?

Der erste Schritt zur Karte der eigenen Baronie besteht daraus, sich mit Hilfe des oben genannten Links den jeweils östlichsten (P_MinX, erste Koordinate), westlichen (P_MaxX, erste Kooridnate), nördlichsten (P_MinY, zweite Koordinaten) und südlichsten Punkt (PMaxY, zweite Koordinate) auszumessen und diese wie oben gezeigt als Parameter einzugeben. Zusätzlich gibt man sinnvollerweise die Detailstufe 9 an (beim Kartenzeichnen geht auch 13, aber irgendwann wird es dann übersichtlich). Durch Einbinden der Vorlage "KarteGesamt" werden alle anderen Karten eingebunden. Schließlich wird die Unterlegte Reliefkarte und das Messen in der Karte aktiviert:

 {{#karte:
  P_MinX:102627
  P_MaxX:149917
  P_MinY:51091
  P_MaxY:104881
  P_LOD:9
  {{KarteGesamt}}
  P_Relief:1
  P_Messen:1
 }}

Mit dem o.g. Beispiel (für die Königliche Vogtei Mardershöh) bekommt man dann dieses Ergebnis:

{{#karte:
 P_MinX:102627
 P_MaxX:149917
 P_MinY:51091
 P_MaxY:104881
 P_LOD:9
 Vorlage:KarteGesamt
 P_Relief:1
 P_Messen:1
}}

In dieser Karte kann man dann Orte, Wege, Seen, Berge und Wälder ausmessen und sie entweder sofort in die entsprechenden Gesamtseiten (z.B. Wald und Forst im Schlund) einfügen oder erst einmal in der eigenen Seite zeilenweise einfügen.

Detailstufen

In den oben genannten Objekten können Detailstufen eingestellt werden. Dieser LOD ist wie folgt definiert:

• 0 - Dere (20.000 M)
• 1 - Meer der sieben Winde (10.000 M)
• 2 - Aventurien (5.000 M)
• 3 - Mittelaventurien (2.500 M)
• 4 - Mittelreich (1.200 M)
• 5 - Garetien und Perricum (600 M)
• 6 - Garetien (300 M)
• 7 - Große Grafschaft (150 M)
• 8 - Kleine Grafschaft (75 M)
• 9 - Baronie (40 M)
• 10 - Großes Edlengut (20 M)
• 11 - Kleines Edlengut, Stadtplan (10 M)
• 12 - Dorfplan (5 M)
• 13 - Burgplan (2 M)

Die "Breite" dieser Skala wurde gewählt, damit wir unsere Daten eventuell weiterverwenden könnten und nicht alles umsonst sammeln. Wenn man also einen Weg oder Ort einfügt, sollte man überlegen, auf welcher der 14 o.g. Karten er "noch" sichtbar sein soll. Dragenfels z.B. auf Ebene 7 und ab 8 mit Beschriftung, der große Fluss oder Gareth auf 0 bzw. 1 usw.

Wenn wir also in unserem Beispiel der Meinung sind, Alt-Gareth sollte auf jeder Karte gezeigt und bezeichnet werden, Wagenhalt dagegen auf Karten der Größe 4 sichtbar und der Text erst auf Karten der Größe 6, gibt man nun die beiden Werte wie folgt an:

 Dorf:Wagenhalt;4;6;0;0
 Reichsstadt:Alt-Gareth;0;0;12250;27650

Eine Karte mit den beiden Städten und Parameter

P_LOD:5

würde dann zu folgendem gewünschten Ergebnis führen:

{{#karte:
 P_LOD:5
 Dorf:Wagenhalt;4;6;0;0
 Reichsstadt:Alt-Gareth;0;0;12250;27650
}}

Zur automatischen Erstellung von Karten wurden die beiden Felder LODBezeichnung und LODAnzeige eingeführt, so ist z.B. bei der Reichsstadt Wandleth LODAnzeige=3 (also ab Karten von Mittelaventurien sichtbar) und LODBezeichnung=4 (also ab Karten des Mittelreiches sichtbar).

Hilfe meine Objekte werden nicht angezeigt!!!

Keine Panik!

1. Ein erster Grund kann sein, dass irgendwo ein Semikolon zu viel oder zu wenig ist. Einfach die fehlenden Objekte überprüfen. Es ist ganz wichtig, dass die Objekte der oben beschriebenen Syntax folgen.
2. Vielleicht ist auch das Level of Detail zu niedrig eingestellt. Setze einfach mal P_LOD=14. Dann sollte alles angezeigt werden.
3. Ein dritter Grund kann sein, dass die Karte aus dem Cache gelesen wurde. Wir erstellen nur alle 15min eine neue Karte. Wenn nach Ablauf dieser Zeit die Karte immer noch ohne die Objekte angezeigt wird, einfach mal die Seite mit &action=purge aufrufen. Dadurch wird der Cache der Wiki gelöscht. (Aufrufbeispiel: für diese Seite (klappt aber mit jeder Wikiseite))