From b604ae734d44a0b9bf20f8aa567944443442d259 Mon Sep 17 00:00:00 2001 From: Marshall Lochbaum Date: Tue, 15 Feb 2022 16:59:28 -0500 Subject: Move online versions to the running.md introduction and add ATO --- docs/running.html | 16 ++++++++-------- running.md | 14 +++++++------- 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/running.html b/docs/running.html index f2add732..7d2b6f7d 100644 --- a/docs/running.html +++ b/docs/running.html @@ -7,6 +7,14 @@

How to run BQN

CBQN is the primary offline implementation. Scripts in this repository start with #! /usr/bin/env bqn in order to look up the user's bqn executable, which is expected to be CBQN.

Third-party packages to build some BQN implementations are available for both Nix and Arch Linux. For general use I recommend cbqn from nixpkgs (Nix) and cbqn-git from the AUR (Arch).

+

There are many websites where you can run BQN as well. All but Attempt This Online are based on Javascript BQN.

+

Self-hosted BQN

See the subsections below for instructions on specific implementations.

This version of BQN is implemented mainly in BQN itself, but a host language supplies basic functionality and can also replace primitives for better performance. This also allows embedding, where programs in the host language can include BQN code. It fully supports all syntax specified so far, and all primitives except a few cases of structural Under (⌾). System value support varies at it's implemented separately in each host.

@@ -21,14 +29,6 @@

Javascript

The file 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, passing a file and •args, or -e to execute all remaining arguments directly and print the results.

-

Several sites run using JS-based BQN:

-

CBQN

C sources are kept in the CBQN repository, but it also depends on bytecode from the BQN sources here. Running make gets a working copy right away with saved bytecode. Then to use the latest bytecode, call $ ./BQN genRuntime …/BQN, where …/BQN points to this repository, and run make again.

genRuntime can also be run with another BQN implementation (the Node.js one works but takes up to a minute), and plain ./genRuntime uses your system's bqn executable. I symlink …/CBQN/BQN to ~/bin/bqn so I can easily use CBQN for scripting.

diff --git a/running.md b/running.md index 32c676e9..b2aed89b 100644 --- a/running.md +++ b/running.md @@ -6,6 +6,13 @@ Third-party packages to build some BQN implementations are available for both Nix and Arch Linux. For general use I recommend `cbqn` from nixpkgs (Nix) and `cbqn-git` from the AUR (Arch). +There are many websites where you can run BQN as well. All but Attempt This Online are based on Javascript 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. +- Try It Online format: [Attempt This Online](https://ato.pxeger.com/run?1=m704qTBvwYKlpSVpuhZoFJQGAA) runs CBQN server-side; [Do Stuff Online](https://dso.surge.sh/#bqn) runs JS BQN locally. +- 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. + ### Self-hosted BQN See the subsections below for instructions on specific implementations. @@ -24,13 +31,6 @@ Support in the following languages has been implemented: 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 C sources are kept in the [CBQN](https://github.com/dzaima/CBQN) repository, but it also depends on bytecode from the BQN sources here. Running `make` gets a working copy right away with saved bytecode. Then to use the latest bytecode, call `$ ./BQN genRuntime …/BQN`, where `…/BQN` points to this repository, and run `make` again. -- cgit v1.2.3