From 2fca5a5bc5e8787792901af30bf5fe0846d1db12 Mon Sep 17 00:00:00 2001 From: Marshall Lochbaum Date: Thu, 7 Apr 2022 22:42:01 -0400 Subject: Table of websites; BQNPAD now optionally running Wasm --- docs/running.html | 70 +++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 58 insertions(+), 12 deletions(-) (limited to 'docs/running.html') diff --git a/docs/running.html b/docs/running.html index 58f488d1..e66fd124 100644 --- a/docs/running.html +++ b/docs/running.html @@ -7,26 +7,72 @@

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.

- +

All these websites run BQN (on your computer, except Attempt This Online):

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
LinkStyleEngineComments
Online REPLOne-shotJS"Explain", error marker
BQNPADSessionJS, WasmPreview, syntax coloring
Attempt This OnlineTIOCBQNServer-side
Do Stuff OnlineTIOJS
RazetimeSessionJS
ObservableNotebookJSFor import in Observable
BQN-80One-shotJSCreate animations
+

Further details in the sections below.

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 functionality specified so far (really it's ahead of the spec, which has some flaws to be addressed). System value support varies at it's implemented separately in each host.

-

Support in the following languages has been implemented:

+

Support in the following languages has been implemented (details in the subsections below):

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.

-- cgit v1.2.3