Microsoft/vscode
1
0
Fork 0
mirror of https://github.com/microsoft/vscode.git synced 2025-12-24 20:26:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

Clarify contributing steps for css-language-features

Browse Source
This commit is contained in:
Pine Wu
2018-06-07 11:15:36 -07:00
parent 3199ba0094
commit d1ed4a3311
1 changed files with 25 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
extensions/css-language-features/README.md
View File

@@ -4,20 +4,32 @@ This extension offers CSS/SCSS/Less support in VS Code.
## Development
- Clone the `vscode` repository
- Open the `extensions/css-language-features/` directory in VS Code.
- Run `yarn` in `css-language-features/`.
- Run `yarn` in `css-language-features/server/`.
- Run the `Launch Extension` debug target in the Debug View.
- Run `Reload Window` command in the launched instance to reload the extension.
- Clone [Microsoft/vscode](https://github.com/microsoft/vscode)
- Run `yarn` at `/`, this will install
- Dependencies for `/extension/css-language-features/`
- Dependencies for `/extension/css-language-features/server/`
- devDependencies such as `gulp`
- Open `/extensions/css-language-features/` as the workspace in VS Code
- Run the [`Launch Extension`](https://github.com/Microsoft/vscode/blob/master/extensions/css-language-features/.vscode/launch.json) debug target in the Debug View. This will:
- Launch the `preLaunchTask` task to compile the extension
- Launch a new VS Code instance with the `css-language-features` extension loaded
- You should see a notification saying the development version of `css-language-features` overwrites the bundled version of `css-language-features`
- Test the behavior of this extension by editing CSS/SCSS/Less files
- Run `Reload Window` command in the launched instance to reload the extension
### Try vscode-css-languageservice
### Contribute to vscode-css-languageservice
[`vscode-css-languageservice`](https://github.com/Microsoft/vscode-css-languageservice) contains the language smarts for CSS/SCSS/Less. This extension only wraps the service into a Language Server for VS Code.
[Microsoft/vscode-css-languageservice](https://github.com/Microsoft/vscode-css-languageservice) contains the language smarts for CSS/SCSS/Less, and this extension wraps the service into a Language Server for VS Code. If you want to fix CSS/SCSS/Less issues or make improvements, you should make changes at [Microsoft/vscode-css-languageservice](https://github.com/Microsoft/vscode-css-languageservice).
If you want to fix CSS/SCSS/Less issues or make improvements, you can:
However, within this extension, you can run a development version of `vscode-css-languageservice` to debug code or test language features interactively:
- Clone `vscode-css-languageservice` and compile it with `npm compile`.
- Run `npm link` in `vscode-css-languageservice`.
- In `css-language-features/server/`, run `npm link vscode-css-languageservice`.
- Now when you run `Launch Extension`, the launched instance will use your version of `vscode-css-languageservice`.
- Clone [Microsoft/vscode-css-languageservice](https://github.com/Microsoft/vscode-css-languageservice)
- Open both `vscode-css-languageservice` and this extension in a single workspace with [multi-root workspace](https://code.visualstudio.com/docs/editor/multi-root-workspaces) feature
- Run `yarn` in `vscode-css-languageservice`
- Run `yarn link` in `vscode-css-languageservice`. This will compile and link `vscode-css-languageservice`
- In `css-language-features/server/`, run `npm link vscode-css-languageservice`
- Run `yarn watch` at `css-languagefeatures/server/` to recompile this extension with the linked version of `vscode-css-languageservice`
- Run `yarn watch` in `vscode-css-languageservice`
- Make some changes in `vscode-css-languageservice`
- Now when you run `Launch Extension` debug target, the launched instance will use your development version of `vscode-css-languageservice`. You can interactively test the language features.
- You can also run the `Debug Extension and Language Server` debug target, which will launch the extension and attach the debugger to the language server. After successful attach, you should be able to hit breakpoints in both `vscode-css-languageservice` and `css-language-features/server/`