Diese Datei ist meine Dokumentation für das Projekt Eisenbahnseiten
und gibt technische Informationen über die Struktur der Bahnseiten.
Allgemeines:
-------------
Der Inhalt dieses Dokumentes wird in Seite project.html dargestellt,
einfachheitshalber in einer pre-Anweisung.
Alle html-Seiten werden generiert.
Zu jeder html-Seite gibt es eine Einstiegs-xml-Datei in der die zugehörige xsl-Datei
angegeben ist, die die html-Ansicht generiert.
Beschreibung der xml-Tags:
--------------------------
Die einzelnen Tags der xml-Dateien sind in "bahn.dtd" und "pagegroups.dtd" beschrieben.
Aufbau der html-Seite:
----------------------
Eine htlm-Seite ist in folgende Teile gegliedert:
1) Head-Bereich (Seitenautor, Favicon, Seitentitel)
2) Kopfbereich (Bild, Überschrift, Seitentitel, Navigationsleiste, Impressumslink,
Trennlinie zu Seiteninhalt)
3) Seiteninhalt
4) Fußbereich (Trennlinie zu Seiteninhalt, Copyrightjahr, Erstellungs- bzw. Änderungsdatum)
Die Templates für den Head-,Kopf- und Fußbereich sind in "libhomepage.xsl" definiert.
Styles:
-------
Es existiert ein zentrales Stylesheet "styles.css" für die Hauptseite und die Bahnseiten.
Seitentypen der Bahnseiten:
---------------------------
1) Haupt-Eisenbahn-Seite (bahn/index.html), die auf Übersichten verweist
2) Übersichtsseite Ereignisse (events.html),
d.h. Liste von Urlauben, Ausflügen, Eisenbahnfesten, Eisenbahnjubiläen, usw.
3) Einzelseite Ereignis
kurze Beschreibung des Ereignisses und Tabelle mit allen Photos des Ereignisses,
jeweils Vorschaubild und Info aus im Photo gespeicherten IPTC-Daten
4) Übersichtsseite Bahngesellschaften (companies.html)
5) Einzelseite Bahngesellschaft
kurze Beschreibung der Bahngesellschaft und Tabelle mit allen Photos der Bahngesellschaft,
jeweils Vorschaubild und Info aus im Photo gespeicherten IPTC-Daten
6) Übersichtsseite Länder
Listet alle Länder auf zu denen Bahngesellschaften vorhanden sind
7) Länderseite (companies.html)
Übersicht über Bahngesellschaften (wie 4) aber nach dem Land angeordnet
8) Übersichtsseite spezielle Bahnstrecken
9) bahn/construction/1bahnbau.html Übersichtsseite (oberste Seite) der Bahnbau/Bahndienstfahrzeug-Seiten
10) Hintergrundseiten (about.html, project.html)
Seiten, die Erläuterungen zum Projekt Eisenbahnseiten geben
Seitengruppen:
--------------
Die Seiten des Projekts sind in die verschiedene Gruppen eingeteilt werden.
1) Homepage
2) Startseite Bahnseiten
3) untergeordnete Bahnseiten
Die Seitengruppendatei "pagegroups.xml" enthält die variablen Daten die seitengruppenspezifisch
sind (Autor, Bild für Kopfbreich, Überschriftszeile, Copyrightjahr und Favicon).
xml-Einstiegs-Dateien:
----------------------
Die seitenspezifischen allgemeinen Daten sind in der Einstiegs-xml-Datei gespeichert
(Verweis auf Seitengruppe, Seitentitel, Elternseite, Navigationspfad zur Hauptseite,
Erstellungs- bzw. Änderungsdatum).
Die Ereignis- und Bahngesellschaftsseiten haben noch zusätzliche Tags.
Ereignis- und Bahngesellschafts-Einstiegs-xml-Dateien:
------------------------------------------------------
Diese Dateien werden aus der jeweiligen Excel-Datei durch ein VB-Programm erzeugt und
in den richtigen Ordner abgelegt (Ordner muß vorhanden sein, lokale Festplatte).
xml-Daten:
----------
Neben den xml-Einstiegsseiten-Daten, die allgemeine Seiteninfos liefern, gibt es noch
xml-Dateien, die Daten für den Seiteninhalt enthalten, sowie Hilfs-xml-Daten.
Diese Daten werden bei Bedarf in der xsl-Datei mit der xpath-Funktion document() eingelesen.
photosdata.xml
wird durch die Photodatenbank IMatch erzeugt.
Enthält alle Daten zu den Photos, die durch die Einzel-Ereignis- und -Bahngesellschafts-
Seiten benötigt werden.
companiesdata.xml
eventsdata.xml
countriesdata.xml
lines.xml
werden durch die jeweiligen Excel-Dateien durch ein VB-Programm erzeugt und enthalten
die Daten zu den Bahngesellschaften, Ereignissen, Bahnstrecken und Ländern.
Die Daten werden von den Übersichtsseiten und den Einzel-Seiten benötigt.
eventyears.xml
Hilfsdatei mit Jahreszahlen der Ereignisse.
Dient als Gruppierung der Ereignisse in der Übersichtsdatei.
companytypes.xml
Hilfsdatei mit Bahngesellschaftstypen.
Mit den Typen werden die Bahngesellschaften auf der Übersichtsseite gruppiert.
construction/1bahnbau.html
Oberste Seite der Bahnbau/Bahndienstfahrzeug-Seiten, untegeordnete Seiten sind im gleichen
Verzeichnis. Die Zahl im Dateinamen gibt die entsprechende Ebene an.
xsl-Transformation:
-------------------
Die xml-Dateien können im Internet direkt aufgerufen werden. Die Transformation zu html
erfolgt mittels der zugeordneten xsl-Dateien. Dies funktioniert mit den getesteten Browsern.
Bei der Entwicklung der Homepage auf dem lokalen Rechner macht Firefox Probleme
(Update 2015: gilt auch heute noch).
Er zeigt Seiten, die Verweise auf eine Datei die in einem höheren Verzeichnis als dem aktuellen
liegt nicht an. Es kommt eine Fehlermeldung.
Übersicht über die Ordnerstruktur und Dateien:
----------------------------------------------
Im Verzeichnis "bahn/companies" werden die Bahngesellschaften nach Gesellschaftstypen
in Unterverzeichnissen gespeichert, um die Anzahl der Bahngesellschaften nicht zu groß
werden zu lassen. Eine weitere Gruppierung z.B. nach Anfangsbuchstaben "A"-"Z" wurde
wieder fallen gelassen.
Im Verzeichnis "bahn/events" werden die Ereignisse nach Jahren gruppiert, um die Anzahl der
Ereignisse nicht zu groß werden zu lassen.
Im Verzeichnis "bahn/lines" werden die Bahnstreckenseiten gespeichert.
Im Verzeichnis "bahn/countries" werden die Länderseiten gespeichert.
Die Gruppierung nach Jahren gilt auch für das Photo- und Vorschaubilder-Verzeichnis.
home
|
|-- index.html Gemeinsame Hauptseite für Flora- und Eisenbahnseiten
|-- index_gen.xml
|-- index_gen.xsl
|
|-- impressum.html Impressumsseite
|-- impressum.xml
|-- impressum.xsl
|
|-- pagegroups.xml Daten für Seitengruppen
|-- pagegroups.dtd
|
|-- styles.css Gemeinsame CSS-Datei
|
|-- kaelib1.xsl Allgemeine Templates
|-- libhomepage2.xsl Templates für Kopf- und Fußbereich der Seiten
|
|
+-- bahn Ordner für Eisenbahnseiten
| |
| |-- main.html Hauptseite Eisenbahnseiten
| |-- main.xml
| |-- main.xsl
| |
| |-- companies.html Übersichtsseite Bahngesellschaften
| |-- companies.xml
| |-- companies.xsl
| |-- companiesdata.xls Daten für Übersichtsseite Bahngesellschaften
| |-- companytypes.xml Hilfetabelle Bahngesellschaftstypen
| |-- company.xsl Gemeinsame xsl-Datei für einzelne Bahngesllschaftsseiten
| |
| |-- events.html Übersichtsseite Ereignisse
| |-- events.xml
| |-- events.xsl
| |-- eventsdata.xml Daten für Übersichtsseite Ereignisse
| |-- eventyears.xml Hilfetabelle mit Jahren der Ereignisse
| |-- event.xsl gemeinsame xsl-Datei für einzelnes Ereignis
| |
| |-- lines.html Übersichtsseite Bahnstrecken
| |-- lines.xml
| |-- lines.xsl
| |-- linesdata.xml Daten für Übersichtsseite Bahnstrecken
| |-- line.xsl gemeinsame xsl-Datei für Bahnstreckenseiten
| |
| |-- countries.html Übersichtsseite Länder
| |-- countries.xml
| |-- countries.xsl
| |-- countriesdata.xml Daten für Übersichtsseite Länder
| |-- country.xsl gemeinsame xsl-Datei für Landseiten
| |
| |-- photosdata.xml Daten der Photos
| |
| |-- about.html Seite mit Hintergründen zu den Bahnseiten
| |-- about.xml
| |-- about.xsl
| |
| |-- history.html Erstellungshistorie der Seiten
| |-- history.xml
| |-- history.xsl
| |
| |-- project.html Diese Seite
| |-- project.xml
| |-- project.xsl
| |
| |-- common2.xsl Templates zu den Bahnseiten
| |
| |-- bahn.dtd Datendefinition der Bahnseiten
| |
| |
| +-- companies Ordner für Bahngesellschaften
| | | (enthält keine Dateien nur Ordner)
| | |
| | +-- bahnbau Ordner für Bahngesellschaften vom Typ "bahnbau"
| | | |
| | | |-- gesellschaftxxx.html Seite für einzelne Bahngesellschaft
| | | /-- gesellschaftxxx.xml
| | |
| | +-- bahngesellschaft Ordner für Bahngesellschaften vom Typ "bahngesellschaft"
| | |
| | +-- hersteller Ordner für Bahngesellschaften vom Typ "hersteller"
| | |
| | +-- museum(sbahn),verein Ordner für Bahngesellschaften vom Typ "museum(sbahn),verein"
| | |
| | +-- sonstige Ordner für Bahngesellschaften vom Typ "sonstige"
| | |
| | +-- standseilbahn Ordner für Bahngesellschaften vom Typ "standseilbahn"
| | |
| | /- werksbahn Ordner für Bahngesellschaften vom Typ "werksbahn"
| |
| |
| |-- countries Ordner für Länder
| | |
| | +-- land.html Einzelseite für Land
| | /-- land.xml
| |
| |
| |-- lines Ordner für Bahnstrecken
| | |
| | +-- line.html Einzelseite für Bahnstrecke
| | /-- line.xml
| |
| |
| +-- events Ordner für Ereignis
| | | (enthält keine Dateien nur Ordner)
| | |
| | +-- 2002 Ereignisse des Jahres 2002
| | | |
| | | |-- ereignisxxx.html Seite für einzelnes Ereignis
| | | /-- ereignisxxx.xml
| | |
| | +-- 2003 Ereignisse des Jahres 2003
| | |
| | /-- ... usw.
| |
| |-- construction Ordner für Bahnbau/Bahndienstfahrzeug-Seiten
| | |
| | +-- kategorie.html Einzelseite für Bahnbau/Bahndienstfahrzeug-Kategorie
| | /-- kategorie.xml
| |
| +-- photos Ordner für Photos
| | | (enthält keine Dateien nur Ordner)
| | |
| | +-- 2002 Ordner für Photos des Jahres 2002
| | | |
| | | /-- cjjjjmmtt_xxx.jpg einzelnes Photo
| | |
| | +-- 2003 Ordner für Photos des Jahres 2003
| | |
| | /-- ... usw.
| |
| |
| +-- thumbnails Ordner für Vorschaubilder
| | | (enthält keine Dateien nur Ordner)
| | |
| | +-- 2002 Ordner für Vorschaubilder der Photos des Jahres 2002
| | | |
| | | /-- tjjjjmmtt_xxx.jpg einzelnes Vorschaubild
| | |
| | +-- 2003 Ordner für Vorschaubilder der Photos des Jahres 2003
| | |
| | /-- ... usw.
| |
| |
| /-- img Ordner für spezielle Bilder der Bahnseiten
| (enthält diverse Grafik-Dateien)
|
|
/-- img Ordner für allgemeine Bilder der Homepage
| (enthält diverse gif- und jpg-Dateien)
|
+-- b Ordner für allgemeine Bilder
| (blauer Hintergrund, enthält diverse gif-Dateien)
|
/-- g Ordner für allgemeine Bilder
(grüner Hintergrund, enthält diverse gif-Dateien)