Most LaTeX compilers need to be re-run several times in several
commonly occurring situations in order to get a final camera ready copy.
For example, when \label
's change, when new
\cite
commands are added etc. If the target format
you are compiling to requires multiple compilations, then you will
need to include the format in the
g:Tex_MultipleCompileFormats
setting. This is a
comma separated string of formats which need multiple compilations to
be generated correctly.
By default, this setting contains just the dvi
format. If you use the pdflatex
compiler to generate
pdf
files, then you might want to also include
pdf
into the above setting.
For every format included in the
g:Tex_MultipleCompileFormats
setting described
above, Latex-Suite will use the following logic to generate the file. Note
that although the following description uses latex
to refer to the compiler, it could be some other compiler such as
pdflatex
for generating pdf
output.
.idx
file, then remember
its contents.latex
..idx
file changed due to the latex
compiler, then run makeindex
to redo the
.ind
file and then remember to rerun latex.
If the .aux
file generated by the latex
compiler contains a \bibdata
line, then it
means that we are using a .bib
file. Therefore,
run bibtex
.
This means that we will always run bibtex
whenever we use the \bibliography
command
whether or not we actually need to. At this time, Latex-Suite does not
parse the .aux
file before and after the latex
compiler to see if we are required to rerun
bibtex
.
.bbl
file changes because of this, then
remember to rerun latex again.
makeindex
or
bibtex
again.
The LaTeX file is compiled atmost 5 times using this logic. These steps will ensure that on most platforms/environments, you will get a clean output with all the cross-references, citations etc correctly labelled and ordered.