Unterabschnitte
C++ Version
Das Kommandozeilen-Programm
Mit dem Programm nsd2ltx und dem Emacs Helper-Mode nsd-helper lassen sich XML-Struktogramme nach LATEX konvertieren.
Voraussetzungen
Installation
Mit ./configure ist das Makefile zu erzeugen. Anschliessend ist mit make install das Programm zu installieren.
Benutzung
Aufruf:
nsd2ltx [Options] file1 file2 ...
Options:
-s Call the external viewer after compilation
-a Don't call the external viewer asynchron!
-b Don't display the description before a structo
-v Print nearly all message to stdout
-h You are reading this help at the moment
Options with arguments:
-m <mode>
Which output mode should i use:
Document Modes:
tex, dvi, pdf, dvi2pdf, ps4dvi, pdf4ps, print
Picture Modes:
eps, png, png100, png150, png300, png600, pdfp, dvi2pdf_pic
-d <directory>
Generate the output in this *existing* directory
-r <resfile>
Parse this additional config file
Das Argument für den Ausgabemodus wurde in Abschnitt 1.3 erläutert. Das genaue Format zur Konfigurationsdatei wird in Abschnitt A.2 beschrieben.
Der Wizard
Als kleine Designstudie habe ich ein Desktop-Programm entwickelt mit dem sich die Konfigurationsoptionen bearbeiten lassen, sowie der Compilerlauf für Struktogrammdateien anstossen lässt.
Voraussetzungen
Es gibt folgende Versionen:
- QT2 mit KDE2 (Makefile: Makefile.in.qt2)
- QT3 mit KDE3 (Makefile: Makefile.in.qt3)
Installation
- QT2
- Ist nur QT2 mit dem Designer 1.1 installiert, muss Makefile.in.qt2 nach Makefile.in kopiert werden.
- QT3
- Ist nur QT3 mit dem Desigern 2.0 installiert, muss Makefile.in.qt3 nach Makefile.in kopiert werden.
Sorry für diese Mühe, aber besser habe ich es noch nicht hinbekommen mit autoconf etall.
Anschliessend kann mit ./configure --enable-kde(2|3) das Makefile erzeugt werden und mit make install das Programm installiert werden.
Benutzung
Im nachfolgenden werden die einzelnen Karteikarten beschrieben.
nsd2tx
Auf der Karteikarte nsd2ltx (s. Abb. 3.1) lassen sich die Parameter zur Programmsteuerung manipulieren.
Abbildung 3.1: Optionen zur Steuerung von nsd2ltx
|
- Output
- Ausgabeformat
- DVI
- Normale Konvertierung als LATEX-Dokument mit latex und anschliessendem Aufruf des DVI-Viewers.
- TEX
- Normale Konvertierung als LATEX-Dokument mit latex, es werden nur die LATEX-Dateien erzeugt.
- PDF
- Normale Konvertierung als LATEX-Dokument mit pdflatex. Vorsicht: pdflatex kann nicht alle Erweiterungen der Pakete eepic bzw. epic.
- DVI2PDF
- Konvertierung der DVI-Datei mit dvipdfm nach PDF.
- PSDVI
- Normale Konvertierung als LATEX-Dokument mit pslatex.
- PDF4PS
- Normale Konvertierung als LATEX-Dokument mit pslatex und konvertierung nach PDF.
- EPS
- Die einzelnen Struktogramme werden als EPS-Dateien exportiert.
- PNG, PNG (100dpi, 150dpi, 300dpi, 600dpi)
- Die einzelnen Struktogramme werden als PNG-Dateien in der entsprechenden Auflösung exportiert.
- PDF (pics)
- Die einzelnen Struktogramme werden als PDF-Dateien exportiert. Da hier der Weg über EPS gegangen wird, sind alle Unstimmigkeiten der pdflatex-Konvertierung nicht gegeben.
- DVI2PDF (pics)
- Die einzelnen Struktogramme werden als PDF-Dateien über dvipdfm exportiert.
- Verbose
- Schalter ob die Ausgabe der Kompilierung unterdrückt werden soll oder nicht.
- Show
- Schalter ob nach Abschluss der Kompilierung der externe Viewer aufgerufen werden soll oder nicht.
- Asyncron
- Schalter ob nach Abschluss der Kompilierung der externe Viewer asyncron aufgerufen werden (z.B. acroread &) soll oder nicht. Diese Option muss für den Emacs-Mode nsd-helper abgestellt sein!
- Ausgabeverzeichnis
- Die Ausgabe wird in diesem Verzeichnis abgelegt.
- XML-Struktogramme
- Liste der XML-Struktogramme die verarbeitet werden sollen.
- Dateien hinzufügen
- Angewählte Datei aus der Liste entfernen
Struktogramme
Auf der Karteikarte Struktogramme (s. Abb. 3.2) lassen sich die Parameter zu den Struktogrammen manipulieren.
Abbildung 3.2: Optionen zur Steuerung des Verhalten der Struktogramme
|
- Strukto-Env
- Schalter ob die einzelnen Struktogramme in eine Fliessumgebung eingebunden werden sollen oder nicht. Dazu wird zusätzlich der Style strukto benötigt.
- Strukto-Position
- Mit diesen Schaltern kann der Positionsparamter der Fliessumgebung gesteuert werden. Bei der Option H wird der Style float benötigt.
- Center NSS
- Schalter ob die einzelnen Struktogramme in eine centernss-Umgebung eingebunden werden sollen oder nicht.
- Show Description
- Schalter ob die Ausgabe des Elements <description> unterdrückt werden soll oder nicht.
- Width
- Standardbreite für ein Struktogramm, sofern das Attribut width bei dem struktogramm-Element nicht gesetzt ist.
- Height
- Standardhöhe für ein Struktogramm, sofern das Attribut height bei dem struktogramm-Element nicht gesetzt ist.
Überschriften
Auf der Karteikarte Überschriften (s. Abb. 3.3) lassen sich die Parameter zu den Überschriften in den Struktogrammen manipulieren.
Abbildung 3.3: Eingabe der Überschriften
|
- Funktionsparameter
- Überschrift zur Beschreibung der Parameter einer Funktion.
- Lokale Variablen
- Überschrift zur Beschreibung der lokalen Variablen einer Funktion.
- Rückgabewerte
- Überschrift zur Beschreibung der Rückgabewerte einer Funktion.
- Andere Definitionen
- Überschrift zur Beschreibung der Variablen in der Hauptfunktion.
- Erläuterung
- Überschrift zur Beschreibung der Funktion.
- IF Ja Text
- Text für den true-Zweig einer IF-Abfrage.
- IF Nein Text
- Text für den false-Zweig einer IF-Abfrage.
LATEX
Auf der Karteikarte LaTeX (s. Abb. 3.4) lassen sich die Dokumentklasse und weitere Pakete verändern. Vorsicht: Ein \begin{document} oder gar ein \end{document} darf in diesen Texten nicht auftauchen.
Abbildung 3.4: Eingabe der Dokumentklassen-Optionen
|
- Document
- LATEX-Dateikopf für ein normales Dokument.
- Picture
- LATEX-Dateikopf für den Export der Struktogramme als EPS- oder PNG-Datei.
Programms
Auf der Karteikarte Programms (s. Abb. 3.5) lassen sich die externen Viewer einstellen.
Abbildung 3.5: Eingabe der externen Programme
|
- PDF-Viewer
- Externer PDF-Viewer (Default: xpdf).
- DVI-Viewer
- Externer DVI-Viewer (Default: xdvi).
- EPS-Viewer
- Externer EPS-Viewer (Default: gv).
- PNG-Viewer
- Externer PNG-Viewer (Default: xv).
|