Browse this file with ================================= PgUp/Down, Caps Shift+1,2 ****** Lnx Text Editor ****** _____ FDMA edition _____ Lnx Text Editor is a simple text editor that supports basic editing functions plus several advanced options. Its main advantage over the most, older ZX Spectrum text editors is that the LnxTEd opens and stores ASCII files directly from/to FAT formatted SD card. Main features of the editor are - operating memory for 64KB text files (approx. 30 pages) - clipboard and UNDO functions - esxDOS I/O support, file requester/browser - ZX and PC keyboards with two layouts and extra characters - K-Mouse support LnxTEd is designed for the eLeMeNt ZX, a superb ZX Spectrum, Pentagon and ZX-Uno clone with a HDMI (video and audio) output, two SD slots (divSD) and a lot of popular ZX-interfaces built-in. LnxTEd runs in the high-resolution graphics mode (HGFX, 512*384 pixels, 4 colours, FastDMA acceleration) and uses fine 8x16 fonts with 224 characters (No. 32 to 255). Currently it has only one charset implemented, providing characters of German, Czech, Slovak and other languages of the Central Europe. You can switch between two keyboard layouts, English (ENG) and Czech (CZE). LnxTEd is designed to serve well for making notes, editing (esxDOS) INI files and creating READ.ME, NFO and DIZ files. In this first version, don't look for files bigger than 64KB and with more than 8190 lines, or for functions like 'overwrite' and 'search'. For a download, visit ilnx.cz Try out my other programs: LnxCopy, LnxCommander, LnxViewer Do you want to know more about the eLeMeNt ZX? Go to the website 128land.com, visit Bytefest, bytefest.cz or FOReVER, forever.zeroteam.sk 2024, Lanex Content: 1. Basic text editing 2. Info/menu bar 3. Selection mode and clipboard 4. ZX keyboard layouts 5. PC keyboard layouts 5. File handling 6. Integration with esxDOS 7. Extras (charset) 1. Basic text editing ---------------------------------------- The keyboard of the LnxTEd preserves the meaning of the most ZX Spectrum keys and adds several new features (editing function and extra characters), as easily accessible as possible. For clarity, let's have these abbreviations of the basic ZX Spectrum shifting keys: Caps Shift ... CS Symbol Shift ... SS Extended (CS+SS) ... EXT Note: The EXT+SS+... or EXT+SS+... combinations of keys mean that first you press CS+SS to get into the Extended mode and in this EXT mode you then press CS+... or SS+.... The EXT+SS+key is not needed on PC keyboards. Simply press CTRL+key instead. In addition to cursor keys (CS+5 to 8), you can move the cursor by 23 lines forward and backward (per screen) with PageUp and PageDown keys assigned to the CS+1 and CS+2. Get to the top of the file with CS+3, to the end with CS+4. Move over words to the left or right. On the ZX keyboard, switch to the Extended mode (press Caps Shift + Symbol Shift) The red label 'EXT' appears in the menu/info line. Then move the cursor to the left or to the right, CS+5 or CS+8. Or use Alt + Left or Right on the PC keyboard. Similarly CS+7, Home and CS+6, End make the cursor to jump to the start or end of line. All movement keys, combinations with the Caps Shift key, work in both EXTended and SELection modes. Note: Use the mouse pointer to change the position of the cursor. Next to the ZX-DELETE, CS+0 (BACKSPACE), the classic PC-DELETE is implemented, on CS+9, to erase characters to the right (of the cursor). The editor does not mark the end of every line. A line break must be inserted by the ENTER key. Another special formatting character is a tabulator, available by pressing Tab or SS+SPACE, that jumps to the nearest fixed position (of eight characters). The series of last eight important editing steps (changes of text after operations like Enter, Cut, Paste, Delete, Open or New) is recorded and stored in a temporary memory. The edited text file can be returned to a previous state by an 'Undo' function, with EXT+SS+Z/Y. 2. Info/menu bar --------------------------------------------- The menu in the top part of the screen offers file operations, functions of the clipboard, Y/Z and ZX/PC keyboard switch and the help screen. Make a selection from the menu by the mouse pointer or open it through CTRL+1,2,3 or EXT+SS+1,2,3. On the far right is a number of the row currently being edited. Next is indicated the keyboard type. To change a keyboard layout, click on the indicator or press CTRL+K, EXT+SS+K. All function and commands, with corresponding key combinations are listed in the help-screen (CTRL+H, EXT+SS+H). In the information bar are also presented, in red letters, enabled working modes, SELection mode and EXTended mode. The info bar does not any show system messages. If some file I/O issue occures (e.g. missing SD card), a message window with an esxDOS error number is displayed. If an editing command cannot be executed, such a limitation or impossibility of the text operation is indicated immediately by a change of both background and border colours. 3. Selection mode and clipboard ------------------------------ The Selection mode can be turned on and off with a combination of keys SS+ENTER (Shift+ENTER on the PC keyboard). The red label SEL appears in the menu/info bar. Move the cursor then, per chars, lines, words or per screens ("pages"). The selected text will be highlighted with a blue backgroud. With the ZX keyboard, you have to enter the EXTended mode. The red label 'EXT' appears in the menu/info bar. Use the classic combination of Cut-Copy-Paste functions, press EXT, then SS+X, SS+C or SS+V. On the PC keyboard, use CTRL+X,C,V. You can join two separate text files into a big one. Load a file, select all (CTRL+A, EXT+SS+A), copy to clipboard (CTRL+C, EXT+SS+C), load a second new file and paste the previous text from the clipboard (CTRL+V, EXT+SS+V). However, the whole size of joined files cannot exceed 65535 bytes. 4. ZX Keyboard layout ---------------------------------------- Any key carries up to 6 different characters, editing functions or commands. Following description of modes and switches is used: Normal Mode +Caps Shift (mostly edit functions) --------------------------------------------------------------- Normal Mode character, +Caps Shift, +Symbol Shift Extended Mode character, +Caps Shift --------------------------------------------------------------- Extended Mode +Symbol Shift (commands) Examples: Key ...................1............5............A.......... Norm. +CS PageUp Crsr left ------------------------------------------------------------ Norm. char,+CS,+SS 1, ,! 5, ,% a,A,~ Ext. char,+CS 1, nothing 5,MWB , ------------------------------------------------------------ Ext. char,+SS Menu No.1 nothing Select All Note: MWB means Move (cursor over) Word Back (to the left) MWF Move (cursor over) Word Forward (to the right) MEL Move (cursor) to End of Line (position 63) MSL Move (cursor) to Start of Line (position 0) Commands of EXT+SS have always the same keys, regardless of the selected keyboard layout. ENG keyboard with German characters: PGUP PGDN TOP END LEFT DOWN UP RIGHT DEL BACKSPACE --------------------------------------------------------------- 1 ! 2 @ 3 # 4 $ 5 % 6 & 7 ' 8 ( 9 ) 0 _ 1 2 3 4 5,MWB 6,MEL 7,MSL 8,MWF 9 0 --------------------------------------------------------------- MENU1 MENU2 MENU3 _______________________________________________________________ qQ wW eE rR < tT > yY [ uU ] iI oO ; pP " --------------------------------------------------------------- QUIT UNDO OPEN _______________________________________________________________ aA ~ sS | dD \ fF { gG } hH ^ jJ - kK + lL = --------------------------------------------------------------- SEL.ALL SAVE SAV.AS HELP KEYB _______________________________________________________________ zZ : xX cC ? vV / bB * nN , mM . --------------------------------------------------------------- UNDO CUT COPY PASTE NEW CZE keyboard with Slovak and German characters: PGUP PGDN TOP END LEFT DOWN UP RIGHT DEL BACKSPACE --------------------------------------------------------------- 1 ! @ # $ % & ' ( ) _ 1 2 3 4 5,MWB 6,MEL 7,MSL 8,MWF 9 0 --------------------------------------------------------------- MENU1 MENU2 MENU3 _______________________________________________________________ qQ wW eE rR < tT > zZ [ uU ] iI oO ; pP " --------------------------------------------------------------- QUIT UNDO OPEN _______________________________________________________________ aA ~ sS | dD \ fF { gG } hH ^ jJ - kK + lL = --------------------------------------------------------------- SEL.ALL SAVE SAV.AS HELP KEYB _______________________________________________________________ yY : xX cC ? vV / bB * nN , mM . ߣ --------------------------------------------------------------- UNDO CUT COPY PASTE NEW 5. PC Keyboard layout --------------------------------------- Three modes are available: non-SHIFTed, SHIFTed and ALTed. For extra operations, use CTRL and (usually) the first letter of the function, instead of the old ZX keyboard switch EXT+SS. German characters are also present. PC ENG keyboard ............................................................ `~ 1! 2@ 3# 4$ 5% 6^ 7& 8* 9( 0) -_ =+ BCKSPC :...:...:...:...:...:...:...:...:...:...:...:...:...:......: MENU1 MENU2 MENU3 ------------------------------------------------------------ TAB qQ wW eE rR tT yY uU iI oO pP [{ ]} ENT :.....:...:...:...:...:...:...:...:...:...:...:...:...:. : QUIT UNDO OPEN -------------------------------------------------------: CAPS aA sS dD fF gG hH jJ kK lL ;: '" \| :......:...:...:...:...:...:...:...:...:...:...:...:...:...: ALL SAVE S.AS HELP KEYB ------------------------------------------------------------ C.SHIFT zZ xX cC vV bB nN mM ,< .> /? C.SHIFT :........:...:...:...:...:...:...:...:...:...:...:.........: UNDO CUT COPY PASTE NEW ------------------------------------------------------------ SYMB ZX ALT SPACE ALT ZX ALT2 SYMB :....:....:....:.......................:....:....:....:....: PC CZE keyboard The fourth group of characters is added to the layout, in order to get special characters with diacritical marks, like etc. The key before the backspace, in the upper (numeric row), hold various diacritics switchers, shifted and non-shifted. 1. row normal, shift, alt 2. row switcher 3. row shift + switcher ............................................................ ; +1! 2@ 3# 4$ 5% 6^ 7& 8* 9( 0) =% BCKSPC :...:...:...:...:...:...:...:...:...:...:...:...:...:......: MENU1 MENU2 MENU3 ------------------------------------------------------------ TAB qQ\ wW| eE rR tT zZ uU iI Oo pP / )( ENT :.....:...:...:...:...:...:...:...:...:...:...:...:...:. : QUIT UNDO OPEN -------------------------------------------------------: CAPS aA~ sS dD fF[ gG] hH^ jJ kK lL "$ ! \' :......:...:...:...:...:...:...:...:...:...:...:...:...:...: ALL SAVE S.AS HELP KEYB ------------------------------------------------------------ C.SHIFT yY xX# cC& vV@ bB{ nN} mM ,?< .:> -_* C.SHIFT :........:...:...:...:...:...:...:...:...:...:...:.........: UNDO CUT COPY PASTE NEW ------------------------------------------------------------ SYMB ZX ALT SPACE ALT ZX ALT2 SYMB :....:....:....:.......................:....:....:....:....: 6. File handling -------------------------------------------- A new file will be created using EXT+SS+N or CTRL+N. Use EXT+SS+O or CTRL+O to open and load a file from the SD card. When done, save this file with EXT+SS+S or CTRL+S. You can also change a filename or make a backup file with 'Save As', EXT+SS+D or CTRL+D. The LnxTEd checks whether the file has been changed since the last saving and offers you an option to save. The program uses a file requester already known from the LnxCopy utility. You can go through directories and filelists, select a file or create a new folder. Choose a directory and press D to make a file operation. Currently it is not possible to choose between first or second SD slot. The program works only with a SD card from which it was started. Also please note, in this beta version of the editor, the mouse is not active in the file requester. 7. Integration with esxDOS ----------------------------------- The LnxTEd supports the esxDOS and the DivSD with FAT formatted SD cards. It is not intended to edit older, legacy, non-ASCII formats and cannot handle various tape- and disk-images. * Autostart of the LnxTEd You can run the editor on every start of your eLeMeNt ZX with the AUTOBOOT.BAS file located in the SYS directory. Check (and edit directly with the LnxTEd) this file: /SYS/CONFIG/ESXDOS.CFG and set, how the autoboot will proceed (never, always, cold/warm boot). The AUTOBOOT.BAS should use these LOAD commands, running from a TAP file: .tapein LNXTED.TAP LOAD "" or directly from SD card: .cd LNXTED LOAD *"LNXTED.BAS" * make a shortcut to the program Launch the LnxTEd easily, no matter what directory you are in. Create a linking dot-command with the utility Launcher, made by ub880d. .LAUNCHER add link-name /LNXTED/LNXTED.BAS or (for a TAP file) .LAUNCHER add link-name LNXTED.TAP Example: If the link-name is TED, run the LnxTEd with a new dot-cmd .TED then. * quick start from the ZX Basic edit-line Copy the dot-command LNXTED to the BIN direcory. If needed, rename this file to whatever you like, e.g. to shorter 'E'. To run a program in order to start a new text, type .LNXTED or, if the editor was renamed, use .E instead :-) To start with a specific textfile, type .LNXTED TEXTFILE.TXT * other esxDOS software ZX Basic files are editable in ASCII format, use import- and export- dot-commands .LOAD, .SAVE, .MERGE by Nagydani. Z-80 assembler source files written in the LnxTEd can be converted with the dot command .SAIMPORT into sources for the powerful SPECASM assembler. https://github.com/markdryan/specasm To check bytes in LnxTEd textfiles, you can view them by the excellent esxDOS Hex Monitor and Editor by namco/hexgen software 2021. 8. Extras ---------------------------------------------------- * Formatting characters Formatting characters are special characters with a value lower than 32 (0x20), that are kept in the textfile. Line break (placed on the ENTER key), or Line Feed, LF, aka End Of Line, EOL, contains the value 10 (0x0A). Tabulator (HT, Horizontal Tabulator) on Tab or SS+SPACE keys, has the value 9. A byte with the Carriage Return code (CR, value 13, 0x0D) is preserved in the imported text. When saving this file, an automatic conversion CR>LF is made. In other words, the LnxTEd accepts any Win/Mac/Unix text file with LF, CR or CR+LF codes, but it saves files only with all line endings converted to Unix/Linux standard (LF bytes). The null character, a control character with a value zero, is not used in the text file either. If found while loading a text file, such a byte stops the text, terminates any loading of next bytes. * Codepage 1250 character table (codes in hexadecimal) _0 _1 _2 _3 _4 _5 _6 _7 _8 _9 _A _B _C _D _E _F 2_ ! " # $ % & ' ( ) * + , - . / 3_ 0 1 2 3 4 5 6 7 8 9 : ; < = > ? 4_ @ A B C D E F G H I J K L M N O 5_ P Q R S T U V W X Y Z [ \ ] ^ _ 6_ ` a b c d e f g h i j k l m n o 7_ p q r s t u v w x y z { | } ~ 8_ 9_ A_ B_ C_ D_ E_ F_ * Memory Usage For text files, undo operations and for the clipboard, the LnxTEd uses eLeMeNt's Ultimate RAM (Protected mode). It has the memory management which is prepared to coexist with some other programs, e.g. with the file manager, the LnxCommander. _________________________________________ LNXTED.MAN, 2024-02-14, typed by samista