Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commita2685b0

Browse files
authored
feat: Tidy up README.md 🧹 (#183)
1 parenta4bdfc2 commita2685b0

File tree

1 file changed

+51
-57
lines changed

1 file changed

+51
-57
lines changed

‎README.md

Lines changed: 51 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
1-
#SQLLanguageServer
1+
#SQL Language Server
22

33
[![build-and-test](https://github.com/joe-re/sql-language-server/actions/workflows/test.yaml/badge.svg)](https://github.com/joe-re/sql-language-server/actions/workflows/test.yaml)
44

5-
SQL Language Server
5+
TheSQL Language Server offers autocompletion, error/warning notifications, and other editor support. It includes a linting feature, an SQL parser, and a Visual Studio Code extension. It supports MySQL, PostgreSQL, and SQLite3 databases.
66

77
![completion](https://user-images.githubusercontent.com/4954534/47268897-36b70500-d589-11e8-98b2-65cffdcd60b8.gif)
88

99
##Packages
1010

11-
- Autocompletion andnotifywarnings and errorsand some other editor support ([sql-language-server](https://github.com/joe-re/sql-language-server/tree/release/packages/server))
12-
-Lint ([sqlint](https://github.com/joe-re/sql-language-server/tree/release/packages/sqlint))
13-
-[VSC extension](https://github.com/joe-re/sql-language-server/tree/release/packages/client)
14-
-[SQL parser](https://github.com/joe-re/sql-language-server/tree/release/packages/sql-parser)
11+
-**sql-language-server**:Autocompletion andnotification ofwarnings and errors[GitHub link](https://github.com/joe-re/sql-language-server/tree/release/packages/server)
12+
-**sqlint**: Linting[GitHub link](https://github.com/joe-re/sql-language-server/tree/release/packages/sqlint)
13+
-**VSC extension**:[Github link](https://github.com/joe-re/sql-language-server/tree/release/packages/client)
14+
-**SQL parser**:[Github link](https://github.com/joe-re/sql-language-server/tree/release/packages/sql-parser)
1515

1616
###Supported DB
1717
- MySQL
@@ -22,7 +22,7 @@ SQL Language Server
2222

2323
###Visual Studio Code
2424

25-
Install[vsc extension](https://marketplace.visualstudio.com/items?itemName=joe-re.sql-language-server).
25+
Installthe[VSC extension](https://marketplace.visualstudio.com/items?itemName=joe-re.sql-language-server).
2626

2727
###Other Editors
2828

@@ -34,7 +34,7 @@ npm i -g sql-language-server
3434

3535
#####[LanguageClient-neovim](https://github.com/autozimu/LanguageClient-neovim)
3636

37-
Add the following to the init.vim file (.vimrc)
37+
Add the following to the`init.vim` file (`.vimrc`):
3838

3939
```vim
4040
let g:LanguageClient_serverCommands = {
@@ -44,18 +44,17 @@ let g:LanguageClient_serverCommands = {
4444

4545
#####[nvim-lsp](https://github.com/neovim/nvim-lspconfig#sqlls)
4646

47-
Run the following command, reference the[nvim-lsp documentation](https://github.com/neovim/nvim-lspconfig#sqlls) for more information.
47+
Run the following command and reference the[nvim-lsp documentation](https://github.com/neovim/nvim-lspconfig#sqlls) for more information.
4848

4949
```vim
5050
:LspInstall sqlls
5151
```
5252

53-
####Monaco Editor([monaco-languageclient](https://github.com/TypeFox/monaco-languageclient))
53+
####Monaco Editor([monaco-languageclient](https://github.com/TypeFox/monaco-languageclient))
5454

55-
https://github.com/joe-re/sql-language-server/blob/master/example/monaco_editor
55+
See the[example](https://github.com/joe-re/sql-language-server/blob/master/example/monaco_editor) to use the Monaco Editor to develop sql-language-server.
5656

57-
It's also used to develop sql-language-server.
58-
You can follow[development section](#development) to check Mocaco Editor working.
57+
Follow the[development section](#development) section to check Mocaco Editor working.
5958

6059
##Usage
6160

@@ -85,8 +84,8 @@ $ sql-language-server up --method stdio
8584

8685
There are two ways to use configuration files.
8786

88-
- Set personal configuration file(~/.config/sql-language-server/.sqllsrc.json)
89-
- Set project configuration file on your project root(\${YOUR_PROJECT/.sqllsrc.json})
87+
- Set personal configuration file (`~/.config/sql-language-server/.sqllsrc.json`)
88+
- Set project configuration file on your project root (`${YOUR_PROJECT}/.sqllsrc.json`)
9089
- Use workspace/configuration according to LSP specification
9190

9291
####Example for personal configuration file
@@ -134,9 +133,9 @@ There are two ways to use configuration files.
134133
}
135134
```
136135

137-
Please restart sql-language-server process aftercreate.sqllsrc.json.
136+
Please restart sql-language-server process aftercreating`.sqllsrc.json`.
138137

139-
####Parameters of connections
138+
####Connection parameters
140139

141140
| Key| Description| value| required| default|
142141
| ------------| -------------------------------------------------------------------------------------------------------------------------| -----------------------| --------| ---------------------------------|
@@ -159,26 +158,23 @@ Please restart sql-language-server process after create .sqllsrc.json.
159158
| remotePort| Port number of the server for ssh| number| false| 22|
160159
| user| User name on the server| string| false||
161160
| dbHost| Database host on the server| string| false| 127.0.0.1|
162-
| dbPort|Databse port on the server| number| false| mysql:3306, postgres:5432|
161+
| dbPort|Database port on the server| number| false| mysql:3306, postgres:5432|
163162
| identityFile| Identity file for ssh| string| false|~/.ssh/config/id_rsa|
164163
| passphrase| Passphrase to allow to use identity file| string| false||
165164

166-
####Personalconfuguration file
165+
####Personalconfiguration file
167166

168-
Personal configuration file is located on`~/.config/sql-language-server/.sqllsrc.json`.
169-
sql-language-server will try to read when it's started.
167+
The personal configuration file is located at`~/.config/sql-language-server/.sqllsrc.json`. When the SQL Language Server starts, it will try to read this file.
170168

171-
####Projectconfuguration file
169+
####Projectconfiguration file
172170

173-
Projectconfiguration file is locatedon`${YOUR_PROJECT_ROOT}/.sqllsrc.json`.
171+
The projectconfiguration file is locatedat`${YOUR_PROJECT_ROOT}/.sqllsrc.json`. This file has the same settings as the personal configuration file, with a few exceptions:
174172

175-
All setting items are similarly to personal configuration file, with some exceptions:
173+
- The connection property is specified directly, rather than as an array.
174+
- The project path does not need to be set. If it is set, it will be ignored.
175+
- The project configuration file is merged with the personal configuration file, if it exists.
176176

177-
- Specify under`connection` property element directly(you don't need to set array)
178-
- You don't need to set project path.(if you set it it will be ignored)
179-
- It's merged to personal configuration if you have it.
180-
181-
Example:
177+
Here is an example project configuration file for a PostgreSQL database:
182178
```json
183179
{
184180
"name":"postgres-project",
@@ -190,7 +186,7 @@ Example:
190186
}
191187
```
192188

193-
And also ifyou have set personal configuration and both of them's names are matched, it's mergedautomatically.
189+
Ifyou havealsosetapersonal configuration, the project configuration and personal configure will be mergedif they have the same name.
194190

195191
Personal configuration example:
196192
```json
@@ -210,7 +206,7 @@ Personal configuration example:
210206
}
211207
```
212208

213-
It will merge them asfollowing:
209+
It will merge them asfollows:
214210

215211
```json
216212
{
@@ -232,12 +228,12 @@ It will merge them as following:
232228
}
233229
```
234230

235-
####workspace/configuration
231+
####Workspaceconfiguration for sql-language-server
236232

237233
#####Parameters of workspace configuration
238234

239-
- connections: It'sthe same as`connections` params ofpersonalconfig file
240-
- lint: It'sthe same as configuration of[sqlint](https://github.com/joe-re/sql-language-server/tree/release/packages/sqlint#configuration).
235+
-`connections`: This parameter isthe same astheconnections parameter in thepersonalconfiguration file. It allows you to specify the connections for your workspace.
236+
-`lint`: This parameter isthe same astheconfiguration of[sqlint](https://github.com/joe-re/sql-language-server/tree/release/packages/sqlint#configuration). It allows you to configure the linting rules for your workspace.
241237

242238

243239
#####Example of workspace configuration
@@ -290,7 +286,7 @@ It will merge them as following:
290286
}
291287
```
292288

293-
-vscode workspace setting
289+
-VS Code workspace setting
294290

295291
```json
296292
"settings": {
@@ -327,12 +323,12 @@ It will merge them as following:
327323
```
328324

329325

330-
####Injectenvitonment variables
326+
####Injectenvironment variables
331327

332-
${env:VARIABLE_NAME} syntax allows you to replace configuration value withenviroment variable.
333-
This is usefulwhen you don't want towrite actual valueon the configuration file.
328+
`${env:VARIABLE_NAME}` syntax allows you to replace configuration value withan environment variable.
329+
This is usefulif you don't want tostore the valuein the configuration file.
334330

335-
#####example
331+
#####Example
336332

337333
```json
338334
{
@@ -355,7 +351,7 @@ This is useful when you don't want to write actual value on the configuration fi
355351

356352
####Switch database connection
357353

358-
If you have multiple connectioninformation onpersonal config file, you canswtich database connection.
354+
If you have multiple connectionentries in yourpersonal config file, you canswitch the database connection.
359355

360356
![2020-05-25_15-23-01](https://user-images.githubusercontent.com/4954534/82788937-02f63c80-9e9c-11ea-948d-e27ee0090463.gif)
361357

@@ -372,22 +368,21 @@ arguments: string(project name)
372368

373369
####SQLite3 Notes
374370

375-
If you get error when you use sqlite3 connection, you may need to rebuild sqlite3on your environment.
371+
If you get error when you use sqlite3 connection, you may need to rebuild sqlite3to your environment.
376372

377373
VSC extension provides the command to rebuild it.(Name:`Rebuild SQLite3 Client`)
378374
![image](https://user-images.githubusercontent.com/4954534/85928359-ef952180-b8de-11ea-8cb3-7a9a509cd6d7.png)
379375

380-
If you're using sql-language-server directly,aftergo to thedirectry of itandcall`npm rebuild sqlite` to rebuild it.
376+
If you're using sql-language-server directly, go to theinstall directoryandrun`npm rebuild sqlite` to rebuild it.
381377

382378

383-
####Lint
379+
####Linting
384380

385-
You can use lint rules that are provided[sqlint](https://github.com/joe-re/sql-language-server/tree/release/packages/sqlint).
386-
Please refer this to know how to use and how to configure to make them be matched your case.
381+
You can use lint rules provided by[sqlint](https://github.com/joe-re/sql-language-server/tree/release/packages/sqlint) to ensure your SQL code follows best practices and avoid potential errors. Refer to the[sqlint configuraton documentation](https://github.com/joe-re/sql-language-server/tree/release/packages/sqlint#configuration) to learn how to use and configure the linter to match your use case.
387382

388383
![sqlint-on-editor](https://user-images.githubusercontent.com/4954534/83353304-3c3f1880-a384-11ea-8266-4d7048461b56.png)
389384

390-
Also youcan useit to fixyour problem if it's possible.
385+
Youcanalsousesqlint toautomaticallyfixany problems it can identify in your code.
391386

392387
![2020-06-18_08-24-03](https://user-images.githubusercontent.com/4954534/84964358-84a95500-b13e-11ea-9c4f-0b787306bbdf.gif)
393388

@@ -398,38 +393,37 @@ command: fixAllFixableProblems
398393
arguments: string(document uri)
399394
```
400395

401-
##Contributing on sql-language-server
402-
403-
###Bug Repots and Feature Requests
396+
##Contributing to sql-language-server
404397

405-
[GitHub Issues](https://github.com/joe-re/sql-language-server/issues) are opening for asking question, reporting problems,andsuggests improvement.
398+
###Bug ReportsandFeature Requests
406399

407-
You can start adisccustionabout newrule for SQLint there also.
400+
If you have any questions, problems or suggestions for improvements, feel free to create a new issue on[GitHub Issues](https://github.com/joe-re/sql-language-server/issues).You canalsostart adiscussion thereabout newrules for SQLint.
408401

409402
###Development
410403

411-
Code contributions are always appreciated. Feel free to fork the repo and submit pull requests.
404+
Code contributions are always appreciated, so feel free to fork the repo and submit pull requests.
412405

413406
####Development environment
414407

415-
You can start to develop sql-language-server on docker compose.
416-
Start development process on your docker by the bellow:
408+
You can start developing sql-language-server using Docker Compose. To begin the development process in your Docker container, run the following command:
417409

418410
```sh
419411
$ docker compose up
420412
```
421413

422414
Open`http://localhost:3000` on your browser.
423415

424-
####Migrate database
416+
####Migrating the Database
417+
418+
To migrate the database, follow these steps:
425419

426-
1. Login into developmentdocker container
420+
1. Login into developmentDocker container
427421

428422
```sh
429423
$ docker composeexec assets bash
430424
```
431425

432-
2. Migrate database
426+
2. Migratethedatabase
433427

434428
```sh
435429
$cd example/monaco_editor

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp