home *** CD-ROM | disk | FTP | other *** search
/ Amiga Times / AmigaTimes.iso / programme / trionbbs110 / Trion / docs / 07_Text_files.doc < prev    next >
Encoding:
Text File  |  1998-10-06  |  3.1 KB  |  89 lines
  1.  
  2.  
  3.   Introduction
  4.   ------------
  5.  
  6.    This chapter describes the text files used by Trion BBS in
  7.    menus, by menu commands and other places and how they are
  8.    named and used.
  9.  
  10.  
  11.   Text files
  12.   ----------
  13.  
  14.    Text files are the files that produce most output to the screen.
  15.    They are used in menus to produce a screen with selections.
  16.    They are used by the system to show login screens and can be
  17.    used by menu commands to show all kind of texts or to show
  18.    the logout screen.
  19.  
  20.    Text files can not only contain pure text but also ANSI,
  21.    or RIP codes to add colors or other graphical effects.
  22.  
  23.    Basically text files can have every name but there are
  24.    a number of special cases.
  25.    When you give a name and the system can't find the file
  26.    it will try a number of extensions:
  27.  
  28.    ".ANSI", ".TXT", ".RIP", ".GR0"
  29.  
  30.    When a file with on of these extensions if found it will
  31.    be printed.
  32.    So in a menu you can use names like "mailscreen" and not
  33.    have to worry about extensions in the name of the files
  34.    on disk. But you could also have named the file "mailscreen.ANSI"
  35.    but only files with that name will be displayed. If you
  36.    would rename the file on disk to "mailscreen.RIP" the system
  37.    can't find it.
  38.  
  39.    Note that files with the extension ".RIP" are a little
  40.    different interpreted as other screens. In other screens
  41.    the number of lines are counted, and if the screen if
  42.    "full" a more prompt will appear. In RIPscrip a line
  43.    of codes doesn't have the same meaning as a line with
  44.    text but is the code the graphical draw a screen so
  45.    there are no more prompts in RIPscreens.
  46.  
  47.  
  48.   File types
  49.   ----------
  50.  
  51.    Menu screens:
  52.  
  53.    Default menu screens are stored in "Trion:menutext/".
  54.    Screens from that directory are used when a user selects menu set 0
  55.    or when there are no screens for other menu sets.
  56.    For menu sets greater than zero a number is added to the name.
  57.    So screens for menu set one are stored in "Trion:menutext1/"
  58.    and so on for other menu sets. But when the directory or
  59.    the file name does not exists the screen from menu set zero is used.
  60.    Note that the menu set number is also used to select a BBStext set.
  61.  
  62.    Text screens:
  63.  
  64.    While loging in the BBS will display a number of screens, these
  65.    screens are stored in "Trion:text/".
  66.    The first screen displayed is "login.ansi".
  67.    For all the following screens a number should be added after the
  68.    login part like "login1.ansi".
  69.    Note that if a screen with a certain number does not exist the
  70.    BBS will terminate the loop to show login screens. So you
  71.    should leave no gaps in the numbering.
  72.  
  73.    Texts displayed by menu commands:
  74.  
  75.    There are menu commands to print files to the screen like
  76.    PrintFile and PrintFileNoPause.
  77.    These are used by the system to print the logout screen.
  78.    The screens are not limited to one space on harddisk so
  79.    a path has to be used. Note that "Trion:text/" is used
  80.    in the default menu set. It's a good idea to store all
  81.    your text files their so you don't have to search
  82.    when you are updating a screen.
  83.    
  84.    An example would be :
  85.  
  86.       PrintFile  "trion:text/logout.ansi"
  87.  
  88.  
  89.