# Outsourcing TikZ code

My Tex files get very confusing since I have multiple long TikZ code in them. How do you organize your files when it comes to TikZ?

-
–  texenthusiast Feb 17 '14 at 14:53

Like with any TeX code you can put your TikZ picture environment into own .tex files and load them in your document with \input{<filename>} (never with \include). Because I faced similar issues like you while writing my thesis I wrote standalone class and package which allows you to add a full preamble to these files and compile them on their own while still be able to \input them into a main document without any changes.

The exact way I organize my TikZ pictures is as follows:

• One .tex file per TikZ picture.
• The files include a full preamble which loads all packages and libraries required and use the standalone class.
• The files can be in a subdirectory, e.g. figures.
• In the main document I load the standalone package and \input the TikZ pictures where I want to have them, e.g. inside a figure environment.
• The newer versions of standlone also provide a \includestandalone[<options>]{<filename>} macro which can be used instead of \input but allows you to use the same options like for \includegraphics, e.g. resize and turn the content, etc.
• It is also possible to compile all the TikZ files to single PDFs and include these in the document. This speeds up the compilation process significantly (except the first one, of course).
• For existing documents you can also just copy every TikZ picture to a single .tex file without preamble and simply \input that one. However, standalone gives you the great benefit of being able to compile the TikZ picture on its own. This is a huge time safer while coding the picture.

## Example

Tikz picture:

% Tikz File 'mytikz.tex'
\documentclass{standalone}
\usepackage{tikz}
%\usetikzlibrary{...}
\begin{document}
\begin{tikzpicture}
\draw (0,0) -- (1,1);
%%%
\end{tikzpicture}
\end{document}


Main document:

% Main document
\documentclass{book}
% Repeat required preamble stuff or use subpreambles option of the standalone package
\usepackage{tikz}
%\usetikzlibrary{...}
\usepackage{standalone}
\begin{document}
Text ...
\begin{figure}
\includestandalone[width=\textwidth]{mytikz}%     without .tex extension
% or use \input{mytikz}
\caption{My TikZ picture}
\label{fig:tikz:my}
\end{figure}
\end{document}


See the standalone manual for more. There are a couple of more options and features.

-
I like the subfiles package, which works like standalone, but has the added benefit of custom commands set with \newcommand in the main file's preamble still available in the other files. Actually, as preambles in the subfiles are simply \documentclass[example.tex]{subfiles}, the whole preamble of the main file is compiled when the single subfile is compiled. A drawback is that all subfiles have to be in the same directory as the main file. –  jlv Oct 29 '12 at 19:17
So glad that you got the rep for this :) Thanks for a great package, and all you do for the community :) –  cmhughes Oct 29 '12 at 19:53
Doesn't \includestandalone go against the idea of tikz a bit? One reason I like tikz and pgfplots is the consistency of fonts. If I scale a tikzpicture I do with \includegraphics, don't the font sizes get scaled accordingly? What remains of the advantage over a compiling the tikz-file standalone and using \includepdf? –  gerrit Oct 29 '12 at 20:04
@gerrit: You don't need to scale the picture when you are using \includestandalone. It is also good for other things, like the build option, which can automatically build and include TikZ files. Also, you mean \includegraphics not \includepdf, right? The latter is only required for full page PDFs. –  Martin Scharrer Oct 29 '12 at 22:03
Yes, I meant \includegraphics. It's been a while since I used \includegraphics (I use tikz and particularly pgfplots nowadays ;-) so I got confused :). Thanks for the explanation on \includestandalone. –  gerrit Oct 29 '12 at 23:45

I 'll try to describe the approach I used for my master thesis. Since I had a lot of tikz figures, compilation time was significant. In order to reduce it I decided to compile them to standalone pdfs and use \includegraphics{} (Martin's answer already mentioned that - I am just elaborating).

In order to do that I followed the following scheme:

\$ tree
.
├── chap1
│   ├── chap1.tex
│   └── figures
│       ├── figure1.tikz
│       └── figure2.tikz
├── chap2
│   ├── chap2.tex
│   └── figures
│       ├── figure1.tikz
│       └── figure2.tikz
├── main.tex
└── tikz_preamble.tex


So I created a folder for each chapter containing a tex file and a subfolder containing the tikz files. In my main.tex i used the import package and I used the command \subimport{chap1/}{chap1.tex} to include the tex files of each chapter. In the tex file of each chapter I was just using \includegraphics{figures/figure1.pdf}

Now, in order to create the tikz figures and convert them to pdfs I used the following approach.

1. I created them using ktikz and I saved them in the appropriate folder. NOTE: Each tikz file contained only the \begin{tikzpicture}...\end{tikzpicture}. NOT the preamble! NEITHER \begin{document} and \end{document}. You can find an example here.

2. I created a a file named tikz_preamble.tex containing the necessary preamble for the compilation of the tikz figures AND \begin{document} - \end{document}. You can find an example here.

3. Lastly I wrote a python script that would search recursively for files with *.tikz extension and would compile them using the tikz_preable.tex. On subsequent runs, only newly created files and files with changes would be compiled. The *.pdf files are created in the same folder as the *.tikz files. So the figures folder would look like this:

└── figures
├── figure1.pdf
├── figure1.tikz
├── figure2.pdf
└── figure2.tikz


Keeping the tikz files preamble as a separate file may seem as inconvenient but it allows greater flexibility. If you decide to make severe changes in your preamble (e.g. change font or font size - that actually happened to me, one day before the presentation!) then all you have to do is to adjust tikz_preamble and to call the script with a certain command line argument and it will update all your tikz files without any hassle.

PS. I would be interested in reading other people's work-flows.

-
I understand the thinking behind this process, and this is how I started also. However, the main benefit you describe of a change needed in the tikz_preamble can still be achieved with the standalone pacakge by using it as \usepackage{tikz_preamble}. Then the preamble can be easily changed if needed, the pictures are compilable by themselves, and can also be imported into the main document. –  Peter Grill Oct 30 '12 at 20:29
@PeterGrill Keeping the preamble together with the tikzpicture environment is not so convenient when you work with ktikz. Also you have to ensure that tikz_preamble package is within the TeX path (actually it is trivial to do it - e.g. symlinking to the texmf-local). Anyway, the other main benefit is the ability to compile automatically all your source files with a single command (e.g. if you use version control and you clone your repo). –  pmav99 Oct 31 '12 at 20:47

Naturally I can't compete with Martins answer :) but I have a different approach which does not include the use of 'yet another' additional package (you know what I mean).

## Resulting Document

First of all -- here is the result:

## Screeshots of the Folder Structure

Here is my simplified folder structure

The content of every folder is

## Main File

The main file looks like this:

\documentclass[parskip]{scrartcl}
% The Usual Suspects
\usepackage[latin1]{inputenc}
\usepackage[english]{babel}
\usepackage{graphicx}
\usepackage{float}
\usepackage{lmodern}
% Nice Captions for Tables and Figures etc.
\usepackage[%
font={small,sf},
labelfont=bf,
format=hang,
]{caption}
\usepackage{tikz}

% For Random Text
\usepackage{blindtext}

\input{TikZ-Styles/myUnitStyle.tex}
\input{TikZ-Styles/myLineStyle.tex}
\input{TikZ-Styles/myColorStyle.tex}
\input{TikZ-Styles/myGrayStyle.tex}

% -------------------------- Start Document --------------------------
\begin{document}

\section*{Test Section}

\blindtext

% That's all!
\input{Figures-Input-Code/fig_Squares.tex}

\blindtext

\end{document}
% -------------------------- End Document --------------------------


## Figure Input Code

The Figure Input Code looks like this:

\begin{figure}[H]
\centering
\input{TikZ-Code/Code_Squares.tex}
\caption{Example TikZ picture that has nothing special to offer.}
\label{fig_Squares}
\end{figure}


The label of the figure always has the filename of the Figure Input Code file. In this case the file is named fig_Squares.tex. So I have a consistent principle. The TikZ code file also shares the filename -- but the prefix is Code. Here it is therefore Code_Squares.tex.

## TikZ Code

The TikZ Code looks like this:

\begin{tikzpicture}[myUnitStyle,myLineStyle]
\draw [myColorStyle] (0,0) rectangle (10,10);
\draw [myGrayStyle] (12,0) rectangle (22,10);
\end{tikzpicture}


## TikZ Styles

The TikZ Styles look like this:

\tikzset{myColorStyle/.style={fill=yellow,draw=red}}

\tikzset{myGrayStyle/.style={fill=gray,draw=black}}

\tikzset{myLineStyle/.style={line width=2pt}}

\tikzset{myUnitStyle/.style={x=1mm,y=1mm}}


The filenames for the styles reflect the name of the style, as you can see.

If you want you can download the whole example as a zip file:

• It's easy to only compile parts by commenting the \input commands -- this also makes it easier to debug