-
Notifications
You must be signed in to change notification settings - Fork 64
Configuration
This page describes the configuration settings that the server will query from the LSP client.
Defines the executable of the LaTeX build tool.
Type: string
Default value: latexmk
Defines additional arguments that are passed to the configured LaTeX build tool.
Note that flags and their arguments need to be separate
elements in this array.
To pass the arguments -foo bar to a build tool,
latex.build.args needs to be ["-foo", "bar"].
The placeholder %f will be replaced by the server.
Placeholders:
-
%f: The path of the TeX file to compile.
Type: string[]
Default value: ["-pdf", "-interaction=nonstopmode", "-synctex=1", "%f"]
Set this property to true if you want to execute a forward search after a build.
Type: boolean
Default value: false
Set this property to true if you want to compile the project after saving a file.
Type: boolean
Default value: false
When set to true, the server will use the .fls files produced by the TeX engine as an additional input for the project detection.
Note that enabling this property might have an impact on performance.
Type: boolean
Default value: false
When not using latexmk, provides a way to define the directory containing the .aux files.
Note that you need to set the aux directory in latex.build.args too.
When using a latexmkrc file, texlab will automatically infer the correct setting.
Type: string
Default value: . (the same directory as the root directory)
When not using latexmk, provides a way to define the directory containing the build log files.
Note that you need to change the output directory in your build arguments too.
When using a latexmkrc file, texlab will automatically infer the correct setting.
Type: string
Default value: . (the same directory as the root directory)
When not using latexmk, provides a way to define the directory containing the output files.
Note that you need to set the output directory in latex.build.args too.
When using a latexmkrc file, texlab will automatically infer the correct setting.
Type: string
Default value: . (the same directory as the root directory)
Allows overriding the default file name of the build artifact. This setting is used to find the correct PDF file to open during forward search.
Type: string
Default value: null (by default, the server searches for foo.pdf if the main document is named foo.tex)
Defines the directory containing the build artifacts.
Note that you need to set the output directory in latex.build.args too,
if you want to change the build directory.
In this case, use the -outdir flag for latexmk.
Type: string
Default value: . (the same directory as the TeX file)
Defines the executable of the PDF previewer. The previewer needs to support SyncTeX.
Type: string | null
Default value: null
Defines additional arguments that are passed to the configured previewer to perform the forward search.
The placeholders %f, %p, %l will be replaced by the server.
Placeholders:
-
%f: The path of the current TeX file. -
%p: The path of the current PDF file. -
%l: The current line number.
Type: string[] | null
Default value: null
Lint using chktex after opening and saving a file.
Type: boolean
Default value: false
Lint using chktex after editing a file.
Type: boolean
Default value: false
Additional command line arguments that are passed to chktex after editing a file.
Don't redefine the -I and -f flags as they are set by the server.
Type: string[]
Default value: []
Delay in milliseconds before reporting diagnostics.
Type: integer
Default value: 300
A list of regular expressions used to filter the list of reported diagnostics. If specified, only diagnostics that match at least one of the specified patterns are sent to the client.
See also texlab.diagnostics.ignoredPatterns.
Hint:
If both allowedPatterns and ignoredPatterns are set,
then allowed patterns are applied first. Afterwards, the results are filtered with the ignored patterns.
Type: string[]
Default value: []
A list of regular expressions used to filter the list of reported diagnostics. If specified, only diagnostics that match none of the specified patterns are sent to the client.
See also texlab.diagnostics.allowedPatterns.
Type: string[]
Default value: []
A list of regular expressions used to filter the list of reported document symbols. If specified, only symbols that match at least one of the specified patterns are sent to the client. Symbols are filtered recursively so nested symbols can still be sent to the client even though the parent node is removed from the results.
See also texlab.symbols.ignoredPatterns.
Hint:
If both allowedPatterns and ignoredPatterns are set,
then allowed patterns are applied first. Afterwards, the results are filtered with the ignored patterns.
Type: string[]
Default value: []
A list of regular expressions used to filter the list of reported document symbols. If specified, only symbols that match none of the specified patterns are sent to the client.
See also texlab.symbols.allowedPatterns.
Type: string[]
Default value: []
A list of objects that allows extending the list of environments that are part of the document symbols.
See also texlab.symbols.allowedPatterns.
Type: SymbolEnvironmentOptions[]
interface SymbolEnvironmentOptions {
// The name of the environment.
name: string;
// The name shown in the document symbols. By default, title case is used.
displayName?: string;
// If set, the server will try to match a label to environment and append its number.
label?: false;
}Default value: []
Defines the maximum amount of characters per line (0 = disable) when formatting BibTeX files.
Type: integer
Default value: 80
Defines the formatter to use for BibTeX formatting.
Possible values are either texlab or latexindent.
Type: string
Default value: texlab
Defines the formatter to use for LaTeX formatting.
Possible values are either texlab or latexindent.
Note that texlab is not implemented yet.
Type: string
Default value: latexindent
Defines the path of a file containing the latexindent configuration.
This corresponds to the --local=file.yaml flag of latexindent.
By default the configuration inside the project root directory is used.
Type: string
Default value: null
Modifies linebreaks before, during, and at the end of code blocks
when formatting with latexindent.
This corresponds to the --modifylinebreaks flag of latexindent.
Type: boolean
Default value: false
Defines an additional replacement flag that is added when calling latexindent.
This can be one of the following:
"-r""-rv""-rr"null
By default no replacement flag is passed.
Type: string
Default value: null
Modifies the algorithm used to filter the completion items returned to the client. Possibles values are:
-
fuzzy: Fuzzy string matching (case sensitive) -
fuzzy-ignore-case: Fuzzy string matching (case insensitive) -
prefix: Filter out items that do not start with the search text (case sensitive) -
prefix-ignore-case: Filter out items that do not start with the search text (case insensitive)
Type: string
Default value: fuzzy-ignore-case
Modifies the way symbol-like commands (e. g. \epsilon) are displayed during a hover request.
Possible values are:
-
none: No hover is shown -
glyph: If available, the command is shown using a unicode character -
image: If available, a markdown image preview is returned. If not, theglyphmethod is tried next.
Type: string
Default value: image
When enabled, the server will return inlay hints for \label-like commands.
Type: boolean
Default value: true
When enabled, the server will return inlay hints for \ref-like commands.
Type: boolean
Default value: true
When set, the server will truncate the text of the inlay hints to the specified length.
Type: int | null
Default value: null
If set to true, dependencies of custom packages are resolved and included in the dependency graph.
Type: boolean
Default value: false
Allows extending the list of environments which the server considers as math environments (for example align* or equation).
Type: string[]
Default value: []
Allows extending the list of environments which the server considers as enumeration environments (for example enumerate or itemize).
Type: string[]
Default value: []
Allows extending the list of environments which the server considers as verbatim environments (for example minted or lstlisting).
This can be used to suppress diagnostics from environments that do not contain LaTeX code.
Type: string[]
Default value: []
Allows extending the list of commands which the server considers as citation commands (for example \cite).
Hint: Additional commands need to be written without a leading \ (e. g. foo instead of \foo).
Type: string[]
Default value: []
Allows extending the list of \label-like commands.
Hint: Additional commands need to be written without a leading \ (e. g. foo instead of \foo).
Type: string[]
Default value: []
Allows extending the list of \ref-like commands.
Hint: Additional commands need to be written without a leading \ (e. g. foo instead of \foo).
Type: string[]
Default value: []
Allows extending the list of \crefrange-like commands.
Hint: Additional commands need to be written without a leading \ (e. g. foo instead of \foo).
Type: string[]
Default value: []
Allows associating a label definition command with a custom prefix. Consider,
\newcommand{\thm}[1]{\label{thm:#1}}
\thm{foo}Then setting texlab.experimental.labelDefinitionPrefixes to [["thm", "thm:"]] and adding "thm" to texlab.experimental.labelDefinitionCommands
will make the server recognize the thm:foo label.
Type: (string, string)[]
Default value: []
Allows associating a label reference command with a custom prefix.
See texlab.experimental.labelDefinitionPrefixes for more details.
Type: (string, string)[]
Default value: []
Allows extending the list of \gls-like commands.
Hint: Additional commands need to be written without a leading \ (e. g. foo instead of \foo).
Type: string[]
Default value: []