Anleitung zur Installation der Sitemap

Version dieser Lieferung: v2.1.05

Übersicht

Inhalt

Die Sitemap - Lieferung besteht aus der Zip - Datei sitmap.zip, die folgende Dateien enthält:

Installation

Vorbemerkung: Wenn Sie von einer früheren Version updaten, verfahren Sie bitte nach den Updatehinweisen.

1. Kopieren Sie diese Dateien in ein Verzeichnis auf Ihrer Seite (z.B. /sitemap)
2. Öffnen  Sie die Seite sitemap.html im Browser. Das Applet sollte bereits starten mit einer Beispielstruktur.
3. Öffnen Sie sitemap.dat mit einem Texteditor. Hier können Sie die Struktur anlegen, die Sie anzeigen möchten:
   • Im HEAD - Bereich der Datei können Sie Ihrer Sitemap einen Titel geben und das Trennzeichen ( Delimiter ) festlegen.
   • Im BODY - Bereich wird die eigentliche Struktur angegeben:
   • Ordner geben Sie an, indem Sie auf der nächsten Zeile eine geschweifte Klammer öffnen. Nach dem letzten Eintrag in diesem Ordner müssen Sie eine Klammer schließen. Beide Klammern müssen allein auf einer Zeile stehen.
     Beispiel:
     Download
     {
          Link 1
          Link 2 ...
     }
   • Links geben Sie an, indem Sie nacheinander schreiben:
     Beschreibender Text [Delimiter] link [Delimiter] Frame
     Startseite, ../index.html, frame
     Dabei bedeuten:
     • Beschreibender Text - Der Text, der ausgegeben wird
     • [Delimiter] Trennzeichen, das im BODY - Bereich der sitemap.dat angegeben wird ( Standard: "," )
     • link - Link zu diesem Dokument. Entweder relativ zu sitemap.html oder absolut durch vollständige Schreibweise mit Protokoll ( http://www.lexasoft.de )
     • Frame - HTML - Zielframe, in dem die Seite angezeigt werden soll. Auch die üblichen Standards wie _blank für neue Seite werden verstanden.
       Hinweis: Ein Zielframe sollte immer angegeben werden, weil das Applet sonst die Seite in den eigenen Frame lädt und dadurch stoppt.
       

       Nur zu beachten bei Seiten ohne Frames:

       Auf Seiten ohne Frames ( wie auch http://www.lexasoft.de/ ) kann die Sitemap nur als Popup laufen. So erzeugen Sie ein Popup: Der Link, der die sitemap.html lädt, muss sinngemäß so aussehen: <a href="applets/sitemap.html" target="sitemap" onClick="window.open('','sitemap','scrollbars=no,toolbar=no,directories=no,status=no,menubar=no,resizable=no,width=300,height=480')">SiteMap 2.0</a> Noch ein Problem im framelosen System: Um den neuen Link im Hauptfenster der Seite zu zeigen, muss dieses, obwohl framelos, einen Frame - Namen haben. Fügen Sie deshalb in jede Seite, die die Sitemap aufruft, in den HEAD - Bereich folgende Zeilen ein: <script language="JavaScript" > window.name="frame"; </script> Danach können Sie über den Namen "frame" auf das Hauptfenster zugreifen. In der Sitemap zum Beispiel durch die Zeile: Startseite, ../index.html, frame

4. Öffnen Sie props/lexasoft.properties und ändern Sie die darin enthaltenen Parameter ggf. 
   Hinweis: Lassen Sie die Einstellungen zu den Icons weitgehend unverändert. Diese Bilder werden aus dem jar - File gezogen.
   Falls Sie dennoch eigene Icons verwenden möchten, kopieren Sie diese am besten in das image - Verzeichnis. Sie können dann deren Namen ohne Pfadangabe verwenden ( Vorausgesetzt Sie lassen den HTML - Parameter ResourceBase in sitemap.html unverändert).
   • Ein Hintergrundbild ( z.B. das Ihrer Webseite ) geben Sie in IMG_background an. 
     Bsp.: IMG_background : $ResourceBase./../../images/backgrnd.gif
Die ResourceBase wird durch den gleichnamigen Parameter in der HTML - Datei ( sitemap.html ) festgelegt. Bei empfohlener Installation würde obiger Aufruf in das globale images - Verzeichnis der Präsenz verweisen und dort die Datei backgrnd.gif laden.
     Natürlich können Sie backgrnd.gif auch in die ResourceBase kopieren, dann würde der Parameter so aussehen:
     IMG_background : $ResourceBase./backgrnd.gif oder
IMG_background : backgrnd.gif ( das ist default )
   • In LINE_SpacePercent steuern Sie den Zeilenabstand zwischen den Zeilen der Sitemap. 100 bedeutet keine Veränderung gegenüber dem Standard, 120 vergrößert den Abstand, 90 verkleinert ihn.
   • Die Schriftart stellen Sie in FONT_Normal ein.
   • Die Vorder- und Hintergrundfarbe können Sie über die Properties   COL_fgcolor und COL_bgcolor beeinflussen. ( Farbkodierungen s.Anhang) 
5. Öffnen Sie props/sitemap.properties mit einem Texteditor. Auch hier gilt: Lassen Sie die Angaben zu den Icons weitgehend unverändert. Konfigurieren Sie das Aussehen der Sitemap wie folgt::

• Die Farbe eines nicht besuchten Links im Property COL_Link. ( Farbkodierungen s.Anhang) 
• Die Farbe eines besuchten Links im Property COL_vLink. ( Farbkodierungen s.Anhang) 
• Die Farbe des aktiven Links im Property COL_aLink. ( Farbkodierungen s.Anhang) 

Zum Anfang

Updatehinweise 

Um festzustellen, welche Version Sie im Moment verwenden, sollten Sie vor dem Update die Sitemap starten, die rechte Maustaste drücken und aus dem Popup - Menü den Punkt "Über..." wählen. Im dann erscheinenden Fenster ist die Version aufgeführt, wobei jedoch zwischen v2.0.1a und v2.0.1 nicht unterschieden wird.

Version 2.1 auf Version 2.1.05

Entpacken Sie das Zip in ein beliebiges Verzeichnis Ihrer Festplatte und ersetzen Sie die Datei sitemap.jar Ihrer Installation durch die gleichnamige Datei dieser Lieferung. Weitere Veränderungen sind nicht erforderlich. Falls Sie von 2.0.x auf 2.1.05 updaten, befolgen Sie bitte die Anweisungen im nächsten Abschnitt.

Version 2.0.x auf Version 2.1

So behalten Sie Ihre Einstellungen:

• Entpacken Sie das Zip in ein beliebiges Verzeichnis auf Ihrer Festplatte.
• Ersetzen Sie die Datei sitemap.jar in Ihrem Web durch die Datei aus der Lieferung.
• Kopieren Sie die Dateien images/open.gif, images/close.gif, images/info.gif, images/search6.gif  und images/search.gif aus der Lieferung zusätzlich in die ResourceBase in Ihrem Web. Im Normalfall ist dies das Verzeichnis ./images unterhalb des Verzeichnisses, in dem sich sitemap.jar befindet.
• Sie sollten jetzt bereits die neue Version starten können.
• Öffnen Sie die Datei props/lexasoft.properties in der Lieferung  in einem Texteditor und fügen Sie den gesamten oberen Abschnitt, der mit der Version 2.1 hinzugekommen ist per "cut and paste" in die gleichnamige Datei Ihrer Webpräsenz ein. Auf diese Weise können Sie zukünftig auch diese Parameter ändern.
• Falls Sie von einer früheren Version als 2.0.1a updaten, beachten Sie bitte auch die Hinweise im Anschluss.

Version 2.0.1 auf Version 2.0.1a

Es wurde lediglich die Datei sitemap.html verändert, um auch im Netscape eine randfreie Darstellung des Applets zu erreichen. Tauschen Sie daher nur diese Datei aus oder, falls Sie diese geändert haben, kopieren Sie folgenden Tag vor den Applet Tag:

<DIV ID="LayoutLYR"><LAYER ID="LayoutLYR" TOP=0 LEFT=0 WIDTH=95%> 

Version 2.0 auf Version 2.0.1

Wenn Sie von Version 2.0 auf 2.0.1 updaten, entpacken Sie das Zip in ein beliebiges Verzeichnis und tauschen Sie lediglich die Datei sitemap.jar aus. Auf diese Weise erhalten Sie Ihre Einstellungen. Beachten Sie aber bitte unbedingt folgendes:

Die wichtigste Veränderung der 2.0.1 gegenüber 2.0 ist die Unterstützung der Lexasoft Global Options. Daraus ergibt sich eine Veränderung, die sie beachten müssen: Der bisherige HTML - Parameter "propertyfile" wurde umbenannt in "propertyfiles" weil hier jetzt mehrere Property - Dateien angegeben werden können.

Der bisherige Parameter "propertyfile" wird nicht mehr unterstützt !!!!.

Nachdem Sie diesen Parameter umbenannt haben, sollte die Sitemap sofort wieder funktionieren.

Um die Lexasoft Global Options auszunutzen, sollten Sie allerdings im weiteren Ihre Property - Dateien gemäß dem Abschnitt "Besonderheiten bei mehrfachem Einsatz / mehreren Lexasoft - Applets" anpassen.

Zum Anfang

Parameter

Alle Parameter ( mit wenigen Ausnahmen ) können in jeder beliebigen Property - Datei oder als Parameter der HTML - Seite angegeben werden. Welche Property - Dateien vom Applet ausgelesen werden, muss im Applet Tag als Parameter "propertyfiles" angegeben werden ( s.a. Beispieldatei calendar.html). 

Die Angabe der Dateien muss ausgehend von der einbindenden HTML - Seite erfolgen. Mehrere Property - Dateien sind durch ";" zu trennen. 

Parameter dürfen auch mehrfach angegeben werden. Welcher Wert dann verwendet wird, richtet sich nach folgender Reihenfolge:

• Parameter in der HTML Seite ( hat Vorrang )
• Letzte angegebene Property - Datei
• ...
• Erste angegebene Property - Datei

Die Form der Parameter in Property - Dateien oder als Parameter im Applet Tag ist den gelieferten Beispieldateien zu entnehmen.

Nachfolgend eine Aufstellung aller relevanten Parameter.

Besonderheiten bei mehrfachem Einsatz / mehreren Lexasoft - Applets

Natürlich kann Sitemap grundsätzlich an unterschiedlichen Stellen in Ihrem Webauftritt eingesetzt werden. Ebenso ist eine Kombination mehrerer Lexasoft - Applets möglich. 

Aus diesem Grunde hat Lexasoft die Möglichkeit geschaffen, Parameter Ihrer Applets hierarchisch zu ordnen. Weiter oben wurde die Rangfolge der Auswertung bereits erläutert. Sie haben so die Möglichkeit, zentrale Eigenschaften aller Lexasoft Applets festzulegen. Dieses Feature wird auch Lexasoft Global Options genannt.

Sie sollten so vorgehen, dass Sie grundsätzlich sowohl das jar - File als auch die allgemeinen Properties ( lexasoft.properties ) nur einmal auf Ihrem Server halten und von den einbindenden HTML - Seiten darauf verweisen.

Die Datei lexasoft.properties definiert auch Parameter, die von Sitemap nicht verwendet werden. Diese können sie auskommentieren ( bzw. auskommentiert lassen ), falls Sie nur Sitemap einsetzen. 

Sie können diese Datei dazu benutzen, allgemeine Properties zu beschreiben, die default für alle Ihre Applets  gelten sollen. Damit können Sie diese perfekt an das Aussehen Ihrer Webseite anpassen.

Da alle URLs relativ zum Verzeichnis der einbindenden HTML - Seite angegeben werden, würden in lexasoft.properties getroffene Angaben zu Resourcen ( z.B. Hintergrundbild ) nicht immer funktionieren, da die einbindenden HTML - Seiten nicht immer im gleichen Verzeichnis stehen.

Deswegen kann mittels des Parameters "ResourceBase" ( nur als Parameter der einbindenden HTML - Seite ) ein spezielles Ressourcen - Verzeichnis angegeben werden. Diese wird vom Applet zusätzlich zum Verzeichnis der einbindenden HTML - Seite ausgewertet. URLs zu Bildern können dann sowohl relativ zu diesem Verzeichnis als auch relativ zum Verzeichnis der einbindenden HTML - Seite angegeben werden.

Die ResourceBase wird aber nur verwendet, wenn relativ zum Verzeichnis der HTML - Seite kein Bild gefunden wurde.

Beispiel:

/applets
  |
  + res
  |  + image1.gif
  + sitemap.jar  
/inhalt
  + sitemapseite.htm
  + image2.gif

In diesem Falle ist das Verzeichnis /applets/res/ als globales Ressourcenverzeichnis gedacht. Um dies zu erreichen, muss im Applet - Tag in sitemapseite.htm ( ausgehend vom eigenen Verzeichnis ) angegeben sein:

...
<param name="ResourceBase" value="../applets/res/.">
...

Um das Bild image1.gif als Hintergrundbild zu verwenden, definiert lexasoft.properties:

IMG_background : image1.gif

Anders ausgedrückt: Alle Applets, die einen analogen Verweis auf das Ressourcenverzeichnis erhalten und lexasoft.properties verwenden, benutzen image1.gif automatisch als Hintergrundbild.

Um, abweichend davon, das Bild image2.gif als Hintergrundbild zu verwenden, könnte in einer anderen ( später aufgeführten ) Property - Datei dieser Wert wie folgt überschrieben werden:

IMG_background : image2.gif

oder als Parameter im Applet - Tag:

...
<param name="IMG_background" value="image2.gif">
...

Dies ist möglich, weil die Ressourcen auch ausgehend vom Verzeichnis der einbindenden HTML - Seite aus angegeben werden dürfen.

Empfehlung: Verwenden Sie in lexasoft.properties nur Verweise relativ zum globalen Ressourcenverzeichnis. In den Property - Files der einzelnen Java - Applets bzw. in den Parametern, mit denen sie aufgerufen werden, verwenden Sie nur Verweise ausgehend vom Verzeichnis der einbindenden HTML - Seite.

Auf diese Weise nutzen Sie die flexible Ressourcenverwaltung der Lexasoft - Applets optimal aus.

Variablen in Lexasoft Global Options

Ab der Version Sitemap 2.1 sind die Lexasoft Global Options um die Möglichkeit von Variablen erweitert worden. Grundsätzlich kann auf alle Properties innerhalb von Propertyfiles als Variablen zugegriffen werden.

Sie kennzeichnen dies durch ein vorangestelltes $ - Zeichen.

Beispiel:

IMG_Warning : warning.gif

...

IMG_Hint : $IMG_Warning

Auch verschachtelte Variablen sowie das Mischen mit Klartext sind möglich:

IMG_Warning : $ResourceBase./warning.gif

...

IMG_Hint : $IMG_Warning

Folgende Hinweise sind jedoch zu beachten: 

• Die Deklaration und Verwendung von Variablen ist nur im Property - File, nicht als Parameter des  HTML - Tags, möglich.
• Auf jedes Property, das in einem Property - File deklariert wird, kann in Form einer Variablen wie oben beschrieben, zugegriffen werden.
• Zusätzlich werden folgende Systemvariablen bereitgestellt, die auch Werte beachten, die als Parameter im HTML - Tag mitgegeben werden:
  • $ResourceBase ( Basis für Ressourcen des Applets )
  • $DocumentBase ( Verzeichnis der HTML - Datei, aus der heraus das Applet gestartet wird )
  • $CodeBase ( Verzeichnis in dem die class - Dateien des Applets liegen, bei der Sitemap innerhalb des jar - Files ).

Zum Anfang

Anhang

Farbkodierungen

Farben in Lexasoft - Applets können als englische Farbbezeichnungen oder, wie in HTML Seiten üblich, in freier Codierung angegeben werden. Folgende Farbbezeichnungen sind zulässig:

• "#RRGGBB", wobei RR, GG und BB für Hexadezimalzahlen stehen, die den Rot, Grün bzw. Blauanteil der Farbe bedeuten. Diese Darstellung entspricht der Codierung in HTML, sodass in HTML - Seiten enthaltene Farbdefinitionen gleichbedeutend verwendet werden können.
• "black" - Standardfarbe schwarz
• "blue" - Standardfarbe blau
• "cyan" - Standardfarbe cyan
• "darkgray" - Standardfarbe dunkelgrau
• "gray" - Standardfarbe grau
• "green" - Standardfarbe grün
• "lightgray" - Standardfarbe hellgrau
• "magenta" - Standardfarbe magenta
• "orange" - Standardfarbe orange
• "pink" - Standardfarbe rosa
• "red" - Standardfarbe rot
• "white" - Standardfarbe weiß
• "yellow" - Standardfarbe gelb
• "bluegreen" - Standardfarbe blaugrün
• "ochre" - Standardfarbe ocker
• "darkblue" - Standardfarbe dunkelblau

Zum Anfang