home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Media Share 9
/
MEDIASHARE_09.ISO
/
comm
/
sedit270.zip
/
SEDIT.DOC
< prev
next >
Wrap
Text File
|
1993-01-02
|
35KB
|
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-