 Eine komplette Dokumentation drucken

Der ISaGRAF Dokumentations-Generator dient dem Aufbau und Ausdruck einer kompletten Dokumentation für das ausgewählte Projekt. Der Dokumentations-Generators wird mit dem Befehl "Drucken" im Menü "Projekt" des Projektmanagers oder der Programmfenster aktiviert. Der Dokumentations-Generator kann auch mit dem Befehl "Drucken" der ISaGRAF Editoren gestartet werden, um den Inhalt eines einzelnen ISaGRAF Dokuments auszudrucken. In beiden Fällen sind folgende Funktionalitäten verfügbar:

Inhaltsverzeichnis persönlich gestalten

Optionen

Die Befehle im Menü "Bearbeiten" werden für die Definition der Projektelemente benutzt, die in die Dokumentation eingefügt werden sollen. Sämtliche Projektdaten (Programme, Variablen, Optionen, E/A-Verdrahtung...) können in die Projektdokumentation aufgenommen werden. Daten, die andere Projekte oder die ISaGRAF Bibliotheken betreffen, erscheinen nicht in der Projektdokumentation.

 Der Befehl "Datei / Drucken" generiert die Dokumentation gemäß des spezifizierten Inhaltsverzeichnisses und sendet sie zum Drucker. Der Druckbefehl kann mehrere Minuten für den Aufbau und die Formatierung der Dokumentation in Anspruch nehmen. Es wird empfohlen, abzuwarten, bis der Druckbefehl im Fenster des ISaGRAF Dokumentations-Generators beendet ist, bevor andere Befehle der ISaGRAF Workstation eingeleitet werden. Der Aufbau einer kompletten Dokumentation kann sehr viel Speicherplatz auf der Festplatte benötigen. Wenn nicht genug Speicherplatz vorhanden ist, wird eine Fehlermeldung angezeigt. In diesem Fall muß Speicherplatz auf der Festplatte geschaffen werden, indem Dateien gelöscht werden oder der Umfang der Dokumentation reduziert wird. Wenn der Befehl "Drucken" eingeleitet wird, erscheint ein Dialogfeld, in dem eine Beschreibung des aktuellen Druckbefehls eingegeben werden kann. Diese Angaben werden in einer Protokolldatei gespeichert und auf der ersten Seite der aktuellen Dokumentation (sowie zukünftiger Dokumenationen) gedruckt


Inhaltsverzeichnis persönlich gestalten

Mit den Befehlen im Menü "Bearbeiten" kann das "Inhaltsverzeichnis" einer Dokumentation definiert werden. Verschiedene Befehle können benutzt werden, um das vorgegebene Inhaltsverzeichnis (mit allen Projektkomponenten) zu benutzen, ein spezielles Inhaltsverzeichnis (mit ausgesuchten Komponenten) zu erstellen oder Elemente im Inhaltsverzeichnis zu verschieben (das Inhaltsverzeichnis zu verändern).

Standardliste

 	Ausschneiden und Einfügen

Inhaltsverzeichnis löschen

Elemente in das Inhaltsverzeichnis einfügen


Standardliste

Der Befehl "Standardliste" im Menü "Bearbeiten" definiert das vorgegebene Inhaltsverzeichnis mit allen Projektkomponenten für die Dokumentation. Die Standardliste beinhaltet:

•	Projektkopf

•	Hierarchische Baumstruktur (Programmverknüpfungen)

•	Quellcode eines beliebigen Programms

•	Protokolldatei eines beliebigen Programms

•	Allgemeine Definitionen

•	Globale Definitionen

•	Lokale Definitionen eines beliebigen Programms

•	Globale Variablen

•	Lokale Variablen eines beliebigen Programms

•	Anwendungsoptionen

•	E/A-Verdrahtung

•	Variablenlisten

•	Umrechnungstabellen

•	Verkürzte Crossreferenzen

•	Detaillierte Crossreferenzen

•	Zusammenfassung der Deklarationen

•	Netzwerkadresskarte

•	Projektprotokoll

Das Inhaltsverzeichnis kann mit dem Befehl "Datei / Sichern" auf der Festplatte gesichert werden. Dieser Befehl ist nicht verfügbar, wenn der Dokumentations-Generator von einem ISaGRAF Editor aus eingeleitet wird, um ein einzelnes Dokument auszudrucken.


 	Ausschneiden und Einfügen

Benutzen Sie die Befehle "Bearbeiten / Ausschneiden" und "Bearbeiten / Einfügen", um Elemente in der Liste zu verschieben und die Anordnung der Elemente zu verändern. Der Dokumentations-Generator ermöglicht die Auswahl mehrerer Elemente im Inhaltsverzeichnis, so daß eine Gruppe von Elementen ausgeschnitten und eingefügt werden kann.


Inhaltsverzeichnis löschen

Benutzen Sie den Befehl "Bearbeiten / Löschen", um das Inhaltsverzeichnis zu löschen, so daß es durch Einfügen einzelner Elemente ganz neu aufgebaut werden kann.


Elemente in das Inhaltsverzeichnis einfügen

Wenn der Befehl "Bearbeiten / Einfügen" eingeleitet wird, erscheint eine Dialogfeld. Hier kann der Benutzer Elemente (Projektkomponenten) in das Inhaltsverzeichnis einfügen.

Im Listenfeld "Programm" kann ein Programmname für programm-lokale Elemente ausgewählt werden. Klicken Sie auf die Schaltfläche "Hinzufügen" um das ausgewählte Element in das Inhaltsverzeichnis einzufügen. Ein Element kann jeweils nur einmal im Inhaltsverzeichnis vorkommen.


Optionen

Mit den Befehlen im Menü "Optionen" kann das Format der generierten Dokumentation definiert und persönlich gestaltet werden.

AS-Netzwerke

Seitenumbruch

Fußzeile

 	Auswahl der Schriftarten

Weitere Optionen sind unmittelbar im Fenster des Dokumentations-Generators als Schaltflächen verfügbar:

Wenn die Option "Titelseite" aktiviert wird, wird eine Titelseite mit dem Titel des Projekts und dem Druckprotokoll am Anfang eines Dokuments gedruckt. Wenn diese Option nicht aktiviert wird, beginnt der Ausdruck mit der ersten Seite.

Wenn die Option "Inhaltsverzeichnis" aktiviert wird, wird ein Inhaltsverzeichnis am Ende des Dokuments gedruckt.

Beide Optionen sind deaktiviert, wenn der Dokumentations-Generator mit dem Befehl "Drucken" eines ISaGRAF Editoren (Programm, Datenverzeichnis...) gestartet wird.


AS-Netzwerke

Mit der Option "AS-Ebenen trennen" kann für jedes AS-Programm zuerst die Ebene 1 (Netzwerk und Kommentare) und dann die Programmierung der Ebene 2 gedruckt werden. Wenn diese Option deaktiviert wird, erscheinen die Ebenen 1 und 2 zusammen im ausgedruckten Dokument.


Seitenumbruch

Benutzen Sie den Befehl "Seitenumbruch" im Menü "Optionen", um die hauptsächlichen Parameter für den Seitenumbruch der Dokumentation zu definieren. Folgende Parameter können bestimmt werden:

•	Linker Rand: (1 oder 2 cm, oder kein Rand)

•	Rahmen: Wenn diese Option aktiviert wird, werden alle Seiten mit einem Rahmen gedruckt.


Fußzeile

Mit dem Befehl "Fußzeile" im Menü "Optionen" kann der Inhalt der Fußzeile, die am Ende einer jeden Seite gedruckt wird, definiert werden. Das Standardformat der Fußzeile sieht so aus:

Die erste Titelzeile (mit dem Namen des ISaGRAF Projekts), das aktuelle Datum und die Seitenzahl werden automatisch vom Dokumentations-Manager generiert und können nicht modifiziert werden.

Die drei Textzeilen links (Text1, Text2 und Text3) und die zweite Titelzeile können frei vom Benutzer definiert werden. Das Logo im linken Feld kann ebenfalls geändert werden. Wenn Sie ein anderes Logo benutzten möchten, müssen Sie den Pfadnamen einer Bitmap-Bilddatei (.BMP) eingeben. Das Bild kann beliebig groß sein und wird beim Ausdruck je nach Seitengröße und Druckauflösung reduziert oder vergrößert. Klicken auf das Logofeld im Dialogfeld zeigt das neue Logo an. Die Bilddatei muß sich auf der Festplatte befinden (im angegebenen Verzeichnis und unter dem spezifizierten Pfadnamen), wenn der Befehl "Drucken" eingeleitet wird.


 	Auswahl der Schriftarten

Die Befehle "Schriftart Text" und "Schriftart Titel" im Menü "Optionen" werden benutzt, um die Schriftarten für die Titel und den Text der Dokumentation zu bestimmen. Die Größe und der Stil der Zeichen für Titel und Text können auch definiert werden. Die Auswahl der Schriftarten erfolgt im Windows-Standard-Dialogfeld. Sämtliche Texte (Textprogramme, Namen in den Diagrammen...) werden in der ausgewählten Größe, Stil und Schriftart gedruckt. Nur die Titel werden in der für die Titel ausgewählten Schriftart gedruckt.

Wenn keine Schriftart gewählt wird, wird die vorgegebene Schriftart des Druckers benutzt, und zwar in den folgenden Stilarten:

•	"Normal" für Texte und Namen in den Diagrammen

•	"Fett" für die Titel