Skip to content

Commit 4cd8fa6

Browse files
author
Release Manager
committed
Trac #30484: Document using Sage on Windows via Visual Studio Code with WSL remote
We already have a basic VS Code configuration; #33103 makes some minor updates. In this ticket, we add documentation for installing VS Code on Windows and setting up the WSL remote, as the primary way how to use Sage on Windows. This goes to - https://doc.sagemath.org/html/en/installation/launching.html Next task: cross reference it from the developer's guide and add information there on how to develop Sage on Windows. References: - Pylance: https://marketplace.visualstudio.com/items?itemName=ms-python .vscode-pylance (includes pyright) URL: https://trac.sagemath.org/30484 Reported by: mkoeppe Ticket author(s): Louis Ng, Matthias Koeppe Reviewer(s): Tobias Diez, Kwankyu Lee
2 parents c96e796 + 79552c6 commit 4cd8fa6

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

src/doc/en/installation/launching.rst

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -234,3 +234,28 @@ You can check the presence of some of these packages using the command
234234
following code in the notebook::
235235

236236
plot3d(lambda u,v:(u^2+v^2)/4-2,(-2,2),(-2,2)).show(viewer="jmol")
237+
238+
Using Jupyter notebook through Visual Studio Code (VS Code) in WSL
239+
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
240+
241+
If you have installed Sage on Windows using Windows Subsystem for
242+
Linux (WSL), it is convenient to use Visual Studio Code (VS Code)
243+
to interact with Sage.
244+
245+
Here are steps to use SageMath in a Jupyter notebook in VS Code:
246+
247+
* Install and run `VS Code <https://code.visualstudio.com/download>`_
248+
in Windows.
249+
250+
* Click the "Extension" icon on the left (or press :kbd:`Ctrl` +
251+
:kbd:`Shift` + :kbd:`X`) to open a list of extensions. Install the
252+
"Remote - WSL" and "Jupyter" extensions.
253+
254+
* In the command palette (:kbd:`Ctrl` + :kbd:`Shift` + :kbd:`P`),
255+
enter "Remote-WSL: New Window", and hit :kbd:`Enter`.
256+
257+
* In the command palette, enter "Create: New Jupyter Notebook", and
258+
hit :kbd:`Enter`.
259+
260+
* Click "Select Kernel" on the right (or press :kbd:`Ctrl` +
261+
:kbd:`Alt` + :kbd:`Enter`), select SageMath, and hit :kbd:`Enter`.

0 commit comments

Comments
 (0)