zpub - für Debian paketiert

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:

  1. Erweiterung der /etc/apt/sources.list um das private zpub-Repository:

    deb http://zpub.de/debian/ ./
  2. $ 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)

  3. $ 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

  4. zpub ist über den Browser erreichbar:

    bspw.: https://zpub.localhost/ (Hostname wie bei zpub-create-instance (s.o.) angegeben)

  5. zpub-Benutzer anlegen (hier: test):

    htpasswd -b /var/lib/zpub/testzpublocal/settings/htpasswd test test

  6. Datenverzeichnis anlegen

  7. Datenverzeichnis mit Dokument-Verzeichnis(sen) füllen

  8. svn: neues Dokumentverzeichnis dem SVN-Repository hinzufügen (svn add), Änderungen übertragen (svn ci)

  9. zpub-Dokumente werden generiert und sind über das Webinterface, welche unter der oben definierten Domain läuft, abrufbar

Anmerkung

  • /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)