You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[](https://github.com/ChrisChinchilla/vale-vscode/actions/workflows/publishTags.yml)
4
-
[](https://github.com/sponsors/chrischinchilla)
4
+
5
+
> The Visual Studio Code extension for [Vale](https://github.com/errata-ai/vale).
5
6
6
7
The Vale extension for VS Code provides customizable spelling, style, and grammar checking for a variety of markup formats (Markdown, AsciiDoc, reStructuredText, HTML, and DITA).
7
8
9
+
## Important notes on switch to Vale Language Server as of v0.30.0
10
+
11
+
There are issues I know about with this switch. But I have been sitting on this for so long I wanted to release it and will fix soon™️.
12
+
13
+
**If the extension is unable while I fix those features, then the old pre-LSP version is still available as the pre-release version (v0.21.0) of the extension.**
14
+
15
+
> [!NOTE]
16
+
> This new release uses the [Vale Language Server](https://github.com/errata-ai/vale-ls). This allows for tighter integration with Vale features, but does involve more platform specific work and some features of the old extension are harder to implement.
17
+
> I based re-development of these features [on this survey](https://github.com/ChrisChinchilla/vale-vscode/discussions/50). If you find features you use no longer working, [open an issue](https://github.com/ChrisChinchilla/vale-vscode/issues/new).
18
+
19
+
> [!WARNING]
20
+
> I know that for those of you use you workspaces, the extension has been broken for a little while. Sorry! I am working on this.
21
+
> The Vale Language Server also has no support for custom Vale binary paths. Again, I am attempting to find a solution to this.
2. install `vale-vscode` (this extension) via the [Marketplace](https://marketplace.visualstudio.com/items?itemName=chrischinchilla.vale-vscode);
12
27
3. Restart VS Code (recommended).
13
28
14
-
### Install pre-release
15
-
16
-
_Want to test the pre-release version? Use the "Switch to Pre-Release Version" button on extension page in VSCode._
17
-
18
-
The current pre-release version is `0.21.0` and switches to using the [Vale language server protocol (LSP)](https://github.com/errata-ai/vale-ls). Only basic problem highlighting works, but your help is appreciated in testing and providing feedback.
19
-
20
29
## Features
21
30
22
31
At the moment, the extension uses any [configuration](https://vale.sh/docs/topics/config/), [vocabularies](https://vale.sh/docs/topics/vocab/), and [packages](https://vale.sh/docs/topics/packages/) defined in your Vale configuration. If you experience any issues with the extension, check if Vale runs as expected on the command line first.
@@ -45,8 +54,6 @@ Fix word usage, capitalization, and more using [Quick Fixes](https://code.visual
45
54
46
55
### Spell checking
47
56
48
-
> As of version 0.17.0, the extension supports spell-checking. The feature is new and likely to change, you can disable it from the settings if you use other spell checkers or experience performance issues.
49
-
50
57
**You need a [`spelling` style](https://vale.sh/docs/topics/styles/#spelling) in your Vale configuration to enable spell-checking**.
51
58
52
59
With no additional Vale configuration, the spell checker uses a Hunspell-compatible US English dictionary. If you want to use other custom dictionaries, then configure your [`spelling` style](https://vale.sh/docs/topics/styles/#spelling) with custom dictionaries.
@@ -57,38 +64,10 @@ The extension doesn't support adding words to dictionaries. For now, the best op
57
64
58
65
The extension offers a number of settings and configuration options (_Preferences > Extensions > Vale_).
59
66
60
-
-`vale.valeCLI.config` (default: `null`): Absolute path to a Vale configuration file. Use the predefined [`${workspaceFolder}`](https://code.visualstudio.com/docs/editor/variables-reference#_predefined-variables) variable to reference configuration file from a custom location. (**NOTE**: On Windows you can use '/' and can omit `.cmd` in the path value.) If not specified, the extension uses the default search process (relative to the current file).
61
-
62
-
**Example**
63
-
64
-
```jsonc
65
-
{
66
-
// You can use ${workspaceFolder} it will be replaced by workspace folder path
-`vale.valeCLI.path` (default: `null`): Absolute path to the Vale binary. Use the predefined [`${workspaceFolder}`](https://code.visualstudio.com/docs/editor/variables-reference#_predefined-variables) variable to reference a non-global binary. (**NOTE**: On Windows you can use '/' and can omit `.cmd` in the path value.)
75
-
76
-
**Example**
77
-
78
-
```jsonc
79
-
{
80
-
// You can use ${workspaceFolder} it will be replaced by workspace folder path
-`vale.valeCLI.config` (default: `null`): Absolute path to a Vale configuration file.
88
68
-`vale.valeCLI.minAlertLevel` (default: `inherited`): Defines from which level of errors and above to display in the problems view.
89
-
90
69
-`vale.doNotShowWarningForFileToBeSavedBeforeLinting` (default: `false`): Toggle display of warning dialog that you must save a file before Vale lints it.
91
-
92
70
-`vale.readabilityProblemLocation` (default: `status`): If you have any `Readability` or `metric` styles, the extension can display the readability score in the status bar, the problems view, or both.
93
-
94
71
-`vale.enableSpellcheck` (default: `false`): Enable in-built spell checking for any `Spelling` styles.
72
+
-`vale.valeCLI.syncOnStartup` (default: `false`): If you have packages in a _.vale.ini_ file, then sync them on startup.
0 commit comments