You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/configuration/runme-gist.md
+10-11Lines changed: 10 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,26 +4,27 @@ Would you love to share or store your plain texts or code snippets securely with
4
4
Runme Gist makes this possible and prioritizes your information's sensitivity by keeping sensitive information secret. In this section, we will explain how Runme Gist works.
5
5
6
6
## **What is Runme Gist?**
7
+
7
8
Runme Gist combines GitHub Gist with Runme capabilities to run, share, and store plain texts or code snippets in your Markdown file. What makes Runme Gist powerful is its ability to capture outputs and mask sensitive data without copying and pasting or integrating a third-party tool. You have everything done inside your Markdown file. Amazing right?
8
9
9
10
## **Installation**
10
11
11
12
- To utilize the Runme Gist feature, ensure the [Runme extension](../installation/installrunme) is installed in your VS Code. If you already have Runme installed in your VS Code, ensure you are upgraded to v3.4.0.
12
13
- Set Runme as your [default Markdown viewer](../installation/installrunme) to ensure all Markdown files in your code editor are automatically opened as a Runme notebook.
13
14
14
-
15
15
## **Setting Up Runme Gist**
16
+
16
17
As stated earlier, Runme Gist combines GitHub Gist with Runme capabilities to enable you to securely run, share, and store code snippets. In this section, we will explain how Runme Gist works using a step-by-step guide.
17
18
18
19
1. Open your Markdown File
19
-
Create a `README.md` file and open it in your VS Code. If you already have the file you want to use, open it in VS Code.
20
+
Create a `README.md` file and open it in your VS Code. If you already have the file you want to use, open it in VS Code.
20
21
2. Run Cells
21
-
Run your notebook cells, and ensure the [auto-save feature](../configuration/auto-save) is turned on to save your outputs without manual intervention.
22
+
Run your notebook cells, and ensure the [auto-save feature](../configuration/auto-save) is turned on to save your outputs without manual intervention.
Session output is a Runme feature that stores your generated cell outputs to a separate file to enable you access the output whenever you need. See the [Session output](../configuration/auto-save#session-outputs) guide.
27
+
Session output is a Runme feature that stores your generated cell outputs to a separate file to enable you access the output whenever you need. See the [Session output](../configuration/auto-save#session-outputs) guide.
27
28
28
29
To view your session output, click “Sessions Outputs” to inspect the locally recorded session. Alternatively, you can find it on the left-hand side of your VS Code right inside your current working directory.
29
30
@@ -32,14 +33,13 @@ To view your session output, click “Sessions Outputs” to inspect the locally
32
33
The Session Outputs feature is only available when the autosave is enabled and the Runme cell is run.
33
34
34
35
4. Toggle Between Mask and Unmask
35
-
You can decide if you want your session outputs to be masked or unmasked.
36
-
The masked and unmasked options are how Runme keeps your sensitive information secret. If you want to keep your sensitive information secret, you should toggle the mask option otherwise, choose the unmasked option.
37
-
Otherwise, Runme uses the open-source `data-guardian` library to mask sensitive information on a best-effort basis.
38
-
36
+
You can decide if you want your session outputs to be masked or unmasked.
37
+
The masked and unmasked options are how Runme keeps your sensitive information secret. If you want to keep your sensitive information secret, you should toggle the mask option otherwise, choose the unmasked option.
38
+
Otherwise, Runme uses the open-source `data-guardian` library to mask sensitive information on a best-effort basis.
## **Creating and Managing gist with Runme using Secret Gists**
42
+
## **Creating and Managing Gist with Runme using Secret Gists**
43
43
44
44
GitHub Gist is a service provided by GitHub that allows users to share code snippets, notes, and other small pieces of text with others. With a single click, you can push your Runme Session Output to GitHub Gist from your Markdown file.
45
45
To do this, click on “Generate Gist”.
@@ -51,16 +51,15 @@ Runme will first prompt you to log into your GitHub account and grant write acce
51
51
The link is generated as a “Secret Gist,” which will stay private as long as you keep it private. Ensure you secure the link cautiously before pushing your sessions to GitHub Gist.
52
52
Lastly, use the Runme mask feature to keep your sensitive pieces secured.
53
53
54
-
55
54
## **Visual Representation of Runme Gist**
55
+
56
56
Here is a video that showcases the power of Runme Gist.
0 commit comments