VSpaceCode configuration for VSCode and Calva extension
VS Code supports Clojure and ClojureScript development through an extension called Calva.
VSpaceCode releases after 0.8.5 will included Calva key bindings directly
VSpaceCode bindings for Calva were added via pull request #154 which will be included in the next VSpaceCode release. Currently key bindings can be copied once the VSpaceCode extension is installed.
Calva with LSP has moments of high memory use
The latest version of Calva runs clojure-lsp when opening a Clojure project. The clojure-lsp process may use a noticeable amount of memory, especially with a large number of dependencies in a project. The maintainers are actively working to resolve this and have already made improvements.
Use Calva version 2.0.136 if RAM resources are very constrained. A specific version can be selected via Extensions > Calva extension settings >Install Another Version...
Install VSCode
Open (double click) the file. The Ubuntu software studio will open. Click the Install button.
Enter your password when prompted to install the software.
Close the Ubuntu Software app once the install has finished.
Running VSCode
To run VSCode, press the Super key and type code, or open a terminal and type the command code.
Double-click on the downloaded archive to expand the contents.
Drag Visual Studio Code.app to the Applications folder, making it available in the Launchpad.
Add VS Code to your Dock by right-clicking on the icon and choosing Options, Keep in Dock.
Running VSCode
Launch VSCode from the Dock, or in a command line terminal, type code.
Open (double click) the file. The Ubuntu software studio will open. Click the Install button.
Running VSCode
To run VSCode, press the Super key and type code, or open a terminal and type the command code.
Download the Windows Installer
Run the installer which should have a name similar to VSCodeUserSetup-{version}.exe.
VS Code is installed under C:\users\{username}\AppData\Local\Programs\Microsoft VS Code.
Running VSCode
Open the Start menu and type code. Click on the VSCode icon to start.
Install Calva extension
Select the Extensions icon in the left hand navigation.
Type calva into the search box to list the relevant extension
Click the Install button next to the Calva: Clojure & ClojureScript interactive programming extension.
After a few moments the extension will show as installed.
Install VS Code extension
Select the Extensions icon in the left hand navigation.
Type vspacecode into the search box to list the relevant extension
Click the Install button next to the VSpaceCode extension.
After a few momments the extension will show as installed, along with several other extensions that VSpaceCode uses.
Settings and Keybinding install
Ctrl+Shift+p (SPC SPC when VSpaceCode keys are working) opens the VS Code command menu, type vspacecode to narrow the command list and select VSpaceCode: Configure Default Settings and Keybindings.
Save the settings.json and keybindings.json by searching Preference: Open Settings (JSON) and Preference: Open Keyboard Shortcuts (JSON) in the command palette (Ctl+Shift+P)
Remap the Calva Esc key
Calva extension adds Esc as a keyboard shortcut for clearing evaluation results. This binding breaks vim-style editing in VSpaceCode, so the Calva keyboard shortcut should be remapped.
SPC SPC opens the VSCode command menu, type keyboard to narrow the command list and select Preferences: Open keyboard shortcuts (JSON).
Toward the end of the settings.json file, add the following configuration. This removes Esc from the calva.clearInlineResults and creates a new keyboard shortcut for that command using Shift Esc
{
"key": "escape",
"command": "-calva.clearInlineResults"
},
{
"key": "shift+escape",
"command": "calva.clearInlineResults",
"when": "editorTextFocus && !editorHasMultipleSelections && !editorReadOnly && !hasOtherSuggestions && !suggestWidgetVisible && editorLangId == 'clojure'"
},
Add the Calva specific keyboard shortcuts
Required for VSpaceCode version 0.8.5 or earlier. Later version will include the Clojure keybindings for the Calva extension pull request.
SPC f f and select the ~/.vscode/extensions/vspacecode.vspacecode-0.8.5/package.json file.
/ followed by Major to find the location to add the clojure keyboard shortcuts
Open the Clojure keybindings pull request and copy the code from the package.json change to your local package.json file.
SPC f s to save the file and the keyboard shortcuts will be available when opening a Clojure file.
Configure theme and font
SPC SPC opens the VSCode command menu, type settings to narrow the command list and select Preferences: Open Settings (JSON).
Change the preferences for theme, font size, font family and window zoom level (size of graphical parts of the VS Code windows - positive numbers for larger, negative for smaller).
"workbench.colorTheme": "Solarized Light",
"editor.fontSize": 14,
"editor.fontFamily": "'Fira Code', 'Ubuntu Mono', 'Droid Sans Mono', 'monospace', monospace, 'Droid Sans Fallback'",
"window.zoomLevel": 0,
SPC f f to save changes and apply them directly.
Fira Code and Ubuntu Mono fonts may require installing on your operating system.