aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMarshall Lochbaum <mwlochbaum@gmail.com>2020-11-19 13:20:36 -0500
committerMarshall Lochbaum <mwlochbaum@gmail.com>2020-11-19 13:22:18 -0500
commite8c1cc898df488daf9c9fe1439ece118d0e14870 (patch)
tree817867fca15bb811155e8bb218f514b6e6601a77
parent1c782eebe6b919b23171ca707f931942086f3f75 (diff)
Shorten paragraph on fonts now that there's a dedicated page
-rw-r--r--README.md2
-rw-r--r--docs/index.html2
2 files changed, 2 insertions, 2 deletions
diff --git a/README.md b/README.md
index 61baaf1b..6121964f 100644
--- a/README.md
+++ b/README.md
@@ -56,7 +56,7 @@ More snippets are programmed into the live demo at the top of the page: hit the
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 this repository also has [scripts](https://github.com/mlochbaum/BQN/tree/master/editors) to support it, along with the standard syntax highlighting and indentation, in Vim and [Kakoune](https://kakoune.org/). When starting out, it may be easier to use the bar above the REPL: hover over a character to see a short description, and click to insert it into the editor. Finally, on Linux [this configuration file](https://github.com/mlochbaum/BQN/blob/master/editors/bqn) for [XKB](https://en.wikipedia.org/wiki/X_keyboard_extension) can be used to allow typing glyphs with a modifier key system-wide.
-As for fonts, take a look at [this comparison page](https://mlochbaum.github.io/BQN/fonts.html). Few existing monospace fonts support all the BQN characters (double-struck letters like `𝕩` are a particular sticking point), which can cause these characters to be rendered with a fallback font and have the wrong width or look inconsistent. Two fonts modified to support BQN are available currently. This site uses a [modified DejaVu Sans Mono](https://github.com/mlochbaum/BQN/blob/master/docs/DejaVuBQNSansMono.ttf), and another, more playful option is [BQN386](https://github.com/dzaima/BQN386) ([demo](https://dzaima.github.io/BQN386/)). Existing font [Fairfax HD](http://www.kreativekorp.com/software/fonts/fairfaxhd.shtml) has excellent BQN support, but be careful not to confuse single quote (`'`) with the smaller acute accent (`´`). [Julia Mono](https://github.com/cormullion/juliamono) also supports all BQN characters, but with varying styles and weights.
+The [font comparison page](https://mlochbaum.github.io/BQN/fonts.html) 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.
## How do I get started?
diff --git a/docs/index.html b/docs/index.html
index add8bb63..bea1fd23 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -51,7 +51,7 @@
<p>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 <a href="https://github.com/mlochbaum/BQN/blob/master/src/c.bqn">gaze into the abyss</a> that is the self-hosted compiler, or the <a href="https://github.com/mlochbaum/BQN/blob/master/src/r.bqn">shallower but wider abyss</a> of the runtime, or take a look at the friendlier <a href="https://github.com/mlochbaum/BQN/blob/master/md.bqn">markdown processor</a> used to format and highlight documentation files. This repository also has <a href="https://github.com/mlochbaum/BQN/blob/master/examples/fifty.bqn">some translations</a> from <a href="https://www.jsoftware.com/papers/50/">&quot;A History of APL in 50 Functions&quot;</a>.</p>
<h2 id="how-do-i-work-with-the-character-set">How do I work with the character set?</h2>
<p>I type the special characters using a backslash escape, so that, for example, typing <code><span class='Value'>\</span></code> then <code><span class='Value'>z</span></code> writes <code><span class='Function'>⥊</span></code> (the backslash character itself is not used by BQN). The online REPL supports this method out of the box, and this repository also has <a href="https://github.com/mlochbaum/BQN/tree/master/editors">scripts</a> to support it, along with the standard syntax highlighting and indentation, in Vim and <a href="https://kakoune.org/">Kakoune</a>. When starting out, it may be easier to use the bar above the REPL: hover over a character to see a short description, and click to insert it into the editor. Finally, on Linux <a href="https://github.com/mlochbaum/BQN/blob/master/editors/bqn">this configuration file</a> for <a href="https://en.wikipedia.org/wiki/X_keyboard_extension">XKB</a> can be used to allow typing glyphs with a modifier key system-wide.</p>
-<p>As for fonts, take a look at <a href="https://mlochbaum.github.io/BQN/fonts.html">this comparison page</a>. Few existing monospace fonts support all the BQN characters (double-struck letters like <code><span class='Value'>𝕩</span></code> are a particular sticking point), which can cause these characters to be rendered with a fallback font and have the wrong width or look inconsistent. Two fonts modified to support BQN are available currently. This site uses a <a href="https://github.com/mlochbaum/BQN/blob/master/docs/DejaVuBQNSansMono.ttf">modified DejaVu Sans Mono</a>, and another, more playful option is <a href="https://github.com/dzaima/BQN386">BQN386</a> (<a href="https://dzaima.github.io/BQN386/">demo</a>). Existing font <a href="http://www.kreativekorp.com/software/fonts/fairfaxhd.shtml">Fairfax HD</a> has excellent BQN support, but be careful not to confuse single quote (<code><span class='String'>'</span></code>) with the smaller acute accent (<code><span class='Modifier'>´</span></code>). <a href="https://github.com/cormullion/juliamono">Julia Mono</a> also supports all BQN characters, but with varying styles and weights.</p>
+<p>The <a href="https://mlochbaum.github.io/BQN/fonts.html">font comparison page</a> 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 <code><span class='Value'>𝕨</span></code>, <code><span class='Value'>𝕩</span></code> and so on, which will cause these characters to be rendered with a fallback font and possibly have the wrong width or look inconsistent.</p>
<h2 id="how-do-i-get-started">How do I get started?</h2>
<p><em>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.</em></p>
<p>BQN's <a href="tutorial/index.html"><strong>tutorials</strong></a> 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 <em>no</em> 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.</p>