mirror of
https://github.com/hexedtech/codemp-vscode.git
synced 2024-11-22 15:34:49 +01:00
chore: updated README
This commit is contained in:
parent
ec2a2950ff
commit
ac3bac3730
1 changed files with 56 additions and 7 deletions
63
README.md
63
README.md
|
@ -1,9 +1,58 @@
|
||||||
# codemp vscode
|
[![codemp](https://codemp.dev/static/banner.png)](https://codemp.dev)
|
||||||
This repository contains the vscode extension for codemp
|
|
||||||
|
|
||||||
## Bundling
|
> `codemp` is a **collaborative** text editing solution to work remotely.
|
||||||
A vscode extension is basically a zip archive with a `.vsix` estension.
|
|
||||||
Use 'npm run bundle' to bundle the extension and create a .vsix file to manually import it into vscode.
|
It seamlessly integrates in your editor providing remote cursors and instant text synchronization,
|
||||||
|
as well as a remote virtual workspace for you and your team.
|
||||||
|
|
||||||
|
# codemp-vscode
|
||||||
|
|
||||||
|
This is the reference codemp [vscode](https://code.visualstudio.com/) plugin maintained by [hexedtech](https://hexed.technology)
|
||||||
|
|
||||||
|
# installation
|
||||||
|
Clone the github repository and use vscode actions to compile and run the extension
|
||||||
|
|
||||||
|
# usage
|
||||||
|
Interact with this plugin using the `codemp` command.
|
||||||
|
|
||||||
|
|
||||||
|
| command | description |
|
||||||
|
| --- | --- |
|
||||||
|
| `codemp.connect ` | to connect to server using server ip, username and password from your config file |
|
||||||
|
|
||||||
|
once connected, more commands become available:
|
||||||
|
|
||||||
|
| command | description |
|
||||||
|
| --- | --- |
|
||||||
|
| `codemp.join <workspace>` | will join requested workspace; starts processing cursors and users |
|
||||||
|
| `codemp.createWorkspace <workspace>` | will create a new workspace with given name |
|
||||||
|
| `codemp.listWorkspaces` | list all workspaces available to join |
|
||||||
|
|
||||||
|
after a workspace is joined, more commands become available:
|
||||||
|
|
||||||
|
| command | description |
|
||||||
|
| --- | --- |
|
||||||
|
| `codemp.attach <buffer>` | will attach to requested buffer if it exists|
|
||||||
|
| `codemp.createBuffer <bufname>` | will create a new empty buffer in workspace |
|
||||||
|
| `codemp.listBuffers` | will list all available buffers in workspace |
|
||||||
|
| `codemp.sync` | forces resynchronization of current buffer |
|
||||||
|
|
||||||
|
|
||||||
|
### quick start
|
||||||
|
* first connect to server with `codemp.connect`
|
||||||
|
* then join a workspace with `codemp.join <workspace>`
|
||||||
|
* either attach directly to a buffer with `codemp.attach <buffer>` or browse available buffers with `codemp.listBuffers`
|
||||||
|
|
||||||
|
|
||||||
|
## example configuration (settings.json)
|
||||||
|
|
||||||
|
|
||||||
|
```
|
||||||
|
"codemp-vscode": {
|
||||||
|
"server" : "http://codemp.dev:50053",
|
||||||
|
"username" : "test@codemp.dev",
|
||||||
|
"password" : "test"
|
||||||
|
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
## Installing
|
|
||||||
From VSCode extensions tab, press the menu button and choose "install from vsix", then pick the previously built file.
|
|
||||||
|
|
Loading…
Reference in a new issue