Change language of this page:English,German
ltex.enabledControls whether the extension is enabled. Allows disabling LanguageTool on specific workspaces or for specific code language modes (i.e., file types).
Either supply a Boolean value stating whether LTEX is enabled for all supported markup languages or disabled for all of them, or supply a list ofcode language identifiers for which LTEX should be enabled (note that extensions can define additional code language identifiers).
All supported markup languages are listed in the default value of this setting. In addition, LTEX can check comments in many popular programming languages like C++ or Java, if you add the corresponding code language identifiers to this setting. If you add an unsupported code language mode, LTEX will check corresponding files as plain text without any parsing.
The activation events are unaffected by this setting. This means that the extension will be activated whenever a file with a supported code language mode is opened. For unsupported code language modes, you may need to activate the extension explicitly by executing theLTeX: Activate Extension command.
Changes require restarting LTEX to take effect.
Type:boolean orarray
Examples:
truefalse["latex", "markdown"]Default:["bibtex", "context", "context.tex", "html", "latex", "markdown", "org", "restructuredtext", "rsweave"]
Full type description:
One of the following types:
booleanArray where each entry has the following type:
stringltex.languageThe language (e.g.,"en-US") LanguageTool should check against. Use a specific variant like"en-US" or"de-DE" instead of the generic language code like"en" or"de" to obtain spelling corrections (in addition to grammar corrections).
When using the language code"auto", LTEX will try to detect the language of the document. This is not recommended, as only generic languages like"en" or"de" will be detected and thus no spelling errors will be reported.
Type:string
Possible values:
"auto": Automatic language detection (not recommended)"ar": Arabic"ast-ES": Asturian"be-BY": Belarusian"br-FR": Breton"ca-ES": Catalan"ca-ES-valencia": Catalan (Valencian)"da-DK": Danish"de": German"de-AT": German (Austria)"de-CH": German (Swiss)"de-DE": German (Germany)"de-DE-x-simple-language": Simple German"el-GR": Greek"en": English"en-AU": English (Australian)"en-CA": English (Canadian)"en-GB": English (GB)"en-NZ": English (New Zealand)"en-US": English (US)"en-ZA": English (South African)"eo": Esperanto"es": Spanish"es-AR": Spanish (voseo)"fa": Persian"fr": French"ga-IE": Irish"gl-ES": Galician"it": Italian"ja-JP": Japanese"km-KH": Khmer"nl": Dutch"nl-BE": Dutch (Belgium)"pl-PL": Polish"pt": Portuguese"pt-AO": Portuguese (Angola preAO)"pt-BR": Portuguese (Brazil)"pt-MZ": Portuguese (Moçambique preAO)"pt-PT": Portuguese (Portugal)"ro-RO": Romanian"ru-RU": Russian"sk-SK": Slovak"sl-SI": Slovenian"sv": Swedish"ta-IN": Tamil"tl-PH": Tagalog"uk-UA": Ukrainian"zh-CN": ChineseDefault:"en-US"
ltex.dictionaryLists of additional words that should not be counted as spelling errors.
This setting is language-specific, so use an object of the format{"<LANGUAGE1>": ["<WORD1>", "<WORD2>", ...], "<LANGUAGE2>": ["<WORD1>", "<WORD2>", ...], ...}, where<LANGUAGE> denotes the language code inltex.language.
This setting is a multi-scope setting.See the documentation for details.
This setting supports external files.See the documentation for details.
By default, no additional spelling errors will be ignored.
Type:object
Example:{"en-US": ["adaptivity", "precomputed", "subproblem"], "de-DE": ["B-Splines", ":/path/to/externalFile.txt"]}
Default:{}
Full type description:
Object with the following properties:
"ar": List of additionalar (Arabic) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"ast-ES": List of additionalast-ES (Asturian) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"be-BY": List of additionalbe-BY (Belarusian) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"br-FR": List of additionalbr-FR (Breton) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"ca-ES": List of additionalca-ES (Catalan) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"ca-ES-valencia": List of additionalca-ES-valencia (Catalan (Valencian)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"da-DK": List of additionalda-DK (Danish) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"de": List of additionalde (German) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"de-AT": List of additionalde-AT (German (Austria)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"de-CH": List of additionalde-CH (German (Swiss)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"de-DE": List of additionalde-DE (German (Germany)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"de-DE-x-simple-language": List of additionalde-DE-x-simple-language (Simple German) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"el-GR": List of additionalel-GR (Greek) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"en": List of additionalen (English) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"en-AU": List of additionalen-AU (English (Australian)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"en-CA": List of additionalen-CA (English (Canadian)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"en-GB": List of additionalen-GB (English (GB)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"en-NZ": List of additionalen-NZ (English (New Zealand)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"en-US": List of additionalen-US (English (US)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"en-ZA": List of additionalen-ZA (English (South African)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"eo": List of additionaleo (Esperanto) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"es": List of additionales (Spanish) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"es-AR": List of additionales-AR (Spanish (voseo)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"fa": List of additionalfa (Persian) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"fr": List of additionalfr (French) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"ga-IE": List of additionalga-IE (Irish) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"gl-ES": List of additionalgl-ES (Galician) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"it": List of additionalit (Italian) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"ja-JP": List of additionalja-JP (Japanese) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"km-KH": List of additionalkm-KH (Khmer) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"nl": List of additionalnl (Dutch) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"nl-BE": List of additionalnl-BE (Dutch (Belgium)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"pl-PL": List of additionalpl-PL (Polish) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"pt": List of additionalpt (Portuguese) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"pt-AO": List of additionalpt-AO (Portuguese (Angola preAO)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"pt-BR": List of additionalpt-BR (Portuguese (Brazil)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"pt-MZ": List of additionalpt-MZ (Portuguese (Moçambique preAO)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"pt-PT": List of additionalpt-PT (Portuguese (Portugal)) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"ro-RO": List of additionalro-RO (Romanian) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"ru-RU": List of additionalru-RU (Russian) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"sk-SK": List of additionalsk-SK (Slovak) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"sl-SI": List of additionalsl-SI (Slovenian) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"sv": List of additionalsv (Swedish) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"ta-IN": List of additionalta-IN (Tamil) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"tl-PH": List of additionaltl-PH (Tagalog) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"uk-UA": List of additionaluk-UA (Ukrainian) words that should not be counted as spelling errors.
Array where each entry has the following type:
string"zh-CN": List of additionalzh-CN (Chinese) words that should not be counted as spelling errors.
Array where each entry has the following type:
stringltex.disabledRulesLists of rules that should be disabled (if enabled by default by LanguageTool).
This setting is language-specific, so use an object of the format{"<LANGUAGE1>": ["<RULE1>", "<RULE2>", ...], "<LANGUAGE2>": ["<RULE1>", "<RULE2>", ...], ...}, where<LANGUAGE> denotes the language code inltex.language and<RULE> the ID of the LanguageTool rule.
This setting is a multi-scope setting.See the documentation for details.
This setting supports external files.See the documentation for details.
By default, no additional rules will be disabled.
Type:object
Example:{"en-US": ["EN_QUOTES", "UPPERCASE_SENTENCE_START", ":/path/to/externalFile.txt"]}
Default:{}
Full type description:
Object with the following properties:
"ar": List of additionalar (Arabic) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"ast-ES": List of additionalast-ES (Asturian) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"be-BY": List of additionalbe-BY (Belarusian) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"br-FR": List of additionalbr-FR (Breton) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"ca-ES": List of additionalca-ES (Catalan) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"ca-ES-valencia": List of additionalca-ES-valencia (Catalan (Valencian)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"da-DK": List of additionalda-DK (Danish) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"de": List of additionalde (German) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"de-AT": List of additionalde-AT (German (Austria)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"de-CH": List of additionalde-CH (German (Swiss)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"de-DE": List of additionalde-DE (German (Germany)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"de-DE-x-simple-language": List of additionalde-DE-x-simple-language (Simple German) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"el-GR": List of additionalel-GR (Greek) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"en": List of additionalen (English) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"en-AU": List of additionalen-AU (English (Australian)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"en-CA": List of additionalen-CA (English (Canadian)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"en-GB": List of additionalen-GB (English (GB)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"en-NZ": List of additionalen-NZ (English (New Zealand)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"en-US": List of additionalen-US (English (US)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"en-ZA": List of additionalen-ZA (English (South African)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"eo": List of additionaleo (Esperanto) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"es": List of additionales (Spanish) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"es-AR": List of additionales-AR (Spanish (voseo)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"fa": List of additionalfa (Persian) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"fr": List of additionalfr (French) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"ga-IE": List of additionalga-IE (Irish) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"gl-ES": List of additionalgl-ES (Galician) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"it": List of additionalit (Italian) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"ja-JP": List of additionalja-JP (Japanese) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"km-KH": List of additionalkm-KH (Khmer) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"nl": List of additionalnl (Dutch) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"nl-BE": List of additionalnl-BE (Dutch (Belgium)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"pl-PL": List of additionalpl-PL (Polish) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"pt": List of additionalpt (Portuguese) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"pt-AO": List of additionalpt-AO (Portuguese (Angola preAO)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"pt-BR": List of additionalpt-BR (Portuguese (Brazil)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"pt-MZ": List of additionalpt-MZ (Portuguese (Moçambique preAO)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"pt-PT": List of additionalpt-PT (Portuguese (Portugal)) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"ro-RO": List of additionalro-RO (Romanian) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"ru-RU": List of additionalru-RU (Russian) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"sk-SK": List of additionalsk-SK (Slovak) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"sl-SI": List of additionalsl-SI (Slovenian) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"sv": List of additionalsv (Swedish) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"ta-IN": List of additionalta-IN (Tamil) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"tl-PH": List of additionaltl-PH (Tagalog) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"uk-UA": List of additionaluk-UA (Ukrainian) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
string"zh-CN": List of additionalzh-CN (Chinese) rules that should be disabled (if enabled by default by LanguageTool).
Array where each entry has the following type:
stringltex.enabledRulesLists of rules that should be enabled (if disabled by default by LanguageTool).
This setting is language-specific, so use an object of the format{"<LANGUAGE1>": ["<RULE1>", "<RULE2>", ...], "<LANGUAGE2>": ["<RULE1>", "<RULE2>", ...], ...}, where<LANGUAGE> denotes the language code inltex.language and<RULE> the ID of the LanguageTool rule.
This setting is a multi-scope setting.See the documentation for details.
This setting supports external files.See the documentation for details.
By default, no additional rules will be enabled.
Type:object
Example:{"en-GB": ["PASSIVE_VOICE", "OXFORD_SPELLING_NOUNS", ":/path/to/externalFile.txt"]}
Default:{}
Full type description:
Object with the following properties:
"ar": List of additionalar (Arabic) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"ast-ES": List of additionalast-ES (Asturian) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"be-BY": List of additionalbe-BY (Belarusian) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"br-FR": List of additionalbr-FR (Breton) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"ca-ES": List of additionalca-ES (Catalan) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"ca-ES-valencia": List of additionalca-ES-valencia (Catalan (Valencian)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"da-DK": List of additionalda-DK (Danish) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"de": List of additionalde (German) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"de-AT": List of additionalde-AT (German (Austria)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"de-CH": List of additionalde-CH (German (Swiss)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"de-DE": List of additionalde-DE (German (Germany)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"de-DE-x-simple-language": List of additionalde-DE-x-simple-language (Simple German) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"el-GR": List of additionalel-GR (Greek) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"en": List of additionalen (English) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"en-AU": List of additionalen-AU (English (Australian)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"en-CA": List of additionalen-CA (English (Canadian)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"en-GB": List of additionalen-GB (English (GB)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"en-NZ": List of additionalen-NZ (English (New Zealand)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"en-US": List of additionalen-US (English (US)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"en-ZA": List of additionalen-ZA (English (South African)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"eo": List of additionaleo (Esperanto) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"es": List of additionales (Spanish) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"es-AR": List of additionales-AR (Spanish (voseo)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"fa": List of additionalfa (Persian) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"fr": List of additionalfr (French) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"ga-IE": List of additionalga-IE (Irish) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"gl-ES": List of additionalgl-ES (Galician) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"it": List of additionalit (Italian) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"ja-JP": List of additionalja-JP (Japanese) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"km-KH": List of additionalkm-KH (Khmer) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"nl": List of additionalnl (Dutch) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"nl-BE": List of additionalnl-BE (Dutch (Belgium)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"pl-PL": List of additionalpl-PL (Polish) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"pt": List of additionalpt (Portuguese) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"pt-AO": List of additionalpt-AO (Portuguese (Angola preAO)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"pt-BR": List of additionalpt-BR (Portuguese (Brazil)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"pt-MZ": List of additionalpt-MZ (Portuguese (Moçambique preAO)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"pt-PT": List of additionalpt-PT (Portuguese (Portugal)) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"ro-RO": List of additionalro-RO (Romanian) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"ru-RU": List of additionalru-RU (Russian) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"sk-SK": List of additionalsk-SK (Slovak) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"sl-SI": List of additionalsl-SI (Slovenian) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"sv": List of additionalsv (Swedish) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"ta-IN": List of additionalta-IN (Tamil) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"tl-PH": List of additionaltl-PH (Tagalog) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"uk-UA": List of additionaluk-UA (Ukrainian) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
string"zh-CN": List of additionalzh-CN (Chinese) rules that should be enabled (if disabled by default by LanguageTool).
Array where each entry has the following type:
stringltex.hiddenFalsePositivesLists of false-positive diagnostics to hide (by hiding all diagnostics of a specific rule within a specific sentence).
This setting is language-specific, so use an object of the format{"<LANGUAGE1>": ["<JSON1>", "<JSON2>", ...], "<LANGUAGE2>": ["<JSON1>", "<JSON2>", ...], ...}, where<LANGUAGE> denotes the language code inltex.language and<JSON> is a JSON string containing information about the rule and sentence.
Although it is possible to manually edit this setting, the intended way is theHide false positive quick fix.
The JSON string currently has the form{"rule": "<RULE>", "sentence": "<SENTENCE>"}, where<RULE> is the ID of the LanguageTool rule and<SENTENCE> is a Java-compatible regular expression. All occurrences of the given rule are hidden in sentences (as determined by the LanguageTool tokenizer) that match the regular expression.See the documentation for details.
This setting is a multi-scope setting.See the documentation for details.
This setting supports external files.See the documentation for details.
If this list is very large, performance may suffer.
Type:object
Example:{"en-US": [":/path/to/externalFile.txt"]}
Default:{}
Full type description:
Object with the following properties:
"ar": List ofar (Arabic) false-positive diagnostics to hide.
Array where each entry has the following type:
string"ast-ES": List ofast-ES (Asturian) false-positive diagnostics to hide.
Array where each entry has the following type:
string"be-BY": List ofbe-BY (Belarusian) false-positive diagnostics to hide.
Array where each entry has the following type:
string"br-FR": List ofbr-FR (Breton) false-positive diagnostics to hide.
Array where each entry has the following type:
string"ca-ES": List ofca-ES (Catalan) false-positive diagnostics to hide.
Array where each entry has the following type:
string"ca-ES-valencia": List ofca-ES-valencia (Catalan (Valencian)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"da-DK": List ofda-DK (Danish) false-positive diagnostics to hide.
Array where each entry has the following type:
string"de": List ofde (German) false-positive diagnostics to hide.
Array where each entry has the following type:
string"de-AT": List ofde-AT (German (Austria)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"de-CH": List ofde-CH (German (Swiss)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"de-DE": List ofde-DE (German (Germany)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"de-DE-x-simple-language": List ofde-DE-x-simple-language (Simple German) false-positive diagnostics to hide.
Array where each entry has the following type:
string"el-GR": List ofel-GR (Greek) false-positive diagnostics to hide.
Array where each entry has the following type:
string"en": List ofen (English) false-positive diagnostics to hide.
Array where each entry has the following type:
string"en-AU": List ofen-AU (English (Australian)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"en-CA": List ofen-CA (English (Canadian)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"en-GB": List ofen-GB (English (GB)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"en-NZ": List ofen-NZ (English (New Zealand)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"en-US": List ofen-US (English (US)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"en-ZA": List ofen-ZA (English (South African)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"eo": List ofeo (Esperanto) false-positive diagnostics to hide.
Array where each entry has the following type:
string"es": List ofes (Spanish) false-positive diagnostics to hide.
Array where each entry has the following type:
string"es-AR": List ofes-AR (Spanish (voseo)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"fa": List offa (Persian) false-positive diagnostics to hide.
Array where each entry has the following type:
string"fr": List offr (French) false-positive diagnostics to hide.
Array where each entry has the following type:
string"ga-IE": List ofga-IE (Irish) false-positive diagnostics to hide.
Array where each entry has the following type:
string"gl-ES": List ofgl-ES (Galician) false-positive diagnostics to hide.
Array where each entry has the following type:
string"it": List ofit (Italian) false-positive diagnostics to hide.
Array where each entry has the following type:
string"ja-JP": List ofja-JP (Japanese) false-positive diagnostics to hide.
Array where each entry has the following type:
string"km-KH": List ofkm-KH (Khmer) false-positive diagnostics to hide.
Array where each entry has the following type:
string"nl": List ofnl (Dutch) false-positive diagnostics to hide.
Array where each entry has the following type:
string"nl-BE": List ofnl-BE (Dutch (Belgium)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"pl-PL": List ofpl-PL (Polish) false-positive diagnostics to hide.
Array where each entry has the following type:
string"pt": List ofpt (Portuguese) false-positive diagnostics to hide.
Array where each entry has the following type:
string"pt-AO": List ofpt-AO (Portuguese (Angola preAO)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"pt-BR": List ofpt-BR (Portuguese (Brazil)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"pt-MZ": List ofpt-MZ (Portuguese (Moçambique preAO)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"pt-PT": List ofpt-PT (Portuguese (Portugal)) false-positive diagnostics to hide.
Array where each entry has the following type:
string"ro-RO": List ofro-RO (Romanian) false-positive diagnostics to hide.
Array where each entry has the following type:
string"ru-RU": List ofru-RU (Russian) false-positive diagnostics to hide.
Array where each entry has the following type:
string"sk-SK": List ofsk-SK (Slovak) false-positive diagnostics to hide.
Array where each entry has the following type:
string"sl-SI": List ofsl-SI (Slovenian) false-positive diagnostics to hide.
Array where each entry has the following type:
string"sv": List ofsv (Swedish) false-positive diagnostics to hide.
Array where each entry has the following type:
string"ta-IN": List ofta-IN (Tamil) false-positive diagnostics to hide.
Array where each entry has the following type:
string"tl-PH": List oftl-PH (Tagalog) false-positive diagnostics to hide.
Array where each entry has the following type:
string"uk-UA": List ofuk-UA (Ukrainian) false-positive diagnostics to hide.
Array where each entry has the following type:
string"zh-CN": List ofzh-CN (Chinese) false-positive diagnostics to hide.
Array where each entry has the following type:
stringltex.bibtex.fieldsList of BibTEX fields whose values are to be checked in BibTEX files.
This setting is an object with the field names as keys (not restricted to classical BibTEX fields) and Booleans as values, wheretrue means that the field value should be checked andfalse means that the field value should be ignored.
Some common fields are already ignored, even if you set this setting to an empty object.
Type:object
Example:{"maintitle": false, "seealso": true}
Default:{}
Full type description:
Object with arbitrary property names, where the value of each property has the following type:
booleanltex.latex.commandsList of LATEX commands to be handled by the LATEX parser, listed together with empty arguments (e.g.,"\ref{}","\documentclass[]{}").
This setting is an object with the commands as keys and corresponding actions as values.
If you edit thesettings.json file directly, don’t forget to escape the initial backslash by replacing it with two backslashes. If you use the VS Code Settings panel, only type one backslash.
Many common commands are already handled by default, even if you set this setting to an empty object.
Type:object
Example:{"\\label{}": "ignore", "\\documentclass[]{}": "ignore", "\\cite{}": "dummy", "\\cite[]{}": "dummy"}
Default:{}
Full type description:
Object with arbitrary property names, where the value of each property has the following type:
One of the following values:
"default": The command is treated like unknown commands are treated by default: The command name itself is ignored, but the arguments are not ignored."ignore": The whole command together with its arguments is ignored."dummy": The whole command together with its arguments is replaced with a dummy word (i.e.,Dummy0,Dummy1, etc.). LTEX internally uses this mechanism for equations, citations, references, and similar constructs that are part of the sentence structure and for which LanguageTool would throw an error if simply omitted from the checked text."pluralDummy": The whole command together with its arguments is replaced with a plural dummy word (i.e.,Dummies). See description for"dummy"."vowelDummy": The whole command together with its arguments is replaced with a vowel dummy word (i.e.,Ina). See description for"dummy".ltex.latex.environmentsList of names of LATEX environments to be handled by the LATEX parser.
This setting is an object with the environment names as keys and corresponding actions as values.
Some environments are already handled by default, even if you set this setting to an empty object.
Type:object
Example:{"lstlisting": "ignore", "verbatim": "ignore"}
Default:{}
Full type description:
Object with arbitrary property names, where the value of each property has the following type:
One of the following values:
"default": The environment is treated like unknown environments are treated by default: The arguments of the environment are ignored, but the contents of the environment are not ignored."ignore": The whole environment together with its arguments and contents is ignored.ltex.markdown.nodesList of Markdown node types to be handled by the Markdown parser.
This setting is an object with the node types as keys and corresponding actions as values.
The Markdown parser constructs an AST (abstract syntax tree) for the Markdown document, in which all leaves have node typeText. The possible node types are listed in thedocumentation of flexmark-java.
Some common node types are already handled by default, even if you set this setting to an empty object.
Type:object
Example:{"CodeBlock": "ignore", "FencedCodeBlock": "ignore", "AutoLink": "dummy", "Code": "dummy"}
Default:{}
Full type description:
Object with arbitrary property names, where the value of each property has the following type:
One of the following values:
"default": The node is not treated specially."ignore": The whole node together with itsText leaves is ignored."dummy": The whole node together with itsText leaves is replaced with a dummy word (i.e.,Dummy0,Dummy1, etc.). LTEX internally uses this mechanism for example for inline code (inside backticks) that is part of the sentence structure and for which LanguageTool would throw an error if simply omitted from the checked text."pluralDummy": The whole node together with itsText leaves is replaced with a plural dummy word (i.e.,Dummies). See description for"dummy"."vowelDummy": The whole node together with itsText leaves is replaced with a vowel dummy word (i.e.,Ina). See description for"dummy".ltex.configurationTargetControls whichsettings.json or external setting file (see documentation) to update when using one of the quick fixes.
Type:object
Default:{"dictionary": "workspaceFolderExternalFile", "disabledRules": "workspaceFolderExternalFile", "hiddenFalsePositives": "workspaceFolderExternalFile"}
Full type description:
Object with the following properties:
"dictionary": One of the following values:
"user": When adding a word to the dictionary, always update the user configuration."workspace": When adding a word to the dictionary, update the workspace configuration if currently in a workspace, otherwise update the user configuration."workspaceFolder": When adding a word to the dictionary, update the workspace folder configuration if currently in a workspace folder, otherwise update the workspace configuration if currently in a workspace, otherwise update the user configuration."userExternalFile": When adding a word to the dictionary, always update the first external setting file listed in the user configuration."workspaceExternalFile": When adding a word to the dictionary, update the first external setting file listed in the workspace configuration if currently in a workspace, otherwise update the analogous file in the user configuration."workspaceFolderExternalFile": When adding a word to the dictionary, update the first external setting file listed in the workspace folder configuration if currently in a workspace folder, otherwise update the analogous file in the workspace configuration if currently in a workspace, otherwise update the analogous file in the user configuration."disabledRules": One of the following values:
"user": When disabling a rule, always update the user configuration."workspace": When disabling a rule, update the workspace configuration if currently in a workspace, otherwise update the user configuration."workspaceFolder": When disabling a rule, update the workspace folder configuration if currently in a workspace folder, otherwise update the workspace configuration if currently in a workspace, otherwise update the user configuration."userExternalFile": When disabling a rule, always update the first external setting file listed in the user configuration."workspaceExternalFile": When disabling a rule, update the first external setting file listed in the workspace configuration if currently in a workspace, otherwise update the analogous file in the user configuration."workspaceFolderExternalFile": When disabling a rule, update the first external setting file listed in the workspace folder configuration if currently in a workspace folder, otherwise update the analogous file in the workspace configuration if currently in a workspace, otherwise update the analogous file in the user configuration."hiddenFalsePositives": One of the following values:
"user": When hiding a false positive, always update the user configuration."workspace": When hiding a false positive, update the workspace configuration if currently in a workspace, otherwise update the user configuration."workspaceFolder": When hiding a false positive, update the workspace folder configuration if currently in a workspace folder, otherwise update the workspace configuration if currently in a workspace, otherwise update the user configuration."userExternalFile": When hiding a false positive, always update the first external setting file listed in the user configuration."workspaceExternalFile": When hiding a false positive, update the first external setting file listed in the workspace configuration if currently in a workspace, otherwise update the analogous file in the user configuration."workspaceFolderExternalFile": When hiding a false positive, update the first external setting file listed in the workspace folder configuration if currently in a workspace folder, otherwise update the analogous file in the workspace configuration if currently in a workspace, otherwise update the analogous file in the user configuration.ltex.additionalRules.enablePickyRulesEnable LanguageTool rules that are marked as picky and that are disabled by default, e.g., rules about passive voice, sentence length, etc., at the cost of more false positives.
Type:boolean
Default:false
ltex.additionalRules.motherTongueOptional mother tongue of the user (e.g.,"de-DE").
If set, additional rules will be checked to detect false friends. Picky rules may need to be enabled in order to see an effect (seeltex.additionalRules.enablePickyRules). False friend detection improves if a language model is supplied (seeltex.additionalRules.languageModel).
Type:string
Possible values:
"": No mother tongue"ar": Arabic"ast-ES": Asturian"be-BY": Belarusian"br-FR": Breton"ca-ES": Catalan"ca-ES-valencia": Catalan (Valencian)"da-DK": Danish"de": German"de-AT": German (Austria)"de-CH": German (Swiss)"de-DE": German (Germany)"de-DE-x-simple-language": Simple German"el-GR": Greek"en": English"en-AU": English (Australian)"en-CA": English (Canadian)"en-GB": English (GB)"en-NZ": English (New Zealand)"en-US": English (US)"en-ZA": English (South African)"eo": Esperanto"es": Spanish"es-AR": Spanish (voseo)"fa": Persian"fr": French"ga-IE": Irish"gl-ES": Galician"it": Italian"ja-JP": Japanese"km-KH": Khmer"nl": Dutch"nl-BE": Dutch (Belgium)"pl-PL": Polish"pt": Portuguese"pt-AO": Portuguese (Angola preAO)"pt-BR": Portuguese (Brazil)"pt-MZ": Portuguese (Moçambique preAO)"pt-PT": Portuguese (Portugal)"ro-RO": Romanian"ru-RU": Russian"sk-SK": Slovak"sl-SI": Slovenian"sv": Swedish"ta-IN": Tamil"tl-PH": Tagalog"uk-UA": Ukrainian"zh-CN": ChineseDefault:""
ltex.additionalRules.languageModelOptional path to a directory with rules of a language model withn-gram occurrence counts. Set this setting to the parent directory that contains subdirectories for languages (e.g.,en).
Type:string
Default:""
ltex.additionalRules.neuralNetworkModelOptional path to a directory with rules of a pretrained neural network model.
Type:string
Default:""
ltex.additionalRules.word2VecModelOptional path to a directory with rules of a word2vec language model.
Type:string
Default:""
ltex.languageToolHttpServerUriIf set to a non-empty string, LTEX will not use the bundled, built-in version of LanguageTool. Instead, LTEX will connect to an externalLanguageTool HTTP server. Set this setting to the root URI of the server, and do not appendv2/check or similar.
Note that in this mode, the settingsltex.additionalRules.languageModel,ltex.additionalRules.neuralNetworkModel, andltex.additionalRules.word2VecModel will not take any effect.
Type:string
Example:"http://localhost:8081/"
Default:""
ltex.languageToolOrg.usernameUsername/email as used to log in at languagetool.org for Premium API access. Only relevant ifltex.languageToolHttpServerUri is set.
Type:string
Default:""
ltex.languageToolOrg.apiKeyAPI key for Premium API access. Only relevant ifltex.languageToolHttpServerUri is set.
Type:string
Default:""
ltex.ltex-ls.pathIf set to an empty string, LTEX automatically downloadsltex-ls from GitHub, stores it in the folder of the extension, and uses it for the checking process. You can point this setting to an ltex-ls release you downloaded by yourself.
Use the path to the root directory of ltex-ls (it containsbin andlib subdirectories).
Changes require restarting LTEX to take effect.
Type:string
Default:""
ltex.ltex-ls.logLevelLogging level (verbosity) of the ltex-ls server log, which is accessible viaView ›Output ›LTeX Language Server.
The levels in descending order are"severe","warning","info","config","fine","finer", and"finest". All messages that have the specified log level or a higher level are logged.
ltex-ls does not use all log levels.
Type:string
Possible values:
"severe": Minimum verbosity. Only log severe errors."warning": Very low verbosity. Only log severe errors and warnings."info": Low verbosity. Additionally, log startup and shutdown messages."config": Medium verbosity. Additionally, log configuration messages."fine": Medium to high verbosity (default). Additionally, log when LanguageTool is called or LanguageTool has to be reinitialized due to changed settings."finer": High verbosity. Log additional debugging information such as full texts to be checked."finest": Maximum verbosity. Log all available debugging information.Default:"fine"
ltex.java.pathIf set to an empty string, LTEX uses a Java distribution that is bundled with ltex-ls. You can point this setting to an existing Java installation on your computer to use that installation instead.
Use the same path as you would use for theJAVA_HOME environment variable (it usually containsbin andlib subdirectories, amongst others).
Changes require restarting LTEX to take effect.
Type:string
Default:""
ltex.java.initialHeapSizeInitial size of the Java heap memory in megabytes (corresponds to Java’s-Xms option, must be a positive integer).
Decreasing this might decrease RAM usage of the Java process.
Changes require restarting LTEX to take effect.
Type:integer
Default:64
ltex.java.maximumHeapSizeMaximum size of the Java heap memory in megabytes (corresponds to Java’s-Xmx option, must be a positive integer).
Decreasing this might decrease RAM usage of the Java process. If you set this too small, the Java process may exceed the heap size, in which case anOutOfMemoryError is thrown.
Changes require restarting LTEX to take effect.
Type:integer
Default:512
ltex.sentenceCacheSizeSize of the LanguageToolResultCache in sentences (must be a positive integer).
If only a small portion of the text changed (e.g., a single key press in the editor), LanguageTool uses the cache to avoid rechecking the complete text. LanguageTool internally splits the text into sentences, and sentences that have already been checked are skipped.
Decreasing this might decrease RAM usage of the Java process. If you set this too small, checking time may increase significantly.
Changes require restarting LTEX to take effect.
Type:integer
Default:2000
ltex.completionEnabledControls whether completion is enabled (also known as auto-completion, quick suggestions, and IntelliSense).
If this setting is enabled, then a list of words is displayed that complete the currently typed word (whenever the editor sends a completion request).
In VS Code, completion is enabled by default while typing (viaeditor.quickSuggestions). Therefore, this setting is disabled by default, as constantly displaying completion lists might annoy the user. It is recommended to enable this setting, but disableeditor.quickSuggestions. Then, LTEX completions can be requested by pressingCtrl+Space.
Type:boolean
Default:false
ltex.diagnosticSeveritySeverity of the diagnostics corresponding to the grammar and spelling errors.
Controls how and where the diagnostics appear in Visual Studio Code. The possible severities are"error","warning","information", and"hint".
This setting can either be a string with the severity to use for all diagnostics, or an object with rule-dependent severities. If an object is used, each key is the ID of a LanguageTool rule and each value is one of the possible severities. In this case, the severity of other rules, which don’t match any of the keys, has to be specified with the special key"default".
Type:string orobject
Examples:
"information"{"PASSIVE_VOICE": "hint", "default": "information"}Default:"information"
Full type description:
One of the following types:
One of the following values:
"error": Error diagnostics are usually underlined with a red squiggly line and appear in editor, minimap, Problems tab, and Explorer."warning": Warning diagnostics are usually underlined with a yellow squiggly line and appear in editor, minimap, Problems tab, and Explorer."information": Information diagnostics are usually underlined with a blue squiggly line and appear in editor, minimap, and Problems tab, but not in the Explorer."hint": Hint diagnostics are not underlined (only subtly marked) and only appear in the editor, not in minimap, Problems tab, or Explorer.Object with arbitrary property names, where the value of each property has the following type:
One of the following values:
"error": Error diagnostics are usually underlined with a red squiggly line and appear in editor, minimap, Problems tab, and Explorer."warning": Warning diagnostics are usually underlined with a yellow squiggly line and appear in editor, minimap, Problems tab, and Explorer."information": Information diagnostics are usually underlined with a blue squiggly line and appear in editor, minimap, and Problems tab, but not in the Explorer."hint": Hint diagnostics are not underlined (only subtly marked) and only appear in the editor, not in minimap, Problems tab, or Explorer.ltex.checkFrequencyControls when documents should be checked.
One of"edit","save", and"manual".
Type:string
Possible values:
"edit": Documents are checked when they are opened or edited (on every keystroke), or when the settings change."save": Documents are checked when they are opened or saved, or when the settings change."manual": Documents are not checked automatically, except when the settings change. Use commands such asLTeX: Check Current Document to manually trigger checks.Default:"edit"
ltex.clearDiagnosticsWhenClosingFileIf set totrue, diagnostics of a file are cleared when the file is closed.
Type:boolean
Default:true
ltex.statusBarItemIf set totrue, an item about the status of LTEX is shown permanently in the status bar.
Type:boolean
Default:false
ltex.trace.serverDebug setting to log the communication between language client and server.
When reporting issues, set this to"verbose" and open theLTeX Language Client log inView ›Output. Append the relevant part to the GitHub issue.
Changes require restarting LTEX to take effect.
Type:string
Possible values:
"off": Don’t log any of the communication between language client and server."messages": Log the type of requests and responses between language client and server."verbose": Log the type and contents of requests and responses between language client and server.Default:"off"