Typing glyphs

From APL Wiki
Revision as of 19:10, 6 August 2024 by Marshall (talk | contribs) (Remove lists category)
(diff) ← Older revision | Latest revision (diff) | Newer revision β†’ (diff)
Jump to navigation Jump to search

APL uses a range of special graphic symbols to represent most functions and operators. While keyboard mappings become memorized over time, entering APL characters can frustrate the beginner. However, a study involving high school students found that typing and using APL characters did not hinder the students in any measurable way. There are several convenient ways to enter the glyphs.

US keyboard with Dyalog APL glyphs

Hardware

Once the keyboard map is configured to one's liking, it may be beneficial (especially for new users learning APL) to have a keyboard with APL symbols. There are a few solutions to this, such as purchasing a dedicated desktop keyboard, key caps for mechanical keyboards, or a keyboard decal.

Item Type Layout Languages Seller
Keyboard Model M Dyalog πŸ‡ΊπŸ‡Έ Amazon.
Cherry Dyalog πŸ‡ΊπŸ‡Έ πŸ‡¬πŸ‡§ πŸ‡©πŸ‡ͺ πŸ‡©πŸ‡° Dyalog
Key caps Model M Dyalog πŸ‡ΊπŸ‡Έ Unicomp
CannonKeys APL2 πŸ‡ΊπŸ‡Έ cannonkeys.com
Cherry APL2 πŸ‡ΊπŸ‡Έ mykeyboard.eu
Cherry Dyalog πŸ‡ΊπŸ‡Έ NovelKeys
Key stickers any Dyalog πŸ‡ΊπŸ‡Έ Tindie

Note that these devices only are visual modifications on regular keyboards; they do not automatically enable entry of APL glyphs into software. For this, one of the below methods is required.

By platform

Β 
The in-browser language bar

Web

  • APL VK is a virtual keyboard for the APL Language for modern mobile devices. You can add this to your own web page to provide a means to enter APL symbols into a web based form or editor. It is similar to the APL language bar but is optimized for mobile devices.

Text editors

Main article: Text editors

Keyboard layout extensions exist for several popular text editors like VS Code, Emacs and Vim. This can be an alternative, or complementary, to system-wide settings.

Linux

Main article: Typing glyphs on Linux
  • Most Linux distributions released after mid-2012 have Dyalog shifting-key support included with the distribution.
Β 
Array Hacker's Keyboard

Android

  • Optima Systems' APL Keys provides both QWERTY keyboard (which uses long-press to select from a list of alternate glyphs), a phone pad, and a symbol view.

Windows

  • APLAutoHotKey is an application to produce configurable AutoHotKey scripts for shifting key input.

Troubleshooting

Installation of the Dyalog Unicode IME can cause so many layouts to be installed that they get in the way when switching layouts. However, the unneeded layouts can be removed through editing the registry[1]

macOS

To enable these keyboard key mappings on macOS, the appropriate .keylayout files for your locale must be downloaded and installed in the /Library/Keyboard Layouts directory:

iOS

  • ohAitch's APLiOS, aimed primarily at iPadOS, provides a number bar and APL symbol layers.

By method

Most of today's APLs use a mapping which derives from the original APL\360 terminals' keyboard layout. For example, Dyalog APL's standard US English layout for is as follows:

β”Œβ”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚~ ⌺ β”‚! ⌢ β”‚@ ⍫ β”‚# ⍒ β”‚$ ⍋ β”‚% ⌽ β”‚^ ⍉ β”‚& βŠ– β”‚* ⍟ β”‚( ⍱ β”‚) ⍲ β”‚_Β ! β”‚+ ⌹ β”‚Backspaceβ”‚
β”‚` β‹„ β”‚1 Β¨ β”‚2 Β― β”‚3 < β”‚4 ≀ β”‚5 = β”‚6 β‰₯ β”‚7 > β”‚8 β‰  β”‚9 ∨ β”‚0 ∧ β”‚- Γ— β”‚= Γ· β”‚         β”‚
β”œβ”€β”€β”€β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€
β”‚Tab    β”‚Q   β”‚W   β”‚E ⍷ β”‚R   β”‚T ⍨ β”‚Y   β”‚U   β”‚I ⍸ β”‚O β₯ β”‚P ⍣ β”‚{ ⍞ β”‚} ⍬ β”‚| ⊣   β”‚
β”‚       β”‚qΒ ? β”‚w ⍡ β”‚e ∊ β”‚r ⍴ β”‚t ~ β”‚y ↑ β”‚u ↓ β”‚i ⍳ β”‚o β—‹ β”‚p * β”‚[ ← β”‚] β†’ β”‚\ ⊒   β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”΄β”¬β”€β”€β”€β”΄β”¬β”€β”€β”€β”΄β”¬β”€β”€β”€β”΄β”¬β”€β”€β”€β”΄β”¬β”€β”€β”€β”΄β”¬β”€β”€β”€β”΄β”¬β”€β”€β”€β”΄β”¬β”€β”€β”€β”΄β”¬β”€β”€β”€β”΄β”¬β”€β”€β”€β”΄β”¬β”€β”€β”€β”΄β”¬β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€
β”‚Caps    β”‚A   β”‚S   β”‚D   β”‚F   β”‚G   β”‚H   β”‚J ⍀ β”‚K ⌸ β”‚L ⌷ β”‚: ≑ β”‚" β‰’ β”‚Enter     β”‚
β”‚Lock    β”‚a ⍺ β”‚s ⌈ β”‚d ⌊ β”‚f _ β”‚g βˆ‡ β”‚h βˆ† β”‚j ∘ β”‚k ' β”‚l βŽ• β”‚; ⍎ β”‚' ⍕ β”‚          β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”¬β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚Shift      β”‚Z βŠ† β”‚X   β”‚C   β”‚V   β”‚B   β”‚N   β”‚M   β”‚< βͺ β”‚> ⍙ β”‚? ⍠ β”‚Shift       β”‚
β”‚           β”‚z βŠ‚ β”‚x βŠƒ β”‚c ∩ β”‚v βˆͺ β”‚b βŠ₯ β”‚n ⊀ β”‚m | β”‚, ⍝ β”‚. ⍀ β”‚/ ⌿ β”‚            β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Additional charts for other layouts are available.

There are multiple ways to access the glyphs associated with a particular key.

Shifting key

It is quite common to use Ctrl or Alt or AltGr (right-side Alt) as an additional shifting key. For example, AltGr+4 would give ≀ while AltGr+Shift+4 would give ⍋.

  • APLX uses AltGr with an option to also use Alt

Prefix key

A prefix key is a special key or character which is entered immediately before typing the corresponding key.

  • TryAPL and ngn/apl's scripted demo interface support ` as prefix key.
  • The Dyalog Unicode IME and the Dyalog RIDE (Remote Integrated Development Environment) uses ` by default, but allows choosing any key as prefix key.
Β 
RIDE keyword lookup

Long-press

dzaima's Hacker's Keyboard + APL language reacts to a long-press, popping up a palette that allows selecting any of the APL glyphs associated with that button.

Keyword look-up

The Dyalog RIDE (Remote Integrated Development Environment) allows hitting the prefix key (` by default, but configurable) twice, followed by the (beginning of the) name of a symbol or a functionality. It then displays a drop-down of choices with arrow keys to indicate choice and the Tab key to insert the symbol. E.g. `,`,d,i,v,Tab↹ inserts ÷.

ASCII symbol composition

Many APL glyphs can be approximated by overlaying or juxtaposing two ASCII characters. ngn/apl's scripted demo interface, AdΓ‘m Brudzewsky's in-browser language bar, and TryAPL's web interface allow such a pair of characters and hitting the Tabβ†Ή key to replace them with the corresponding APL character. For example, <,-,Tabβ†Ή will insert ← and T,o,Tabβ†Ή will insert ⍕.

For Windows users, e-sushi has an AutoHotkey script that allows such composition.

Text replacement

Espanso allows typing a pattern which is then immediately replaced with something else. This can be used in various ways to type APL glyphs without conflicting with application or operating system keyboard shortcuts. espanso-apl-keyboard is an Espanso configuration that emulates prefix key, so for example typing pressing `,e too type `e will be end up producing the ∊ glyph.

Β 
NARS2000 language bar

On-screen language bar

Several APL IDEs allow the display of a toolbar with a button for each APL glyph:

LaTeX

In order to typeset APL using LaTeX, you need to be sure your LaTeX engine has full Unicode support. At the time of writing, LuaLaTeX and XeLaTeX are two of the most popular such alternatives, both included with TeX Live.

After ensuring you have a LaTeX engine that is Unicode capable, you need to make sure your .tex document is using a font that has the APL glyphs you want to type. One way to do this is through the fontspec package, as seen in the example template below.

To check your setup is fully functional you can try compiling the following template:

Β 
Screenshot of the typeset document
\documentclass[11pt]{article}

\usepackage{fontspec}
\setmainfont{APL385 Unicode}
\setmonofont{APL385 Unicode}[Scale=MatchLowercase]

\begin{document}

I just want some ← +-Γ—Γ·*βŸβŒΉβ—‹!? |⌈⌊βŠ₯⊀⊣⊒ =≠≀<>β‰₯≑≒ ∨∧⍲⍱ β†‘β†“βŠ‚βŠƒβŠ†βŒ·β‹β’ ⍳⍸∊⍷βˆͺ∩~ /\textbackslashβŒΏβ€ ,βͺβ΄βŒ½βŠ–β‰ ¨⍨⍣.∘⍀β₯@ βžβŽ•β βŒΈβŒΊβŒΆβŽβ• β‹„ββ†’β΅βΊβˆ‡\& ¯⍬

\texttt{The ``setmonofont'' was needed because of this, otherwise βΊβŒŠΒ―β†’β¬ wouldn't show properly}.

\end{document}

Depending on whether you want the whole document to use the APL font or not, you may remove the command to set the main font. If you do so, APL glyphs will be rendered correctly inside code listings and similar environments, but not in the main body of the document.

Listings

LuaLaTeX and XeLaTeX can use the listings package to include APL source with the following document preamble:[2]

% set lstlisting to accept UTF8 APL text
\makeatletter
\lst@InputCatcodes
\def\lst@DefEC{%
 \lst@CCECUse \lst@ProcessLetter
  ^^80^^81^^82^^83^^84^^85^^86^^87^^88^^89^^8a^^8b^^8c^^8d^^8e^^8f%
  ^^90^^91^^92^^93^^94^^95^^96^^97^^98^^99^^9a^^9b^^9c^^9d^^9e^^9f%
  ^^a0^^a1^^a2^^a3^^a4^^a5^^a6^^a7^^a8^^a9^^aa^^ab^^ac^^ad^^ae^^af%
  ^^b0^^b1^^b2^^b3^^b4^^b5^^b6^^b7^^b8^^b9^^ba^^bb^^bc^^bd^^be^^bf%
  ^^c0^^c1^^c2^^c3^^c4^^c5^^c6^^c7^^c8^^c9^^ca^^cb^^cc^^cd^^ce^^cf%
  ^^d0^^d1^^d2^^d3^^d4^^d5^^d6^^d7^^d8^^d9^^da^^db^^dc^^dd^^de^^df%
  ^^e0^^e1^^e2^^e3^^e4^^e5^^e6^^e7^^e8^^e9^^ea^^eb^^ec^^ed^^ee^^ef%
  ^^f0^^f1^^f2^^f3^^f4^^f5^^f6^^f7^^f8^^f9^^fa^^fb^^fc^^fd^^fe^^ff%
  ^^^^20ac^^^^0153^^^^0152%
  ^^^^20a7^^^^2190^^^^2191^^^^2192^^^^2193^^^^2206^^^^2207^^^^220a%
  ^^^^2218^^^^2228^^^^2229^^^^222a^^^^2235^^^^223c^^^^2260^^^^2261%
  ^^^^2262^^^^2264^^^^2265^^^^2282^^^^2283^^^^2296^^^^22a2^^^^22a3%
  ^^^^22a4^^^^22a5^^^^22c4^^^^2308^^^^230a^^^^2336^^^^2337^^^^2339%
  ^^^^233b^^^^233d^^^^233f^^^^2340^^^^2342^^^^2347^^^^2348^^^^2349%
  ^^^^234b^^^^234e^^^^2350^^^^2352^^^^2355^^^^2357^^^^2359^^^^235d%
  ^^^^235e^^^^235f^^^^2361^^^^2362^^^^2363^^^^2364^^^^2365^^^^2368%
  ^^^^236a^^^^236b^^^^236c^^^^2371^^^^2372^^^^2373^^^^2374^^^^2375%
  ^^^^2377^^^^2378^^^^237a^^^^2395^^^^25af^^^^25ca^^^^25cb%
  ^^00}
\lst@RestoreCatcodes
\makeatother


Metafont

An APL metafont usable to typeset APL in LaTeX files is available on the (Comprehensive TeX Archive Network), available for free use. The version of the package is from 1987 and may not be suitable for glyphs used in modern APL implementations..

plainTeX

LdBeth has made a Type1 version of 3270 font with APL support, suitable for traditional TeX implementations that cannot directly use TTF/OTF fonts.

Β 
Screenshot of the typeset document
\input apldef.tex

\font\apl=3270

\apl

1234567890{\rm Good?}\NG1+2-3{\rm Mixing some roman}

I just want some \IS +-\ML\DV\ST\LG\DQ\LO{}!?\ |\CE\FL\DE\EN\LK\RK\ =\NE\LE<>\GE\EU\SE

\AD\OR\NA\NO\ \UA\DA\RU\LU\SS\SQ\GU\GD\ \IO\UI\EP\UE\UU\DU\NT\ /\BL\CS\CB\ ,\BC\RO\RV\CR\TR

\DD\RR\PP.\SO\RN\OV{}@\ \QQ\BX\CQ\EQ\MQ\IB\XQ\FM\ \DM\LM\GO\OM\AM\DL\&

\NG\NL

\obeylines\DL S\IS SUM N;I
S\IS I\IS 0
\GO (N<I\IS I+1)/0
S\IS S+I\ST 2
\GO 2
\DL
\bye

References

  1. ↑ Chan, Vince. How to remove Dyalog APL IME from various languages (MS WIN). Dyalog Forums. November 3, 2021.
  2. ↑ Baker, John D. Typesetting UTF8 APL code with the LaTeX lstlisting package. Analyze the Data not the Drivel. August 15, 2011.
APL development [edit]
Interface Session βˆ™ Typing glyphs (on Linux) βˆ™ Fonts βˆ™ Text editors
Publications Introductions βˆ™ Learning resources βˆ™ Simple examples βˆ™ Advanced examples βˆ™ Mnemonics βˆ™ ISO 8485:1989 βˆ™ ISO/IEC 13751:2001 βˆ™ A Dictionary of APL βˆ™ Case studies βˆ™ Documentation suites βˆ™ Books βˆ™ Papers βˆ™ Videos βˆ™ APL Quote Quad βˆ™ Vector journal βˆ™ Terminology (Chinese, German) βˆ™ Neural networks βˆ™ Error trapping with Dyalog APL (in forms)
Sharing code Backwards compatibility βˆ™ APLcart βˆ™ APLTree βˆ™ APL-Cation βˆ™ Dfns workspace βˆ™ Tatin βˆ™ Cider
Implementation Resources βˆ™ Open-source βˆ™ Magic function βˆ™ Performance βˆ™ APL hardware
Developers Timeline of corporations βˆ™ APL2000 βˆ™ Dyalog βˆ™ IBM βˆ™ IPSA βˆ™ STSC
APL glyphs [edit]
Information Glyph βˆ™ Typing glyphs (on Linux) βˆ™ Unicode βˆ™ Fonts βˆ™ Mnemonics βˆ™ Overstrikes βˆ™ Migration level
Individual glyphs Jot (∘) βˆ™ Right Shoe (βŠƒ) βˆ™ Up Arrow (↑) βˆ™ Zilde (⍬) βˆ™ High minus (Β―) βˆ™ Dot (.) βˆ™ Del (βˆ‡)