Beschreibung der .smg-Datei
Zweck:
Die Dateien mit der Endung .smg enthalten alle Einstellungen, die in SMG für die Sitemap getroffen wurden.
Anmerkungen:
Wo die .smg-Dateien liegen, spielt keine Rolle, da der Pfad in der smg.ini abgespeichert wird. Eine beliebige .smg-Datei kann auch im Fenster "Einstellungen" geladen werden.
Wird eine neue .smg-Datei geladen, so werden alle Werte entsprechend der Einträge in der Datei neu gesetzt. Einige Werte werden auf ihre Plausibilität geprüft und nur dann gesetzt, wenn der Eintrag als gültig erkannt wird.
Da die .smg-Dateien von SMG erzeugt werden, ist es normalerweise nicht erforderlich, eine solche Datei manuell zu ändern.
Ich habe zwar versucht, den Parser für die .smg-Datei robust zu gestalten, kann aber nicht ausschließen, daß es zu unerwartetem Effekten kommt, wenn ungültige Werte in einer .smg-Datei stehen.
Es ist leider noch nicht möglich, auf dem Desktop eine .smg-Datei anzuklicken, um damit SMG mit den Einstellungen in der angeklickten Datei zu starten.
Beispiel für eine .smg-Datei
---
smg.smg
<site>Ingolf</site>
<arbeitsverzeichnis>Macintosh HD:Users:ingolfhelmes:Sites:ingolf:</arbeitsverzeichnis>
<vorlagedatei>Macintosh HD:Users:ingolfhelmes:Sites:Sitemapvorlagen:Ingolf Sitemapvorlage.html</vorlagedatei>
<sitemapverzeichnis>Macintosh HD:Users:ingolfhelmes:Sites:ingolf:links:</sitemapverzeichnis>
<einfügemarke><!--sitemap--></einfügemarke>
<datummarke><!--datum--></datummarke>
<zeilenende>mac</zeilenende>
<einfüge_titel>ja</einfüge_titel>
<einfüge_datum>ja</einfüge_datum>
<einfüge_dateiname>nein</einfüge_dateiname>
<format>tabelle</format>
<tabelle_rand>0</tabelle_rand>
<tabelle_einheit>prozent</tabelle_einheit>
<tabelle_prozent>100</tabelle_prozent>
<tabelle_pixel>400</tabelle_pixel>
<titel_format>fett</titel_format>
<dateiname_format></dateiname_format>
<datum_format>small</datum_format>
---
Erklärung des Beispiels:
In der ersten Zeile steht die Dateikennung. Wenn die ersten sieben Zeichen der Datei nicht "smg.smg" lauten, wird die Datei als ungültig betrachtet und nicht ausgewertet.
In dieser Datei werden Pseudo-Tags verwendet, um die Einträge zu kennzeichnen.
Es ist egal, an welcher Stelle in der Datei ein Eintrag steht. SMG schreibt die Einträge in der Reihenfolge, wie sie im Beispiel zu sehen ist.
Erklärung der Pseudo-Tags:
Jedes Pseudo-Tag besteht aus einem Anfangs-Tag (<x>) und einem End-Tag (</x>), welche den Eintrag umschließen.
Im Folgenden wird nur das Anfangs-Tag gezeigt.
<site>
Dies ist der Name, unter dem die Einstellungen im Eingabefeld des Einstellungsfensters benannt wurden. Dieser Name wird im Hauptfenster von SMG angezeigt, damit man sieht, welche Einstellungen geladen sind.
Gültiger Wert: Ein beliebiger Name.
Beispiel: <site>Ingolf</site>
<arbeitsverzeichnis>
Hier steht der komplette Pfad zu dem Verzeichnis, in dem die zu indizierenden HTML-Dateien liegen. Das ist also der Ordner Ihrer Web-Site.
Gültiger Wert: Kompletter Pfad zu einem Verzeichnis.
Beispiel: <arbeitsverzeichnis>Macintosh HD:Users:ingolfhelmes:Sites:ingolf:</arbeitsverzeichnis>
Anmerkung: Man beachte den Abschließenden Doppelpunkt, da es sich um einen Verzeichnispfad handelt.
<vorlagedatei>
Hier steht der komplette Pfad zu einer Vorlagedatei. Das ist die Datei, in welche die Sitemap eingefügt wird.
Gültiger Wert: Kompletter Pfad zu einer HTML-Datei.
Beispiel: <vorlagedatei>Macintosh HD:Users:ingolfhelmes:Sites:Sitemapvorlagen:Ingolf Sitemapvorlage.html</vorlagedatei>
Anmerkung: Die Datei heißt: "Ingolf Sitemapvorlage.html"
<sitemapverzeichnis>
Hier steht der komplette Pfad zu dem Verzeichnis, in dem die Sitemap angelegt werden soll.
Gültiger Wert: Kompletter Pfad zu einem Verzeichnis.
Beispiel: <sitemapverzeichnis>Macintosh HD:Users:ingolfhelmes:Sites:ingolf:links:</sitemapverzeichnis>
Anmerkung: Man beachte den Abschließenden Doppelpunkt, da es sich um einen Verzeichnispfad handelt.
<einfügemarke>
Die Einfügemarke ist ein Platzhalter. An dieser Stelle wird die Sitemap in die Vorlagedatei eingefügt. Standardmäßig sieht die Einfügemarke so aus: <!--sitemap-->. Falls Sie es für nötig halten, können Sie die Einfügemarke im Einstellungsfenster von SMG ändern.
Gültiger Wert: Eine eindeutige Bezeichnung.
Beispiel: <einfügemarke><!--sitemap--></einfügemarke>
<datummarke>
Die Datummarke ist ein Platzhalter. An dieser Stelle wird das Erstellungsdatum der Sitemap in die Vorlagedatei eingefügt. Standardmäßig sieht die Datummarke so aus: <!--datum-->. Falls Sie es für nötig halten, können Sie die Datummarke im Einstellungsfenster von SMG ändern.
Gültiger Wert: Eine eindeutige Bezeichnung.
Beispiel: <datummarke><!--datum--></datummarke>
<zeilenende>
Hier wird festgelegt, mit welchen Zeilenenden die Sitemap geschrieben werden soll. Es gibt drei Möglichkeiten: Mac (ASCII 13), Unix (ASCII 10) und PC (ASCII 13,10)
Gültiger Wert: mac oder unix oder pc
Beispiel: <zeilenende>mac</zeilenende>
<einfüge_titel>
Dieses Schlüsselwort wird zur Zeit noch ignoriert. Es legt fest, ob der Titel der Seite in die Sitemap eingefügt werden soll. Egal, was Sie hier eintragen, der Titel wird immer in die Sitemap eingefügt.
Gültiger Wert: ja oder nein
Beispiel: <einfüge_titel>ja</einfüge_titel>
<einfüge_datum>
Hier wird festgelegt, ob das Änderungsdatum der Seite in die Sitemap eingefügt werden soll.
Gültiger Wert: ja oder nein
Beispiel: <einfüge_datum>ja</einfüge_datum>
Anmerkung: Es handelt sich um das Änderungsdatum der Datei, gibt also nicht unbedingt das Datum einer inhaltliche Änderung an.
<einfüge_dateiname>
Hier wird festgelegt, ob der Dateiname der Seite in die Sitemap eingefügt werden soll.
Gültiger Wert: ja oder nein
Beispiel: <einfüge_dateiname>nein</einfüge_dateiname>
<format>
Das Format, in dem die Sitemap erstellt werden soll. Zur Zeit gibt es zwei Möglichkeiten, die Sitemap zu formatieren: Als Liste oder als Tabelle.
Gültiger Wert: liste oder tabelle
Beispiel: <format>tabelle</format>
<tabelle_rand>
Falls die Sitemap als Tabelle formatiert werden soll, wird hiermit die Breite der Gitternetzlinien der Tabelle festgelegt.
Gültige Werte: 0 oder 1 oder 2
Beispiel: <tabelle_rand>0</tabelle_rand>
<tabelle_einheit>
Hiermit wird die Einheit für die Tabellenbreite der Sitemap festgelegt. Diese Einstellung wird nur dann beachtet, wenn die Sitemap als Tabelle formatiert wird. Es gibt drei gültige Werte:
1. Automatisch: Die Tabelle wird vom Browser so breit formatiert, wie es das breiteste Element in der Tabelle erfordert. Das ist die geringstmögliche Breite der Tabelle.
2. Prozent: Der Prozentwert gibt die Breite der Tabelle relativ zum nächsten übergeordneten Objekt an. Das kann entweder die Fensterbreite oder die Spaltenbreite einer übergeordneten Tabelle sein.
3. Pixel: Hiermit kann man die absolute Breite der Tabelle in Pixeln angeben.
Gültige Werte: automatisch oder pixel oder prozent
Beispiel:<tabelle_einheit>prozent</tabelle_einheit>
<tabelle_prozent>
Falls als Einheit für die Tabellenbreite Prozent gewählt wurde, wird dieser Wert für die Prozentuale Tabellenbreite genommen.
Gültige Werte: Zahlen zwischen 1 und 100.
Beispiel: <tabelle_prozent>100</tabelle_prozent>
<tabelle_pixel>
Falls als Einheit für die Tabellenbreite Pixel gewählt wurde, wird dieser Wert für die Breite der Tabelle in Pixeln genommen.
Gültige Werte: Zahlen zwischen 1 und einer vernüftigen Größe.
Beispiel: <tabelle_pixel>400</tabelle_pixel>
<titel_format>
Hiermit wird bestimmt, wie der Titel einer indizierten Seite in der Sitemap formatiert werden soll. Hierbei können mehrere Attribute kombiniert werden. Das Attribut normal schließt alle anderen Attribute aus. Small kann nicht mit big kombiniert werden, da das unsinnig ist.
Gültige Werte: normal und/oder fett und/oder kursiv und/oder small oder big
Anmerkung: Wenn mehrere Attribute verwendet werden, werden diese durch ein Komma getrennt.
<dateiname_format>
Hier gilt das Gleiche wie für <titel_format>.
<datum_format>
Hier gilt das Gleiche wie für <titel_format>.
|