Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / SEDIT270.ZIP / SEDIT.DOC < prev next >

Wrap

Text File | 1993-01-02 | 34.3 KB | 901 lines

SEDIT V2.7 (c) 1992 by Oliver Weindl Page 1 ════════════════════════════════════════════════════════════════════ ▄████▄ ██████ █████▄ ██ ████████ ██ ██ ██ ██ ██ ██ ▀█████▄ ████ ██ ██ ██ ██ V2.7 ██ ██ ██ ██ ██ ██ ▀████▀ ██████ █████▀ ██ ██ The MenuEditor for SBBS (c) 1991,92 by Oliver Weindl 2:246/45 -1- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 2 ════════════════════════════════════════════════════════════════════ 1. What is SEDIT SEDIT is a MenuEditor for SuperBBS. It supports multilanguage and all menutypes and keycodes of SuperBBS. All menus can be edited in WYSIWYG or linenumber mode. 2.Getting started SEDIT can be configured by a small config file named SEDIT.CTL. Simply edit this file for your own purposes. The CONFIG-FILE : I only want to give a short overview of the available control statements. The syntax and some mor information is given in the SEDIT.CTL file. This variable points to your SBBS-homdirectory, where the CONFIG.BBS and SCONFIG.BBS files are stored. BBSPath=c:\sbbs Quite a silly variable, but for some freaks quite nice ;-) It generates a sound when exploding the windows ... Sound Defines the paths to the different menudirectories and textdirectories in multilanguage mode. Usually ther is only one MenuPath statement here, but you can define up to 300. MENUPath=c:\sbbs\menu c:\sbbs\text German Menu directory This control variable defines the startupmode of SEDIT. If you define Supresslines, the default display is WYSIWYG, otherwise SEDIT will startup in Linennumbermode. Supresslines Quite important is this statement. Here you define the default menuprompt of new menus. DEFAULTPROMPT=Restzeit ^~^ Minuten, Dein Befehl> If you define this variable in the control file, SEDIT will explode all windows (nice ;-). Explode -2- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 3 ════════════════════════════════════════════════════════════════════ If you define explode, you should also define the Delay for the explode, 0 is the fastest, 255 the slowest (not recommended). ExplodeDelay=4 The Startmenu statement defines the menu your BBS starts up. This is important for the menustructure simulation, so that SEDIT knows, which menu is the first one. StartMenu This statement sets two flashing indicator lights at the SEDIT-logo in editmode.This two lights indicate savestatus and the editmode in which you are workling. I advice you to keep this feature active ! DisplaySaveFlag The ActionKey statement defines in which editmode SEDIT starts up. Read more about the JumpMenu and JumpEntry mode in the following sections. Possible parameters of ActionKey are "JumpEntry" and "JumpMenu". A New feature is EditText for default. All other neccessary informations SEDIT takes from the config files of SBBS. If you have changed this file, you can start SEDIT. You don't have to put SEDIT in the SBBS directory ( i hate this long directories) , you can define a subdirectory and put the dos-path on it. SEDIT checks itself, in which directory it's placed. If you haven't registered SEDIT, SEDIT will prompt you to type in 4 different keys on startup. I've decided to do so, cause i don't want to bring out crippled software any more. You should see how the program works, and if you decide it's good enough for you, you can register it. When registering you receive a key-file, which supresses this stupid typing at startup. 3. The Startup Depending on wether you defined more than one menu-directory in the CTL-file, SEDIT asks for the language if you're running multilanguage. Choose one of the languages, und you receive a scrollbox where the menus are listet in. You can choose one of the menus by scrolling the inverted bar on it, or just simply type in the name of the menu. If you only have defined one Language, you directly jump to the file-selection-box. 4. Edit Mode -3- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 4 ════════════════════════════════════════════════════════════════════ When you have choosen a menu, the screen changes to edit mode. Depending on the displaymode (WYSIWYG or Linenumber) you can scroll up and down to the different menuentries. Pressing F1 in the editmode displays a list of all available functions (press ALT+H for a helpscreen). -4- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 5 ════════════════════════════════════════════════════════════════════ ┌─────────────────╒═══════════ Choose a Function ════════════╕ │ ░▒▓█▓▒░ │ Insert Entry (ALT+I) │ │ ░▒▓█▓▒░ │ Append Entry (ALT+A) │ │ ░▒▓█▓▒░ I ▀│ Delete Entry (ALT+D) │ └─────────────────│ │ │ Key-Menu Add/Delete (ALT+K) │ │ Change Flagdescriptions (ALT+F) │ [I] Impressum │ Edit Prompt & Highlight Colors (ALT+P) │ [M] Message Base │ Change prompt in all menus (ALT+T) │ [K] Konfiguration │ Change Flag & Security (ALT+B) │ [X] Netmails │ Edit default menuentry (ALT+M) │ │ Define & Save a Block (ALT+S) │ [A] Allgemei│ Load $ Insert a Block (ALT+L) │ [W] Wegweise│ Copy Entry to new Position (ALT+C) │ [Q] Fragebog│ Compile ANSI to Menu (ALT+U) │len ----- [#] SysOp Me│ Preview actual Menu (ALT+V) │ [S] Gesamtan│ View/Print Menu (ALT+G) │ [H] HILFE !!│ Save Menu (F2) │ │ Linenumbers ON/OFF (F8) │ │ Menustructure Simulation (F10) │ │ Changed my mind, do nothing ;-) │ ╘══════════════════════════════════════════╛ Menu : C:\SBBS\MENU\TOP_2.MNU │ SEDIT V2.6 A:--------B:--------C:--------D:-------- Sec:5 FG:15 BG:1 Key:? Typ:0 ----------------------------------------------------------------------------- The Screenshot above shows you the screen when pressing F1. Following i will explain the different functions (all functions can also be started by pressing the combination in brackets). "Insert Entry (ALT+I)" Inserts an entry at current cursorposition. the contents of the entry are take from the default menu entry, which is explained later. "Append Entry (ALT+A)" Appends an entry at the bottom of the current menu. "Delete Entry (ALT+D)" Deletes the entry at current cursorposition. "New Name for Menu (ALT+N)" -5- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 6 ════════════════════════════════════════════════════════════════════ Give the actual menu a new name (so called save-as feature). "Key-menu Add/Delete (ALT+K)" SEDIT provides a variety of alread built in keycodes, which are supported from SBBS. In this menu you can create your own key-definitions. There are already about 60 keycodes available, which are defined from SBBS (showing minutes left etc...). This keycodes can be used in entry-editing ind the text-line. more information about this topic follows later. ╒═════════════════════════════ Edit Special Keys ══════════════════════════════╕ │ │ │ ╒═══════════════════ Please Choose ════════════════════╕ │ │ │ 0 Displays user's sysop comment │ │ │ │ 1 Full screen editor (returns ON or OFF) │ │ │ │ 2 User's age │ │ │ │ 3 User's birthday │ │ │ │ 4 Time of user's first call │ │ │ │ 5 Date of user's first call │ │ │ │ 6 MailCheck at logon (returns ON or OFF) │ │ │ │ 7 User's down-/upload ration in kilobytes │ │ │ │ 8 User's down-/upload ratio in files │ │ │ │ A User's full name │ │ │ │ B User's city and state │ │ │ │ C User's password │ │ │ │ D User's business/data phone number │ │ │ │ E User's home/voice phone number │ │ │ ╘══════════════════════════════════════════════════════╛ │ │ │ │ │ │ <E>dit Key <D>elete Key <A>dd Key <ESC> Quit & Save │ │ │ ╘══════════════════════════════════════════════════════════════════════════════╛ Screenshot for Keycode-menu. -6- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 7 ════════════════════════════════════════════════════════════════════ "Change Flagdescription (ALT*F)" Sedit provides a possibility to give each Flag a own description. So you never loose the overview over your flag-system. Simply choose the flag and give it a descfription of your choice. "Edit Prompt & Highlight Colors (ALT+P)" Each menu has a prompt, which contains something like "Minutes Left, Your order >". This context can be changed with this option. Also you have in common menu entries the possibility to highlight parts of the text, by putting them between two "^". The Highlight color can also be changed in this menu. ╒═════════════════════════════ Change the Prompt ══════════════════════════════╕ │ │ │ │ │ │ │ │ │ Prompt Text : Restzeit ^~^ Minuten, Dein Befehl => │ │ │ Foreground : 15 │ │ Background : 0 │ │ │ │ HL FGround : 15 │ │ HL BGround : 1 │ │ │ │ │ │ │ │ │ │ ╒══ Prompt Preview ═════════════════════════════════════════════════════╕ │ │ │ │ │ │ │ Restzeit ~ Minuten, Dein Befehl => │ │ │ │ │ │ │ ╘═══════════════════════════════════════════════════════════════════════╛ │ │ │ ╘══════════════════════════════════════════════════════════════════════════════╛ "Change Prompt in all Menus (ALT+T)" If you want a single "always-be-the-same-prompt" in your menus simply run these option. SEDIT searches all menus of the defined path and changes the prompt to that one you specified. It's a quite usefull utility ! "Edit Default Menu Entry (ALT+M)" -7- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 8 ════════════════════════════════════════════════════════════════════ Every time you insert or append an entry, SEDIT needs to know, what should contain this entry. With this option you define a default entry, which will be used by SEDIT for such purposes. "Define & Save a Block (ALT+S)" Here you can define the beginning and the end of a entry-block and save this one to disk. This is very usefull for logos, headlines etc... "Load & Insert a Block (ALT+L)" Loads a saved Block (you remember ;-) and inserts it at current cursor position. "Copy Entry to new Position (ALT+C)" If you want to copy one of the entries to another position, you can do this by choosing this funtion. I think i don't have to explain more about the copy function ;-) "Compile ANSI to Menu (ALT+U)" This is a quite powerfull function of SEDIT. First you have to choose a ANSI file, and then define a destination block. SEDIT compiles the ANSI file to a valid SBBS-menustructure. So you can simply paint your menu by using one of the ANSI-painters and then compile the whole thing into a menu-block. This block can be insertet by the "Load-A-Block" - function listed above. "Preview actual Menu (ALT+V)" If you're working in Linenumber-mode this option is quite usefull. You see the WYSIWYG-display of the actual menu. The INCLUDE1.MNU function of SBBS is supported, so you see the real result of your work without first running SBBS for testmode. "View/Print Menu (ALT+G)" I don't know why i've implemented this function, i think it was for testing purposes. Just be glad, you have it ;-) -8- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 9 ════════════════════════════════════════════════════════════════════ "Save Menu (F2)" If you don't know why to use this option, consider about buying a storage-medium ;-) "EditText ON/OFF (F7)" Allows you to toggle between JumpEntry/JumpMenu (described below) and an EditMode, where you can simply scroll around the textlines. If you don't know what i mean, try it ;-) "Linenumbers ON/OFF (F8)" Toggle between WYSIWYG an Linenumbermode "Toggle JumpEntry / JumpMenu (F9)" There are two different modes SEDIT handles the the so called Fast-Jump feature. In the JumpEntry mode, SEDIT jumps to a specific menuentry when the key, which would start the action in SuperBBS, is pressed. This works quite fine, if you have large menus, and you often have to scroll the window. In JumpMenu mode SEDIT jumps to a new menu (only if the key you pressed is a Goto/Gosub/Return menutype). You also can jump to a new menu by pressing the TAB-key on your keyboard. This is only possible, if you locate the cursor on an entry which would jump to a new menu (in linenumbermode the ":" char will change to a ">", to show you, that you are on a jump-entry). In JumpMenu mode the INCLUDE1.MNU menujumps are supported (if you have put your "Jump to MainMenu" entry in the INCLUDE1.MNU menu, this will be recognized). In JumpEntry mode you can't do this, cause the INCLUDE1.MNU entries are not visible. To indicate in which mode you are operating watch the blinking points to reight an left of the SEDIT V?.?? logo on the right bottom. In JumpEntry mode this to lights are blinking, in JumpMenu mode they are ,hmm, let's call this smoothing ;-) "Menustructure Simulation (F10)" Starts the simulation of the actual menustructure. Debending on the startupmenu, defined in the CTL-file, SEDIT starts the simulation on the specified menu. Only menutypes which jump to other menus or display ASC/ANS files are supported. Why ? Because i didn't want to write another BBS-Program, SBBS is good enough ;-). the INCLUDE1.MNU function of SBBS is also supported. Pressing F1 in simulation changes the simulationlevel, so that you can test the structure from different point of views. -9- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 10 ════════════════════════════════════════════════════════════════════ ESC brings you back to editmode. The Editmode can be left by pressing ESC. SEDIT checks wether you made changes to the entries in this menu, if this is true, it asks you to save the menu. Those of you, which don't even know why saving, just forget about it ;-) If you have enabled the status-lights in the config-file, there are two flashing points to the right and left of the SEDIT V?.?? logo. A green flashing indicates als is ok, a red flashing indicates that you have changed the menu and should save the changes. The two points are flashing in different ways, which indicate the two editmodes JumpEntry and JumpMenu. In JumpEntry mode the points are growing and shrinking, in JumpMenu mode the points are smoothing. Just try it, and you will see. -10- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 11 ════════════════════════════════════════════════════════════════════ 5. Editing an Entry ╒═════════════════════════ Editing the Default-Entry ══════════════════════════╕ │╒══════════════════════════════════Display═══════════════════════════════════╕│ ││ 1 2 3 4 5 6 7 ││ ││123456789012345678901234567890123456789012345678901234567890123456789012345 ││ ││............................................................................ ││ │╘════════════════════════════════════════════════════════════════════════════╛│ │╒════════════════════════════════Data-String═════════════════════════════════╕│ ││ ││ │╘════════════════════════════════════════════════════════════════════════════╛│ │ ╒════MenuType════╕ ╒════════════════════════Help═════════════════════════╕│ │ │Number : 0 │ │ Type : Text Line (Not Considered a Command) . ││ │ ╘════════════════╛ │ Desc. : None ││ │ ╒════Security════╕ │ >>> Warning - Key already used in this menu <<< ││ │ │Sec : 0 │ │ Level : Level not in LIMITS.BBS !!! ││ │ ╘════════════════╛ │ Keys used : #?AFHIKMNOPQSTUWX\ ││ │ ╒══════Key═══════╕ ╘═════════════════════════════════════════════════════╛│ │ │Key : ? │ ╒═════════Flags══════════╕ Graphic-Chars │ │ ╘════════════════╛ │ Flag A : -------- │ F1 = ┌ F6 = │ │ │ ╒═════Colors═════╕ │ Flag B : -------- │ F2 = ┘ F7 = ┤ │ │ │FColor : 7 │ │ Flag C : -------- │ F3 = ─ F8 = ├ │ │ │BColor : 0 │ │ Flag D : -------- │ F4 = ┐ F9 = ┴ │ │ ╘════════════════╛ ╘════════════════════════╛ F5 = └ F10 = ┬ │ ╘══════════════════════════════════════════════════════════════════════════════╛ Menu : C:\SBBS\MENU\TOP_2.MNU │ SEDIT V2.6 ALT+F1 Special-Keys / F1-F10 Graphic Chars / CTRL+F1-F5 Change Graphic Chars Above you see the edit-window for an entry. In the bottom-line you always get some little help about the actual editingpoint. -Display Window The text SBBS will put out is defined in this window. With ALT+F1 you can insert one of the keycodes you can define in the "Key-Menu" described above. The normal function keys are assigned to some special graphic chars which you can see in the rigth lower corner. This chars can be changed by pressing CTRL F1...F5, just test it. -Data-String Some menutypes need special parameter, which are expected in this window. Refer to the Help-Window, which data you have to fill in. -Menu Type The menutype defines what command should be executed whenn pressing -11- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 12 ════════════════════════════════════════════════════════════════════ the specified key (described below). If you're not so familiar with the possibility of the menutypes, just press F1 and you will receive a list ov possible menutypes. This types are defined in the SEDIT.TPY file, which can be updated by a simple ASCII-editor. -Security This value (from 0 - 32000) defines the minimum security level to access this entry. Pressing F1 will show you a list of available userlevels you already hav defined in the SBBS-config. -Key Defines the key which should execute the function described by the menutype. -Foreground Foregroundcolor of the Display-String -Background Backgroundcolor of the Display-String -Flags Define the Flagsetting. For each Flag a window pops up, where you can set the different bits by pressing the keys from 1 to 8. Additionally the flagdescription of each bit is displayd. Active flags are highlighted. -Help-Window The help-window shows some usefull information. The type-statement describes the menutype you've choosen. The description field below gives you a hint, which parameters should stand in the Data-String. The Level statement shows the userleveldescription how it is defined in SBBS configuration. "Keys used" shows every used keycombination in the menu. If you define a key twice in the actual menu, a flashing warning is shown in the middle of the box (see screenshot). -12- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 13 ════════════════════════════════════════════════════════════════════ 6. Difference between WYSIWYG and Linenumbermode The following Screenshot displays my own TOP.MNU in the Linenumbermode. The entries can be choosen by the cursorkeys, pgup, pgdn, home and end. In both modes you can make a quick-jump to an entry by pressing the key, which would invoke the function in SBBS. e.g. if you have a menu entry "[I] Impressum" (like below) just type "I" and the cursor moves to the designated entry. 1 :┌───────────────────────────────────────────────────────────┐; 2 : 3 :; 4 :│ ░▒▓█▓▒░ █▀█ █ ░▒▓█▓▒░ │; 5 : 6 :; 7 :│ ░▒▓█▓▒░ █▀▀ rogrammers █ nn ░▒▓█▓▒░ │; 8 : 9 :; 10 :│ ░▒▓█▓▒░ I ▀ ▀ J ░▒▓█▓▒░ │; 11 : 12 :; 13 :└────────────────────; 14 :>>> MAIN MENU <<<; 15 :──────────────────────┘; 16 : 17 : 18 : 19 :[I] Impressum ; 20 :[U] Userlevel ; The WYSIWYG displaymode is shown below. Please remind, that in this mode the invisible function of your menus are REALLY invisible ;-) the cursor is shown by a reverse "*". *───────────────────────────────────────────────────────────┐ │ ░▒▓█▓▒░ █▀█ █ ░▒▓█▓▒░ │ │ ░▒▓█▓▒░ █▀▀ rogrammers █ nn ░▒▓█▓▒░ │ │ ░▒▓█▓▒░ I ▀ ▀ J ░▒▓█▓▒░ │ └────────────────────>>> MAIN MENU <<<──────────────────────┘ [I] Impressum [U] Userlevel [N] News anzeigen [M] Message Base [F] File Area [P] Private Mails [K] Konfiguration [T] Internas [X] Netmails [O] Online Games -13- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 14 ════════════════════════════════════════════════════════════════════ The two bottomlines show you some usefull informations about the menuentry under the cursor. Menu : C:\SBBS\MENU\TOP_2.MNU │ SEDIT V2.6 A:--------B:--------C:--------D:-------- Sec:5 FG:15 BG:1 Key:? Typ:0 There is the actual menu-name and path, the flag settings, security, fore/backgroundcolor, the key and the menutype displayed. 7. Registration You can registrate SEDIT by different ways. ** Please look into REGISTER.DOC for further information ** The first way is to send a cheque payable to Oliver Weindl to the following adress: Oliver Weindl Sudetenstr.3 Germany-8303 Rottenburg/L If you want to get your key by disk, please don't forget to include a formatted disk with an full adressed envelope (don't forget the stamp ;-). There also is the possibility to download the key from my BBS. If you add 5,-- German Marks (or 5 US Dollars) i will send you the key crash to your BBS (or upload it, if you're not in FIDO). You also can pay the fee to following bank-account: Sparkasse Rottenburg * BLZ: 743 500 50 * Ktnr. 701 493 7 Please infrom me about this transaction per mail. I need following information from you to generate the key for SEDIT: -14- SEDIT V2.7 (c) 1992 by Oliver Weindl Page 15 ════════════════════════════════════════════════════════════════════ The complete registration datas you have inserted in the SBBS-config (the best would be a screenshot from this config-option like below !) ╒═════════════════════════Registration══════════════════════════╕ │ │ │ SysOp name : Oliver Weindl │ │ System name : Programmer's Inn *HST* │ System location : 8303 Rottenburg │ │ Registration code : <not neccessary> │ │ Beta code : <not neccessary> │ │ │ ╘═══════════════════════════════════════════════════════════════╛ ======================================================= This is quite important, so don't forget it !!!!!!!!!!! ======================================================= You will receive a File named SEDIT.INI which contains the registration datas for SEDIT. This keyfile allows you to use all following versions of SEDIT in registered mode ! 8. Updates Updates are available at my BBS Programmer's Inn. You can request (if you're in Fido) the Magic SEDIT, or can download the newest version of SEDIT locally in the BBS. The numbers for the two lines are as following: 2:246/45 PI Line 1 Intl+49-8781-3418 HST/DS 2:246/145 PI Line 2 Intl+49-8781-3442 ZyXEL+ -15-