evallogs
[ --verbose
| --no_verbose
] [ --overwrite
| --no_overwrite
]
[ --datadir
DATADIR
] [ --newlogdir
NEWLOGDIR
] [ --evlogdir
EVLOGDIR
]
[ --docroot
DOCROOT
] [ --favdir
FAVDIR
]
[ --srcbase
SRCBASE
] [ --srcdir
SRCDIR
] [ --pooldir
POOLDIR
]
[ --trlang
TRLANG
] [ --srclang
SRCLANG
]
[ --ptnstory
PTNSTORY
] [ --ptnlang
PTNLANG
] [ --ptniix
PTNIIX
]
[ --undo
--eval
--reduce
--xslt
--xhtml
--langs
--titles
--upload
]
| [ --no_undo
--no_eval
--no_reduce
--no_xslt
--no_xhtml
--no_langs
--no_titles
--no_upload
]
--help
Gibt eine kurze Hilfe aus und zeigt die aktuellen Einstellungen an.
--version
Gibt kurze Hinweise zum Programm und die Version aus.
--verbose
Meldungen über den Programmablauf werden nach STDOUT ausgegeben.
--no_verbose
Diese Option hebt die Wirkung der Option --verbose
auf.
--overwrite
Existierende Dateien werden überschrieben.
--no_overwrite
Diese Option hebt die Wirkung der Option --overwrite
auf: existierende Dateien bleiben erhalten.
--datadir
DATADIR
Im Verzeichnis DATADIR
liegen die Ergebnisse der Auswertung der Log-Dateien. TIMESTAMP
bezeichnet die Zeit der Auswertung, siehe logs.pl
(Quelltext) und sums.pl
(Quelltext). visits.rng
beschreibt die XML-Elemente.
open.xml.TIMESTAMP
Die noch nicht beendeten Besuche.
finished.xml.TIMESTAMP
Die aufgeschlüsselten Zahlen der Besuche, deren Abschluss aus den ausgewerteten Log-Dateien hervorgeht.
detailed.xml.TIMESTAMP
Einzelheiten der abgeschlossenen Besuche.
visits.xml.TIMESTAMP
Die aufgeschlüsselten Zahlen aller bisherigen abgeschlossenen Besuche einschließlich der Besuche, die in der Datei finished.xml.
gezählt sind.TIMESTAMP
--newlogdir
NEWLOGDIR
Das Verzeichnis NEWLOGDIR
enthält die gzip-komprimierten Logdateien, die noch nicht ausgewertet sind.
--evlogdir
EVLOGDIR
Nachdem eine Logdatei ausgewertet worden ist und die Auswertung einen „echten” Besuch ergeben hat, wird die Datei aus dem Verzeichnis NEWLOGDIR
in das Verzeichnis EVLOGDIR
verschoben.
--docroot
DOCROOT
Wurzelverzeichnis der Webserver-Daten („document root”).
--favdir
FAVDIR
Unterverzeichnis von DOCROOT
, das die Daten zur Präsentation der Auswertung enthält.
--srcbase
SRCBASE
Basis-Verzeichnis der Skripte zur Website.
--srcdir
SRCDIR
Verzeichnis der Skripte im Zusammenhang mit der Auswertung der Logdateien und der Präsentation der Ergebnisse: die meistbesuchten Bildergeschichten, Bilder und Sprachen.
--pooldir
POOLDIR
Das Verzeichnis POOLDIR
enthält XSLT-Dateien, die an verschiedenen Stellen genutzt werden. Hier wird die Datei
benutzt.POOL
/xml_minimize.xslt
--trlang
TRLANG
TRLANG
ist eine durch Leerzeichen getrennte Liste der Kennungen (LANG
) der Sprachen, für die eine Datei
mit den Titeln zu den Ergebnissen der Auswertung erstellt wird. „Titel” sind hier die Titel der Bildergeschichten und der Bilder und die Bezeichnungen der Sprachen.FAVDIR
/t.xml.LANG
--srclang
SRCLANG
SRCLANG
ist die Kennung der Quellsprache (de
, Deutsch). Die Dateien
aller anderen Sprachen werden als maschinelle Übersetzung aus dieser Sprache gekennzeichnet, s. FAVDIR
/t.xml.LANG
vis_titles.xslt
(Text).
--ptnstory
PTNSTORY
PTNSTORY
ist das Muster des (absoluten) Dateipfades einer Bildergeschichte in einer bestimmten Sprache mit den Platzhaltern ${storyid}
für die Kennung der Bildergeschichte und ${lang}
für die Kennung der Sprache. Aus diesen Dateien werden die Titel der Bildergeschichten und Bilder zusammengestellt.
--ptnlang
PTNLANG
PTNLANG
ist das Muster des (absoluten) Dateipfades einer XHTML-Datei, die die Bezeichnungen aller verfügbaren Sprachen enthält. Der Platzhalter ${lang}
steht für die Kennung der Sprache.
--ptniix
PTNIIX
PTNIIX
ist das Muster des (absoluten) Dateipfades einer Bildbewertungsdatei mit dem Platzhalter ${storyid}
für die einer Bildergeschichte. Die Datei wird benutzt, um ein geeignetes Bild zu wählen, das zum Titel einer Bildergeschichte angezeigt wird.
--undo
Diese Aktion wird nur ausgeführt, wenn die Befehlszeile die Option --undo
enthält. Die letzte Auswertung wird rückgängig gemacht. Dazu müssen die folgenden Bedingungen erfüllt sein:
DATADIR
/visits.xml
ist ein symbolischer Verweis auf eine Datei DATADIR
/vivits.xml.TIMESTAMP
DATADIR
/detailed.xml.TIMESTAMP
und DATADIR
/finished.xml.TIMESTAMP
existieren.DATADIR
/detailed.xml.TIMESTAMP
aufgeführten Log-Dateien existieren im Verzeichnis EVLOGDIR
.DATADIR
/visits.xml.OLDTIME
, die älter ist als DATADIR
/visits.xml.TIMESTAMP
. OLDTIME
bezeichnet im Folgenden den Zeitstempel der neuesten solcher Dateien.DATADIR
/detailed.xml.OLDTIME
und DATADIR
/finished.xml.OLDTIME
existieren.Wenn alle Voraussetzungen erfüllt sind, geschieht Folgendes:
DATADIR
/detailed.xml.TIMESTAMP
aufgeführten Log-Dateien werden aus dem Verzeichnis EVLOGDIR
in das Verzeichnis NEWLOGDIR
verschoben.DATADIR
/visits.xml
und die Datei DATADIR
/visits.xml.TIMESTAMP
werden gelöscht. Es wird der neue symbolische Verweis DATADIR
/visits.xml
auf die Datei DATADIR
/visits.xml.OLDTIME
angelegt.Falls der symbolische Verweis
existiert, wird er gelöscht.DATADIR
/open.xml
Falls die gewöhnliche Datei
existiert, wird sie gelöscht.DATADIR
/open.xml.TIMESTAMP
Falls die gewöhnliche Datei
existiert, wird der neue symbolische Verweis DATADIR
/open.xml.OLDTIME
auf sie angelegt.DATADIR
/open.xml
DATADIR
/detailed.xml.TIMESTAMP
und DATADIR
/finished.xml.TIMESTAMP
werden gelöscht.--eval
Die Logdateien im Verzeichnis NEWLOGDIR
werden ausgewertet. Wenn die Auswertung einen neuen abgeschlossenen Besuch ergibt, werden im Verzeichnis DATADIR
die Dateien finished.xml.
, TIMESTAMP
detailed.xml.
und TIMESTAMP
visits.xml.
erstellt sowie der symbolische Verweis TIMESTAMP
visits.xml
auf die Datei visits.xml.
. Wenn ein Besuch nach dem letzten protokollierten Zugriff noch nicht abgeschlossen ist, wird auch die Datei TIMESTAMP
open.xml.
und der symbolische Verweis TIMESTAMP
open.xml
auf diese Datei erstellt. Die ausgewerteten Logdateien werden in das Verzeichnis EVLOGDIR
verschoben.
Wenn die Auswertung keinen neuen abgeschlossenen Besuch ergibt, endet die Ausführung dieses Skripts.
--reduce
Zur Präsentation im Web werden die Zahlen aus der Datei visits.xml
zu allen Bildergeschichten und allen besuchten Bildern und Sprachen beschränkt auf die meistbesuchten Bildergeschichten, Bilder und Sprachen und die am wenigsten besuchten Bildergeschichten. Außerdem werden kurze Elementnamen aus nur einem Zeichen verwendet, s. vis.rng
. Das Ergebnis ist die Datei
.FAVDIR
/f.xml
--xslt
Aus der Datei v.xslt
(Text) im Verzeichnis SRCDIR
werden Kommentare und unnötige Leerzeichen entfernt. Das Ergebnis ist die Datei
. Diese Aktion wird nur ausgeführt, wenn die Befehlszeile die Option FAVDIR
/v.xslt--xslt
enthält.
--xhtml
In die Dateien h.xhtml.de
(Startseite der Präsentation der Auswertung), i.xhtml.de
(die meistbesuchten Bilder), l.xhtml.de
(die meistgefragten Sprachen), s.xhtml.de
(die meistbesuchten Bildergeschichten) und u.xhtml.de
(die am wenigsten besuchten Bildergeschichten) wird die Kennung der Sprache eingefügt. Unnötige Leerzeichen werden entfernt. Das Ergebnis sind die gleichnamigen Dateien im Verzeichnis FAVDIR
. Diese Aktion wird nur ausgeführt, wenn die Befehlszeile die Option --xhtml
enthält.
--langs
Die Titel der Bilder und der Bildergeschichten in den verschiedenen Sprachen werden aus den Bildergeschichten entnommen. Die Bezeichnungen der Sprachen müssen aus einer anderen Quelle kommen. Die Datei
enthält die deutschen Bezeichnungen der Sprachen. Diese wird maschinell in die anderen Sprachen übersetzt. Auch diese Aktion wird nur ausgeführt, wenn die Befehlszeile die Option DATADIR
/langs/langs.xhtml.de--langs
enthält.
--titles
Zu den in der Datei
aufgeführten Bildergeschichten, Bildern und Sprachen werden die Titel in den Sprachen FAVDIR
/f.xmlTRLANG
zusammengestellt. Das Ergebnis sind die Dateien
.FAVDIR
/t.xml.LANG
--upload
Die Dateien
und FAVDIR
/f.xml
werden in der unkomprimierten und in der gzip-komprimierten Version hochgeladen.FAVDIR
/t.xml.LANG
--no_*
Wenn keine der „Aktionsoptionen” --undo
, --eval
, --reduce
, --xslt
, --xhtml
, --langs
, --titles
, --upload
genutzt wird, können die Optionen mit dem Präfix no_
" (--no_undo
, --no_eval
, t--no_reduce
, --no_xslt
, --no_xhtml
, --no_langs
, --no_titles
und --no_upload
) genutzt werden. Diese schließen die zugehörige Aktion aus. Die nicht ausgeschlossenen Aktionen werden ausgeführt.
Das Skript evallogs
unterstützt die Auswertung der Logdateien und die Präsentation der Ergebnisse der Auswertung auf der Website.