zpub – Zentrales Publikationssystem

Technische Dokumentation

Joachim Breitner

Thomas Breitner

zpub-Version 0.6.2-15-g67911bd

2016


Inhaltsverzeichnis

Versionshistorie
Version 0.6.2
Version 0.6.1
Version 0.6
Version 0.5
Version 0.4
Version 0.3
Version 0.2
Systemvoraussetzungen
zpub - für Debian paketiert
Verzeichnisstruktur
Zusammenspiel der Komponenten
Erstellung einer neuen Dokumenten-Revsion
Aufbau der Stile
Übersetzung
Authentifizierung und Authentisierung
LDAP
Single sign-on (Kerberos)

Versionshistorie

Version 0.6.2

Veröffentlicht am 7.2.2016

  • Packaging improvements

Version 0.6.1

Veröffentlicht am 20.5.2015

  • Compatibility with Debian jessie

Version 0.6

Veröffentlicht am 7.9.2013

  • Bugfix: Die Datei /opt/zpub/demo/cache/documents spiegelt jetzt stets den neusten Revisionsstand wieder; nicht den der zuletzt gebauten Dokumentrevision (welcher älter sein kann).

  • In der Datei /opt/zpub/demo/conf/logo.png kann ein Logo hinterlegt werden. (Dazu muss die Apache-Konfiguration angepasst werden.)

  • Bugfix: Dateien, die im Grundverzeichnis des SVN-Repositories angelegt werden, stoßen keine Dokumenten-Bau-Jobs an.

  • Es gibt jetzt eine Testsuite für zpub.

  • Der Pfad /opt/zpub/demo/output/archive/document/latest ist jetzt ein Verzeichnis, das pro Stil einen symbolischen Link auf die letzte Revision mit diesem Stil enthält.

  • Es ist jetzt möglich, im Verzeichnis common Dateien (Bilder und Dokumentfragmente) direkt in den Dokumenten zu verwenden. zpub erkennt bei Änderungen an diesen Dateien, welche Dokumente von der Änderung betroffen sind und baut nur jene Dokumente neu. Dieses Feature wurde per Crowdfunding finanziert:

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" \
        href="../common/fragment.xml" />
  • Bei der Erstellung der HTML-Ausgabe werden wirklich nur verwendete Bilder kopiert, und die Dokumenterstellung schlägt fehl, wenn nicht alle referenzierten Bilder gefunden werden können.

Version 0.5

7.11.2012

  • Dokumente, die nicht mehr im Subversion-Repository liegen, werden auch nicht mehr in der Web-Oberfläche angezeigt.

  • Die zpub-Dokumentation wird jetzt mit installiert und kann mit zpub-update-docs.sh in eine Instanz eingefügt bzw. darin aktualisiert werden. Dabei wird in der Dokumentations der zur Instanz gehörende Instanz- und Hostname eingefügt.

  • Diese Versionshistorie.

Version 0.4

Veröffentlicht am 10.2.2012

  • Ab dieser Version kann man auch mehrere zpub-Instanzen auf dem selben virtuellen Host unterbringen, da eine Instanz auch in einem Unterverzeichnis des URL-Adressraumes eingerichtet werden kann.

  • Es können mehrere Ausgabevarianten („styles“) gleichzeitig konfiguriert werden.

Version 0.3

Veröffentlicht am 2.1.2012

  • Das Ausgabeformat epub für mobile Lesegeräte wird unterstützt.

  • Die aktuelle Version der zpub-Installation wird im Web-Interface angezeigt.

Version 0.2

Veröffentlicht am 6.12.2010

  • Es gibt jetzt ein Installationsskript und eine Paketierung für Debian- und Ubuntu-Pakete.

  • Die generierten Ausgabeformate sind jetzt konfigurierbar.

  • Ein Backup der gesamten Dokumentquellen samt Historie kann über das Web-Interface heruntergeladen werden.