From baea0a77846a69b1b50f8ac7d219be14c989f3f4 Mon Sep 17 00:00:00 2001 From: edeediong Date: Wed, 14 Aug 2024 11:26:23 +0100 Subject: [PATCH] docs: update syntax of runme on windows --- .../windows-01J585B7P92E7E2SA4VTQD5Q5S.md | 127 ------------------ 1 file changed, 127 deletions(-) delete mode 100644 docs/how-runme-works/windows-01J585B7P92E7E2SA4VTQD5Q5S.md diff --git a/docs/how-runme-works/windows-01J585B7P92E7E2SA4VTQD5Q5S.md b/docs/how-runme-works/windows-01J585B7P92E7E2SA4VTQD5Q5S.md deleted file mode 100644 index be7f686a..00000000 --- a/docs/how-runme-works/windows-01J585B7P92E7E2SA4VTQD5Q5S.md +++ /dev/null @@ -1,127 +0,0 @@ ---- -runme: - id: 01J583JVRDADD3Y3TG41EEF291 - version: v3 - document: - relativePath: windows.md - session: - id: 01J585B7P92E7E2SA4VTQD5Q5S - updated: 2024-08-14 11:24:16+01:00 ---- - -# Runme on Windows - -To use Runme on a Windows machine, you have to use the Windows Subsystem for Linux 2 (WSL 2). Currently, Runme is built on Cloud-native Shell Kernel with a notebook, editor, terminal, and CLI interface, With WSL 2 you can get the full Runme exprience on your Windows machine. WSL 2 allows you to run a full Linux kernel inside a lightweight utility virtual machine (VM) on Windows 10 and Windows 11. - -In this section, we will explore the various steps required to get Runme working on your Windows machine. - -## Requirements - -To get started, you need to : - -- Set up the [Windows Subsystem for Linux](ht*******************************************ll) and choose your preferred Linux distribution. -- Ensure you have [Visual Studio Code](ht*************************om/) installed on the Windows side rather than within WSL. -- Install the [WSL extension](ht***************************************************************************sl) in your VS Code editor. - -Once all the requirements are fulfilled, the next thing you need to do is start your WSL. To learn all about starting WSL, check out [this article.](ht*************************************************ll) - -## How to Install Runme Extension on VS Code on Windows - -In this section, we will provide a step-by-step guide to help you install the Runme VS Code extension on your Windows machine. - -To get Runme installed in VS Code on your Windows machine, follow the steps below: - -1. Open up VS Code on your local machine. -2. Navigate to the **`Extension`** tab, which can be located on the dashboard on your left. - -![runme extension](../../static/img/how-runme-works/runme-extension-windows.png) - -3. In your search bar, type "Runme". This will display the Runme Notebook extension. - -![runme extension](../../static/img/how-runme-works/runme-notebook-extension-windows.png) - -4. Now click on Install to install the Notebook extension. - -## Setting up Runme on WSL - -At this point, you should have WSL set up on your local Windows machine. As stated earlier, Runme is built on Cloud-native Shell Kernel. WSL helps you get the full experience of Runme on your Windows machine. - -To set up Runme on WSL, follow the steps below: - -- **Step One** - -In your VS Code, press `F1`. This will open up a dashboard containing a list of configuration/setup options. Select **Connect to WSL**. - -![runme on wsl](../../static/img/how-runme-works/runme-wsl.png) - -Alternatively, you can click on the button at the bottom left side of your VS Code dashboard, as shown in the image below, and you will be prompted with the same dashboard options. - -![vs code dashboard](../../static/img/how-runme-works/runme-wsl-vscode-windows.png) - -- **Step Two** - -After connecting to your server using WSL, the next step is to install the Runme extension on the remote server so you can use it as you like. - -![install runme](../../static/img/how-runme-works/runme-wsl-server-windows.png) - -![wsl windows](../../static/img/how-runme-works/runme-install-wsl-windows.png) - -- **Step Three** - -Use the File menu to open your folder. If you already have a folder open, you can also use the **WSL: Reopen Folder in WSL** command. You will be prompted which “Distro" to use. - -## How Runme Works - -This section will explore how [Runme works in VS Code on Windows](ht*****************************************de). - -- Create a Markdown file and click the “+Code” button to create a code cell for your scripts or command. - -![runme +code](../../static/img/how-runme-works/runme-vscode-windows.png) - -- Enter your command into the code cell and click Run. - -![click run](../../static/img/how-runme-works/runme-execute-windows.png) - -- If you want to configure your code cell before running, click the configure button. - -![runme configure](../../static/img/how-runme-works/runme-configure-windows.png) - -## Runme CLI with WSL - -You can also access Runme from your CLI with WSL on your Windows machine. To use the Runme CLI on your WSL server, follow these steps: - -1. **Connect to WSL** - Open your terminal and run the command below: - -```bash {"id":"01J583JVRDADD3Y3TG3YRJNV4Y"} -wsl -``` - -This will connect your machine to your WSL server. - -2. **Install Runme CLI** - -After successfully connection to the WSL server, the next step is to install Runme CLI on your local machine. - -To do this, run the command below: - -```bash {"id":"01J583JVRDADD3Y3TG3ZGM1EYA"} -brew install runme -``` - -3. **Run tasks** - -At this point, you have connected to the WSL server and installed Runme CLI. You can run any task of your choice within your CLI. To do this, use `runme ` to execute tasks defined in the Markdown `.md` files. - -![runme cli](../../static/img/how-runme-works/runme-cli-windows.png) - -For more details on how to use the Runme CLI, refer to the [Runme CLI documentation](ht**************************************li). - -## Additional Resources - -To learn more about how Runme works on several other client interfaces, see these resources: - -- [How Runme Works in VS Code](ht*****************************************de) -- [How Runme Works on the Web](ht**************************************eb) -- [How Runme works on VS Code SSH and Remote](ht************************************************sh) -- [How Runme Works on CLI](ht**************************************li)