Travel-Guide

Aus GoPalWiki
Wechseln zu: Navigation, Suche

Einleitung

Versionen

  Cityguide / Travelguide 3
{{{Screenshot}}}
{{{Beschreibung}}}
Aktuelle Version:  ()
Datei: TravelGuide.exe
Daten:
Zugehörigkeit: Teil von GoPal 3.x
Erstellungsdatum: Montag, 23. April 2007, 18:54:38
MD5: noch nachzutragen
  Cityguide / Travelguide 2
{{{Screenshot}}}
{{{Beschreibung}}}
Aktuelle Version:  ()
Datei: Cityguide.exe
Daten:
Zugehörigkeit: Teil von GoPal 2.x
Erstellungsdatum: Sonntag, 1. Oktober 2006, 14:06:54
MD5: noch nachzutragen











Paket-Inhalte

Installation

Datei-System

Werkzeuge

Editoren

XML-Generator

Work-Shop

Datei-XML erstellen

Um den Aufbau der XML-Stadtdateien besser zu verstehen kann man im Travel-Guide Work-Shop erlernen wie man selbst Dateien erstellen kann. Dort wird der hierarchische Aufbau der Dateien genau erklärt. Alle benötigten Variabeln und Textparameter werden genau beschrieben. Ebenso ist ein Travel-Guide konformer Aufbau der Stadtdaten angeben damit jede neue Stadt-Datei auch gleich bedienbar bleibt. Letztendlich werden auch die Werkzeuge zur Erstellung der Daten beschrieben. Allgemeine Fragen werden genauso behandelt wie Fehlerbeschreibungen oder die Touristikinformationen...

..und hier gehts zum Work-Shop

Datei-Variablen

Datei-Variabeln in den XML-Dokumenten

1. Die Kopfparameter - Start-Tag/Ende-Tag                                                          Erklärung

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE TravelInfo SYSTEM "Medion.dtd">
<TravelInfo>     </TravelInfo>
<Country CountryCodeISO="DE" CountryName="Deutschland"> </Country>
<RegionCity RegionCityCode="HAN" RegionCityName="Hannover">      </RegionCity>


2. Überschriften / Textkörper

<InfoItem Name="Hannover - Landeshauptstadt an der Leine" CategorieCode="1" CategorieName="Willkommen">
<ItemText>     </ItemText>
<TextPara ParaNumber="1">      </TextPara>


3. Adressenkopf

<ItemAdress>    </ItemAdress>
<GeoPositionLatitude>     </GeoPositionLatitude>
<GeoPositionLongitude>    </GeoPositionLongitude>
<Street>    </Street>
<ZipCode>    </ZipCode>
<Locality>    </Locality>
<PhoneNumber>    </PhoneNumber>
<FaxNumber>    </FaxNumber>
<EMail>    </EMail>
<URL>    </URL>
<OpeningHours>    </OpeningHours>


4. Sonder-Tags

<Impressum ImpressumName="Impressum">    </Impressum>
<Copyright>    </Copyright>
<Disclaimer>    </Disclaimer>


5. Zusätzliche - Tags

<Rating Budget="1"/>

<Rating Business="3" Culture="3" Family="2" Leisure="4"/>


Datei-Fehlercodes

Fehlercodes die vom Travel-Guide 2.x geliefert werden

!!!Es werden nur Fehler erklärt die auch UNSERE Veränderungen betreffen könnten!!!


Fehler
Rückmeldung
Bedeutung
01. No error

.? = Kein Fehler .! = Rückmeldung an das ausführende Programm,-

alles OK

02. Error

.? = Fehler .! = nicht explizit zugeordnet ,- kann alles

Mögliche sein

03. Failed to open file Memory allocation failed. .? = Fehler beim Öffnen einer Datei, Dateispeicherverteilung versagte .! = entweder ist die Datei (XML) defekt, Speicher

zu klein ,- in den Einstellungen mehr Datenspeicher zuweisen

04. Error parsing Element. .? = XML-Analyse-Fehler (unfinished tag mismatch) mit Befehlsfehler .! = Klammer vergessen,- Befehl nicht

abgeschlossen </befehl> ,- Schreibfehler im Befehl

05. Failed to read .? = Fehler beim Lesen der Datei .! = Falsches Format beim Abspeichern gewählt,-

unbedingt „UTF-8“-Kodierung wählen

06. Element name Error reading Element value.

07. Error reading Attributes.

08. Error: empty tag.

09. Error reading end tag.

10. Error parsing Unknown.

11. Error parsing Comment.

12. Error parsing Declaration.

13. Error document empty.

14. Error null (0) or unexpected EOF found in input stream.

15. Error parsing CDATA.


Datei-Sonderzeichen

Wenn man für den Travel-Guide ein neues Datenblatt erstellen will, kann es vorkommen das wir in der Überschrift, im Textkörper oder in der Beschreibung auf Sonder -Zeichen stossen. Gibt man diese so wie gewohnt mit ein verweigert Travel-Guide den Dienst und im schlimmsten Fall gibt es einen sauberen Absturz. Aber es gibt Abhilfe...

Die einzelnen Zeichen werden wie folgt in einem XML-Doc. ohne Leerzeichen eingegeben :

Die betroffenen Sonderzeichen sind : < > " & `
& lt; das ist eine Spitzklammer Links
& gt; das ist eine Spitzklammer Rechts
& quot; das ist ein Hochkomma
& apos; das ist ein Apostrophe
& amp; das ist ein kaufmännisches Pluszeichen

So kann man auf einfache Weise diese Sonderzeichen einsetzen. Das geht auch mit dem XML-Generator.


... und so sieht es dann im Travel-Guide aus...

Testbild 1.jpg





Skin(ning)Travel-Guide 2.x -Work-Shop

Polyglott - Skin(ning) für den

Travel(City)-Guide

Nachdem wir nun wissen wie man zusätzliche Städte im City - Guide erstellen kann, widmen wir uns nun dem Verändern des Travel(City)- Guide´s. Um es gleich vorweg zu nehmen,- es geht hier nicht um ein fertiges Skin sondern soll lediglich den Weg dorthin beschreiben um selbst ein Skin für seine "Gelüste" herzustellen.

Die Datei, die das Aussehen maßgeblich beeinflusst, liegt im Ordner  \My Flash Disk\Medion   und heißt  SDASkin.skn . Wir gehen so vor wie bereits im Workshop Travel(City) - Guide beschrieben, in dem wir uns diese Datei vom PNA kopieren und uns diese als KOPIE! in ein anderes Verzeichnis unserer Wahl auf der Festplatte des PC´s ablegen. Mit dieser Kopie arbeiten wir nun. Damit wir überhaupt sehen was dort drin ist muss wieder unser Text-Editor herhalten. Wir rufen also den Editor auf und laden uns die Kopie von SDASkin.skn hinein. Anders als bei einer Textbasierten XML-Datei finden wir hier nun eine Strukturierung vor und erkennen auch einzelne zusammenhängende Abschnitte. Und mit denen wollen wir uns im Einzelnen nun beschäftigen. Unsere Aufgabe wird darin bestehen das Aussehen so zu verändern, das es zu einer BMW-Ausleuchtung passt. Es ist aber so gut beschrieben, das es ohne grossen Aufwand an jede Fahrzeug-Beleuchtung,- z.B. Blau,- angepasst werden kann.

Bei der Beschreibung gilt folgendes :

die blauen Einträge sind die Orginal-Einträge,- die roten sind die neuen Einträge !

Abschnitt:

System
Hier werden die Leistenfarben definiert die gerade aktiv (im Fokus) sind. Statt also "helles blau" nun in Orange. Alle Farbparameter werden immer in RGB-Werte angegeben. ROT/GRÜN/BLAU - Werte können mit jedem x-beliebigen Malprogramm ausprobiert werden um die ermittelten Werte dann hier einzusetzen.

Beispiel                                          Orange             Blau                Grün               Weiß





                                                     255,133,80            0,0,255            0,185,0          255,255,255

Wir ersetzen nun folgende Zeile im Abschnitt System

DefaultFocusColor:
170,206,243;// Light blue.

DefaultFocusColor: 255,133,80; // BMW-Orange Fokus-Leisten

Jetzt speichern wir das erstmal ab und überschreiben unsere Datei auf dem PNA. Dann Polyglott starten und das Ergebnis anschauen. Nun,- der aktive Balken ist zwar jetzt Orange nur die Schrift sieht nicht so dolle aus. Also werden wir nun zu Schritt 2 gehen.

Abschnitt:

Defines
Hier ändern wir vier Einträge im Abschnitt Defines.

Der Überschriftentext in der Titelleiste kann verändert werden. Das geschieht mit folgenden Eintrag...
TITEL_TEXT_COLOR: 0,0,0;
TITEL_TEXT_COLOR: 0,0,255; // Überschriftentext Farbe Blau

Damit wir einen blendfreien  Hintergrund für unsere Schrift bekommen schalten wir den Hintergrund einfach auf sattes Schwarz und das geschieht mit folgenden Eintrag ...
AREA_HIGHLIGHT_COLOR: 225,228,229; //light gray
AREA_HIGHLIGHT_COLOR: 000,000,000; //Hintergrund Tiefschwarz

Wenn wir das jetzt abspeichern würden und uns dann auf dem PNA ansehen würden,- tja,- ... wir sehen garnichts mehr. Also müssen wir noch die Schriftfarbe aus dem Schwarz wieder hervorholen. das machen wir mit folgenden Eintrag ...
LISTBOX_TEXT_COLOR: 0,0,0;
LISTBOX_TEXT_COLOR: 255,255,255; //Textfarbe weiss

Und weil wir  schon mal in diesem Abschnitt sind können wir hier auch gleich den Hintergrund der Scrollbalken anpassen. Da er im Orginal sehr hell ist und man nie genau weiss wieviel Text bis zum Ende noch da ist, sollte hier für mehr Kontrast und Abgrenzung gesorgt werden. Da ja schwarz bereits für den Hintergrund gewählt ist ,- in unserem Beispiel,- fällt die Farbe aus da wir ihn sonst nicht sehen würden. Also nehmen wir einen Blauton der in etwa unseren Buttons links und rechts unten entspricht.und das machen wir nun mit folgenden Eintrag...
AREA_BG_COLOR: 205,205,214; // gray
AREA_BG_COLOR: 26,134,186; // Scrollbalken Hintergrund auf blau

So,- mehr brauchen wir erstmal nicht und wir speichern uns das Ganze nun ab, kopieren es auf unseren PNA und üben nun Kontrolle aus. Sieht doch schon ganz gut aus,- nicht wahr ?? - Na dann zum nächsten Schritt...

Abschnitt:

PointOfInterestText
Damit wir eine kontrastreiche Schrift auf unseren Beschreibungsseiten erreichen kann diese Schrift verändert werden. Das erreichen wir mit dem Eintrag ...
TextColor: 0,0,0; // Farbe der eigentlichen Beschreibungstexte
Wie man sehen kann, gibt es hier keinen roten Eintrag,- na klar ich habe ihn auch nicht verändert. Wenn nun aber jemand auf die Idee kommt einen schwarzen oder sehr dunklen Hintergrund zu wählen, so wird er keinen Text mehr sehen. Folglich muss dieser ebenfalls geändert werden,- sehr helles blau oder weiss wäre hier wohl eher angesagt. Das Text-Hintergrundbild kann ebenfalls ausgetauscht werden. Da es das gesammte Erscheinungsbild und die Lesefähigkeit beeinflusst wird es auch in diesem Zusammenhang der Schriftgestaltung hier genannt.

Der Austausch der Datei : background.png passiert

in dem Verzeichnis \My Flash Disk\Medion\SKIN und nicht vergessen,- ERST DIE DATEI(en) SICHERN !!... dann überschreiben !

Wenn wir dann schon mal dabei sind den Hintergrund farblich anzupassen liegen im selben Verzeichnis noch die Dateien

1. poi_mapselection_icons.png
2. udlr_icons.png

3. titlebar1.png

Falls hier Veränderungen jetzt gemacht wurden,- nun wieder abspeichern und auf dem PNA kontrollieren Und weiter gehts im nächsten Schritt..

Abschnitt:

NavigateText
Wir haben nun auch die Hintergründe angepasst,- was jetzt noch fehlt ist die passende Schriftenfarbe bei einem Hinweis in der untersten Leiste. Die erscheint nur wenn auch Adress-Koordinaten hinterlegt sind. ( siehe dazu den Workshop )
In unserem Beispiel ist der Hintergrund der Leiste ja in Blau gehalten und wir brauchen nun die Kontrastfarbe dazu die auch Nachts zu sehen ist. Ich habe mich erstmal für ein Neongrün entschieden bis mir was besseres einfällt. Der Eintrag der verändert werden muß lautet ...
TextColor:  $QUESTION_COLOR$;
TextColor:  0,255,0; // Textfarbe der unteren Leiste in Neongrün

Wie wir sehen können ist hier keine RGB-Farbe im Orginal angegeben. Hier wird mit einer festen Variablen gearbeitet die im Abschnitt Defines hinterlegt ist. Warum ändern wir nun da nicht die RGB-Werte ?? - Nun,- falls andere Erweiterungen darauf zugreifen so erwarten diese natürlich den dortigen Eintrag
QUESTION_COLOR=0,0,0; . Wir wollen aber lediglich die Schrift in der unteren Leiste ändern,- also machen wir das in der Form von einem RGB-Eintrag wie oben beschrieben. Jetzt wieder unsere Abspeichern/Anschauen/Testen-Prozedur und gehen dann zum letzten Schritt.

Abschnitt: 
ImpressumText

Eine Besonderheit ist in der Rubrik Impressum zu sehen. Hier wird kein Hintergrundbild angezeigt. Da wir in unserem Beispiel einen schwarzen Hintergrund gewählt hatten und die Schrift ebenfalls Schwarz vorgegeben ist muß diese nun angepasst werden. Das geschieht nun mit folgenden Eintrag...
TextColor: 0,0,0;
TextColor: 255,255,255;

// Farbe des Textes im Impressum weiss
So, das war es erstmal und das Ganze lädt natürlich zum Experimentieren ein. Hier kann Man(n)/Frau sich richtig auslassen bis man SEINE ultimative Einstellung gefunden hat. Die Icons lassen sich natürlich ebenfalls verändern und verschieben. Einfach mal ausprobieren kann schon nichts kaputt gehen. Wichtig ist lediglich das immer alle Orginaldaten/Bilder  gesichert worden sind und wir immer nur mit den Kopien arbeiten. Außerdem müssen die Dateinamen immer identisch zum Orginal sein,- wie soll er(der PNA) sie sonst auch finden.

Ansonsten gilt der Grundsatz der Pfadfinder : Learning by Doing

Tools & Applikationen

Tools

XML-Generator

Stadt-Notizen

Um Städte für den Travel-Guide zu beschreiben bedarf es im Vorfelde der Daten-Suche. Da kann es schnell passieren den Überblick zu verlieren und man erstickt in der eigenen Zettelwirtschaft. Um hier ein bischen Ordnung in das eigene Chaos zu bekommen gibt es ein Text-File wo genau die

1. gewünschten Rubriken
2. in der richtigen Reihenfolge
3. mit den benötigten Variabeln(Koordinaten,Tel/Mail/Web etc)
4. mit der benötigten Anzahl je Rubrik
5. mit fertigem Impressum-Text zur Übernahme.

beschrieben sind und das gibt es HIER.

Applikationen

Travel-Shopper

Städte - Neue

Hier werden Städte veröffentlicht die Travel-Guide konform sind. Das bedeutet das diese Dateien folgende Kriterien erfüllen müssen:

1. Alle Rubriken die vom Orginal her bekannt sind müssen in den neuen Städte-Dateien auch erscheinen.

2. Die Reihenfolge muss identisch sein um ein einheitliches Bedienen zu ermöglichen.

3. Eine echte Navigation zu den dort angegebenen Zielen muss möglich sein.

4. Leereinträge wie: "Email ist nicht vorhanden" etc. müssen gelöscht werden.

5. Neue Rubriken müssen im Forum zur Absprache gebracht werden und genehmigt werden.

6. Wenn Neu-Rubriken erstellt werden, sollten alle bestehenden Städte die Neuerung erhalten.

7. Es dürfen nur neu erstellte Städte veröffentlicht werden


Welche Rubriken gebraucht werden kann im Verzeichnis [Tools] aus den Stadt-Notizen ermittelt werden.


Bislang sind dazu erschienen :

Stadt Hannover

Hansestadt Bremen

Hansestadt Hamburg

Hansestadt Lübeck

Links