Eisenbahnphotos von K. Kämpfe
Projektbeschreibung

Navigation: Home  >  Eisenbahnphotos  >  Über  >  Projektbeschreibung Impressum  Datenschutz  
Linie

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)

          
Linie
Copyright © 2009-2024 Erstellt/Geändert: 2016-02-28