FAQ-Verwaltung mit Perl - v1.0

Auf dieser Seite möchte ich kurz meine FAQ-Verwaltung vorstellen, die ich in Perl programmiert habe.
Das ganze ist durch meine Mitarbeit im Bürgernetz entstanden. Wir hatten da ein paar FAQ-Seiten, aber die Verwaltung von diesen war ziemlich mühsam, da immer direkt in den HTML-Seiten programmiert werden mußte. Also habe ich mich eines Tages hingesetzt und einfach zwei kleine Perl-Skripts zusammengeschustert, mit denen man das ganze etwas komfortabler handhaben kann.

Eine lauffähige Version dieser Skripte kannst Du Dir hier ansehen: FAQs Bürgernetz Dillingen.

Ich wünsche allen viel Spaß mit diesem kleinen Paket. Anregungen, Kritik, Änderungen etc. bitte an jonny@bndlg.de

[ Übersicht - Installation - Download - Copyright ]

Kurze Übersicht:

Man hat ein beliebiges Root-Verzeichnis für seine FAQs
dort legt man für jede Kategorie ein Unterverzeichnis an
dort kommen dann die einzelnen Abschnitte rein und zwar als einfache Text-Files, in denen natürlich auch beliebige HTML-Kommandos stecken können. Der Aufbau dieser Dateien ist sehr einfach:

1. Zeile: Frage, die beantwortet wird, diese taucht auch in der Übersicht auf
2. Zeile: eine Leerzeile zur Abtrennung
3. Zeile: ab hier kommt der Text, der beliebig lange sein kann

Header und Footer der WWW-Seiten können jeweils über eigene Dateien eingestellt werden.

Installationsanleitung + Hinweise:

Downloaden der gepackten Tar-Datei
Auswahl eines Zielverzeichnisses, das übers WEB erreichbar ist (entweder direkt im htdocs-Baum, oder per Alias im Server)
dort bitte die Datei entpacken
Editieren der Datei index.cgi (Haupt-Skript). Dort sind folgende Einträge von Bedeutung:

rootdir: Bitte setzen auf Installationsverzeichnis
dirs: Bitte alle FAQ-Unterverzeichnisse hier eingeben
title: Titel der HTML-Seite
back: Background-Image der HTML-Seite
BULLET_GIF: Bullet, das vor jedem Link angezeigt werden soll

Anpassen des Headers & des Footers: Dateien header.html u. footer.html (können bei Bedarf auch in index.cgi geändert werden)
Editieren der Datei hindex.cgi (Skript für die einzelnen Unterverzeichnisse). Dort sind folgende Einträge anzupassen:

rootdir: gleiches wie in index.cgi
title: Titel der Seiten
back: Background der Seiten
FZ_GIF: Icon, daß vor jeder Frage angezeigt werden soll. Standard ist ein Fragezeichen
AZ_GIF: Icon, daß vor jeder Antwort angezeigt werden soll. Standard ist ein Ausrufezeichen

Testen der Skripte. Im WWW-Server sollte eingetragen sein, daß Dateien mit der Endung .cgi als CGI-Skripte ausführbar sind. Ansonten muß man die CGI-Skripte in das cgi-bin des Servers kopieren und evtl. noch ein paar Pfade anpassen.
Anlegen von eigenen FAQ-Seiten

Download

Die gepackte Version des Programms kann man sich hier holen: faqperl.tgz (52kB)
Für Windows habe ich noch eine zweite Ausgabe zusammengestellt, da manche Browser beim Download von tgz-Dateien Probleme haben: faqperl.zip

Das ganze ist ein kleiner Teil der FAQ-Seiten vom Bürgernetz Dillingen mit den dort verwendeten HTML-Headern&Footern und den GIFs.

Copyright

Das Programm ist frei verfügbar. Anpassungen dürfen selbstverständlich vorgenommen werden. Allerdings sollte ein Link (z.b. in Form einer E-Mail-Addresse) auf mich enthalten sein. Wenn jemand Veränderungen vornimmt, würde ich mich freuen, wenn er sie mir zukommen läßt und ich würde das hier auch mit auf die Page aufnehmen...