home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / maxmen03.zip / MAXMENU.DOC next >
Text File  |  1994-03-27  |  11KB  |  315 lines
  1. Welcome to the Maxmenu version 3.0
  2.  
  3.  
  4. What it does:
  5.  
  6. Maxmenu generates from your *.mnu files full 3D Ansi *.bbs menus
  7. You can define there the colors, the Helplevel and what menus for what
  8. privlevel you want displayed.
  9.  
  10.  
  11. Maxmenu generates also RIP compatible menus
  12. You can define there the Buttons/line the Icons/line the colors
  13. and the fonts.
  14. So you don't have to change your menus manually for every new
  15. Menuitem only run maxmenu over your *.mnu file that's all.
  16.  
  17. You can also tell maxmen to process only RIP or only AVATAR.
  18. Don't bother what OS you have maxmen now runs under OS/2 and also under DOS.
  19.  
  20. Install :
  21. read first this doc file
  22.  
  23. What you need :
  24.  
  25. first edit your Menus.ctl file that it looks like this
  26.  
  27. Menu MAIN0
  28.         Title           MAIN
  29.         MenuHeader      none
  30.         MenuFile        c:\max\menus\Main0  < there you call *.bbs menus
  31.         Display_Menu    Message%Y              Disgrace "Message Areas"
  32.         Display_Menu    File%Y                 Disgrace "File Areas"
  33.         Display_Menu    Change%Y               Disgrace "Change Setup"
  34.  
  35.  
  36. So if you have a main0.mnu file maxmenu will generate a main0.bbs file.
  37.  
  38. Then make shure your RIP users get the R keyflag set cause my ripmenus
  39. have in the first line the [ifkey]R and my normal Maximus Menus have
  40. the [notkey]R token included.
  41.  
  42. you only have to make shure that the following mecca sequence is included
  43. in your Welcome.bbs and rookie.bbs file.
  44.  
  45. ...... welcome.mec .............
  46. [moreoff ckoff]
  47. [link]c:\max\misc\rip\r-logo
  48.  
  49. .......r-logo...................
  50. [moreoff ckoff][cls]
  51. [comment !|1K|w0000270O12|#|#|# = Set Rip text windows to 80x25]
  52. [comment !|1K|w05052D1421|#|#|# = Set Rip text windows to 80x25 small font]
  53. looking for RIP-TERMINAL
  54. [ifkey]R [keyoff]R
  55. !|1K|w0000270O11|#|#|#
  56. [cls]
  57. [clear_stacked]
  58. [comment !|1F000000RIP? Will return a 0 or 1 if the caller has a RIP Terminal]
  59. !|1F000000RIP?
  60. [pause][pause][pause]
  61. [no_keypress][goto no_rip]
  62. [menu]0123456789zxcvbnm,./';lkjhgfdsaqwertyuiop[]
  63. [choice]1 [goto rip]
  64. [choice]0 [goto rip]
  65. [goto no_rip]
  66.  
  67. [/rip]
  68. [cls]
  69. [hotkeys goto hotenabled]
  70. [menu_cmd chg_hotkeys]
  71. [/hotenabled]
  72. [keyon]R
  73. [link]c:\max\misc\rip\hello.rip
  74. !|10$PHASER$!|10$PHASER$!|10$PHASER$
  75. [/no_rip]
  76. ..................................................
  77.  
  78. DON'T PUT IT IN YOUR LOGO.BBS cause max doesn't know at this time the
  79. Username!
  80.  
  81.  
  82. MAXMENUS.CFG
  83.  
  84. this is the configuration file for Maxmenu if you don't
  85. have one it doesn't matter maxmenu will then use it's default
  86. settings.
  87.  
  88. delim1  '│' this symbol defines the left and right border
  89.  
  90. delim2  '═' this symbol defines the top and bottom border
  91.  
  92. corner1 '╕'
  93. corner2 '╒'  This symbols defines the corners
  94. corner3 '╛'
  95. corner4 '╘' 
  96.  
  97. NOTIME if you don't want the Time displayed then uncomment this line
  98.  
  99. NOSYMBOL if you don't want a '■' symbol at the top left of the menu
  100.          then uncomment this line
  101.  
  102. RIPKEY 'x'  uncomment this line if you don't want userkey 'R' for
  103.             your menus and write your own key.
  104.             only key 1..8,A..X are supported by Maximus.
  105.  
  106. NOptback    Fore/Background of top left Menusymbol '■'
  107.  
  108. NLback      Fore/Background of Menudescriptions this is the 'ile'
  109.             string for menupoint File.
  110.  
  111. NHeader     Headercolor this is the Fore and Backgroundcolor in the Menuheader
  112.             Like MAINMENU or MESSAGEAREA
  113.  
  114. NBackground Backgroundcolor this is the Backgroundcolor of the whole Menu
  115.  
  116. NForeground Foregroundcolor of Select and Time line
  117.  
  118. NHighShadow Fore/Backcolor of Highlighted Shadow
  119.  
  120. NLowShadow  Fore/BackColor of Lowlighted Shadow
  121.  
  122.  
  123. If you use the colors in maxmenus.cfg then you
  124. HAVE TO SELECT FOR ALL MENUS the colors.
  125.  
  126.  
  127. ; if the user has defined NOVICE Menus then you can control if
  128. ; he should get instead REGULAR or EXPERT menus.
  129. ; valid keys are :             valid combinations are:
  130. ;
  131. ; TWIT                         EXPERT
  132. ; DISGRACE                     REGULAR
  133. ; LIMITED
  134. ; NORMAL
  135. ; WORTHY
  136. ; PRIVIL
  137. ; FAVORED
  138. ; EXTRA
  139. ; CLERK
  140. ; ASSTSYSOP
  141. ; SYSOP
  142. ;
  143. ;SYSOP_EXPERT   ; sysop should get expert menus
  144. ;TWIT_NOVICE    ; twit should get novice menus
  145. ;NORMAL_REGULAR ; normal should get regular menus
  146. ;FAVORED_REGULAR ;
  147. ;EXTRA_EXPERT    ;
  148. ;DISGRACE_NOVICE ; disgrace should get novice menus
  149. ;
  150.  
  151.  
  152. RIP_STUFF
  153.  
  154. change the fonts for all of your RIP Menus :
  155. RIP_HEADERFONT         8; font of all headertitles like 'MAIN MENU'
  156. RIP_HEADFONTSIZE       4; size of the font depends on the font you are using
  157. RIP_BUTTONFONT         2; font of all Buttons like 'Goodbye'
  158. RIP_BUTTFONTSIZE       4; size of the font depends on the font you are using
  159.  
  160. Please take a look in maxmenus.cfg there you will find an overview of valid
  161. Fonts.
  162.  
  163.  
  164. With the following commands it's possible to give some of your menus
  165. different colors.
  166.  
  167. N_Rip_ButtonText         0;   { text inside buttons is black }
  168. N_Rip_ButtonShadow       8;   { darkgray shadow }
  169. N_Rip_ButtonInvShadow    15;  { white shadow }
  170. N_Rip_Buttoncol          7;   { button appears gray }
  171. ....
  172. ....
  173.  
  174. The Icons are now also configurable with the
  175. ICONFILE 301 d:\ripaint\icons\hangman
  176. this means for the maximus internal command 301 = 'Hangup' the Icon
  177. Hangman will be displayed on the remoteside.
  178. Use only icons for commands which are unique in the menu cause you will get
  179. displayed this icon in the other menus too.
  180. In this example you will display a hangman icon in every menu where you use
  181. the maximus hangup command.
  182.  
  183. With the next two tokens you can define if you only want ANSI/AVATAR or
  184. if you only want RIP menus.
  185.  
  186. NO_ANSI ;this produces only RIP menus and no Ansi/Avatar code
  187. NO_RIP  ;this produces only ANSI/AVATAR menus and no RIP stuff
  188.  
  189. This is for those of you who have already ansi or rip menus and only need one
  190. of them.
  191. Please make a separate directory with your *.mnu in it and then compile it,
  192. cause maxmen will overwrite your ANSI or RIP menus.
  193.  
  194. The next token is valid for RIP and ANSI/AVATAR
  195.  
  196. ;NO_TWIT_d:\max\misc\twit
  197. ;NO_DISGRACE_d:\max\misc\disgrace
  198. ;NO_LIMITED_d:\max\misc\limited
  199. ;NO_NORMAL_d:\max\misc\normal
  200. ;NO_WORTHY_d:\max\misc\worthy
  201. ;NO_PRIVIL_d:\max\misc\privil
  202. ;NO_FAVORED_d:\max\misc\favored
  203. ;NO_EXTRA_d:\max\misc\extra
  204. ;NO_CLERK_d:\max\misc\clerk
  205. ;NO_ASSTSYSOP_d:\max\misc\assys
  206. ;NO_SYSOP_d:\max\misc\sysop
  207.  
  208. This means don't display a menu for level DISGRACE and do instead a
  209. [display]d:\max\misc\disgrace.
  210.  
  211. So you can Experiment with your own menus or give some special privlevels
  212. special menus.
  213. Please note that you must also write your own RIP menus if you include
  214. this token.
  215.  
  216.  
  217.  
  218. thats all for the beginning.
  219.  
  220. If you already have some *.bbs menufiles then copy some of your *.mnu
  221. files to a different subdir and run maxmenu in this subdir cause Maxmenu
  222. overwrites all old *.bbs files with his outputfiles.
  223. so if you only want to see how your menus would look like then e.g.
  224. rename the main.bbs to f9.bbs copy this file to your \misc subdir and run
  225. it with function key F9.
  226.  
  227.  
  228. Now something for the interested sysops :
  229.  
  230. if you want to know how the bbsfiles are generated then run ACCEM on them
  231. then you can see how this menus are generated.
  232. The normal Ansi/maximus menus have the following construction.
  233. Every privlevel gets only Menus with his Privlevel so a user with
  234. level NORMAL doesn't see Menuitems for users with level EXTRA.
  235. Thats normaly a hard work if you generate your menus with an AnsiEditor.
  236.  
  237. The normal Ansi/maximus menus are also helpdependent that means a user with
  238. helplevel NOVICE gets full menus a user with helplevel REGULAR gets only
  239. the first characters of the menupoints and so on.
  240. users with helplevel Hotflash are not supported but they are also
  241. not supported in all other ansi menus.
  242.  
  243. The ripmenus are somewhat different with ripmenus the user gets only
  244. menupoints where he has a valid level so NORMAL users get only menupoints
  245. with privlevel TWIT,DISGRACE,NORMAL.
  246. The ripmenus don't care what helplevel the user has they all get full menus.
  247.  
  248.  
  249.  
  250. How to run maxmenu:
  251.  
  252. you can run it by commandline
  253.  
  254. MAXMENU MAIN1
  255. then maxmenu will look for a main1.mnu file and make in the same subdir a
  256. Main1.bbs file
  257.  
  258. you can also make a batchfile if you want to make *.bbs files for all your
  259. *.mnu files
  260.  
  261. .................allmenus.bat....................
  262. @echo off
  263. for %%X in (*.mnu) do maxmenu %%X
  264.  
  265. in this archive there should also be an ENGLISH.MAD file this is an
  266. special language file created from the original english.mad for max 2.01wb
  267. but this language file takes advantage of my ansi/max menus so your maximus
  268. will get an unique look and feel.
  269.  
  270. If you want to know how to implement your own menustyles then open
  271. english.mad with your texteditor and search for ▌ alt-221 this char
  272. is mostly implemented in my menus.
  273.  
  274.  
  275. Switching ripmenusupport on and of in the change septup menu
  276. here is an sample how to switch rip on and off in the change setup
  277.  
  278. ....................menus0.ctl.......................
  279. Menu CHANGE0
  280.         Title           CHANGE
  281.         HeaderFile      Misc\Change < you need this line
  282.         MenuHeader      Change
  283.         MenuFile        c:\max\menus\change0
  284.         Display_Menu    Main%Y                     Twit "Quit to Main Menu"
  285.         ....
  286.         ....
  287. NoDsp   Display_File    Misc\Ripsupp             Normal "R"
  288.         Display_menu    Change%Y                 Normal "Rip Support"
  289.  
  290. ......................change.mec.......................
  291. [ifkey]R [white          ]▐[white on gray] [black on gray]  RIP Support   [yellow on gray] YES                                                      [white on gray]  [darkgray]▌
  292. [notkey]R [white          ]▐[white on gray] [black on gray]  RIP Support   [yellow on gray] NO                                                       [white on gray]  [darkgray]▌
  293. [up]
  294.  
  295. ......................rippsupp.mec......................
  296. [ifkey]R [keyoff]R [goto end]
  297. [notkey]R [keyon]R [goto end]
  298. [/end]
  299.  
  300.  
  301. Thats all so the user can online toggle if he wants now rip or if he
  302. wants to switch it off.
  303.  
  304.  
  305. If you have any questions/hints/tips then don't hesitate and gimme
  306. a netmail.
  307. If you don't like the menus then send me an example what menustyle you
  308. prefer and i will look to implement it in the next version but don't make
  309. them too difficult even computers have their limits.
  310.  
  311.  
  312. greetings Schlagi
  313.           2:310/3.0 cuckoo's nest vienna/austria
  314.  
  315.