10.5 Compiler Customization

10.5.1 g:Tex_DefaultTargetFormat
10.5.2 g:Tex_CompileRule_<format>
10.5.3 g:Tex_IgnoredWarnings
10.5.4 g:Tex_IgnoreLevel

The following settings affect Latex-Suite's compilation functionality

10.5.1 g:Tex_DefaultTargetFormat

TypeString
Default Valuedvi for windows/*nix and pdf for mac

Use this setting to choose the default target format. For example, setting this to pdf makes Latex-Suite compile a pdf file when you press \ll and fire up the pdf viewer on pressing \lv. Make sure that a rules for compiling and viewing have been defined for this target format as described here and here.

10.5.2 g:Tex_CompileRule_<format>

Here <format> refers to the target format for which this rule is defined. Latex-Suite supports compiling into dvi, ps and pdf by default. All these rules are strings defined by default as follows:

g:Tex_CompileRule_dvi'latex -interaction=nonstopmode $*'
g:Tex_CompileRule_ps'ps2pdf $*'
g:Tex_CompileRule_pdf'pdflatex -interaction=nonstopmode $*'

If you desire forward and inverse searching via Latex-Suite, you will need to change g:Tex_CompileRule_dvi to include -src-specials. However, this has been known to cause problems with the output file. Therefore, use this with care.

10.5.3 g:Tex_IgnoredWarnings

TypeString
Default Valuea new-line seperated list of patterns as described below

The default value of this setting is

\"Underfull\n".
\"Overfull\n".
\"specifier changed to\n".
\"You have requested\n".
\"Missing number, treated as zero.\n".
\"There were undefined references\n"
\"Citation %.%# undefined"

This setting defines a set of patterns which will be filtered out when displaying the output from the latex compiler. This is to aid in filtering out very common warnings/errors.

Note

Remember to check the value of g:Tex_IgnoreLevel when you change this setting. For example, if you append a new pattern which you would like to ignore by default, increase the value of g:Tex_IgnoreLevel.

10.5.4 g:Tex_IgnoreLevel

TypeInteger
Default Value7

This setting defines a "filter level" or an "ignore level". A value of 7 for instance means that any warning/error matching with any of the first 7 fields of g:Tex_IgnoredWarnings will be ignored. Setting this value to zero will mean that no error/warning is ignored. However, even with a value of zero, Latex-Suite will filter out most of the text which a LaTeX compiler typically produces. Use

TCLevel strict

from within Vim in order to see all the lines from the compiler's output.