HandbuchSetup

Aus GENprofi-Stammbaum
Wechseln zu: Navigation, Suche

Erstellen der Installationsdatei für das Handbuch

Das Handbuch wird genauso wie das Hauptprogramm installiert und benötigt daher ein spezielles Installationsprogramm. Es genügt nicht, die Handbuchdateien einfach in das Programmverzeichnis zu kopieren, da Einträge in der Windows Registry benötigt werden. Das Installationsprogramm erstellt diese Einträge und findet auch automatisch das Verzeichnis, in das das Hauptprogramm installiert wurde.

Es ist außerdem wichtig, daß das Handbuch versioniert wird, d.h. Handbuchinstallationen mit unterschiedlichem Inhalt müssen auch unterschiedliche Versionsnummern erhalten. Eine Versionsnummer ist eine Zeichenkette, die aus zwei ganzen Zahlen besteht, die durch einen Punkt getrennt sind, also z.B. "2.1" oder "1.0". Die erste Zahl gibt die Hauptversion an, die zweite Zahl die Unterversion. Eine Version v1 ist größer als v2, wenn die Hauptversion von v1 größer als die Hauptversion von v2 ist, oder beide Hauptversionen gleich sind und die Unterversion von v1 größer als die von v2 ist. Also ist "2.5" < "3.1" < "3.10".

Wird der Zeichenkette eine dritte Zahl hinzugefügt, dann wird diese als Angabe der Beta-Level interpretiert, also würde eine Versionsangabe der Form 2.7.1 als 2.7ß1 interpretiert. Beta Versionen haben der Definition immer eine niedrigere Wertigkeit als "Releaseversionen", d.h. Versionen ohne Beta-Level. Also ist "2.7.1" < "2.7.2" < "2.7".

===Vorgehensweise zum Erstellen der Installation===
Handbuch Setup Verzeichnis
  • Lade die Datei innosetup.zip herunter und entpacke sie in ein Verzeichnis.
  • Erstelle mit "Help & Manual" wie gewohnt die Dateien handbuch.chm und handbuch.pdf
  • Kopiere die jeweils aktuelle Version der beiden Dateien in das Verzeichnis, in das innosetup.zip entpackt wurde. Anschließend sollte das Verzeichnis aussehen wie in nebenstehendem Bild.
  • Bearbeite die Datei "handbuch.iss" mit einem Texteditor. In der ersten Zeile der Datei steht
#define private VERSION "1.0"

Dabei handelt es sich um die Versionsnummer des Handbuchs. Ändere diese Versionsnummer bei jeder Neuerung so ab, daß die größer ist als vorher. Bei kleinen Änderungen modifiziere die Unterversion, bei größeren Änderungen die Hauptversion.

  • Speichere die Datei "handbuch.iss"
  • Klicke doppelt auf "compile.bat" im Handbuchverzeichnis. Es öffnet sich ein schwarzes Kommandofenster und nach einigen Sekunden erscheint die Aufforderung, eine Taste zu betätigen (siehe Bild rechts).
    Handbuch Kommandozeile
  • Das Installationsprogramm ist nun fertig und findet sich in dem Unterordner "output". Benenne es bitte nicht um, sondern kopiere es auf den Server und benachrichtige mich, daß eine neue Version vorliegt.