Miroirs/waforth
1
0
Fork 0
mirror of https://github.com/remko/waforth synced 2025-01-17 18:11:39 +01:00
Code Issues Projects Releases Packages Wiki Activity

vscode-extension: Update README

Browse source
This commit is contained in:
Remko Tronçon 2022-11-19 22:29:27 +01:00
parent fcc610b0cd
commit c00ae873e9
3 changed files with 26 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
README.md
View file

@ -155,6 +155,21 @@ forth.interpret(`
`);
```
## Visual Studio Code Notebooks
The [WAForth Visual Studio Code Extension](https://marketplace.visualstudio.com/items?itemName=remko.waforth-vscode-extension) adds support
for interactive Forth notebooks powered by WAForth. You can execute both text-based Forth code, as well as [Thurtle](https://mko.re/thurtle/) graphics.
Because it is powered by WebAssembly, this extension works both in the desktop version of Visual Studio Code and in [the browser version of Visual Studio Code](https://code.visualstudio.com/docs/editor/vscode-web) (e.g. https://github.dev, https://vscode.dev).
<div align="center">
<div>
<a href="https://github.dev/remko/waforth/blob/master/src/web/vscode-extension/examples/drawing-with-forth.wafnb"><img src="https://raw.githubusercontent.com/remko/waforth/master/src/web/vscode-extension/doc/notebook.gif" alt="WAForth notebook"></a>
</div>
<figcaption><em><a href="https://github.dev/remko/waforth/blob/master/src/web/vscode-extension/examples/drawing-with-forth.wafnb">WAForth notebook</a></em></figcaption>
</div>
## Goals
Here are some of the goals (and non-goals) of WAForth:

12
src/web/vscode-extension/README.md
View file

@ -1,6 +1,6 @@
# WAForth VS Code Extension
This extension provides support for [WAForth](https://github.com/remko/waforth) notebooks.
This extension provides support for Forth notebooks, powered by [WAForth](https://github.com/remko/waforth).
Choose between a standard (text-based) Forth kernel, and a
[Thurtle](https://mko.re/thurtle/) kernel for drawing
@ -11,4 +11,12 @@ Logo-like Forth Turtle graphics.
<a href="https://github.dev/remko/waforth/blob/master/src/web/vscode-extension/examples/drawing-with-forth.wafnb"><img src="https://raw.githubusercontent.com/remko/waforth/master/src/web/vscode-extension/doc/notebook.gif" alt="WAForth notebook"></a>
</div>
<figcaption><em><a href="https://github.dev/remko/waforth/blob/master/src/web/vscode-extension/examples/drawing-with-forth.wafnb">WAForth notebook</a></em></figcaption>
</div>
</div>
## Installation & Usage
Install the extension from the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=remko.waforth-vscode-extension).
Once the extension is installed, you can create a new WAForth notebook from the command pallet (*WAForth: New notebook*), or open [this example notebook](https://raw.githubusercontent.com/remko/waforth/master/src/web/vscode-extension/examples/drawing-with-forth.wafnb).
The extension also works in the web-based VS Code environments.
For example, install the extension on https://github.dev, and then open [this example notebook](https://github.dev/remko/waforth/blob/master/src/web/vscode-extension/examples/drawing-with-forth.wafnb).

2
src/web/vscode-extension/package.json
View file

@ -1,6 +1,6 @@
{
"name": "waforth-vscode-extension",
"version": "0.1.5",
"version": "0.1.6",
"displayName": "WAForth",
"description": "WAForth interactive notebooks",
"categories": [