If you wish to wish to expand certain environments differently from the way Latex-Suite does it, you can define custom expansions using global variables of the form Tex_Env_{name} where name corresponds to the environment.

For example, if you press <F5> after typing theorem, Latex-Suite will by default expand it to

\begin{theorem}
      \label{<++>}<++>
\end{theorem}<++>

However, if you wish change this to

\begin{theorem}
      <++>
\end{theorem}<++>

then define the following variable

let g:Tex_Env_theorem = "\\begin{theorem}\<CR><++>\<CR>\\end{theorem}"

If the expansion uses special keys such as carriage return etc, then use double-quotes and use the "\<key>" notation for special keys. Backslashes have to be doubled.

You could even use strings returned by functions as the expansion by using the IMAP_PutTextWithMovement() function.

If the name of the environment contains special characters (for example, the align* environment), then use the following form:

let g:Tex_Env_{'align*'} =
         \ "\\begin{align*}\<CR><++> &= <++>\<CR>\\end{align*}<++>"

This will make pressing <F5> after align* expand to

\begin{align*}
     <++> &= <++>
 \end{align*}<++>

By default, Latex-Suite inserts labels without prefixes. The setting Tex_EnvLabelprefix_{name}, where name corresponds to the environment, is used to create labels with prefixes automatically. For instance, if you use

let g:Tex_EnvLabelprefix_equation = "eq:"

the prefix eq: is inserted in all labels in generated equations:

\begin{equation}
      <++>
      \label{eq:<++>}
\end{equation}<++>

This setting works for the environments figure, table, theorem, definition, lemma, proposition, corollary, assumption, remark, equation, align and multline.

If Tex_EnvEndWithCR is set to 1, a carriage return (i.e., line break) is inserted between \end{environment} and the last placeholder:

\begin{equation}
      <++>
      \label{<++>}
\end{equation}
<++>

If Tex_ItemsWithCR is set to 1, a carriage return (i.e., line break) is inserted after \item and the placeholder, e.g., itemize<F5> is expanded to

\begin{itemize}
      \item
            <++>
\end{itemize}

If Tex_LabelAfterContent is set to 0, the label is placed before the content of the environment:

\begin{equation}
      \label{<++>}
      <++>
\end{equation}<++>

If this variable is set to 1, then when an environment is chosen from the menu then for selected environments, Latex-Suite asks a series of questions on the command line and inserts a template with the corresponding fields already filled in. Setting this to zero will insert a template with place-holders marking off the places where fields need to be filled.

This string represents a comma separated list of fields corresponding to environments. Pressing <F5> in insert-mode in the body of the document asks you to choose from one of these environments to insert.

Leaving this string empty will leave the <F5> key unmapped

This string represents a comma separated list of environments which are mapped to <Shift-F-1> through <Shift-F-4>. For example, pressing <Shift-F-2> with this setting inserts the equation environment.

Leaving this string empty will leave <Shift-F-1> through <Shift-F-4> unmapped.

If you wish to define new expansions for fast command insertion as described here, or redefine expansions from the default values in Latex-Suite, you will need to define variables of the form g:Tex_Com_{name} where name is a command name. For example, with the setting

let g:Tex_Com_frac = "\\frac{<++>}{<++>}<++>"

pressing <F7> after typing frac will change it to \frac{<++>}{<++>}<++>

See Tex_Env_name for additional details on how to create this setting in various special circumstances.

This string represents a comma separated list of LaTeX commands which Latex-Suite uses for the <F7> and <S-F7> maps as described here.

Leaving this string empty will leave the <F7> key unmapped.

This setting affects the style which Latex-Suite uses to insert an \item when <Alt-I> is pressed as described here. By default Latex-Suite defines styles for the following environments:

Each style is defined by a variable of the form g:Tex_ItemStyle_{envname} where envname is the name of the environment for which the style is defined. For example, by default

g:Tex_ItemStyle_description = '\item[<+label+>] <++>'

Redefining the style for a particular environment or defining a style for an entirely new environment is simply a matter of setting the value of a variable of the corresponding name.