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

  • Installierte libxml2


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
\includegraphics[scale=.5]{../pics/nsd2ltx_tab}
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.
\includegraphics[scale=.65]{../pics/fileadd}
Dateien hinzufügen
\includegraphics[scale=.65]{../pics/fileremove}
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
\includegraphics[scale=.5]{../pics/strukto_tab}
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
\includegraphics[scale=.5]{../pics/ueberschriften_tab}
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
\includegraphics[scale=.5]{../pics/latex_tab}
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
\includegraphics[scale=.5]{../pics/programms_tab}
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).




> Ergänzende Hilfsmittel ||  < PHP-Version
© 2002 DokuTransData, Aachen
2002-11-13
Jürgen A. Lamers