TeXToolKit (ttk)

This software package is build especially to overcome the problem of including postscript figures (and features) in pdflatex.

Download

You can clone the git repo with:

git clone git://git.derhammer.net/textoolkit.git

and of course you can access and browse the source online

Dependencies

Für die Verwendung von TeXToolKit werden folgende Softwarepakete benötigt:

epstool
GNU make
>=python-2.5

Projektstruktur

Jedes LaTeX Projekt hat folgende Minimalstruktur aufzuweisen: (f=file, d=directory, s=symbolic link)

f ${projekt}/main.tex
f ${projekz}/literature.bib (optional)
d ${projekt}/images/
d ${projekt}/src_images/

D.h. das zentrale tex file für die Übersetzung ist main.tex.

Darüber hinaus müssen folgende symbolischen Links auf die tools im ttk vorhanden sein:

s ${projekt}/Makefile
s ${projekt}/ttk_eps2pdf
s ${projekt}/ttk_tex2pdf
s ${projekt}/ttk_qcad2psfrag
s ${projekt}/ttk_acad2psfrag

`./src_images/`

Hier liegen die Basisfiles aus denen die einzufügenden pdfs erstellt werden. Es sollen folgende Fälle unterstützt werden:

eps Grafiken aus AutoCAD exportiert
ps Grafiken aus QCAD gedruckt
eps Grafiken aus xfig exportiert (oder einem anderen Vektorgrafikprogramm, dass in der Lage ist Schriften zu exportieren)
tex Dateien (enthält postscript Anweisung - z.B. pstricks)

`./images/`

Hier liegen ausschließlich jene Grafiken die sofort in pdflatex verarbeitet werden können

jpg,png,usw. die direkt mit \includegraphics eingefügt werden können

Funktionalitaeten:

a.) ttk_acad2psfrag: Ersetzte die mit dem Layer font_{l,r,c} erstellten Linienelemente mit Textstatements. Der Startpunkt der Linie ist hier der Einfuegepunkt des Textes. die Endungen l,r,c stehen hier für l=left,r=right,c=center Ausrichtung. Die eps Dateien (in ${projekt}/src_images) müssen nach folgendem Schema benannt sein: ${name}_acad.eps und es erstellt daraus ${name}_img.eps als input für b.).

b.) ttk_eps2pdf: Dieses Programm kombiniert die beiden Dateien ${name}_img.eps und ${name}_img.tex (in ${projekt}/src_images) und erzeugt daraus ${name}.eps und ${name}.pdf in ${projekt}/images. ${name}_img.eps ist bereits ein psfrag taugliches epsfile. Darüber hinaus werden auch noch die preamble von ${projekt}/main.tex verwendet und die "bounding box" richtig gesetzt. Das file ${name}_img.tex enthält daher keine preamble mehr und hat folgendes beispielhaftes Aussehen:
```
 x----------------------------------x
 % opt: <options for includegraphics>
  \psfrag{}[][]{}
  .
  .
  .
 x----------------------------------x
```
a.) ttk_qcad2psfrag: Ersetzte die mit den Farben (RGB Code)
```
(`255 0   127`)->(left aligned)
(`127 255 127`)->(center aligned)
(`85  0   255`)->(right aligned)
```
erstellten Linienelemente mit Textstatements. Der Startpunkt der Linie ist hier der Einfügepunkt des Textes. Die ps Dateien (in ${projekt}/src_images) müssen nach folgendem Schema benannt sein: ${name}_qcad.ps und es erstellt daraus ${name}_img.eps als input für b.). ACHTUNG: QCAD exportiert ps und keine eps!

b.) siehe 1. b.) -> selber Vorgang
a.) siehe 1. b.) -> selber Vorgang
a.) ttk_tex2pdf: Dieses Programm erzeugt auch aus Dateien vom Typ ${name}_tex.tex -> ${name}.eps und ${name}.pdf (in ${projekt}/images). Gedacht ist das z.B. für die Arbeit mit pstricks. Die Dateien ${name}_tex.tex (in ${projekt}/src_images) sollten dabei folgende Gestalt haben:
```
x----------------------------------x
%opt: <packages to load>
<imagecode>
x----------------------------------x
```

Makefile:

Zum Kompilieren steht ein Makefile zur Verfügung, dass folgende Targets unterstützt:

make all
make images
make clean