4,493
edits
Typing glyphs: Difference between revisions
Jump to navigation
Jump to search
m
→ASCII symbol composition
m (Text replacement - "<source" to "<syntaxhighlight") |
Tags: Mobile edit Mobile web edit |
||
| (11 intermediate revisions by 5 users not shown) | |||
| Line 4: | Line 4: | ||
== Hardware == | == 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 | 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. | ||
{| class=wikitable | |||
! Item !! Type !! Layout !! Languages !! Seller | |||
|- | |||
! rowspan=2 | Keyboard | |||
| [[wikipedia:Model_M_keyboard|Model M]] || [[Dyalog APL|Dyalog]] || 🇺🇸 || [https://www.amazon.com/Unicomp-Classic-Buckling-Spring-Keyboard/dp/B01M7V3M61/ref=sr_1_8 Amazon]. | |||
|- | |||
| [[wikipedia:Cherry (company)|Cherry]] || Dyalog || 🇺🇸 🇬🇧 🇩🇪 🇩🇰 || [https://www.dyalog.com/apl-font-keyboard.htm#mainContent Dyalog] | |||
|- | |||
! rowspan=3 | Key caps | |||
| Model M || Dyalog || 🇺🇸 ||[https://www.pckeyboard.com/page/product/USAPLSET Unicomp] | |||
|- | |||
| Cherry || [[APL2]] || 🇺🇸 || [https://mykeyboard.eu/catalogue/pbt-crp-r4-alphas-apl_3957/ mykeyboard.eu] | |||
|- | |||
| Cherry || Dyalog || 🇺🇸 || [https://novelkeys.com/products/cherry-olivia?variant=43001363431591 NovelKeys] | |||
|- | |||
! Key stickers | |||
| any || Dyalog || 🇺🇸 || [https://www.tindie.com/products/russtopia/apl-keyboard-symbol-sticker-set/ 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. | 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. | ||
| Line 23: | Line 32: | ||
=== Web === | === Web === | ||
[[Adám Brudzewsky]]'s [https://abrudz.github.io/lb/apl in-browser language bar] adds APL keyboard functionality to most web pages on demand. | * [[Adám Brudzewsky]]'s [https://abrudz.github.io/lb/apl in-browser language bar] adds APL keyboard functionality to most web pages on demand. | ||
[https://daveremba.com/public/apl_vk_demo/ APL VK] is a virtual keyboard for the APL Language for modern mobile devices. | * [https://daveremba.com/public/apl_vk_demo/ 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. | 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. This is work in progress. | It is similar to the APL language bar but is optimized for mobile devices. This is work in progress. | ||
=== Text editors === | === Text editors === | ||
{{Main|Text editors}} | |||
Keyboard layout extensions exist for several popular | 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 === | === Linux === | ||
{{Main|Typing glyphs on Linux}} | {{Main|Typing glyphs on Linux}} | ||
Most Linux distributions released after mid-2012 have Dyalog | * Most Linux distributions released after mid-2012 have Dyalog shifting-key support included with the distribution. | ||
* [https://github.com/secwang/espanso-apl-keyboard espanso-apl-keyboard] provides text replacement entry. | |||
[[File:Array Hacker's Keyboard.png|thumb|right|Array Hacker's Keyboard]] | [[File:Array Hacker's Keyboard.png|thumb|right|Array Hacker's Keyboard]] | ||
| Line 51: | Line 62: | ||
* [[Fawn Locke]] offers [https://github.com/awagga/DvorakAPL a number of alternative Dvorak keyboard layouts for Windows], which adopt the functionality of Adám's layouts. | * [[Fawn Locke]] offers [https://github.com/awagga/DvorakAPL a number of alternative Dvorak keyboard layouts for Windows], which adopt the functionality of Adám's layouts. | ||
* [https://github.com/secwang/espanso-apl-keyboard espanso-apl-keyboard] provides text replacement entry. | |||
* The [https://www.dyalog.com/apl-font-keyboard.htm#tab-1 Dyalog Unicode IME] uses <kbd>Ctrl</kbd>. Unless unselected, this [[wikipedia:Input_method|IME]] is installed by default with [[Dyalog APL]]:<br>[[File:Dyalog_APL_Installer.png|frameless|Dyalog APL IME selected in installer]] | * The [https://www.dyalog.com/apl-font-keyboard.htm#tab-1 Dyalog Unicode IME] uses <kbd>Ctrl</kbd>. Unless unselected, this [[wikipedia:Input_method|IME]] is installed by default with [[Dyalog APL]]:<br>[[File:Dyalog_APL_Installer.png|frameless|Dyalog APL IME selected in installer]] | ||
* e-sushi has [https://github.com/e-sushi/aplhotstrings/tree/main an AutoHotkey script] that allows ASCII composition. | |||
==== Troubleshooting ==== | ==== Troubleshooting ==== | ||
| Line 58: | Line 73: | ||
=== macOS === | === macOS === | ||
* [https://github.com/secwang/espanso-apl-keyboard espanso-apl-keyboard] provides text replacement entry. | |||
To enable these keyboard key mappings on [[wikipedia:macOS|macOS]], the appropriate <code>.keylayout</code> files for your locale must be downloaded and installed in the <code>/Library/Keyboard Layouts</code> directory: | To enable these keyboard key mappings on [[wikipedia:macOS|macOS]], the appropriate <code>.keylayout</code> files for your locale must be downloaded and installed in the <code>/Library/Keyboard Layouts</code> directory: | ||
* [[Dyalog Ltd.]] provides keyboard layouts for [https://www.dyalog.com/uploads/files/download.php?file=DyalogAltDK.zip Danish], [https://www.dyalog.com/uploads/files/download.php?file=DyalogAltIT.zip Finnish], [https://www.dyalog.com/uploads/files/download.php?file=DyalogAltIT.zip Italian], [https://www.dyalog.com/uploads/files/download.php?file=DyalogAltUK.zip British], and [https://www.dyalog.com/uploads/files/download.php?file=DyalogAltUS.zip American]. | * [[Dyalog Ltd.]] provides keyboard layouts for [https://www.dyalog.com/uploads/files/download.php?file=DyalogAltDK.zip Danish], [https://www.dyalog.com/uploads/files/download.php?file=DyalogAltIT.zip Finnish], [https://www.dyalog.com/uploads/files/download.php?file=DyalogAltIT.zip Italian], [https://www.dyalog.com/uploads/files/download.php?file=DyalogAltUK.zip British], and [https://www.dyalog.com/uploads/files/download.php?file=DyalogAltUS.zip American]. | ||
* LdBeth provides a keyboard layout for [https://github.com/LdBeth/APL-JIS Japanese (JIS)]. | * LdBeth provides a keyboard layout for [https://github.com/LdBeth/APL-JIS Japanese (JIS)]. | ||
* [https://aplwiki.com/wiki/Typing_glyphs#ASCII_symbol_composition ASCII symbol composition] US and UK layouts are available from [https://github.com/abrudz/kbd#ascii-symbol-composition-layouts github.com/abrudz/kbd]. | * [https://aplwiki.com/wiki/Typing_glyphs#ASCII_symbol_composition ASCII symbol composition] US and UK layouts are available from [https://github.com/abrudz/kbd#ascii-symbol-composition-layouts github.com/abrudz/kbd]. | ||
| Line 66: | Line 86: | ||
* ohAitch's [https://github.com/ohAitch/APLiOS APLiOS], aimed primarily at iPadOS, provides a number bar and APL symbol layers. | * ohAitch's [https://github.com/ohAitch/APLiOS APLiOS], aimed primarily at iPadOS, provides a number bar and APL symbol layers. | ||
* [https://github.com/gitonthescene/APLKeyboard APLKeyboard] is built with [http://omz-software.com/pythonista/ Pythonista's] keyboard extension. The keys are a bit small but it's functional. | |||
== By method == | == By method == | ||
| Line 91: | Line 113: | ||
=== Shifting key === | === Shifting key === | ||
It is quite common to use <kbd>Ctrl</kbd> or <kbd>Alt</kbd> or <kbd>AltGr</kbd> (right-side <kbd>Alt</kbd>) as an additional shifting key. For example, <kbd>AltGr</kbd>+<kbd>4</kbd> would give <syntaxhighlight lang=apl inline>≤</ | It is quite common to use <kbd>Ctrl</kbd> or <kbd>Alt</kbd> or <kbd>AltGr</kbd> (right-side <kbd>Alt</kbd>) as an additional shifting key. For example, <kbd>AltGr</kbd>+<kbd>4</kbd> would give <syntaxhighlight lang=apl inline>≤</syntaxhighlight> while <kbd>AltGr</kbd>+<kbd>Shift</kbd>+<kbd>4</kbd> would give <syntaxhighlight lang=apl inline>⍋</syntaxhighlight>. | ||
* The [https://www.dyalog.com/apl-font-keyboard.htm#tab-1 Dyalog Unicode IME] uses <kbd>Ctrl</kbd> | * The [https://www.dyalog.com/apl-font-keyboard.htm#tab-1 Dyalog Unicode IME] uses <kbd>Ctrl</kbd> | ||
| Line 108: | Line 130: | ||
* [[Adám Brudzewsky]]'s [https://abrudz.github.io/lb/apl in-browser language bar] recognises all the following as prefix keys: <kbd>`</kbd>, <kbd>½</kbd>, <kbd>²</kbd>, <kbd>^</kbd>, <kbd><s>º</s></kbd>, <kbd>§</kbd>, <kbd>ù</kbd>, <kbd>µ</kbd>, <kbd>°</kbd>. | * [[Adám Brudzewsky]]'s [https://abrudz.github.io/lb/apl in-browser language bar] recognises all the following as prefix keys: <kbd>`</kbd>, <kbd>½</kbd>, <kbd>²</kbd>, <kbd>^</kbd>, <kbd><s>º</s></kbd>, <kbd>§</kbd>, <kbd>ù</kbd>, <kbd>µ</kbd>, <kbd>°</kbd>. | ||
* Custom .XCompose files can be used on Linux as described in [https://aplwiki.com/wiki/Typing_glyphs_on_Linux#XCompose_(backtick/prefix/dead_key) the page Typing Glyphs on Linux]. | |||
[[File:RIDE keyword lookup.png|thumb|right|RIDE keyword lookup]] | [[File:RIDE keyword lookup.png|thumb|right|RIDE keyword lookup]] | ||
| Line 117: | Line 141: | ||
=== Keyword look-up === | === Keyword look-up === | ||
The [https://github.com/Dyalog/ride/releases/latest Dyalog RIDE] (Remote Integrated Development Environment) allows hitting the prefix key (<kbd>`</kbd> 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. <kbd>`</kbd>,<kbd>`</kbd>,<kbd>d</kbd>,<kbd>i</kbd>,<kbd>v</kbd>,<kbd>Tab↹</kbd> inserts <syntaxhighlight lang=apl inline>÷</syntaxhighlight>. | |||
=== ASCII symbol composition === | === ASCII symbol composition === | ||
Many APL glyphs can be approximated by overlaying or juxtaposing two ASCII characters. [[ngn/apl]]'s scripted demo interface, [https://abrudz.github.io/lb/apl Adám Brudzewsky's in-browser language bar], and [[TryAPL]]'s web interface allow such a pair of characters and hitting the <kbd>Tab↹</kbd> key to replace them with the corresponding APL character. For example, <kbd><</kbd>,<kbd>-</kbd>,<kbd>Tab↹</kbd> will insert <syntaxhighlight lang=apl inline>←</syntaxhighlight> and <kbd>T</kbd>,<kbd>o</kbd>,<kbd>Tab↹</kbd> will insert <syntaxhighlight lang=apl inline>⍕</syntaxhighlight>. | |||
For Windows users, e-sushi has [https://github.com/e-sushi/aplhotstrings/tree/main an AutoHotkey script] that allows such composition. | |||
=== Text replacement === | |||
[https://github.com/espanso/espanso 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. [https://github.com/secwang/espanso-apl-keyboard espanso-apl-keyboard] is an Espanso configuration that emulates prefix key, so for example typing pressing <kbd>`</kbd>,<kbd>e</kbd> too type <code>`e</code> will be end up producing the <syntaxhighlight lang=apl inline>∊</syntaxhighlight> glyph. | |||
[[File:NARS2000 language bar.png|thumb|right|NARS2000 language bar]] | [[File:NARS2000 language bar.png|thumb|right|NARS2000 language bar]] | ||
| Line 152: | Line 182: | ||
\end{document} | \end{document} | ||
</ | </syntaxhighlight> | ||
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. | 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. | ||
| Line 186: | Line 216: | ||
\lst@RestoreCatcodes | \lst@RestoreCatcodes | ||
\makeatother | \makeatother | ||
</ | </syntaxhighlight> | ||
=== plainTeX === | === plainTeX === | ||
| Line 217: | Line 247: | ||
\DL | \DL | ||
\bye | \bye | ||
</ | </syntaxhighlight> | ||
== References == | == References == | ||