IT

Technische Dokumentationen mit LaTeX

Für den Virtualisierungsworkshop mit Vmware Link hatte ich mir vorgenommen, längere Unterlagen mit Bildern zu erstellen. Aus Erfahrung wusste ich, dass dies mit Word sehr mühsam werden würde: lange (mehrseitige) Tabellen mit Bildern werden garantiert irgendwann kaputtgehen. Ausserdem musste jedes Bild auf eine einheitliche Grösse gebracht werden:

textable

Der Entscheid war evident, diese Dokumente mit LateX zu setzen.

Bei den langen Tabellen mit den vielen Bildern konnte LaTeX seine Stärken ausspielen: alle Bilder werden automatisch von der Festplatte geholt und eingebunden, wobei sie auf eine einheitliche Breite angepasst werden. Dies geschieht in einem Block wie unten, wobei die Bilder durchnummeriert werden. Der Dateiname setzt sich aus einer laufenden Nummer und einem Prefix zusammen, der mit dem Macro \renewcommand{\bildprefix}{./VMWARE-Server/VMwareServer-Host-} vor jeder Tabelle gesetzt wird. Die Tabelle wird mit dem Paket longtable gesetzt.

\begin{longtable}{|l|c|l|}
\hline \multicolumn{3}{|l|}{}\\
\multicolumn{3}{|l|}{{\textbf{Installation von VMware Server}}}\\
\multicolumn{3}{|l|}{}\\ \hline & & \\
Nr. & Wo & Bemerkungen\\
&  & \\ \hline &  & \\
\hspace*{5mm} & \hspace*{\MittelSpalte} & \hspace*{\RechteSpalte}\endfirsthead
\bildzeile{1}{Bei einem allfälligen Update muss zuerst eine ältere Version deinstalliert werden.}\\
&  & \\ \hline &  & \\
\bildzeile{2}{Startbildschirm...}\\
&  & \\ \hline &  & \\
\bildzeile{3}{der Installationsassistent startet...}\\
& & \\ \hline
\end{longtable}

Es wurden einige einfache Macros selber definiert:

% =====================================================
% eigene Macros Beginn
% Konfiguration von longtable
\setlength\LTleft{0pt}\setlength\LTright{\fill}
\newlength\MittelSpalte \newlength\RechteSpalte
\setlength\MittelSpalte{70mm}
\setlength\RechteSpalte{70mm}
%\newlength\BildGroesse \setlength\BildGroesse{\MittelSpalte-\tabcolsep-\tabcolsep}
% Lücke oben um die Bilder
\setlength{\extrarowheight}{-2.5mm}
% Bildbreiten
\newlength\BildSchmal \setlength\BildSchmal{40mm}
\newlength\BildMittel \setlength\BildMittel{55mm}
\newlength\BildBreit  \setlength\BildBreit{70mm}
% hier steht der aktuelle Pfad zu den Screenshots ohne die abschliessende Nummer, nach - darf keine Null stehen
\newcommand{\bildprefix}{./VMWARE-Server/vmserver-inst-}
\newcommand{\bildzeile}[3][\BildBreit]{#2 & \raisebox{3ex-\height}{\includegraphics[width=#1]{\bildprefix#2.jpg} } & \begin{minipage}[t]{70mm} #3\end{minipage}}
% für Zwischentitel
\newcommand{\zwischentitel}[1]{\hline \multicolumn{3}{|l|}{}\\\multicolumn{3}{|l|}{}\\\multicolumn{3}{|l|}{{\textbf{#1}}}\\\multicolumn{3}{|l|}{}\\ \hline &  & \\}
% eigene Macros Ende
% =====================================================

Weiterhin musste eine ganze Reihe von weiteren Paketen geladen werden und das Layout gezielt angepasst werden. Die gesamte TeX-Preambel sieht so aus (Code erstellt mit WinEdt, siehe Kurs):


% ------------------------------------------------------------------------
% !Mode:: "TeX:Hard"
% PDFLaTeX this document and view or print it from Acrobat Reader!
% ------------------------------------------------------------------------
%
\documentclass[a4paper,12pt]{article}
\usepackage[pdftex]{graphicx}
%\usepackage[T1]{fontenc}
\usepackage{german}
\usepackage[ansinew]{inputenc}
\usepackage{float}
\usepackage[pdftex]{hyperref}
\usepackage{pdfsync} %Positionierung im PDF, opt.
\usepackage{longtable}
\usepackage{bmpsize}
\usepackage{calc}
\usepackage{array}
\usepackage[pdftex]{color}
\usepackage[pdftex]{colortbl}
\usepackage{fancyhdr}
%\usepackage{bigstrut}


\pdfoutput=1
\hypersetup{%
pdfauthor={Andreas Bieri},
pdftitle={PRIG Workshop Virtualiserung}
pdfcreator={pdfTeX},
pdfsubject={},
colorlinks=true}
\date{26. Januar 2008}
\author{Andreas Bieri}
\title{PRIG Workshop Virtualisierung - Modul A}
\parindent0mm
%\addtolength{\textwidth}{5mm}
\setlength\textwidth{160mm} \setlength\oddsidemargin{0mm} \setlength\evensidemargin{0mm} \setlength\topmargin{-37pt}\setlength\textheight{240mm}
\pagestyle{fancy} \lfoot{Andreas Bieri PRIG Workshop} \cfoot{Ver. 1.0} \rfoot{Seite \thepage}
\renewcommand{\headrulewidth}{0pt}\renewcommand{\footrulewidth}{0.4pt}

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert