Skip to content

Commit 9746ff1

Browse files
committed
Update README.md to disable Python language server for t-linter compatibility
1 parent 01ec7b1 commit 9746ff1

File tree

2 files changed

+40
-8
lines changed

2 files changed

+40
-8
lines changed

README.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,21 @@ Install the extension from the Visual Studio Code Marketplace:
4040
3. Search for "t-linter"
4141
4. Click Install on "T-Linter - Python Template Strings Highlighter & Linter" by koxudaxi
4242

43-
**Step 3: Configure the server path (if needed)**
43+
**Step 3: Disable Python Language Server**
44+
To prevent conflicts with t-linter's syntax highlighting, disable the Python language server:
45+
46+
1. Open VSCode Settings (Ctrl+, / Cmd+,)
47+
2. Search for "python.languageServer"
48+
3. Set it to "None"
49+
50+
Alternatively, add to your settings.json:
51+
```json
52+
{
53+
"python.languageServer": "None"
54+
}
55+
```
56+
57+
**Step 4: Configure the server path (if needed)**
4458
If t-linter is not in your PATH, configure the server path in VSCode settings:
4559

4660
1. **Find your t-linter path** by running in terminal:
@@ -87,8 +101,9 @@ After installing both the PyPI package and VSCode extension, t-linter will autom
87101

88102
**Troubleshooting**: If syntax highlighting doesn't work:
89103
1. Ensure `t-linter` is installed: Run `t-linter --version` in terminal
90-
2. Check the server path in VSCode settings: `t-linter.serverPath`
91-
3. Restart VSCode after making changes
104+
2. Check that Python language server is disabled: `python.languageServer` should be set to "None"
105+
3. Check the server path in VSCode settings: `t-linter.serverPath`
106+
4. Restart VSCode after making changes
92107

93108
### Command Line Interface
94109
If you installed via PyPI, you can use t-linter from the command line:

editors/vscode/README.md

Lines changed: 22 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,23 @@ pip install t-linter
4040
3. Search for "t-linter"
4141
4. Click Install on "T-Linter - Python Template Strings Highlighter & Linter" by koxudaxi
4242

43-
### Step 3: Configure server path (if needed)
43+
### Step 3: Disable Python Language Server
44+
To prevent conflicts with t-linter's syntax highlighting, you need to disable the Python language server:
45+
46+
1. Open VSCode Settings (Ctrl+, / Cmd+,)
47+
2. Search for "python.languageServer"
48+
3. Set it to "None"
49+
50+
Alternatively, add to your settings.json:
51+
```json
52+
{
53+
"python.languageServer": "None"
54+
}
55+
```
56+
57+
[Learn more about Python language server settings](https://code.visualstudio.com/docs/python/settings-reference#_intellisense-engine-settings)
58+
59+
### Step 4: Configure server path (if needed)
4460
If the extension can't find the t-linter binary automatically:
4561

4662
1. **Find your t-linter path**:
@@ -158,10 +174,11 @@ If you see "t-linter binary not found":
158174

159175
### No syntax highlighting
160176
1. Ensure both the PyPI package AND VSCode extension are installed
161-
2. Check that Python semantic highlighting is enabled in VSCode
162-
3. Verify your template strings use the `t"..."` syntax
163-
4. Ensure type annotations are correctly formatted
164-
5. Try restarting the language server: `Ctrl+Shift+P` → "T-Linter: Restart Server"
177+
2. **Verify that Python language server is disabled**: `python.languageServer` should be set to "None"
178+
3. Check that Python semantic highlighting is enabled in VSCode
179+
4. Verify your template strings use the `t"..."` syntax
180+
5. Ensure type annotations are correctly formatted
181+
6. Try restarting the language server: `Ctrl+Shift+P` → "T-Linter: Restart Server"
165182

166183
### Performance issues
167184
- Disable `t-linter.enableTypeChecking` if you don't need cross-module type resolution

0 commit comments

Comments
 (0)