Hinweise zum kompilieren eines Dokuments

Für das Kompilieren der Ausarbeitung stehen maßgeblich 2 Makefiles zur Verfügung.

Durch ein Aufruf von "make" im Verzeichnis ".../Dokumentation/Text/" wird das Dokument ausschließlich kompiliert.

Soll zusätzlich zum kompilieren des Dokuments auch die Verteilung der erzeugten Dokumente auf die richtigen Verzeichnisse unter Beachtung der korrekten Dateinamengebung geschehen, so muss "make" im Verzeichnis ".../Dokumentation/" aufgerufen werden. Hierbei ist zu beachten, dass in der Datei "Makefile.DEF" ein gültiger Schlüssel für die Variable "MASTER" eingetragen worden ist. Einen eindeutigen Schlüssel erhalten Sie bei Ihrem jeweiligen Betreuer der Arbeit.

Verzeichnisstruktur

Mit Fertigstellung der Arbeit ist dem Betreuer ein Verzeichnis zu übergeben, das den Bibliographie-Index des Studenten trägt (In der Regel die ersten 4 Buchstaben des Nachnamens in Kleinschrift und die letzten beiden Jahresziffern). Es enthält alle im Rahmen der Arbeit erstellten Dokumente und Quelldateien. Die Struktur der (Unter-)Verzeichnisse muss folgendem Layout genügen:

stud06 --- Dokumentation  ---  Postscript  ---  stud06.ps, stud06.2.ps
        |                  |                
        |                  |
        |                  |-- PDF         ---  stud06.pdf
        |                  |                  
        |                  |
        |                  |-- Latex       ---  Bilder  ---  *.{ps|eps|fig}
        |                  |                |
        |                  |                |-  main.tex, *.tex, ...
        |                  |                
        |                  |
        |                  |-- HTML        --- index.html, main.html, .....                
        |                  |
        |                  |-- Other       ---  *.{*|doc|cdr|....}
        |                  |                |-  mittels anderer Programme
        |                  |                    erstellte Doku
        |                  |
        |                  |-- Abstract.txt
        | 
        |-   Sourcen      ---  Makefile
        |                  |
        |                  |-- *.c, *.h
        |                  |-- Andere Quellprogramme
        |                  |-- Nicht "rekonstruierbare" Binaerdateien
        | 
        | 
        |-   Folien       ---  *.{fig|ppt|...}

Ein paar Erläuterungen

Die Datei stud06.ps im Verzeichnis "Postscript" beinhaltet die Postscriptversion der Ausarbeitung, und zwar in der Fassung "eine Seite pro Blatt", z.B. erzeugt mit pdf2ps. Vor der Weitergabe an den Betreuer ist in jedem Verzeichnis mit einem Makefile make clean auszuführen, um im Archiv Speicherplatz zu sparen.

Wichtig ist insbesondere das "Abstract.txt"-File. Dieses enthält eine Zusammenfassung der Diplomarbeit/des FoPras/des SEPs, wie sie üblicherweise vor dem Inhaltsverzeichnis vorangestellt wird. Diese Zusammenfassung enthält die Aufgabenstellung bzw. das Ziel der Arbeit, eine kurze Darstellung der Vorgehensweise und schließlich die Ergebnisse der Arbeit. I.d.R. ist diese Zusammenfassung 1/2 bis 3/4 DIN A 4 Seiten lang. Unter keinen Umständen ist diese Zusammenfassung länger als 1 DIN A 4 Seite. Das Format des Files sollte pures ASCII sein (also keine Formatierungsangaben in HTML/Latex/oder ähnliches). Diese Zusammenfassung wird dann im Web als Beschreibung der Arbeit erscheinen.

Anschließend ist aus dem entstandenen Verzeichnisbaum mit "tar -zcf stud06.tar.gz stud06" ein komprimiertes tar-File zu erzeugen (siehe "man tar"). Dieses File heißt also dann stud06.tar.gz und liefert beim späteren Auspacken die oben beschriebene Verzeichnishierarchie.