Icy Board Menu System

PCBoard had a built in menu system - there were several hooks where a .mnu file could be used instead of a display file or .ppe.

IcyBoard will support custom menus as well the .mnu files get translated to icyboard menu files and there is an editor "mkicbmnu" to edit them.

MKICBMNU 

 The original one:

MKPCBMNU

The general idea a menu system like RemoteAccess/MysticBBS. The original menus supported hot keys and commands. IcyBoard menus will add lightbars on top of these. 

The commands are more complex than the original PCBoard commands, therefore the setup is a bit different. And has two parts - a command list:

Command list

And a setup screen where the command can be set up:

Setup screen

For lightbars the commands need to display a selected/non selected text. For the other types display & highlight text can be empty. Each command has an action list attached these actions can run on selection or activation. 

This command has 3 actions - gotoxy & print text which is run on selection and prints an information text about this item and the "WhoIsOnline" action which is run on activation.

Lightbar commands can be activated with "return" or the hotkey (W in that case). For hotkey & lightbar menusu the keyword should be just one char or the command can't be activated with a keyboard hotkey.

Menus contradict the PCBoard spirit a bit but give the flexibility to make a more "modern" BBS. I probably wouldn't have implemented a menu system (the idea of IcyBoard is to utilize the PPE ecosystem) but pcboard covered that and therefore it's a core feature.

The lightbar menu system in action inside icy board: 

 
 

Note that the selection behavior currently isn't configurable. IcyBoard handles the cursor keys & selection behavior.

Comments/thoughts? Is there something I should consider/look at?

Comments

  1. grymmjackMay 15, 2024 at 8:29 AM

    Very good stuff man. You will want to make sure to implement FIRSTCMD, EVERYTIME, ONLYONCE, etc. too. This allows the menu system to be used for modding without coding any PPL stuff.

    3. When editing menus, the following can be used in the "hot key"
    field of the menu command:

    FIRSTCMD : Automatically run the command each time the menu is
    loaded.
    EVERY : Automatically run the command each time the menu is
    redrawn (before its actually redrawn)
    AFTER : Automatically run the command each time the menu is
    redrawn, just before the prompt is displayed.

    From here: https://github.com/KALRONG/mysticbbs/blob/f6e9b4a92a245a662b6e106bd332addf15ead3d3/mystic/docs/mystic.txt#L105

    ReplyDelete
  2. Mike KrügerMay 15, 2024 at 9:02 AM

    This is an interesting feature. I'll look at how I can provide that functionality. In the hot key field it's hard to find that - maybe I'll take a look at mystic what's their approach is. Thanks

    But yes the idea is that for menus PPL isn't required. If a feature like that is provided by IcyBoard it should be a good implementation. (that the commands are ~1:1 the old PCB commands is by design. I'll try to provide alternatives for as many as possible over the time).

    ReplyDelete

Post a Comment

Popular posts from this blog

File Processing

The file handling won't be much different than that from PCBoard. However I need to research the PPEs for a final decision :). Internally it'll be different. PCBoard works basically just with a text file. IcyBoard will have a more database like approach. I want to provide a file scanner/repacker to work with file bases. It should support the most common formats out of the box. I want to provide as much code in Rust as possible which is a problem in that area. That's why I've begun working on compression algorithms. I ported zip compression methods Shrink, Reduce and Implode to zip-rs (excellent blog post about these methods are here: https://www.hanshq.net/zip2.html). I've implemented an ARJ decompressor and started working on ARC. There seems to be a working RAR library that I can just use as well as LZH/LHA. So it'll support 7Z, ZIP, ARJ, RAR, LHA/Z and ARC out of the box. The rest needs to be done with external packers. If you think that I need to support ano
Read more

Configuration tools

One thing I wanted to have for Icy Board are console configuration tools. PCBoard was a complex system so it did split up configuration in several parts.  So does IcyBoard. This blog post gives an overview of the various tools. mkicbmnu For creating & changing menu files - I've used that in the demo of the menu system.  mkicbtxt   This one is used for changing the BBS display strings. Every string the BBS displays is stored in a icbtxt.toml file (or pcbtxt). IcyBoard usually uses the .toml format so it's possible to use an ordinary text editor for everything.  However I prefer config tools :).Note: mkicbtxt can be used to change PCBTXT files as well. It doesn't alter the format. icbsetup Icbsetup is the main configuration utility. All BBS options, conferences, file & message areas can be configured with this tool. IcyBoard inherits a complex structure from PCBoard to work with and ads some more options on the pile. The main file is "icyboard.toml" whic
Read more