Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
custom:menu_files [2018/03/01 12:21] – old revision restored digital mancustom:menu_files [2018/10/25 10:53] – [Menu Files] More details/clarity digital man
Line 2: Line 2:
  
 Menu files displayed to the remote terminal client / user are stored in the ''[[dir:text]]/menu'' directory. Menu files displayed to the remote terminal client / user are stored in the ''[[dir:text]]/menu'' directory.
 +
 +Other display files (mainly used during the terminal server's new user registration process), are stored in the ''[[dir:text]]'' directory.
  
 Menu files may have one of the following file suffixes / extensions: Menu files may have one of the following file suffixes / extensions:
  
-^Extension       ^Description^ +^Extension       ^Description of expected contents^ 
-|''.asc''        |[[Ctrl-A Codes]] for ANSI X3.64-subset and Dumb ASCII/TTY Terminals| +|''.asc''        |ASCII characters (CP437 characters, optionally)| 
-|''.ans''        |ANSI X3.64 Color Terminals (only)| +|''.msg''        |ASCII/CP437 characters ((the main difference between .asc and .msg files are their selection priority, with .asc files targeting plain-ASCII terminals)) | 
-|''.mon''        |ANSI X3.64 Monochrome Terminals| +|''.seq''        |PETSCII characters and control-sequences | 
-|''.rip''        |RIPscrip Terminals| +|''.ans''        |ASCII/CP437 characters and ANSI X3.64 Terminal control-sequences| 
-|''.wip''        |WIP Terminals (deprecated)| +|''.mon''        |ASCII/CP437 characters and ANSI X3.64 Terminal control-sequences suited for monochrome displays | 
-|''.html''       |Experimental HTMLterm|+|''.rip''        |ASCII/CP437 characters and RIPscrip Terminal control-sequences|
  
-See the [[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/text/menu/|Menu Directory]] in [[dev:CVS]] for default menu files and their contents.+//All// of these file types may contain [[Ctrl-A Codes]] color/attribute codes and/or [[atcodes|@-Codes]].
  
-All of these file types may contain [[Ctrl-A Codes]] and/or [[atcodes|@-Codes]].+Although you may have multiple menu files with the same base filename and different suffixes/extensions, only one menu file will be selected and displayed to the terminal user based on their configured or auto-detected terminal type/capabilities. The menu/display file selection priority is as follows (the highest-priority file type that exists on disk will be displayed to the user): 
 + 
 +|          |^ ANSI / CP437((ANSI/CP437 would be the most common BBS terminal-type encountered))         ^^ ANSI / ASCII       ^|   ||| 
 +^ Priority ^     RIP    ^ Color    ^ Mono      ^  Color   ^ Mono     ^  PETSCII  ^ TTY / CP437   ^  TTY / ASCII     ^ 
 +| 1        | ''.rip''   | ''.ans'' | ''.mon'' | ''.ans'' | ''.mon''  | ''.seq''  | ''.msg''      | ''.asc''       | 
 +| 2        | ''.ans''   | ''.msg'' | ''.ans'' | ''.asc'' | ''.ans''  | ''.msg''  | ''.asc''      | ''.msg''       | 
 +| 3        | ''.msg''   | ''.asc'' | ''.msg'' | ''.msg'' | ''.asc''  | ''.asc''  |               |                | 
 +| 4        | ''.asc''   |          | ''.asc'' |          | ''.msg''  |           |               |                | 
 + 
 +Each of these file types may be preempted by a terminal-width specific file with a name ending in ''.//X//col//.ext//'' where ''//X//'' is the (exact) number of screen columns (e.g. usually 80 or 40) and ''//.ext//'' is one of the supported file extensions from the above list. 
 + 
 +If you only have **one** display file for any particular base filename, it should have either a ''.msg'' or ''.asc'' extension and contain no terminal-control sequences (e.g. ANSI, PETSCII, or RIP). 
 + 
 +See the [[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/text/menu/|Menu Directory]] in [[dev:CVS]] for default menu files and their contents.
  
 Most menu files are loaded/displayed by a [[custom:command shell]], so the name and location (e.g. sub-directory) of those files may depend on which command shell is in use by the users of your [[server:terminal]] server. Most menu files are loaded/displayed by a [[custom:command shell]], so the name and location (e.g. sub-directory) of those files may depend on which command shell is in use by the users of your [[server:terminal]] server.

Trace: