From f2754035893cd44c290e3d50e4d5c21746ea88c8 Mon Sep 17 00:00:00 2001 From: Marshall Lochbaum Date: Sun, 18 Apr 2021 20:39:22 -0400 Subject: Change site font from DejaVu BQN to BQN386 --- docs/fonts.html | 4 ++-- docs/index.html | 2 +- docs/repl.js | 2 +- docs/style.css | 8 ++++---- 4 files changed, 8 insertions(+), 8 deletions(-) (limited to 'docs') diff --git a/docs/fonts.html b/docs/fonts.html index 42cf2a62..1ffd552f 100644 --- a/docs/fonts.html +++ b/docs/fonts.html @@ -272,9 +272,9 @@ Iosevka Term Extended

Finally, a REPL where you can enter any code you like (but remember, not all characters from these fonts are embedded—just those likely to be used in BQN).

- + - + diff --git a/docs/index.html b/docs/index.html index cde1b387..fe8ae698 100644 --- a/docs/index.html +++ b/docs/index.html @@ -51,7 +51,7 @@

More snippets are programmed into the live demo at the top of the page: hit the arrow at the right of the code window to see them. For longer samples, you can gaze into the abyss that is the self-hosted compiler, or the shallower but wider abyss of the runtime, or take a look at the friendlier markdown processor used to format and highlight documentation files. This repository also has some translations from "A History of APL in 50 Functions".

How do I work with the character set?

Right at the beginning, you can use the bar above the online REPL to enter BQN code: hover over a character to see a short description, and click to insert it into the editor. But you'll soon want to skip the clicking and use keyboard input. I type the special characters using a backslash escape, so that, for example, typing \ then z writes ⥊ (the backslash character itself is not used by BQN). The online REPL supports this method out of the box, and configuration files to enable it in various other places are included with the editor plugins. There's also a bookmarklet you can use to enable BQN input in any webpage in your browser.

-

The font comparison page shows several fonts that support BQN (including the one used on this site, a modified version of DejaVu Sans Mono). Most other monospace fonts are missing some BQN characters, such as double-struck letters 𝕨, 𝕩 and so on, which will cause these characters to be rendered with a fallback font and possibly have the wrong width or look inconsistent.

+

The font comparison page shows several fonts that support BQN (including the one used on this site, BQN386). Most other monospace fonts are missing some BQN characters, such as double-struck letters 𝕨, 𝕩 and so on, which will cause these characters to be rendered with a fallback font and possibly have the wrong width or look inconsistent.

How do I get started?

Writing good learning material for a programming language is a pretty huge task, so neither the tutorials nor the documentation are complete. With some willingness to experiment and possibly outside knowledge of array programming, it's enough to get by, just not smooth sailing.

BQN's tutorials are intended as an introduction to array programming with BQN. They assume only knowledge of elementary mathematics, but will probably be hard to follow if you have no programming experience. BQN has a lot in common with dynamically-typed functional languages like Lisp, Julia, or Javascript, so knowledge of these languages will be particularly helpful. However, there's a significant (but shrinking) gap between the last tutorial and existing documentation. If you're motivated, you may be able to get across by reading material on other array languages like APL, J, NumPy, or Julia.

diff --git a/docs/repl.js b/docs/repl.js index b65ac21e..cc7a7cf4 100644 --- a/docs/repl.js +++ b/docs/repl.js @@ -125,7 +125,7 @@ doc.kb.onmousedown = ev => { } if (doc.demo) { - let fonts=[["DejaVu","Mod"],["BQN386"],["Fairfax","HD"],["3270","font"],["Iosevka","Term"],["Julia","Mono"]]; + let fonts=[["BQN386"],["DejaVu","Mod"],["Fairfax","HD"],["3270","font"],["Iosevka","Term"],["Julia","Mono"]]; let fclass = f => f==="3270"?"f"+f:f let fontsel = '