diff options
| author | Marshall Lochbaum <mwlochbaum@gmail.com> | 2022-02-03 22:14:31 -0500 |
|---|---|---|
| committer | Marshall Lochbaum <mwlochbaum@gmail.com> | 2022-02-03 22:16:50 -0500 |
| commit | 4c95f1b8a83993eda4545a2c81806b1b14f37053 (patch) | |
| tree | bf6ec23e1594a9ac164541415f289c2e254688d0 | |
| parent | fa752481c9e9b166ba9232d4eff61b85a07290e6 (diff) | |
Move the various online REPLs into running.md
| -rw-r--r-- | community/README.md | 2 | ||||
| -rw-r--r-- | docs/community/index.html | 2 | ||||
| -rw-r--r-- | docs/running.html | 12 | ||||
| -rw-r--r-- | running.md | 11 |
4 files changed, 19 insertions, 8 deletions
diff --git a/community/README.md b/community/README.md index f081e76a..513fcd60 100644 --- a/community/README.md +++ b/community/README.md @@ -23,8 +23,6 @@ And also: - Some reference pages: [compact functions](https://pastebin.com/raw/ynsghrHM), [big everything](https://gist.github.com/dzaima/52b47f898c5d43f72dc2637d6cdadedd) - Asher Mancinelli's [youtube channel](https://www.youtube.com/channel/UCZ5sL4E662VP1ZwC4h85ttQ) includes walkthroughs of BQN programs. - Lukas Hermann writes some [Observable notebooks](https://observablehq.com/@lsh?tab=notebooks) based on BQN. -- [BQN-80](https://dancek.github.io/bqn-80): make animations with BQN. -- Razetime's [alternative REPL](https://razetime.github.io/bqn-repl/) works as a continuous session instead of re-evaluating each time. ### Fan art diff --git a/docs/community/index.html b/docs/community/index.html index d1fdba95..0be35168 100644 --- a/docs/community/index.html +++ b/docs/community/index.html @@ -24,8 +24,6 @@ <li>Some reference pages: <a href="https://pastebin.com/raw/ynsghrHM">compact functions</a>, <a href="https://gist.github.com/dzaima/52b47f898c5d43f72dc2637d6cdadedd">big everything</a></li> <li>Asher Mancinelli's <a href="https://www.youtube.com/channel/UCZ5sL4E662VP1ZwC4h85ttQ">youtube channel</a> includes walkthroughs of BQN programs.</li> <li>Lukas Hermann writes some <a href="https://observablehq.com/@lsh?tab=notebooks">Observable notebooks</a> based on BQN.</li> -<li><a href="https://dancek.github.io/bqn-80">BQN-80</a>: make animations with BQN.</li> -<li>Razetime's <a href="https://razetime.github.io/bqn-repl/">alternative REPL</a> works as a continuous session instead of re-evaluating each time.</li> </ul> <h3 id="fan-art"><a class="header" href="#fan-art">Fan art</a></h3> <p><a href="https://codeberg.org/wezl">Wezl</a> has provided a view into the BQN programmer in 𝕩e's typical place of residence.</p> diff --git a/docs/running.html b/docs/running.html index e2f911ff..e50a3256 100644 --- a/docs/running.html +++ b/docs/running.html @@ -20,7 +20,15 @@ <li><a href="https://git.sr.ht/~andreypopp/BQN.jl">Julia</a> embedding, with common primitives implemented natively. Slow startup.</li> </ul> <h4 id="javascript"><a class="header" href="#javascript">Javascript</a></h4> -<p>The online REPL is <a href="https://mlochbaum.github.io/BQN/try.html">here</a>. The file <a href="https://github.com/mlochbaum/BQN/blob/master/docs/bqn.js">docs/bqn.js</a> is zero-dependency Javascript, and can be loaded from HTML or Node.js. For command line use, call the Node.js script <a href="https://github.com/mlochbaum/BQN/blob/master/bqn.js">bqn.js</a>, passing a file and <code><span class='Value'>•args</span></code>, or <code><span class='Function'>-</span><span class='Value'>e</span></code> to execute all remaining arguments directly and print the results. <a href="https://observablehq.com/@lsh/bqn">This notebook</a> shows how to run it in an Observable notebook.</p> +<p>The file <a href="https://github.com/mlochbaum/BQN/blob/master/docs/bqn.js">docs/bqn.js</a> is zero-dependency Javascript, and can be loaded from HTML or Node.js. For command line use, call the Node.js script <a href="https://github.com/mlochbaum/BQN/blob/master/bqn.js">bqn.js</a>, passing a file and <code><span class='Value'>•args</span></code>, or <code><span class='Function'>-</span><span class='Value'>e</span></code> to execute all remaining arguments directly and print the results.</p> +<p>Several sites run using JS-based BQN:</p> +<ul> +<li><a href="https://mlochbaum.github.io/BQN/try.html">The main online REPL</a>.</li> +<li>Razetime's <a href="https://razetime.github.io/bqn-repl/">alternative</a> runs as a continuous session so you can save results.</li> +<li><a href="https://dso.surge.sh/">do-stuff-online</a> considers BQN to be a stuff (it's like Try It Online).</li> +<li>This <a href="https://observablehq.com/@lsh/bqn">Observable notebook</a> can be imported into other notebooks.</li> +<li><a href="https://dancek.github.io/bqn-80">BQN-80</a>: make animations with BQN.</li> +</ul> <h4 id="cbqn"><a class="header" href="#cbqn">CBQN</a></h4> <p>C sources are kept in the <a href="https://github.com/dzaima/CBQN">CBQN</a> repository, but it also depends on bytecode from the BQN sources here. Running <code><span class='Value'>make</span></code> gets a working copy right away with saved bytecode. Then to use the latest bytecode, call <code><span class='Value'>$</span> <span class='Value'>.</span><span class='Function'>/BQN</span> <span class='Value'>genRuntime</span> <span class='Value'>…</span><span class='Function'>/BQN</span></code>, where <code><span class='Value'>…</span><span class='Function'>/BQN</span></code> points to this repository, and run <code><span class='Value'>make</span></code> again.</p> <p><code><span class='Value'>genRuntime</span></code> can also be run with another BQN implementation (the Node.js one works but takes up to a minute), and plain <code><span class='Value'>.</span><span class='Function'>/</span><span class='Value'>genRuntime</span></code> uses your system's <code><span class='Value'>bqn</span></code> executable. I symlink <code><span class='Value'>…</span><span class='Function'>/CBQN/BQN</span></code> to <code><span class='Value'>~</span><span class='Function'>/</span><span class='Value'>bin</span><span class='Function'>/</span><span class='Value'>bqn</span></code> so I can easily use CBQN for scripting.</p> @@ -34,4 +42,4 @@ </pre> <p>If compiled with Native Image, <code><span class='Value'>nBQN</span></code> can be used directly instead.</p> <h3 id="bqn2ngn"><a class="header" href="#bqn2ngn">BQN2NGN</a></h3> -<p><a href="https://github.com/mlochbaum/BQN2NGN">BQN2NGN</a> is a prototype implementation in Javascript build to experiment with the langauge, which is now abandoned.</p> +<p><a href="https://github.com/mlochbaum/BQN2NGN">BQN2NGN</a> is a prototype implementation in Javascript built to experiment with the langauge. It's now abandoned.</p> @@ -22,7 +22,14 @@ Support in the following languages has been implemented: #### Javascript -The online REPL is [here](https://mlochbaum.github.io/BQN/try.html). The file [docs/bqn.js](docs/bqn.js) is zero-dependency Javascript, and can be loaded from HTML or Node.js. For command line use, call the Node.js script [bqn.js](bqn.js), passing a file and `•args`, or `-e` to execute all remaining arguments directly and print the results. [This notebook](https://observablehq.com/@lsh/bqn) shows how to run it in an Observable notebook. +The file [docs/bqn.js](docs/bqn.js) is zero-dependency Javascript, and can be loaded from HTML or Node.js. For command line use, call the Node.js script [bqn.js](bqn.js), passing a file and `•args`, or `-e` to execute all remaining arguments directly and print the results. + +Several sites run using JS-based BQN: +- [The main online REPL](https://mlochbaum.github.io/BQN/try.html). +- Razetime's [alternative](https://razetime.github.io/bqn-repl/) runs as a continuous session so you can save results. +- [do-stuff-online](https://dso.surge.sh/) considers BQN to be a stuff (it's like Try It Online). +- This [Observable notebook](https://observablehq.com/@lsh/bqn) can be imported into other notebooks. +- [BQN-80](https://dancek.github.io/bqn-80): make animations with BQN. #### CBQN @@ -46,4 +53,4 @@ If compiled with Native Image, `nBQN` can be used directly instead. ### BQN2NGN -[BQN2NGN](https://github.com/mlochbaum/BQN2NGN) is a prototype implementation in Javascript build to experiment with the langauge, which is now abandoned. +[BQN2NGN](https://github.com/mlochbaum/BQN2NGN) is a prototype implementation in Javascript built to experiment with the langauge. It's now abandoned. |
