On most operating systems (macOS being one notable exception), installing Dyalog also installs the default public-domain APL fonts. These can also be downloaded and installed as follows:
After downloading the appropriate font, follow the instructions specific to your operating system:
@MIKE: THE FOLLOWING THREE SECTIONS WERE ORIGINALLY IN TABS – SEE https://www.dyalog.com/apl-font-keyboard.htm
Dyalog on the Microsoft Windows Operating System
Installing the Font
Navigate to the downloaded .ttf file in Windows Explorer, right-click on it and select Install from the drop-down menu.
NOTE: The setup_fonts.msi file contains all the fonts supplied with the Microsoft Windows versions of Dyalog, including APL385 (for Dyalog Unicode edition) and the Dyalog Symbol (for Dyalog Classic edition) fonts. To install these fonts, double-click on the downloaded setup_fonts.msi file and follow the on-screen instructions.
Enabling the Keyboard Key Mappings
The Dyalog Unicode IME defines the mapping of keystrokes to Unicode characters – it can be regarded as an overlay of the standard keyboard which contains just APL characters. It enables APL characters to be input into any Microsoft Windows application that supports IME input, including Dyalog Unicode Edition (not Classic), PuTTY, Notepad and the Microsoft Office Suite.
NOTE (May 2022): If you are using Microsoft Windows 11, then you might find that the standard Dyalog IME does not work with UWP (Universal Windows Platform) applications such as Notepad. We are working on both immediate and long-term solutions to meet our customers’ wide range of needs.
The version of the Dyalog Unicode IME that should be downloaded and installed is dependent on whether a 32-bit or 64-bit version of the Microsoft Windows operating system is installed:
NOTE: These .msi files should support any Dyalog Unicode edition from version 12.1 onwards, providing that the interpreter has a build date later than 20 April 2011. Dyalog Ltd recommends that you always install the latest version of the Dyalog Unicode IME that is available.
Installing the Dyalog IME
To install the Dyalog Unicode IME, download the appropriate .msi file.
If you already have a Dyalog Unicode IME installed and want to update it, then you must uninstall the currently installed version and reboot your PC before installing the new one.
Double-clicking on the downloaded .msi file does not install the IME successfully; instead, open a Command Window by right‑clicking on the command prompt and select Run as Administrator from the drop-down menu (running with raised privileges is essential to the success of the installation of the IME). In the Command Window, navigate to the directory that contains the downloaded .msi file and enter msiexec /i setup_ime_64.msi (or msiexec /i setup_ime_32.msi). Select the appropriate options in the dialog boxes that are displayed.
After installation you must reboot your PC to complete the installation process.
Diagrams showing the keyboard layouts can be found on the keyboard layout page of the dfns website.
Documentation
The Dyalog for Microsoft Windows UI Guide includes instructions for:
- configuring the Dyalog IME (from within a Session or in the Microsoft Windows taskbar)
- configuring automatic selection of the APL keyboard each time a session is started (Unicode edition only)
More hints and tips about using the Dyalog Unicode IME can be found in the FAQ section of the Dyalog forum. For example:
- Why does my Unicode Dyalog stop giving APL characters?
- How to remove Dyalog APL IME?
- Dyalog (Unicode) Problem typing APL characters on Windows 8?
- Why don’t Ctrl-X, Ctrl-C, and Ctrl-V work in Dyalog Unicode?
- Problems with entering ⍲ (NAND) under Vista and Windows 7
- Unable to type any APL characters in Dyalog (Unicode)
- Windows 10: adding Dyalog Unicode IME as an input method
Dyalog on the Linux Operating System
NOTE: When installing Dyalog on the Raspberry Pi, (or any other Debian-based Linux distribution), the fonts and keyboard mappings are automatically installed and enabled.
Installing the Font
Most non-Debian-based Linux distributions include fonts that can display the APL character set. However, if the APL385/APL333 font is required, then place the downloaded .ttf file in the /usr/share/fonts/truetype/dyalog/ directory. As root, open a command prompt and run fc-cache /usr/share/fonts.
Enabling the Keyboard Key Mappings
Most Linux distributions released after mid-2012 have Dyalog keyboard support included with the distribution, for example, openSUSE 12.2, Ubuntu 12.10 and Fedora 17. Keyboard support for other window managers (for example, Gnome and Unity) is in a state of flux; the latest information about the process of installing and configuring Dyalog keyboard support for such environments can be found on the Dyalog forum or by e-mailing us.
Documentation
The Dyalog for UNIX Installation and Configuration Guide includes instructions for:
- configuring the terminal window for Dyalog keyboard support (global per user per UI)
- generating APL glyphs through the PuTTY terminal emulator by installing the Dyalog Unicode IME and APL385 font
For Linux distributions that have Dyalog keyboard support included with the distribution, a diagram showing the keyboard layout can be found in the /usr/share/X11/xkb/symbols/apl file.
Diagrams showing the keyboard layouts can be found on the keyboard layout page of the dfns website.
Dyalog on the macOS Operating System
NOTE: When installing Dyalog for macOS, the font and keyboard mappings are automatically installed and enabled for use in a Dyalog Session – the following allows use of Dyalog glyphs both outside and inside a Dyalog Session (for example, in email).
Installing the Font
Place the downloaded .ttf file in the /Library/Fonts/ directory.
Enabling the Keyboard Key Mappings
To enter Dyalog glyphs, the keyboard key mappings must be enabled. To enable these keyboard key mappings on macOS, the appropriate DyalogAlt.keylayout and DyalogAlt.icns files for your locale must be downloaded and installed in the /Library/Keyboard Layouts directory. To download a zip file containing these files, click on the relevant flag (if the country you require is not available, or you want to customise one of these layouts, then please refer to this forum post):
DyalogAlt.keylayout and DyalogAlt.icns files: @MIKE THE LINKS WERE INDICATED BY FLAGS ORIGINALLY, THESE HAVE NOT COME ACROSS. SEE https://www.dyalog.com/apl-font-keyboard.htm
The keyboard key mappings installed with these files are enabled whenever the Dyalog keyboard is selected in the main menu bar. The following locale-specific images show these keyboard key mappings. To enter Dyalog glyphs using these keyboard key mappings, hold down the key combination shown shaded in the following images and press the appropriate character key.
Diagrams showing the keyboard layouts can be found on the Mac keyboard layout page of the dfns website.
Documentation
The Dyalog for macOS Installation and Configuration Guide includes instructions for:
- installing the APL385 Unicode font
- using the DyalogAlt.keylayout file to enable keyboard key mappings
