zpub ist als Debian-Paket verfügbar, welches die Installation und Ersteinrichtung stark vereinfacht bzw. automatisiert. Ein Installationsskript für zpub-Instanzen (zpub-create-instance) ist ebenfalls vorhanden.
Einrichtung über das zpub-Debian-Paket:
Erweiterung der /etc/apt/sources.list um das private zpub-Repository:
deb http://zpub.de/debian/ ./
$ apt-get install zpub:
neuer Benutzer "zpub" wird erstellt und der Gruppe "www-data" hinzugefügt
ein vorhandener Apache-Webserver wird für zpub konfiguriert (ein neuer vhost wird erstellt)
$ zpub-create-instance Usage: /usr/sbin/zpub-create-instance name 'Full Name' zpub.domain.com where name: Directory name of the instance in /var/lib/zpub 'Full Name': Name as shown in the web interface zpub.domain.com: Hostname for this virtual host $ zpub-create-instance testzpublocal "test-zpub auf Localhost" zpub.localhost
Die neue zpub-Instanz "testzpublocal" ist nun angelegt.
Weitere Schritte sind beispielsweise:
style-Verzeichnis anpassen bzw. eigene Stylesheets hinterlegen
via htpasswd neue zpub-Benutzer anlegen
zpub-admin Benutzer anlegen
eventuell /etc/hosts anpassen
Apache neu starten, um die neue zpub-Instanz zu erreichen
zpub ist über den Browser erreichbar:
bspw.: https://zpub.localhost/ (Hostname wie bei zpub-create-instance (s.o.) angegeben)
zpub-Benutzer anlegen (hier: test):
htpasswd -b /var/lib/zpub/testzpublocal/settings/htpasswd test test
Datenverzeichnis anlegen
Datenverzeichnis mit Dokument-Verzeichnis(sen) füllen
svn: neues Dokumentverzeichnis dem SVN-Repository hinzufügen (svn add), Änderungen übertragen (svn ci)
zpub-Dokumente werden generiert und sind über das Webinterface, welche unter der oben definierten Domain läuft, abrufbar
/var/lib/zpub/ → enthält ein Verzeichnis je instanz
/var/lib/zpub/testzpublocal/conf/formats → Aktivierung/Deaktivierung der gewünschten Ausgabeformate
/var/lib/zpub/testzpublocal/conf/default_style → Standard-Stil (z.B.
draft)
/var/lib/zpub/testzpublocal/conf/final_style → Alternativ-Stil (z.b.
final)